Partenaires d’approvisionnement - Demande d’enchère

Pour envoyer une demande d’enchère à Xandr, utilisez POST un fichier au format JSON contenant les détails de la demande d’enchère au point de terminaison suivant :

https://ib.adnxs.com/asi?member_id=YOUR_PROD_MEMBER_ID

Pour les tests dans notre environnement de test client, vous accédez POST au point de terminaison :

https://ib.client-testing.adnxs.net/asi?member_id=YOUR_TESTING_MEMBER_ID

Pour obtenir des conseils sur la mise en forme de votre demande, consultez les exemples en bas de la page.

Champs JSON

Lorsque les champs sont disponibles pour les valeurs internes et externes (par exemple, int_blocked_categories et ext_blocked_categories), incluez un seul des champs dans votre fichier au format JSON. Si les deux sont inclus, la valeur interne est utilisée.

Exemple de mise en forme : blocked_urls

{
"blocked_urls": [
"landingpage1.com",
"landingpage2.com"
]
}

Mappage de positionnement

Xandr n’envoie une offre que lorsque nous pouvons mapper votre demande à un placement dans Xandr. Nous recherchons les éléments suivants dans l’ordre suivant :

1. an_placement_id
2. ext_placement_code
3. ext_pub_code (balise par défaut de l’éditeur)
4. Placement par défaut de votre membre (configuré pour votre compte par votre responsable technique de compte avant même que les informations d’identification de connexion de production soient affectées).

Si aucun des éléments ci-dessus n’est disponible, Xandr n’envoie pas d’offre. Notez que chacun ext_placement_code ne peut mapper qu’à un seul emplacement dans Xandr, et que chacun ext_pub_code peut mapper à un seul éditeur dans Xandr.

Exemples

Envoi d’une demande d’offre minimalement acceptable

1. Create un fichier au format JSON comprenant uniquement les champs obligatoires. Cet exemple utilise le champ , mais vous pouvez utiliser ext_user_id à la an_user_id place.

   $ cat bid_request |
                  {
                  "an_user_id": 1089773736613054100,
                  "ext_auction_id": "395dj2j2j2dd",
                  "ad_format":"iframe",
                  "width": 300,
                  "height": 250
                  }
   

2. POST fichier au format JSON. Veillez à inclure votre ID de membre dans la chaîne de requête.

   curl -X POST -d @bid_request 'https://ib.adnxs.com/asi?member_id=123'
   

Envoi d’une demande d’enchère qui inclut uniquement des valeurs Xandr

1. Create un fichier au format JSON avec les champs des valeurs Xandr au lieu de fournir des valeurs de partenaire, par exemple, an_user_id au lieu de ext_user_id et int_blocked_technical_attributes au lieu de ext_blocked_technical_attributes.

   "$ cat bid_request"{
      "an_user_id":1089773736613054100,
      "ext_auction_id":"395dj2j2j2dd",
      "width":300,
      "height":250,
      "ad_format":"iframe",
      "ip_address":"38.108.249.106",
      "page_url":"publisher.com",
      "position":"above",
      "ext_pub_code":"203pub",
      "ext_site_code":"145site",
      "an_placement_id":40,
      "language":1,
      "user_agent":"Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.1.8) Gecko/20100214 Ubuntu/9.10 (karmic) Firefox/3.5.8",
      "int_blocked_technical_attributes":[
         6,
         10,
         11
      ],
      "int_blocked_categories":[
         16,
         17,
         19
      ],
      "int_content_categories":[
         5,
         6,
         7
      ],
      "blocked_urls":[
         "landingpage1.com",
         "landingpage2.com",
         "landingpage3.com",
         "landingpage4.com",
         "landingpage5.com"
      ],
      "blocked_languages":[
         2,
         3,
         4,
         5,
         6,
         7,
         8,
         9,
         10
      ],
      "age":25,
      "gender":"male",
      "supply_type":"web"
   }
   

2. POST fichier au format JSON. Veillez à inclure votre ID de membre dans la chaîne de requête.

   curl -X POST -d @bid_request 'https://ib.adnxs.com/asi?member_id=123'
   

Envoi d’une demande d’enchère qui inclut uniquement des valeurs externes

1. Create un fichier au format JSON avec les champs pour fournir des valeurs de partenaire au lieu de valeurs Xandr, par exemple, ext_placement_code au lieu de an_placement_id et ext_blocked_categories au lieu de int_blocked_categories.

   $ cat bid_request
   {
       "ext_user_id": 1089773736613054100,
       "ext_auction_id": "395dj2j2j2dd",
       "width": 300,
       "height": 250,
       "ad_format": "iframe",
       "ip_address": "38.108.249.106",
       "page_url": "publisher.com",
       "position": "above",
       "ext_pub_code": "203pub",
       "ext_site_code": "145site",
       "ext_placement_code": "40placement",
       "language": 1,
       "user_agent": "Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.1.8) Gecko/20100214 Ubuntu/9.10 (karmic) Firefox/3.5.8",
       "ext_blocked_technical_attributes": [
           3,
           5,
           8
       ],
       "ext_blocked_categories": [
           2,
           15,
           20
       ],
       "ext_content_categories": [
           2,
           9,
           13
       ],
       "blocked_urls": [
           "landingpage1.com",
           "landingpage2.com",
           "landingpage3.com",
           "landingpage4.com",
           "landingpage5.com"
       ],
       "blocked_languages": [
           2,
           3,
           4,
           5,
           6,
           7,
           8,
           9,
           10
       ],
       "age": 25,
       "gender": "male",
       "supply_type": "web"
   }
   

2. POST fichier au format JSON. Veillez à inclure votre ID de membre dans la chaîne de requête.

   curl -X POST -d @bid_request 'https://ib.adnxs.com/asi?member_id=123'
   

Envoi d’une demande d’enchère qui n’inclut pas de détails de blocage

Si vous configurez des profils publicitaires pour appliquer les préférences de vos éditeurs, vous n’avez pas besoin de spécifier les détails de blocage dans votre demande d’offre.

1. Create un fichier au format JSON à l’exclusion des champs de blocage des attributs techniques, des catégories créatives, des catégories de contenu, des URL et des langues.

   $ cat bid_request
   {
       "an_user_id": 1089773736613054100,
       "ext_auction_id": "395dj2j2j2dd",
       "width": 300,
       "height": 250,
       "ad_format": "iframe",
       "ip_address": "38.108.249.106",
       "page_url": "publisher.com",
       "position": "above",
       "ext_pub_code": "203pub",
       "ext_site_code": "145site",
       "an_placement_id": "40",
       "language": 1,
       "user_agent": "Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.1.8) Gecko/20100214 Ubuntu/9.10 (karmic) Firefox/3.5.8",
       "age": 25,
       "gender": "male",
       "supply_type": "web"
   }
   

2. POST fichier au format JSON. Veillez à inclure votre ID de membre dans la chaîne de requête.

   curl -X POST -d @bid_request 'https://ib.adnxs.com/asi?member_id=123' 
   

Envoi d’une demande d’offre pour un créatif vidéo VAST (NON ENCORE PRIS EN CHARGE)

Lorsque vous demandez un créatif vidéo VAST :

• Doit ad_format être défini sur « vast ».
• Doit width être défini sur 1.
• Doit height être défini sur 1.
• La demande doit correspondre à un emplacement dans le système Xandr qui autorise les créatifs du type de média « Vidéo » ou toute combinaison des sous-types de médias « VAST de 15 secondes », « VASTE de 30 secondes » ou « Autre VASTE ». Si la demande est mappée à un placement non vidéo, AppNexus répond avec une erreur (le format de la publicité de la demande ne correspond pas au format de placement). Pour plus d’informations sur la façon dont nous recherchons le placement à utiliser, consultez Mappage de placement ci-dessus.
• Ne passez pas ou ext_blocked_technical_attributes pour définir les durées int_blocked_technical_attributes de vidéo VAST souhaitées. Au lieu de cela, comme mentionné ci-dessus, le placement Xandr doit définir la durée de la vidéo VAST autorisée.
• Si vous avez demandé à Xandr de configurer un modèle d’approvisionnement pour inclure des paramètres personnalisés dans le ad_tag champ de notre réponse d’offre, définissez template_id sur l’ID de ce modèle d’approvisionnement. Pour plus d’informations, consultez Modèles d’approvisionnement dans la documentation réponse aux enchères.

1. Create un fichier au format JSON conformément aux exigences ci-dessus. Cet exemple suppose qu’il existe un emplacement spécifique dans le système Xandr défini pour autoriser les créations vidéo VAST. L’ID de ce placement est passé dans le an_placement_id champ .

   $ cat bid_request
   {
       "an_user_id": 1089773736613054100,
       "ext_auction_id": "395dj2j2j2dd",
       "ad_format":"vast",
       "width": 1,
       "height": 1.
       "an_placement_id": 204,
       "tmpl_id": 4,
       "ip_address": "38.108.249.106",
       "page_url": "ibdo.com",
       "position": "unknown",
       "language": 0,
       "user_agent": "Mozilla/5.0 (X11; U; Linux x86_64; en-US; rv:1.9.1.8) Gecko/20100214 Ubuntu/9.10 (karmic) Firefox/3.5.8",
       "age": 25,
       "gender": "female"
   }
   

2. POST fichier au format JSON. Veillez à inclure votre ID de membre dans la chaîne de requête.

   curl -X POST -d @bid_request 'https://ib.adnxs.com/asi?member_id=123'