Partager via

Soumissionnaires - Demande de soumission

Importante

  • Non pris en charge : le protocole d’enchères AppNexus n’est plus pris en charge ; cette documentation est destinée uniquement à des fins héritées. Nous déprécierons ce protocole le 1er décembre 2018.
  • Si vous êtes un nouveau soumissionnaire qui intègre AppNexus, consultez le protocole d’enchères OpenRTB 2.4.

Une demande de soumission est envoyée aux soumissionnaires chaque fois qu’un appel publicitaire atteint le bus Impression. Il contient toutes les informations nécessaires pour qu’un soumissionnaire produise un prix de soumission et un créatif à servir.

La demande d’offre inclut des informations des vendeurs qui spécifient quels annonceurs et créatifs sont autorisés à gagner une enchère et à s’exécuter sur une page. Ces informations sont stockées dans un profil d’approbation publicitaire, que les soumissionnaires peuvent utiliser pour s’assurer que leurs offres sont acceptées.

Limitation des demandes d’enchères

Vous ne souhaiterez peut-être pas recevoir toutes les demandes d’enchères qui transitent par la plateforme AppNexus. Vous pouvez limiter les demandes d’un certain pourcentage, ou filtrer les requêtes en fonction de critères prédéfinis tels que la géographie.

Demandes d’enchères à plusieurs étiquettes

Nous envoyons parfois des « demandes d’enchères à plusieurs étiquettes » où une demande d’offre peut inclure plusieurs ID d’étiquette avec des tailles potentiellement différentes, des normes de qualité publicitaire, des prix de réserve, etc. Pour l’instant, ces demandes doivent être traitées avec des réponses individuelles pour chaque balise comme s’il s’agissait de demandes indépendantes. Toutefois, dans un avenir proche, ces demandes multi-étiquettes seront la base des prises de contrôle, des rachats de page complète et de nombreuses autres fonctionnalités d’inventaire premium.

Chaque étiquette individuelle dans une demande à plusieurs étiquettes a un ID d’enchère unique.

Implémentation

En-têtes de demande

Champ Portée Type Description
Connection tout string Toujours défini sur « keep-alive » pour garantir des connexions TCP persistantes.
Content-Length tout int Longueur du corps de la requête HTTP (qui inclut tous les champs décrits ci-dessous).
Host tout string Adresse IP à laquelle la demande d’offre a été envoyée.
X-Debug Certains int Si la valeur est 1, l’appel publicitaire incluait l’indicateur debug=1 et aucune annonce ne sera servie.
X-DMA Certains int Code pour la zone de marché désignée de l’utilisateur en fonction de l’adresse IP, si elle peut être déterminée.
X-Exclusive Certains int Indique si la vente aux enchères est exclusive par défaut. Une vente aux enchères exclusive est une vente aux enchères dans laquelle seul le propriétaire du placement peut servir une annonce. La valeur par défaut exclusive peut être remplacée par le propriétaire pendant la phase propriétaire de la vente aux enchères.
X-Segment Certains string Liste de segments séparés par des virgules dans lequel se trouve l’utilisateur. Les segments disponibles incluent ceux appartenant à vos membres et ceux appartenant à des fournisseurs de données tiers (auxquels AppNexus a accordé l’accès à votre soumissionnaire).
X-Venue tout int Cet en-tête n’est pas utilisé actuellement.

Informations sur les enchères

Données générales

Champ Portée Type Description
member_ad_profile_id Certains int ID de profil d’approbation publicitaire au niveau du membre qui s’applique à l’impression.
timestamp tout Timestamp Heure d’envoi de la demande.
bidder_timeout_ms tout int Nombre de millisecondes dont dispose le soumissionnaire entre le moment où la demande est envoyée par l’Imp Bus et le moment où la réponse est reçue par imp Bus avant expiration. Ce nombre varie en fonction du fournisseur partenaire.
bid_info tout objet Détails sur l’utilisateur et la demande d’enchère en général. Pour plus d’informations, consultez Bid_Info ci-dessous.
members tout tableau d’objets Tableau de membres éligibles pour soumissionner sur cet appel. Un membre est une entité qui a une relation d’achat ou de vente financière avec AppNexus et qui est associée à un soumissionnaire. Certains soumissionnaires peuvent avoir plusieurs membres ; si vous créez un soumissionnaire pour votre usage exclusif, vous serez le seul membre. L’objet membre a l’ID du membre. Pour plus d’informations, consultez Membres ci-dessous.

Remarque : Il ne s’agit pas d’un tableau de nombres, mais d’un tableau d’objets. La syntaxe exacte est indiquée dans l’exemple ci-dessous.
tags tout tableau d’objets Tableau des balises mises aux enchères dans cet appel. Une vente aux enchères aura au moins un, mais peut avoir plusieurs étiquettes. Pour plus d’informations, consultez Balises ci-dessous.

Données spécifiques au propriétaire

Champ Portée Type Description
allow_exclusive Certains Valeur booléenne Si le membre soumissionnaire est propriétaire de l’inventaire (c’est-à-dire member_id d’étiquette = ID de membre du soumissionnaire), le membre peut servir dans celui-ci sans permettre à d’autres soumissionnaires de participer.

Déboguer des données

Champ Portée Type Description
debug_requested Certains Valeur booléenne Si la valeur est true, l’appel publicitaire incluait l’indicateur debug=1 et aucune annonce ne sera servie. Cela ne sera inclus dans la demande d’offre que si le dongle correct est utilisé.
debug_member_id Certains int Ce champ contient la valeur du paramètre « debug_member », si le paramètre est passé dans la chaîne de requête et que le paramètre « dongle » passé dans la chaîne de requête correspond au dongle du membre (défini sur le service membre). Votre soumissionnaire peut utiliser la debug_member_id pour produire une sortie de débogage limitée à un membre particulier.
test Certains Valeur booléenne Si la valeur est true, la balise d’annonce s’exécute en tant que test et aucune annonce n’est servie. S’il n’est pas présent, le test a la valeur false.

Autres données

Champ Portée Type Description
excluded_adservers Certains tableau d’entiers ID des serveurs d’annonces qui ne sont pas éligibles pour l’impression, tels que définis par les paramètres de qualité des annonces du vendeur. Vous pouvez utiliser le service Ad Server pour rechercher des serveurs publicitaires.
excluded_brands Certains tableau d’entiers ID des marques qui ne sont pas éligibles pour l’impression, tels que définis par les paramètres de qualité de l’annonce du vendeur. Vous pouvez utiliser le service de marque pour rechercher des marques.
excluded_languages Certains tableau d’entiers ID des langues qui ne sont pas éligibles pour l’impression, telles que définies par les paramètres de qualité de l’annonce du vendeur. Vous pouvez utiliser le service de langage pour rechercher des langues.
excluded_categories Certains tableau d’entiers ID des catégories qui ne sont pas éligibles pour l’impression, telles que définies par les paramètres de qualité de l’annonce du vendeur. Vous pouvez utiliser le service de catégorie pour rechercher des catégories.
excluded_creatives Certains tableau d’entiers ID des créatifs qui ne sont pas éligibles pour l’impression, tels que définis par les paramètres de qualité de l’annonce du vendeur. Vous pouvez utiliser creative service pour rechercher des créations.
excluded_technical_attributes Certains tableau d’entiers ID des attributs techniques qui ne sont pas éligibles pour l’impression, tels que définis par les paramètres de qualité des annonces du vendeur. Vous pouvez utiliser le service d’attributs techniques pour rechercher des attributs techniques.
single_phase Certains Valeur booléenne Ce champ n’est actuellement pas utilisé pour les soumissionnaires.

Members

Champ Portée Type Description
id tout int ID du membre.

Tags

Informations associées à la balise d’annonce.

Données d’enchères

Champ Portée Type Description
auction_id_64 tout int ID de la vente aux enchères. Cela est utile pour le rapprochement et les différences. Nous vous recommandons donc de l’ajouter à vos journaux. Il n’est pas garanti que ce soit unique.

Données de hiérarchie d’inventaire

Champ Portée Type Description
id Certains int ID du TinyTag. Une balise est un sous-ensemble d’inventaire au sein d’un site. Les soumissionnaires ne peuvent pas rechercher la balise à laquelle correspond l’ID, mais ces ID peuvent être utilisés comme blocs d’inventaire anonymes et optimisés.
site_id Certains int ID du site. Les sites sont le deuxième plus grand regroupement d’inventaire pour les membres qui vendent leur inventaire via AppNexus. Un site est un sous-ensemble d’inventaire pour un éditeur. Les soumissionnaires ne peuvent pas rechercher le site auquel correspond l’ID, mais ces ID peuvent être utilisés comme blocs d’inventaire anonymes et optimisés.

Données générales

Champ Portée Type Description
size tout string Taille (widthxheight, par exemple 300x160) pour cette impression.
sizes tout tableau de chaînes Tailles créatives autorisées pour cette impression, au format « widthxheight ».
position tout enum(« below »,"above »,"unknown ») Position de l’annonce sur la page au-dessus ou en dessous du pli ; extrait de la balise, si disponible.
tag_format Certains enum(« iframe », « js », « wp7 », « vast », « json », « xml ») Pour les balises « iframe », le bus d’impression retourne du code HTML pour afficher la création gagnante sur la page de l’éditeur (si nécessaire, le code HTML contient une balise IFrame.) Pour les balises « js », le bus d’impression retourne javascript pour être exécuté sur la page de l’éditeur. (Le javascript retourné contient généralement des commandes document.write pour générer le code HTML permettant d’afficher le contenu créatif.) Cette distinction s’applique uniquement aux soumissionnaires dans le cas où un créateur ne s’affichera pas correctement dans un ou plusieurs formats d’étiquette.
allowed_media_types Certains tableau d’entiers Types de médias valides. Utilisez le service de type de média pour obtenir la liste des ID.
allowed_media_subtypes Certains tableau d’entiers ID de sous-type de média valides. Utilisez le service de sous-type multimédia pour obtenir la liste des ID.
media_subtypes Certains tableau de chaînes Sous-types de média valides pour un créatif, au format chaîne.
inventory_audits Certains tableau Données d’auto-classification du vendeur sur le contenu du site.
venue_id Certains int Ce champ n’est actuellement pas utilisé pour les soumissionnaires.
ad_profile_id Certains int ID de profil d’approbation publicitaire au niveau de l’étiquette qui s’applique à l’impression de la balise particulière.
predicted_view_rate tout double Probabilité que l’impression soit visible par l’utilisateur, en fonction des données historiques.

Données de tarification

Champ Portée Type Description
reserve_price Certains float Lorsqu’il est fourni, il s’agit de l’enchère minimale nécessaire pour gagner la vente aux enchères. Si le membre enchère est propriétaire de l’inventaire (allow_exclusive = true), cela est ignoré.
estimated_clear_price Certains double L’ECP est le prix estimé nécessaire pour gagner l’inventaire. Le PÉC est supérieur à 95 % de toutes les enchères gagnantes pour cette étiquette envoyées par le biais d’AppNexus.

Remarque : Un pourcentage significatif des enchères gagnantes pour une étiquette ne peut pas être soumis via AppNexus.

Pour plus d’informations, consultez Mécanismes de réduction des prix.
estimated_average_price Certains double Le PAE est similaire à celui du PROGRAMME, sauf que le PAE est supérieur à 70 % de toutes les soumissions gagnantes pour cette étiquette envoyées par le biais d’AppNexus.
estimated_price_verified Certains Valeur booléenne Ce champ indique si eap et ECP ont été vérifiés par les données observées par AppNexus.

Données spécifiques au propriétaire

Champ Portée Type Description
tag_data possédé uniquement chaîne Si elles sont disponibles, les autres informations associées à cet ID TinyTag. Le propriétaire du TinyTag peut ajouter ces informations au TinyTag avant une vente aux enchères.
exclusive_default possédé uniquement Valeur booléenne Indique si la vente aux enchères est exclusive par défaut. Une vente aux enchères exclusive est une vente aux enchères dans laquelle seul le propriétaire du placement peut servir une annonce. La valeur par défaut exclusive peut être remplacée par le propriétaire pendant la phase propriétaire de la vente aux enchères.
default_creative_id possédé uniquement int ID créatif par défaut pour ce TinyTag.

Champs spécifiques aux appareils mobiles

Champ Portée Type Description
supply_type Certains Toujours envoyé pour « mobile_app » (pas envoyé pour « web ») Distingue si cet inventaire est web, navigateur mobile ou application mobile. Pour déterminer si une impression web est visible sur un appareil mobile, utilisez le système d’exploitation dans la demande d’enchère.
creative_formats Certains Un ou plusieurs de « text », « image », « html-url », « js-url », « flash », « js-raw », « html-raw », « html-iframe », « url-vast », « xml-url », « file-url », unknown » Liste des formats créatifs AppNexus qui peuvent être utilisés pour enchérir l’impression. D’autres formats peuvent être ajoutés à cette liste à mesure qu’ils deviennent pris en charge.
creative_actions Certains Une ou plusieurs des options « click-to-web », « click-to-call » Liste des actions de clic autorisées des créatifs qui peuvent être utilisées pour enchérir sur cette impression. Aujourd’hui, l’appel en un clic n’est pas disponible, mais le sera bientôt. D’autres actions peuvent être ajoutées à cette liste à mesure qu’elles deviennent prises en charge.
smaller_sizes_allowed Certains Valeur booléenne True si les créatifs d’une taille plus petite et les créations de texte peuvent également être utilisés pour l’impression.

Données de transaction

Champ Portée Type Description
deals Certains tableau d’objets Tableau de transactions qui s’appliquent à l’impression. Pour plus d’informations, consultez Offres .

Offres

Chaque objet du deals tableau contient les champs suivants.

Champ Type Description
ad_quality_override int Spécifie la façon dont la transaction gère les créations :
- 1: les créatifs utilisent des paramètres de qualité publicitaire existants. (Valeur par défaut)
- 2: les créatifs dans les status d’audit « en attente » serviront. Une fois ces créations auditées, les paramètres de qualité des publicités existants sont utilisés.
- 3: aucune restriction de profil publicitaire n’est appliquée à cette offre. (Confiance maximale)
allowed_media_subtypes tableau d’entiers. Spécifie les ID des sous-types de média autorisés sur cette transaction. Utilisez le service De sous-type multimédia pour afficher une liste de sous-types multimédias. S’il n’existe aucun sous-type de média unique pour cette transaction par rapport à l’objet de demande d’enchère main, ce champ est un tableau vide. Cela ne signifie PAS que la transaction n’autorise aucun sous-type de média, au lieu de cela, cela signifie simplement que les sous-types de média sur l’objet d’offre main doivent être utilisés lors de la soumission sur cette transaction.
allowed_media_types tableau d’entiers. Spécifie les ID des types de médias autorisés sur cette transaction. Utilisez le service de type de média pour afficher la liste des types de médias. S’il n’existe aucun type de média unique pour cette transaction par rapport à l’objet de demande d’enchère main, ce champ est un tableau vide. Cela ne signifie PAS que la transaction n’autorise aucun type de média, au lieu de cela, cela signifie simplement que les types de média sur l’objet d’offre main doivent être utilisés lors de la soumission sur cette transaction.
floor_cpm double Prix que le vendeur a fixé pour la transaction. Utilisez ce montant plus les frais applicables comme enchère minimale afin d’être en concurrence pour cet inventaire. Notez que la soumission de ce montant plus les frais applicables vous permettra de vous assurer que vous êtes éligible à la transaction, mais ne garantira pas que votre offre gagne.
Ce montant sera toujours en dollars américains. Les prix demandés entrés dans une autre devise seront convertis en dollars.
id int ID de la transaction qui s’applique à l’impression. Vous pouvez utiliser le service d’accès acheteur de transaction pour afficher les détails de la transaction, notamment le nom de la transaction, la description, la date de début et de fin, ainsi que l’inventaire associé.
member_id int ID du membre acheteur pour lequel la transaction a été créée.
sizes tableau de chaînes. Tailles créatives autorisées pour cette offre, au format « widthxheight ». S’il n’existe aucune taille unique pour cette transaction par rapport à l’objet de demande d’offre main, ce champ est un tableau vide. Cela ne signifie PAS que la transaction n’autorise aucune taille, mais simplement que les tailles de l’objet d’offre main doivent être utilisées lors de l’enchère sur cette transaction.

Bid_Info

Informations sur l’utilisateur et la demande d’enchère globale.

Utilisateur

Champ Portée Type Description
user_id_64 tout int ID 64 bits unique de l’utilisateur. Il en sera de même pour toutes les demandes de cet utilisateur jusqu’à ce que les cookies soient effacés.

Remarque : cette valeur est renseignée uniquement lorsque le champ no_cookies est false.

Ce champ est 0 lorsque AppNexus n’a pas de correspondance pour cet utilisateur ou que le navigateur de l’utilisateur n’accepte pas les cookies. Il sera -1 destiné aux utilisateurs opt-out.
user_agent Certains string En-tête « User-Agent » du navigateur. (En d’autres termes, le type de navigateur.)
operating_system Certains int ID du système d’exploitation de l’utilisateur. Vous pouvez utiliser le service de système d’exploitation pour mapper des ID de système d’exploitation à des noms.
browser Certains int ID du navigateur de l’utilisateur. Vous pouvez utiliser le service de navigateur pour mapper les ID de navigateur aux noms.
accepted_languages Certains string En-tête « Accept-Language » du navigateur (en utilisant la langue ISO-639 et les codes pays ISO-3166).
language Certains int ID de la langue telle qu’analysée à partir de la chaîne accepted_languages. Vous pouvez utiliser le service de langage pour mapper les langues aux noms.
no_flash tout valeur booléenne Informe le soumissionnaire si nous avons détecté que flash n’est pas installé dans le navigateur de l’utilisateur.
no_cookies tout valeur booléenne Si le no_cookies champ est défini sur false
- AppNexus est en mesure de suivre l’utilisateur via un ID utilisateur placé dans un cookie dans le navigateur de l’utilisateur.
- L’ID utilisateur sera contenu dans le user_id_64 champ de la demande d’enchère.

Si le no_cookies champ est défini sur true ET que le user_id_64 champ est défini sur 0
- AppNexus n’est pas en mesure de suivre l’utilisateur, car le navigateur de l’utilisateur n’accepte pas les cookies.
- Vous ne devez pas soumissionner pour une telle enchère pour le compte de campagnes qui nécessitent des données utilisateur (par exemple, le plafonnement de la fréquence, le plafonnement de la récence).

Si le no_cookies champ est défini sur true ET que le user_id_64 champ est différent de zéro
- AppNexus est en mesure de suivre l’utilisateur via des cookies, et le champ user_id_64 contient l’ID utilisateur.
- Toutefois, un problème s’est produit lors de la recherche d’informations utilisateur dans le magasin de données utilisateur côté serveur AppNexus.
- Par conséquent, la demande d’enchère n’inclut pas de données utilisateur, et AppNexus ne peut pas mettre à jour de manière fiable les données utilisateur en fonction des commandes envoyées dans la réponse d’enchère.
- Vous ne devez pas soumissionner pour une telle enchère pour le compte de campagnes qui nécessitent des données utilisateur (par exemple, le plafonnement de la fréquence, le plafonnement de la récence).
gender Certains enum « mâle » ou « femelle » - Ces données peuvent être fournies par l’éditeur au moment de la vente aux enchères.
age Certains int Ces données peuvent être fournies par l’éditeur au moment de la vente aux enchères.
segments tout tableau d’objets. Tableau des segments où se trouve l’utilisateur. Les segments disponibles incluent ceux appartenant à vos membres et ceux appartenant à des fournisseurs de données tiers (auxquels AppNexus a accordé l’accès à votre soumissionnaire). Décrit plus en détail ci-dessous.
session_freq tout int Nombre d’impressions qu’AppNexus a servi à cet utilisateur pendant la durée de la session de navigation. À ces fins, une session de navigation est définie comme la durée de vie du cookie AppNexus de l’utilisateur.
pub_session_freq tout int Nombre d’impressions qu’AppNexus a servi à cet utilisateur, sur cet éditeur, pendant la durée de la session de navigation. À ces fins, une session de navigation est définie comme la durée de vie du cookie AppNexus de l’utilisateur.

Données géographiques

Champ Portée Type Description
ip_address tout chaîne Adresse IP de l’utilisateur.
country Certains string Le pays de l’utilisateur en fonction de l’adresse IP, s’il peut être déterminé.
region Certains string Région (état/province) de l’utilisateur en fonction de l’adresse IP, si elle peut être déterminée.
city Certains string Ville de l’utilisateur en fonction de l’adresse IP.
postal_code_id Certains int ID du code postal de l’utilisateur, basé sur l’adresse IP.
dma Certains int Code pour la zone de marché désignée de l’utilisateur en fonction de l’adresse IP, si elle peut être déterminée.
time_zone Certains string Fuseau horaire de l’utilisateur en fonction de l’adresse IP, s’il peut être déterminé.
Champ Portée Type Description
userdata_json Certains Données utilisateur jointes au cookie de l’utilisateur stockées par le soumissionnaire qui reçoit la demande.
total_clicks Certains int Ce champ a été déconseillé.

Informations d’inventaire (page)

Champ Portée Type Description
selling_member_id tout int ID du membre qui vend l’inventaire. Consultez Platform Member Service pour trouver les noms de membres correspondants.
url Certains chaîne L’URL de référence (contient l’annonce / lance la demande d’annonce). Ceci est toujours fourni si disponible, sauf si l’éditeur a choisi de restreindre son utilisation. Un éditeur peut également choisir de configurer une URL de référent par défaut dans AppNexus qui sera transmise à la demande d’enchère dans le cas où le référent n’est pas disponible ou si l’éditeur a choisi de restreindre son utilisation. Pour plus d’informations, contactez votre représentant technique AppNexus.
domain Certains string Domaine de l’URL de référence.
inventory_audits Certains tableau AppNexus audite les données relatives au contenu du site. Les audits sur bid_info concernent toutes les étiquettes de la vente aux enchères. Ces informations proviennent souvent d’un audit au niveau du domaine. Décrit plus en détail ci-dessous.
within_iframe tout valeur booléenne Si la balise se trouve sur la page sans iframe englobant, il s’agit 'true'de . Notez que si AppNexus ne parvient pas à déterminer si la balise est encapsulée, il s’agit 'false'de .
publisher_id Certains int ID de l’éditeur. Les éditeurs sont utilisés comme les plus grands regroupements d’inventaire pour les membres qui vendent leur inventaire via AppNexus. Les soumissionnaires ne peuvent pas rechercher l’éditeur à lequel correspond l’ID, mais ces ID peuvent être utilisés en tant que blocs d’inventaire anonymes et optimisés.
is_secure Certains valeur booléenne Si la page est sécurisée, c’est vrai.

Remarque : toutes les connexions à l’inventaire sécurisé doivent être sécurisées. Cela inclut les pixels, les créatifs et les appels tiers. (c’est-à-dire pour un créatif : https://mysecure.content.com/ad/ABC.123.com/DEF.40;sz=300x250) \\)
certified_supply Certains valeur booléenne Déconseillé.

Champs spécifiques aux appareils mobiles

Champ Portée Type Description
app_id Certains chaîne ID d’application global pour les appareils Android et iOS (par exemple, pour l’application Angry Birds : « app_id » : « com.rovio.angrybirds » pour un appareil Android, « app_id » : « 343200656 » ou « com.clickgamer.AngryBirds » pour un appareil iOS).
loc Certains string Emplacement de l’utilisateur, fourni en termes de latitude et de longitude. Exprimé au format « snnn.ddd,snnn.ddd », par exemple +123.456 ou -456.123. Le sud et l’ouest sont représentés comme négatifs. Il peut y avoir un maximum de 5 décimales de précision.
carrier Certains int Identificateur de l’opérateur. Un mappage des ID aux noms et pays des opérateurs sera disponible à partir du service de l’opérateur en lecture seule. Un opérateur spécial « WIFI » existera pour les utilisateurs se connectant via Wi-Fi.
device_make Certains int ID de l’appareil sur lequel l’annonce sera affichée. Vous pouvez l’utiliser pour le fabricant de l’appareil sur lequel la publicité sera affichée. Pour plus d’informations, consultez service Device Make.
device_model Certains int ID du modèle d’appareil sur lequel l’annonce sera affichée. Pour plus d’informations, consultez Service de modèle d’appareil.
device_type Certains int ID du type d’appareil sur lequel la publicité sera affichée. Il est représenté par un entier et peut être recherché à l’aide du service de modèle d’appareil. Valeurs autorisées et leur signification :
- 1 = « pc »
- 2 = « phone »
- 3 = « tablet »
device_ids Certains objet Objet JSON contenant des informations sur les ID d’appareil associés à l’impression d’enchère. Pour plus d’informations, consultez ID d’appareil.

ID d’appareil

Champ Portée Type Description
aaid Certains string Identificateur de publicité Google pour les appareils Android récupéré à partir des services Google Play.
idfa Certains string Identificateur de publicité Apple pour les appareils iOS exécutant iOS 6+.
md5udid Certains string Hachage MD5 du ANDROID_ID. Cela ne doit être envoyé que pour les appareils Android. Il doit être encodé url.
openudid Certains string OpenUDID de l’appareil. Cela doit être envoyé uniquement pour iOS versions 5 et antérieures.
sha1mac Certains string ODIN. Cela doit être envoyé uniquement pour iOS versions 5 et antérieures. Il doit s’agir d’une URL encodée
sha1udid Certains string Hachage SHA1 de .ANDROID_ID Cela ne doit être envoyé que pour les appareils Android. Il doit être encodé url.

Segments

Tableau des segments où se trouve l’utilisateur. Les segments disponibles incluent ceux appartenant à vos membres et ceux appartenant à des fournisseurs de données tiers (auxquels AppNexus a accordé l’accès à votre soumissionnaire).

Champ Portée Type Description
code Certains chaîne Pour plus d’informations, consultez Pixel Services .
id tout int ID de segment.
last_seen_min tout int Nombre de minutes depuis que cet utilisateur a été étiqueté pour la dernière fois avec ce segment. Donnée en temps Posix (représentée en minutes). Multipliez cette valeur par 60 pour obtenir le nombre de secondes depuis l’époque où ce segment a été mis à jour.
member_id tout int ID du membre associé à ce segment.
other Certains int Valeur du segment, si le segment contient une valeur.

Audits d’inventaire

Champ Portée Type Description
auditor_member_id tout int ID du membre qui a fourni cet audit. Si ce champ est null, l’audit a été effectué par l’équipe des opérations de plateforme.
content_categories Certains tableau d’entiers. ID des catégories de contenu du site. Pour obtenir les noms explicites de catégories de contenu spécifiques ou pour obtenir la liste complète, consultez Service de catégorie de contenu.

Remarque : Vous pouvez voir des ID dans cette liste qui ne sont pas visibles par vous dans le service de catégorie de contenu.
intended_audience Certains enum général, enfant, young_adult ou mature. Indique le niveau de maturité cible des lecteurs de ce site web.
inventory_attributes Certains tableau d’entiers. ID des attributs sensibles du site que certains annonceurs peuvent choisir de ne pas exécuter. Pour obtenir les noms explicites d’attributs spécifiques ou pour obtenir la liste complète, consultez Service d’attributs d’inventaire. La présence d’un tableau vide dans ce champ indique que le site a été audité et n’a pas d’attributs sensibles.

Exemple

Demande d’étiquette unique

{
    "bid_request": {
        "timestamp": "2015-06-07 14:39:35",
        "bidder_timeout_ms": 100,
        "members": [
            {
                "id": 6
            },
            {
                "id": 12
            }
        ],
        "allow_exclusive": false,
        "debug_requested": false,
        "tags": [
            {
                "id": 13,
                "sizes": [
                    "728x90"
                ],
                "position": "unknown",
                "inventory_source_id": 476,
                "auction_id_64": 8984480746668973000,
                "tag_format": "iframe",
                "reserve_price": 1,
                "ad_profile_id": 382,
                "predicted_view_rate": 0.654321,
                "inventory_audits": [
                    {
                        "auditor_member_id": 3,
                        "inventory_attributes": [
                            1431,
                            1432,
                            1887
                        ],
                        "content_categories": [
                            171
                        ]
                    }
                ]
            }
        ],
        "bid_info": {
            "user_id_64": 2987961585469200400,
            "no_flash": false,
            "no_cookies": false,
            "ip_address": "96.246.152.18",
            "inventory_audits": [
                {
                    "auditor_member_id": null,
                    "intended_audience": "young_adult",
                    "inventory_attributes": [
                        2,
                        3,
                        6,
                        7
                    ],
                    "content_categories": [
                        39
                    ]
                }
            ],
            "user_agent": "Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; en-US;rv:1.9.0.3) Gecko/2008092414 Firefox/3.0.3",
            "accepted_languages": "en-US,en;q=0.8",
            "country": "US",
            "region": "NY",
            "city": "New York",
            "postal_code_id": "10014",
            "dma": 501,
            "time_zone": "America/New_York",
            "url": "https://www.foodandwine.com/recipes/",
            "domain": "foodandwine.com",
            "selling_member_id": 3,
            "inventory_source_id": 123,
            "inventory_class": "class_2",
            "within_iframe": false,
            "total_clicks": 0,
            "segments": [
                {
                    "id": 103,
                    "member_id": 6,
                    "code": "PotentialCarBuyer",
                    "last_seen_min": 21108407
                }
            ]
        }
    }
}

Demande de plusieurs étiquettes

{
    "bid_request": {
        "timestamp": "2015-09-17 20:32:00",
        "bidder_timeout_ms": 200,
        "members": [
            {
                "id": 1513
            }
        ],
        "member_ad_profile_id": 11138,
        "tags": [
            {
                "auction_id_64": 1704399148337927200,
                "size": "120x600",
                "sizes": [
                    "120x600"
                ],
                "smaller_sizes_allowed": false,
                "position": "unknown",
                "tag_format": "js",
                "site_id": 188164,
                "creative_formats_map": "1111111110",
                "creative_formats": [
                    "unknown",
                    "html-url",
                    "js-url",
                    "flash",
                    "image",
                    "js-raw",
                    "html-raw",
                    "html-iframe",
                    "url-vast"
                ],
                "ad_profile_id": 201859,
                "ad_profiles": [
                    201859
                ],
                "visibility_profile_id": 132,
                "venue_id": 12043,
                "predicted_view_rate": 0.675,
                "allowed_media_types": [
                    1
                ],
                "allowed_media_subtypes": [],
                "ecp": 1.43206,
                "eap": 0.5,
                "id": 624139,
                "inventory_audits": [
                    {
                        "auditor_member_id": null,
                        "intended_audience": "general",
                        "inventory_attributes": [],
                        "content_categories": []
                    }
                ]
            },
            {
                "auction_id_64": 3898100382999990000,
                "size": "5x6",
                "sizes": [
                    "5x6"
                ],
                "smaller_sizes_allowed": false,
                "position": "unknown",
                "tag_format": "js",
                "site_id": 188164,
                "creative_formats_map": "1111111110",
                "creative_formats": [
                    "unknown",
                    "html-url",
                    "js-url",
                    "flash",
                    "image",
                    "js-raw",
                    "html-raw",
                    "html-iframe",
                    "url-vast"
                ],
                "ad_profile_id": 201859,
                "ad_profiles": [
                    201859
                ],
                "visibility_profile_id": 132,
                "venue_id": 12043,
                "predicted_view_rate": 0.7131,
                "allowed_media_types": [
                    1
                ],
                "allowed_media_subtypes": [],
                "ecp": 2.07576,
                "eap": 0.5,
                "id": 624139,
                "inventory_audits": [
                    {
                        "auditor_member_id": null,
                        "intended_audience": "general",
                        "inventory_attributes": [
                            14
                        ],
                        "content_categories": []
                    }
                ]
            }
        ],
        "bid_info": {
            "user_id_64": 488125638053592500,
            "no_cookies": false,
            "payment_rule_id": 91411,
            "selling_member_id": 681,
            "no_flash": false,
            "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_4) AppleWebKit/537.1 (KHTML, like Gecko) Chrome/21.0.1180.89 Safari/537.1",
            "browser": 8,
            "operating_system": 11,
            "language": 1,
            "accepted_languages": "en-US,en;q=0.8",
            "session_freq": 75,
            "pub_session_freq": 15,
            "ip_address": "207.27.32.2",
            "country": "US",
            "region": "NY",
            "city": "New York",
            "dma": 501,
            "time_zone": "America/New_York",
            "inventory_class": "unaudited",
            "within_iframe": false,
            "publisher_id": 89400,
            "url": "https://www.foodandwine.com/recipes/",
            "domain": "www.foodandwine.com",
            "inventory_audits": [
                {
                    "auditor_member_id": null,
                    "inventory_attributes": [],
                    "content_categories": []
                }
            ],
            "userdata_json": "{}",
            "segments": []
        }
    }
    }

Demande mobile (mode débogage)

{
    "bid_request": {
        "timestamp": "2015-08-23 14:27:08",
        "bidder_timeout_ms": 2000,
        "members": [
            {
                "id": 307
            },
            {
                "id": 308
            }
        ],
        "single_phase": true,
        "member_ad_profile_id": 8610,
        "tags": [
            {
                "auction_id_64": 5638094169507807000,
                "size": "728x90",
                "sizes": [
                    "728x90"
                ],
                "smaller_sizes_allowed": true,
                "position": "unknown",
                "tag_format": "wp7",
                "site_id": 173564,
                "supply_type": "mobile_app",
                "creative_formats_map": "0000100001",
                "creative_formats": [
                    "image",
                    "text"
                ],
                "visibility_profile_id": 129,
                "venue_id": 663,
                "predicted_view_rate": 0.6891,
                "inventory_source_id": 926,
                "allowed_media_subtypes": [
                    1
                ],
                "estimated_clear_price": 1.24481,
                "estimated_average_price": 0.167,
                "estimated_price_verified": true,
                "id": 583751
            }
        ],
        "bid_info": {
            "user_id_64": 5725700387444723000,
            "no_cookies": false,
            "payment_rule_id": 84497,
            "selling_member_id": 618,
            "no_flash": true,
            "user_agent": "Mozilla%2f5.0+(compatible%3b+MSIE+9.0%3b+Windows+NT+6.1%3b+Trident%2f5.0)",
            "operating_system": 13,
            "language": 1,
            "accepted_languages": "en-us,en;q=0.5",
            "app_id": "2ac11907-8e3b-4b9b-b803-2ac834fa559a",
            "ip_address": "131.107.0.83",
            "country": "US",
            "postal_code_id": "10016",
            "loc": "38.7875232696533,-77.2614831924438",
            "inventory_class": "class_1",
            "within_iframe": false,
            "publisher_id": 81242,
            "gender": "male",
            "age": 27,
            "userdata_json": "{\"frequency\":[[\"r\",101,1,1,1,1303349386],[\"r\",102,1,1,1,1303349386]],\"last_imp_time\":1303349386,\"version\":4,\"pixel\":[],\"impserved\":45}",
            "segments": []
        }
    }
}

Demande extensible

{
    "bid_request": {
        "timestamp": "2015-04-20 20:00:14",
        "bidder_timeout_ms": 2000,
        "members": [
            {
                "id": 123
            }
        ],
        "test": true,
        "member_ad_profile_id": 11138,
        "tags": [
            {
                "auction_id_64": "7310650419817444682",
                "size": "300x250",
                "sizes": [
                    "300x250"
                ],
                "smaller_sizes_allowed": false,
                "position": "unknown",
                "tag_format": "js",
                "site_id": 188163,
                "creative_formats_map": "1111111111",
                "creative_formats": [
                    "unknown",
                    "html-url",
                    "js-url",
                    "flash",
                    "image",
                    "js-raw",
                    "html-raw",
                    "html-iframe",
                    "url-vast",
                    "text"
                ],
                "ad_profile_id": 201859,
                "predicted_view_rate": 0.675,
                "visibility_profile_id": 132,
                "venue_id": 12043,
                "allowed_media_types": [
                    6
                ],
                "allowed_media_subtypes": [
                    10,
                    11,
                    12,
                    13,
                    14,
                    15,
                    16,
                    17,
                    18,
                    19,
                    20,
                    24
                ],
                "estimated_clear_price": 1,
                "estimated_average_price": 0.5
            }
        ],
        "bid_info": {
            "user_id_64": 7994340253645703000,
            "no_cookies": false,
            "payment_rule_id": 91411,
            "selling_member_id": 681,
            "no_flash": false,
            "is_secure": false,
            "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_6_8) AppleWebKit/535.19 (KHTML, like Gecko) Chrome/18.0.1025.163 Safari/535.19",
            "browser": 8,
            "operating_system": 11,
            "language": 1,
            "accepted_languages": "en-US,en;q=0.8",
            "session_freq": 1,
            "pub_session_freq": 1,
            "ip_address": "68.67.167.12",
            "country": "US",
            "region": "NY",
            "city": "New York",
            "postal_code_id": "10003",
            "dma": 501,
            "time_zone": "America/New_York",
            "inventory_class": "unaudited",
            "within_iframe": false,
            "url": "https://www.foodandwine.com/recipes/",
            "domain": "foodandwine.com",
            "inventory_audits": [
                {
                    "auditor_member_id": null,
                    "inventory_attributes": []
                }
            ],
            "userdata_json": "{}",
            "segments": []
        }
    }
}

{
    "bid_request": {
        "timestamp": "2015-04-18 17:00:57",
        "bidder_timeout_ms": 2000,
        "members": [
            {
                "id": 1417
            }
        ],
        "test": true,
        "member_ad_profile_id": 555216,
        "excluded_technical_attributes": [
            2033
        ],
        "tags": [
            {
                "auction_id_64": 5555508250840351000,
                "size": "300x250",
                "sizes": [
                    "300x250"
                ],
                "smaller_sizes_allowed": false,
                "position": "unknown",
                "tag_format": "iframe",
                "site_id": 555526,
                "creative_formats_map": "111111111011",
                "creative_formats": [
                    "unknown",
                    "html-url",
                    "js-url",
                    "flash",
                    "image",
                    "js-raw",
                    "html-raw",
                    "html-iframe",
                    "url-vast",
                    "unknown",
                    "unknown"
                ],
                "ad_profile_id": 555180,
                "visibility_profile_id": 5553,
                "venue_id": 407258,
                "predicted_view_rate": 0.675,
                "pop_max_width": 300,
                "pop_max_height": 250,
                "pop_is_prepop": false,
                "allowed_media_types": [
                    1
                ],
                "media_subtypes": [
                    "banner"
                ],
                "estimated_clear_price": 0.913,
                "estimated_average_price": 0.456,
                "id": 5555354,
                "deals": [
                    {
                        "id": 555664,
                        "member_id": 5555,
                        "floor_cpm": 0.5,
                        "ad_quality_override": 2,
                        "allowed_media_types": [
                            1,
                            5
                        ],
                        "allowed_media_subtypes": [
                            10,
                            11,
                            23,
                            50
                        ],
                        "sizes": [
                            "300x250",
                            "300x600"
                        ]
                    }
                ]
            }
        ],
        "bid_info": {
            "user_id_64": 5555037017052493000,
            "no_cookies": false,
            "payment_rule_id": 555018,
            "selling_member_id": 55578,
            "no_flash": false,
            "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_8_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/34.0.1847.116 Safari/537.36",
            "browser": 8,
            "operating_system": 11,
            "operating_system_extended": 81,
            "operating_system_family": 4,
            "carrier": 1,
            "device_type": 1,
            "language": 1,
            "accepted_languages": "en-US",
            "session_freq": 1,
            "pub_session_freq": 1,
            "ip_address": "555.1.12.54",
            "country": "US",
            "inventory_class": "unaudited",
            "within_iframe": false,
            "device_ids": {
                "sha1udid": "d55555c2314f3789198685914c01425034b5d502",
                "md5udid": "caf55557c5b39fb4ad68dabc9808bda1"
            },
            "publisher_id": 555547,
            "userdata_json": "{}",
            "segments": [
                {
                    "id": 1,
                    "member_id": 0,
                    "code": "cookie_birthday",
                    "provider": "",
                    "last_seen_min": 23274134
                }
            ]
        }
    }
}
  • Last updated on