Soumissionnaires - Service membre

Toute entité qui a une relation financière avec la plateforme de Xandr (généralement un acheteur ou un vendeur) doit être ajoutée au système de Xandr en tant que « membre » avant de pouvoir effectuer des transactions. Les membres peuvent être inscrits auprès du service aux membres par un enchérisseur ou par le personnel Xandr.

Membres et contrats

Avant de pouvoir acheter ou vendre des annonces, un membre a besoin d’un contrat avec Xandr. Ce contrat établit des conditions financières et des facilités de crédit (le cas échéant) et lie le membre aux conditions générales de Xandr, telles que la qualité du contenu et l’utilisation des informations d’identification personnelle. Tout soumissionnaire peut créer un membre à tout moment, mais les membres ne pourront pas soumettre d’offres tant que leur contrat n’aura pas été approuvé.

API REST

Champs JSON

Exposition de la plateforme

Le paramètre d’exposition de la plateforme détermine la façon dont votre compte est affiché aux autres membres de la plateforme. Il existe trois valeurs qui entraînent des comportements légèrement différents, comme indiqué ci-dessous :

hidden Exemple

{
  "seller_id": "8253",
  "is_confidential": 1,
  "seller_type": "PUBLISHER"
}

public Exemple

{
  "seller_id": "7694",
  "seller_type": "INTERMEDIARY",
  "domain": "groupm.com",
  "name": "Xaxis – Slovakia Marketplace"
}

L’exemple JSON ci-dessous montre comment définir ce paramètre.

{
  "member": {
    "platform_exposure": "public"
  }
}

Jeton d’authentification

L’authentification est toujours la première étape lors de l’utilisation des services d’API. Le jeton d’authentification peut ensuite être écrit dans notre fichier de cookie pour une utilisation ultérieure. Pour obtenir des instructions plus détaillées, consultez Service d’authentification.

Exemples

Create un fichier au format JSON décrivant le membre

Les seuls champs obligatoires sont billing_name et bidder_id si le membre est associé à un soumissionnaire, mais étant donné qu’un membre a une relation financière avec Xandr, vous voudrez probablement inclure d’autres informations relatives à la facturation.

$ cat member
{
        "member" : {
                "active" : true,
                "billing_name" : "My Company",
                "bidder_id" : 2,
                "billing_address_1" : "One Coke Way",
                "billing_city" : "Atlanta",
                "billing_region" : "GA",
                "billing_country" : "US",
        "email_code" : "cola"
        }
}

Ajouter le fichier membre au cache du bus d’impression

$ curl -b cookies -c cookies -X POST --data-binary @member 'https://api.adnxs.com/member'
{
        "response":{
                "status":"OK","id":1
        }
}

À présent, modifiez le membre via un fichier au format JSON modifié

$ cat member_mod
{
        "member" : {
                "active" : true,
                "billing_name" : "My Company",
                "bidder_id" : 2,
                "billing_address_1" : "Building 5",
                "billing_address_2" : "Company Complex",
                "billing_city" : "Atlanta",
                "billing_region" : "GA",
                "billing_country" : "US",
                "billing_postal_code" : "33608"
        }
}

Mettre à jour les informations de membre dans le cache du bus d’impression, à l’aide de l’ID de membre

$ curl -b cookies -c cookies-X PUT --data-binary @member_mod 'https://api.adnxs.com/member/1'
{
        "response":{
                "status":"OK"
        }
}

Afficher des informations sur le membre

$ curl -b cookies -c cookies 'https://api.adnxs.com/member/1'
{
   "response":{
      "status":"OK",
      "member": {
        "id": 334,
        "agent_id": null,
        "code": null,
        "active": true,
        "buyer_credit_limit": 0,
        "billing_name" : "My Company",
                "bidder_id" : 2,
                "billing_address_1" : "Building 5",
                "billing_address_2" : "Company Complex",
                "billing_city" : "Atlanta",
                "billing_region" : "GA",
                "billing_country" : "US",
                "billing_postal_code" : "33608"
        "email_code": "cola",
        "seller_revshare_pct": 95,
        "price_buckets": [
        ],
        "default_tag_id": null,
        "default_ad_profile_id": 251,
        "buyer_clearing_fee_pct": null,
        "serving_domain": {
          "cname": null,
          "type": null
        },
        "last_activity": "2010-04-08 03:38:16",
        "timezone": "EST5EDT"
      }
   }
}