Partager via

Partenaires d’approvisionnement - Réponse à l’offre

Avertissement

Nous avons désactivé le protocole Supply Integration (ASI) (anciennement AppNexus Supply Integration) pour les intégrations d’approvisionnement côté serveur à compter du 1er octobre 2017. Nous vous encourageons vivement à migrer votre approvisionnement vers le protocole OpenRTB. Tous les éléments de cette section sont du contenu hérité.

Après avoir envoyé une demande d’enchère, Xandr renvoie une réponse d’enchère au format JSON. Cette page explique les champs JSON possibles et leurs valeurs. Les exemples en bas de la page affichent les champs retournés dans les cas suivants :

  • Xandr soumet une offre
  • Xandr ne soumet pas d’offre - Aucune offre disponible
  • Xandr n’envoie pas d’enchère - Erreur
  • Xandr envoie une vidéo vaste créative (PAS ENCORE PRIS EN CHARGE)

Conseil

Si une offre Xandr gagne votre enchère, vous devez insérer le prix de l’enchère gagnante dans la %%pricepaid%% macro du avant de ad_tag placer l’étiquette sur la page web.

Champs JSON

Champ Type Description Exemple
external_auction_id string ID de la vente aux enchères du partenaire fournisseur, tel qu’il a été envoyé dans la demande d’offre. "A4s24536"
appnexus_auction_id int Xandr tient sa propre vente aux enchères pour sélectionner l’offre à soumettre pour votre enchère. Il s’agit de l’ID de l’événement de vente aux enchères Xandr. 4396943919143109134
bid decimal Valeur CPM de l’enchère Xandr. 0.206367
creative_id int ID du créatif qui est servi si Xandr gagne votre enchère. 345634
landing_page_url string URL de la page d’accueil du créatif. "www.landingpage.com"
brand_id int L’ID Xandr pour la marque du créatif. Pour mapper les ID de marque aux noms, utilisez le service de marque. 12
buyer_member_id int ID du membre propriétaire du créatif. 3453
no_bid valeur booléenne Si la valeur est true, Xandr n’a pas d’enchère pour votre enchère. false
request_error valeur booléenne Si la valeur est true, une erreur a empêché Xandr d’envoyer une enchère. false
request_error_id int ID de l’erreur. Ce champ est retourné uniquement lorsque request_error a la valeur true. Pour connaître tous les ID d’erreur possibles et leur signification, consultez la section Erreurs ci-dessous. 3
ad_tag string Balise publicitaire qui est placée sur la page web si Xandr gagne votre enchère.

Note: Si vous souhaitez suivre les clics, Xandr peut ajouter une macro pour votre URL de clic : &pubclick=%%pub_click_url%%.

Pour en savoir plus sur cette fonctionnalité, contactez votre équipe d’implémentation.		 Consultez les exemples ci-dessous.

Fournir des modèles

Pour les créations vidéo VAST, si vous avez besoin de paramètres personnalisés qui ne sont normalement pas inclus dans la ad_tag réponse de la soumission, vous pouvez demander à Xandr de créer un modèle d’approvisionnement pour vous. Voici le principe de fonctionnement :

  1. Vous communiquez directement avec votre représentant Xandr sur les paramètres personnalisés que vous souhaitez retourner pour les créations vidéo VAST.
  2. Si Xandr accepte votre demande, Xandr génère un modèle d’approvisionnement pour vous et vous envoie l’ID.
  3. Dans vos demandes d’enchères pour les créations vidéo VAST, vous incluez l’ID de modèle d’approvisionnement dans le template_id champ.
  4. Dans les réponses d’enchère, le modèle d’approvisionnement ajoute vos paramètres personnalisés à la <Extensions> section du ad_tag.

Exemple

Supposons que vous souhaitiez que Xandr inclue les informations supplémentaires suivantes pour les créations vidéo VAST :

  • Stratégie d’appel d’offres (CPM, CPC, etc.)
  • Devise
  • Source de l’offre

Le modèle d’approvisionnement que Xandr créerait pour vous ajouterait ces informations à la <Extensions> section du ad_tag:

"ad_tag":"<?xml version="1.0" encoding="UTF-8" standalone="no"?><VAST version="2.0" xmlns:xsi=
                "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd">
                <Ad id="560469"><Wrapper><AdSystem version="1.0">adnxs</AdSystem><VASTAdTagURI><![CDA
                TA[http://ib.adnxs.com/ab?enc=AAAAAAAA8D8AAAAAAADwPwAAAAAAAPA_AAAAAAAA8D8AAAAAAADwPwkWl1e
                GIxl9XgZfiHCnHw8p021QAAAAADd8CQBVBAAAVQQAAA0AAABVjQgAMmgBAAAAAQBVU0QAVVNEAAEAAQASEwAAVgAB
                BAMCAQUAAIIAaRIvXgAAAAA.&cnd=%21chngsgiT1QUQ1ZoiGAAgstAFMAA4kqYEQARI1QhQt_glWABgLmgAcAB4A
                IABAIgBAJABAZgBAaABAagBALABALkBAAAAAA AA8D_BAQA AAAAAAPA_yQEzMzMzMzMDQNkBAAAAAAAA8D_gAQA.
                &udj=uf%28%27a%27%2C+51512%2C+1349374761%29%3Buf%28%27r%27%2C+560469%2C+1349374761%29%3B&
                ccd=%212gSgJwiT1QUQ1ZoiGLLQBSAE&vpid=171&referrer=espn.com&dlo=1&pp=%%pricepaid%%]>
                </VASTAdTagURI><Impression></Impression><Creatives><Creative AdID="560469"><Linear>
                </Linear></Creative></Creatives><Extensions><Extension type="Partner Name">
                <Price model="CPM" currency="USD" source="AppNexus">1</Price></Extension>
                </Extensions></Wrapper></>"

Remarque

Pour obtenir la réponse d’offre complète pour une vidéo vaste créative, consultez les exemples ci-dessous.

Erreurs

Lorsqu’une erreur empêche Xandr d’envoyer une enchère, le request_error_id dans la réponse vous aide à diagnostiquer le problème.

request_error_id Signification
1 La syntaxe de la demande d’enchère était incorrecte.
2 Impossible d’analyser l’ID de membre dans la requête.
3 La demande n’a pas été mappé à un ID d’utilisateur Xandr.
4 La demande d’offre n’incluait external_auction_idpas .
5 La demande n’a pas été mappé à un placement.
6 La vente aux enchères de Xandr a échoué.
7 Le demandé ad_format ne correspondait pas au format de placement.
8 L’inventaire (par exemple page_url) ou l’utilisateur (par exemple, ip_address) passé est bloqué par Xandr.**
9 Le ad_format paramètre (obligatoire) n’a pas été transmis dans la requête.

Remarque

**L’ID d’erreur 8 se déclenche également si le domaine passé est exclu par le profil de ciblage global du membre acheteur.

Exemples

Xandr soumet une offre

{
    "external_auction_id": "A4s24536",
    "appnexus_auction_id": 4396943919143109000,
    "request_error": false,
    "no_bid": false,
    "bid": 0.206367,
    "creative_id": 345634,
    "landing_page_url": "http://www.landingpage.com",
    "brand_id": 12,
    "buyer_member_id": 328,
    "ad_tag": "<scriptsrc='http: //ib.adnxs.com/ab?enc=nkFD_wQXyz-iXL8FfvnHPwAAAAAAAOA_oly_BX75xz-eQUP_BBfLP0p8RFYC0OIKHKmTLdGzBl2rOWpOAAAAALGQCADLAQAAbAEAAAIAAACyGQkAmwkBAAEAAABVU0QAVVNEANgCWgC0AoMDvw4BAgUCAQQAAAAAciHhvwAAAAA.&tt_code=13394&udj=uf%28%27a%27%2C+1008%2C+1315584427%29%3Buf%28%27c%27%2C+117682%2C+1315584427%29%3Buf%28%27g%27%2C+51717%2C+1315584427%29%3Buf%28%27r%27%2C+596402%2C+1315584427%29%3Bppv%2815221%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815223%2C+%27784417993571728458%27%2C+1315584427%2C+1315670827%2C+117682%2C+67995%29%3Bppv%2815225%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815227%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815229%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815231%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3B&cnd=!VyRDEwiylwcQsrMkGAAgm5MEMAA4tAVAAEjsAlAAWABgrARoAHAAeACAAQCIAQCQAQGYAQGgAQGoAQOwAQC5AUw3iUFg5cA_wQFwscHFBhfLP8kBmpmZmZmZ8T_ZAYV80LNZ9eM_4AHkKA..&ccd=!XASOJAiylwcQsrMkGJuTBCAA&referrer=http: //www.nydailynews.com&media_subtypes=1&pp=%%pricepaid%%'></script>"
}

Xandr ne soumet pas d’offre - Aucune offre disponible

{
   "external_auction_id":"A4s24536",
   "no_bid":true,
   "request_error":false
}

Xandr n’envoie pas d’enchère - Erreur

{
   "external_auction_id":"A4s24536",
   "no_bid":true,
   "request_error":true,
   "request_error_id":2
}

Xandr envoie une vidéo vaste créative (PAS ENCORE PRIS EN CHARGE)

Quand Xandr soumet une vidéo VAST créatif :

  • Le créatif est passé en tant que FICHIER XML VAST placé dans une séquence d’échappement dans le ad_tag champ.
  • Si l’offre remporte votre enchère, vous devez annuler l’échappement du contenu avant de le placer sur la page.
  • Si l’offre remporte votre enchère, vous devez insérer le prix de l’enchère gagnante (en CPM) dans la %%pricepaid%% macro dans le ad_tag.
  • Si vous avez demandé à Xandr de générer un modèle d’approvisionnement qui transmet des paramètres personnalisés dans des enchères créatives VAST, ces paramètres personnalisés apparaissent dans la <Extensions> balise du xml dans .ad_tag Dans l’exemple ci-dessous, le modèle d’offre a ajouté des informations supplémentaires sur le prix de l’offre. Pour plus d’informations sur les modèles d’approvisionnement, consultez Fournir des modèles ci-dessus.

Conseil

Suivant la pratique standard de l’industrie, Xandr n’enregistre pas une impression VAST sur la victoire. Au lieu de cela, l’impression n’est enregistrée qu’une fois que la vidéo démarre (l’utilisateur clique sur lecture, etc.).

{
   "external_auction_id":"A4s24536",
   "appnexus_auction_id":4396943919143109134,
   "request_error":false,
   "no_bid":false,
   "bid":2.000000,
   "creative_id":345634,
   "landing_page_url":"http://www.landingpage.com",
   "brand_id":12,
   "buyer_member_id":328,
   "ad_tag":"<?xml version="1.0" encoding="UTF-8" standalone="no"?><VAST version="2.0" xmlns:xsi=
                "http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd">
                <Ad id="560469"><Wrapper><AdSystem version="1.0">adnxs</AdSystem><VASTAdTagURI><![CDA
                TA[http://ib.adnxs.com/ab?enc=AAAAAAAA8D8AAAAAAADwPwAAAAAAAPA_AAAAAAAA8D8AAAAAAADwPwkWl1e
                GIxl9XgZfiHCnHw8p021QAAAAADd8CQBVBAAAVQQAAA0AAABVjQgAMmgBAAAAAQBVU0QAVVNEAAEAAQASEwAAVgAB
                BAMCAQUAAIIAaRIvXgAAAAA.&cnd=%21chngsgiT1QUQ1ZoiGAAgstAFMAA4kqYEQARI1QhQt_glWABgLmgAcAB4A
                IABAIgBAJABAZgBAaABAagBALABALkBAAAAAA AA8D_BAQA AAAAAAPA_yQEzMzMzMzMDQNkBAAAAAAAA8D_gAQA.
                &udj=uf%28%27a%27%2C+51512%2C+1349374761%29%3Buf%28%27r%27%2C+560469%2C+1349374761%29%3B&
                ccd=%212gSgJwiT1QUQ1ZoiGLLQBSAE&vpid=171&referrer=espn.com&dlo=1&pp=%%pricepaid%%]>
                </VASTAdTagURI><Impression></Impression><Creatives><Creative AdID="560469"><Linear>
                </Linear></Creative></Creatives><Extensions><Extension type="Partner Name">
                <Price model="CPM" currency="USD" source="AppNexus">1</Price></Extension>
                </Extensions></Wrapper></>"
}

Remarque

Les champs de transaction ci-dessous sont visibles uniquement par les employés de Xandr.

Xandr soumet une offre pour une transaction

{
    "external_auction_id": "A4s24536",
    "appnexus_auction_id": 4396943919143109000,
    "request_error": false,
    "no_bid": false,
    "bid": 0.206367,
    "creative_id": 345634,
    "landing_page_url": "http://www.landingpage.com",
    "brand_id": 12,
    "buyer_member_id": 328,
    "deal_code": "This is a big deal",
    "deal_id": 123456,
    "ad_tag": "<scriptsrc='http: //ib.adnxs.com/ab?enc=nkFD_wQXyz-iXL8FfvnHPwAAAAAAAOA_oly_BX75xz-eQUP_BBfLP0p8RFYC0OIKHKmTLdGzBl2rOWpOAAAAALGQCADLAQAAbAEAAAIAAACyGQkAmwkBAAEAAABVU0QAVVNEANgCWgC0AoMDvw4BAgUCAQQAAAAAciHhvwAAAAA.&tt_code=13394&udj=uf%28%27a%27%2C+1008%2C+1315584427%29%3Buf%28%27c%27%2C+117682%2C+1315584427%29%3Buf%28%27g%27%2C+51717%2C+1315584427%29%3Buf%28%27r%27%2C+596402%2C+1315584427%29%3Bppv%2815221%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815223%2C+%27784417993571728458%27%2C+1315584427%2C+1315670827%2C+117682%2C+67995%29%3Bppv%2815225%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815227%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815229%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3Bppv%2815231%2C+%27784417993571728458%27%2C+1315584427%2C+1318176427%2C+117682%2C+67995%29%3B&cnd=!VyRDEwiylwcQsrMkGAAgm5MEMAA4tAVAAEjsAlAAWABgrARoAHAAeACAAQCIAQCQAQGYAQGgAQGoAQOwAQC5AUw3iUFg5cA_wQFwscHFBhfLP8kBmpmZmZmZ8T_ZAYV80LNZ9eM_4AHkKA..&ccd=!XASOJAiylwcQsrMkGJuTBCAA&referrer=http: //www.nydailynews.com&media_subtypes=1&pp=%%pricepaid%%'></script>"
}
  • Last updated on