Partager via

Service de placement

Le service placement vous permet de créer des balises publicitaires de placement, de les modifier et de les afficher. Vous utiliserez des placements pour les éditeurs managés ou pour les achats de médias directs.

  • Les ID de placement et leurs informations associées sont stockés côté serveur avec Xandr et sont faciles à modifier.
  • Lorsque vous créez un placement, vous spécifiez les types de créations autorisées à y servir (voir supported_media_types et supported_media_subtypes ci-dessous).

Remarque

Le ciblage d’annonceurs, d’éléments de ligne ou de campagnes via ce service remplacera tout ciblage défini par le service de règle de paiement.

Format de balise

Une fois que vous avez l’ID de placement, vous mettez en forme la balise de placement comme suit et vous la passez à l’éditeur que vous représentez ou avec lequel vous avez un achat garanti.

Remarque

"id" est l’ID de placement.

Conseil

Vous pouvez inclure des espaces réservés pour passer des paramètres de chaîne de requête supplémentaires à notre plateforme pendant l’appel publicitaire.

Importante

Lorsque vous servez vos balises de placement sur l’inventaire sécurisé (SSL), vous devez modifier les balises ci-dessous pour utiliser l’hôte : "https://secure.adnxs.com/..."

IFRAME

<!-- BEGIN IFRAME TAG < - DO NOT MODIFY -->
<IFRAME SRC="https://ib.adnxs.com/tt?id=2704"
    FRAMEBORDER="0"
    SCROLLING="no"
    MARGINHEIGHT="0"
    MARGINWIDTH="0"
    TOPMARGIN="0"
    LEFTMARGIN="0"
    ALLOWTRANSPARENCY="true"
    WIDTH="120"
    HEIGHT="600"></IFRAME>
<!-- END TAG -->

JavaScript

<!-- BEGIN JS TAG < - DO NOT MODIFY -->
<SCRIPT SRC="https://ib.adnxs.com/ttj?id=2704" TYPE="text/javascript"></SCRIPT>
<!-- END TAG -->

API REST

Remarque

placement_code, code, site_codeet publisher_code peuvent être utilisés à la place des ID correspondants dans les appels ci-dessous.

HTTP, méthode Endpoint Description
POST https://api.appnexus.com/placement?publisher_id=PUBLISHER_ID

https://api.appnexus.com/placement?site_id=SITE_ID
(json de placement)		 Ajouter un placement (NETWORK).
PUT https://api.appnexus.com/placement?id=PLACEMENT_ID&publisher_id=PUBLISHER_ID

https://api.appnexus.com/placement?code=PLACEMENT_ID&site_id=SITE_ID
(json de placement)		 Modifier un placement existant (RÉSEAU).
DELETE https://api.appnexus.com/placement?id=PLACEMENT_ID&publisher_id=PUBLISHER_ID

https://api.appnexus.com/placement?code=PLACEMENT_CODE&publisher_code=PUBLISHER_CODE		 Supprimer un placement existant.
GET https://api.appnexus.com/placement?publisher_id=PUBLISHER_ID Affichez tous les placements de l’un de vos éditeurs.
GET https://api.appnexus.com/placement?id=PLACEMENT_ID Affichez un emplacement spécifique pour l’un de vos éditeurs.
GET https://api.appnexus.com/placement?id=1,2,3 Afficher tous les placements d’un site.

Champs JSON

Champ Type Description
id int ID du placement.

Par défaut : nombre incrémenté automatiquement (par exemple, 123)
Obligatoire Sur : PUT, dans la chaîne de requête
name string (100) Nom du placement.

Obligatoire sur : POST
code string (100) Code personnalisé pour le placement.

Remarque : les codes doivent être alphanumériques et ne peuvent pas contenir d’espaces. Les caractères suivants sont également autorisés :
- point (« . »)
- trait de soulignement (« _ »)
- trait d’union (« -« )
- pourcentage (« % »)
code2 string (100) Deuxième code personnalisé pour le placement.

Remarque : les codes doivent être alphanumériques et ne peuvent pas contenir d’espaces. Les caractères suivants sont également autorisés :
- point (« . »)
- trait de soulignement (« _ »)
- trait d’union (« -« )
- pourcentage (« % »)
code3 string (100) Troisième code personnalisé pour le placement.

Remarque : les codes doivent être alphanumériques et ne peuvent pas contenir d’espaces. Les caractères suivants sont également autorisés :
- point (« . »)
- trait de soulignement (« _ »)
- trait d’union (« -« )
- pourcentage (« % »)
state enum État du placement. Valeurs possibles : "active" ou "inactive".

Par défaut : "active"
width int Largeur du placement.
height int Hauteur du placement.
is_resizable Valeur booléenne Si le placement utilise un iFrame convivial et que vous souhaitez qu’il soit redimensionné pour s’adapter à des créations plus petites ou plus grandes, définissez ce champ sur true.

Par défaut : false
default_position enum Position par défaut du placement sur la page. Valeurs possibles : - "above" (au-dessus du pli)
"below" (sous le pli)
"unknown"

Par défaut : "unknown"
publisher_id int ID du serveur de publication associé au placement.

Obligatoire sur : POST
publisher_name string (100) Nom de l’éditeur associé au placement.
site_id int ID du site parent de ce placement. Chaque placement doit appartenir à un site.

Par défaut : Site de l’éditeur
site_name string (100) Nom du site sur lequel le placement est utilisé.
inventory_source_id int Déconseillé.
ad_profile_id int ID du profil publicitaire associé au placement.

Remarque : La méthode recommandée pour « affecter » un profil publicitaire à un placement est la suivante : Create une règle de qualité d’annonce avec un profil de ciblage (le profil « cible » le placement). Liez le profil d’annonce à la règle de qualité des annonces. Affectez la règle de qualité des annonces au serveur de publication. De cette façon, vous pouvez bénéficier d’une plus grande flexibilité à l’aide du profil de ciblage.
supported_media_types tableau d’objets Types de médias autorisés à servir sur le placement. Pour plus d’informations, consultez Types de supports pris en charge ci-dessous.

Attention : Si vous ne spécifiez supported_media_types pas ou supported_media_subtypes, le "Banner" type de média et tous ses sous-types sont autorisés par défaut.
supported_media_subtypes tableau d’objets Sous-types de média autorisés à servir sur le placement. Pour plus d’informations, consultez Sous-types de média pris en charge ci-dessous.
pop_values tableau Déconseillé.
default_creative_id int Déconseillé. default_creatives Utilisez à la place.
default_creatives tableau Les créations par défaut qui seront affichées à la place d’un PSA lorsqu’il n’y a pas de gagnant de la vente aux enchères. Pour chaque création par défaut, le prix de réserve est défini avec le "price" champ dans le tableau. Pour plus d’informations, consultez Créations par défaut ci-dessous.

Remarque : le placement ne s’affiche pas si le prix de réserve n’est pas atteint, sauf dans le cas d’une prépape.
reserve_price double Le prix de réserve pour chacun des éléments créatifs par défaut du placement est défini dans le default_creatives tableau (voir Créations par défaut ci-dessous). Si le placement n’a pas de créations par défaut, un prix de réserve peut être défini ici pour le placement ; Ce n’est toutefois pas une bonne pratique, car le prix de réserve peut entraîner l’affichage d’un APS.

Important : Un profil de gestion du rendement remplace tous les paramètres de prix de réserve au niveau placement. Si vous avez un tel profil, vous devez définir le prix de réserve souhaité via un plancher dur.
hide_referer Valeur booléenne Si truela valeur est , le référent n’est pas signalé.
default_referrer_url string Si un profil de visibilité est défini pour masquer les URL d’inventaire dans vos demandes d’enchères, vous pouvez définir ce champ pour passer une URL de vanité à la place. Cela est particulièrement utile dans les cas où les éditeurs ne souhaitent pas partager des domaines réels, mais veulent néanmoins que les acheteurs puissent les identifier par domaine.
visibility_profile_id int ID du profil de visibilité affecté directement au placement. Pour plus d’informations sur les profils de visibilité, consultez profil de visibilité.
exclusive Valeur booléenne En lecture seule.
Pour indiquer si l’inventaire d’un placement doit être mis à disposition pour la revente, utilisez le rtb champ dans l’objet marketplace_map du site du placement. Pour obtenir une description de ce champ, consultez Service de site. Tout le stock mis à disposition pour la revente fait partie de la Place de marché RTB.

Par défaut : False
pixel_url string Appel piggyback lors du chargement par l’utilisateur.

Par défaut : null
pixel_type enum Identifie le type de pixel. Les valeurs possibles sont : "javascript" ou "image".

Par défaut : image
content_categories tableau Liste des catégories de contenu associées à ce placement. Au maximum 20 catégories peuvent être spécifiées pour un placement.
filtered_advertisers tableau Liste des annonceurs autorisés à cibler le placement.
filtered_line_items tableau Liste des éléments de ligne autorisés à cibler le placement.
filtered_campaigns tableau Liste des campagnes autorisées à cibler le placement.
segments tableau Liste des segments auxquels les utilisateurs seront ajoutés lors de l’affichage de ce placement.
estimated_clear_prices tableau d’objets Le montant de la soumission qui a historiquement remporté la majorité (95%) des enchères tierces auxquelles elle participe. Pour plus d’informations, voir Estimation des prix en clair ci-dessous.
media_subtypes tableau Déconseillé. supported_media_types Utilisez et supported_media_subtypes à la place.
intended_audience enum Valeurs pour l’auto-audit uniquement. Valeurs possibles :
- "general"
- "children"
- "young_adult"
- "mature"
inventory_attributes tableau Attributs sensibles contenus dans le placement.

Conseil : le inventory_attributes peut également être appliqué au niveau du site et, dans ce cas, influence également les objets au niveau du placement. Il s’agit d’un tableau d’objets avec des ID. Consultez service d’attribut d’inventaire pour obtenir la liste des ID.
audited Valeur booléenne Si truela valeur est , le placement a été auto-audité par le propriétaire.

Par défaut : false
audit_level enum Valeurs pour l’auto-audit uniquement.

Remarque : Les auto-audits au niveau du site peuvent être remplacés au niveau du placement. Valeurs possibles :
- "site" - Utilisez cette valeur si le audited champ est défini sur false dans le placement, mais true dans le site.
- "placement" - Utilisez cette valeur si le audited champ est défini sur true dans le placement.

Par défaut : "site"
default_calculation_type enum Cela détermine le seuil de prix de l’offre en dessous duquel un créatif par défaut sera servi. Vous pouvez choisir si ce seuil correspond au chiffre d’affaires brut du réseau ou au chiffre d’affaires net de l’éditeur. S’il n’y a pas de campagnes éligibles supplémentaires, ni de créations par défaut disponibles, un psa est servi. Valeurs possibles : "gross" ou "net".

Par défaut : "gross"
apply_floor_to_direct Valeur booléenne Supprimé. floor_application_target Utilisez à la place.
demand_filter_action string Indique les sources de demande qui peuvent être incluses ou exclues.

Par défaut : default
floor_application_target enum Type d’enchères auxquelles le prix de réserve est appliqué. Valeurs possibles :
- "external_only" - Le prix de réserve est appliqué uniquement aux enchères externes (le membre acheteur et le membre vendeur sont différents). Utilisez cette option si vous préférez fournir une impression d’apprentissage managé disponible plutôt qu’une valeur par défaut, même si cela signifie dépasser le pourcentage maximal de volume quotidien pour learn (max_learn_pct champ dans Publisher Service).
- "external_non_preferred" - Le prix de réserve est appliqué aux enchères externes (le membre acheteur et le membre vendeur sont différents) ou lorsque l’impression est une impression d’apprentissage managé disponible qui dépasse le pourcentage maximal de volume quotidien pour learn. Utilisez cette option si vous préférez servir une valeur par défaut plutôt qu’une impression d’apprentissage managé disponible qui dépasserait le pourcentage maximal de volume quotidien pour learn.
- "all" - Le prix de réserve est appliqué à toutes les enchères à l’exception des impressions d’apprentissage managées dans le pourcentage maximal du volume quotidien pour learn.

Par défaut : "all"
pixel_url_secure string Appel de piggyback sécurisé lors du chargement de l’utilisateur.

Par défaut : null
site_audit_status enum Indique comment le site a décidé d’effectuer des audits créatifs. Les valeurs possibles sont : "self" ou "unaudited".

Par défaut : unaudited
toolbar objet Les vendeurs doivent déclarer tout l’inventaire de la barre d’outils et du plug-in du navigateur. Si un vendeur attribue l’attribut d’inventaire « barre d’outils », ces métadonnées supplémentaires doivent également être incluses.
acb_code chaîne (32) Déconseillé.
tag_data string Déconseillé.
cost_cpm double Si une valeur existe, elle sera utilisée comme informations de paiement pour le placement. Cela remplacera toutes les règles de paiement associées à l’éditeur.

Par défaut : null
is_prohibited Valeur booléenne En lecture seule. Si truela valeur est , le placement a été interdit en raison d’une violation des stratégies de contenu Xandr. Les enchères directes et tierces ne seront pas exécutées pour un placement interdit.

Par défaut : false
last_modified Timestamp En lecture seule. Date et heure de la dernière modification du placement.
stats objet L’objet stats est déconseillé (depuis le 17 octobre 2016). Utilisez plutôt le service de rapports pour obtenir des informations statistiques.
content_retrieval_timeout_ms int Délai d’expiration défini par ce placement sur le contenu récupéré à partir de créations « médiatées », c’est-à-dire "mediation"les créatifs dont content_source la valeur est définie sur . Pour plus d’informations, consultez Creative Service.
- Si la 0valeur est définie sur , le serveur publicitaire utilise la valeur du service membre
- La valeur par défaut est 0 si elle n’est pas fournie à l’API sur PUT ou POST appelle.
- Si le serveur publicitaire lit un 0 dans ce champ, il effectue une recherche de membre et utilise le délai d’expiration par défaut défini par le service membre (en supposant qu’il est également différent de zéro).
- Lors de la création d’un placement, aucune valeur n’est copiée dans ce champ à partir des paramètres par défaut du membre. Vous devez les spécifier explicitement dans vos appels à POST. Pour plus d’informations, consultez le default_content_retrieval_timeout_ms champ du service membre.

Par défaut : 0
enable_for_mediation Valeur booléenne Ce sera la source de vérité pour savoir si un placement doit accepter le contenu médiat. Sauf si la valeur est définie sur PUT ou POST, ce champ héritera de sa valeur par défaut du membre. Si la valeur par défaut est modifiée sur le service membre, cette action n’aura pas d’impact rétroactif sur les placements créés précédemment . ils continueront à être définis sur l’ancienne valeur par défaut. En d’autres termes, la valeur de ce champ ne peut pas être mise à jour rétroactivement en définissant le membre par défaut. Pour plus d’informations, consultez le default_enable_for_mediation champ du service membre.

Par défaut : hérité du default_enable_for_mediation champ Du service membre.
private_sizes tableau d’objets Liste des tailles de placement qui peuvent être autorisées à servir dans des offres et des packages. Pour plus d’informations, consultez Tailles privées ci-dessous.
video objet Sous-type de média autorisé à servir sur le placement. Pour plus d’informations, consultez Paramètres vidéo ci-dessous.

Par défaut : null
ad_types tableau d’objets Contient des informations relatives aux types de placement, notamment l’ID de type d’annonce et des informations sur le renderer. Pour plus d’informations, consultez Types d’annonces ci-dessous.

Par défaut : null
Obligatoire sur : PUT
use_detected_domain valeur booléenne En lecture seule. Indique s’il faut utiliser le domaine détecté par rapport au domaine signalé. La valeur par défaut est true pour tous les clients.

Par défaut : true
mime_types tableau de chaînes Liste des types mime à inclure ou à exclure sur le placement. supported_mime_types_action_include Ci-dessous est utilisé pour spécifier s’il faut inclure ou exclure ces types mime. Pour obtenir la liste des chaînes utilisées pour identifier chaque type mime, consultez Types Mime pris en charge.

Par défaut : empty
supported_mime_types_action_include valeur booléenne Si truela valeur est , les types mime répertoriés dans le mime_types tableau sont inclus.

Par défaut : false
handles_mixed_media valeur booléenne Cela indique à notre plateforme si le lecteur vidéo peut prendre en charge un fichier VAST avec différents types mime.

Par défaut : true
tinytag_renderer_asset_floor_prices tableau d’objets Associe les prix planchers aux créatifs natifs qui ont été affectés au placement. Pour plus d’informations, consultez Tinytag Renderer Asset Floor Prices.

Obligatoire sur : PUT
is_ss_native_assembly_enabled valeur booléenne Lorsqu’elle est activée, bien que la demande d’origine soit une demande de bannière, les demandes envoyées aux soumissionnaires ont des informations natives définies afin de recevoir les ressources natives dans les réponses. La réponse finale sera définie sur un type d’annonce de bannière avec un balisage d’annonce assemblé natif attaché. Si true alors oui.

Types de médias pris en charge

Les éléments créatifs sont classés par type de média et sous-type de média. Le type de média définit le style d’affichage général du créatif, par exemple , "Banner"et le sous-type multimédia définit le style d’affichage spécifique des éléments créatifs, par exemple, "Standard Banner" ou "In-Banner Video". Vous pouvez utiliser ce tableau pour limiter le type de média, le style d’affichage général des éléments créatifs, qui peuvent servir sur un placement. Pour limiter le sous-type multimédia, le style d’affichage spécifique des éléments créatifs, utilisez le supported_media_subtypes tableau (voir Sous-types multimédias pris en charge ci-dessous).

Champ Type Description
id int ID du type de média autorisé. Vous pouvez utiliser le service de type de média pour afficher tous les types de médias.

Par défaut : 1
name chaîne Nom du type de média autorisé.

Par défaut : "Banner"
media_type_group_id int ID de groupe pour le type de média.
uses_sizes enum Indique si le type de média a des spécifications de taille. Valeurs possibles :
- "always"
- "sometimes"
- "never"
last_modified date Lorsque l’objet allowed_media_type a été mis à jour pour la dernière fois.

Sous-types de média pris en charge

Les éléments créatifs sont classés par type de média et sous-type de média. Le type de média définit le style d’affichage général du créatif, par exemple , "Banner"et le sous-type multimédia définit le style d’affichage spécifique des éléments créatifs, par exemple, "Standard Banner" ou "In-Banner Video". Vous pouvez utiliser ce tableau pour limiter le sous-type multimédia, le style d’affichage spécifique des éléments créatifs, qui peut servir sur un placement. Pour limiter le type de média, le style d’affichage général des éléments créatifs, utilisez le supported_media_types tableau (voir Types de médias pris en charge ci-dessus).

Champ Type Description
id int ID du sous-type de média autorisé. Vous pouvez utiliser le service De sous-type multimédia pour afficher tous les sous-types multimédias.

Par défaut : null
name string Nom du sous-type de média autorisé.
is_private valeur booléenne Indique si le sous-type de média est défini sur privé. Si true alors oui.
media_type_group_id int ID de groupe pour le type de média.

Remarque

Types de médias et sous-types de média pris en charge

  • Si vous ne spécifiez pas les types de médias pris en charge ou les sous-types de média pris en charge, le "Banner" type de média et tous ses sous-types sont autorisés par défaut.
  • Vous pouvez combiner les "Banner" types de média et "Text" et toute combinaison de leurs sous-types multimédias sur un emplacement unique, mais vous ne pouvez pas combiner les autres types de médias et sous-types de médias. Cette limitation garantit que seuls les contenus créatifs appropriés sont servis sur un placement. Par exemple, un placement qui autorise les éléments créatifs du type "Video" de média est destiné à être transmis à un lecteur vidéo ; il n’est pas judicieux d’autoriser les créatifs d’un autre type de média, tel que "Interstitial", à servir sur le placement.
  • Vous pouvez définir un emplacement pour autoriser le "Expandable" type de média ou l’un de ses sous-types pour l’inventaire direct. Si vous souhaitez prendre en charge les éléments créatifs extensibles pour les placements qui peuvent être revendus à d’autres membres de la plateforme, indiquez l’ID du placement pour prendre en charge la vérification.

Types mime pris en charge

Le mime_types tableau d’objets prend en charge les types mime indiqués dans le tableau suivant. Si aucun type mime n’est spécifié, tous les types mime sont acceptés. L’API Placement utilise la chaîne dans la colonne Nom . Si vous devez transmettre ces informations dans une balise, utilisez l’ID.

Nom ID
application/x-shockwave-flash 1
video/x-flv 2
video/mp4 3
video/webm 4
application/javascript 5
application/octet-stream 6
image/jpeg 7
image/gif 8
image/png 9
application/zip 10
application/vnd.ms-asf 11
video/x-ms-wmv 12
video/ogg 13
video/x-msvideo 14
video/mpeg 15
video/quicktime 16
video/3gpp 17
video/3gpp2 18
video/x-m4v 19
audio/ogg 20
audio/x-pn-realaudio 21
audio/mpeg 22
text/css 23
text/html 24
text/plain 25
audio/mp4 26

Paramètres vidéo

Si a la supported_media_type valeur "video" ou a la supported_media_subtypes valeur "Standard VAST", ces champs doivent être inclus dans l’objet video . Consultez les exemples ci-dessous.

Remarque

Les paramètres suivants affectent les résultats des enchères : pour les paramètres du lecteur Outstream, qui déterminent le comportement ultime du lecteur vidéo Outstream, consultez « Paramètres du lecteur vidéo Outstream » dans notre documentation de l’interface utilisateur.

Champ Type Description
id int ID de la vidéo créative.
width int Largeur de la vidéo créative.
max_duration_secs int Durée maximale d’une publicité vidéo autorisée à être lue sur le placement.
- Si maximum_number_ads a la valeur >1, la durée maximale s’applique à toute la longueur d’un pod d’annonce (regroupement linéaire de plusieurs annonces conçue pour remplir un seul emplacement).

Remarque : ce champ doit être défini pour activer les pods publicitaires.
maximum_ad_duration_secs int Durée maximale de la publicité vidéo en secondes d’une seule annonce pouvant être lue sur le placement. Cela s’applique uniquement aux pods publicitaires.
maximum_number_ads int Nombre maximal d’annonces autorisées à être diffusées sur le placement. Si maximum_number_ads a la valeur >1, le placement peut être un pod publicitaire (regroupement linéaire de plusieurs annonces conçue pour remplir un seul placement).
start_delay_secs int Délai de début en secondes pour le placement. Si la valeur du délai de début est >0, la position du placement est "mid-roll".

Remarque : ce champ doit être défini si le contexte est "mid-roll".
skipoffset_seconds int Nombre de secondes autorisées pour la lecture de la vidéo, avant qu’elle ne puisse être ignorée.
La valeur par défaut est null.

ATTENTION : si vous définissez cette valeur sur autre chose que null, le supports_skippable champ doit être défini sur true. (Voir ci-dessous).
supports_skippable valeur booléenne L’emplacement publicitaire est skippable.
Valeurs possibles : "true" ou "false"
context string Position de rouleau de la vidéo créative.
Valeurs possibles : "pre-roll", "mid-roll", "post-roll".

Important : ce champ doit être défini pour activer les pods publicitaires.
layback_method string Les différentes méthodes de lecture sont les suivantes :
- Auto-play, sound-on
- Auto-play, sound-off
- Click-to-play
- Mouse-over
- Auto-play, sound unknown

Valeurs possibles :
- "auto_play_sound_on"
- "auto_play_sound_off"
- "click_to_play"
- "mouse_over"
- "auto_play_sound_unknown"
- null
frameworks tableau de chaînes Framework du placement. Les options suivantes sont disponibles :
- VPAID 1.0
- VPAID 2.0
- MRAID-1
- ORMMA
- MRAID-2
Valeurs possibles :
- "vpaid_1_0"
- "vpaid_2_0"
- "mraid_1"
- "ormma"
- "mraid_2"
video_bumpers tableau d’objets Les pare-chocs qui peuvent être associés au pod publicitaire. La durée du pare-choc n’est pas incluse dans la durée globale du pod publicitaire. Voir l’objet pare-chocs vidéo .
player_vast_version string Ce champ spécifie la version la plus vaste prise en charge par le placement et doit être défini sur la valeur la plus élevée prise en charge par votre joueur. Les créatifs qui nécessitent une version étendue supérieure à la version de votre joueur ne seront pas éligibles pour servir dans votre placement.
Valeurs possibles :
- 2.0
- 3.0
- 4.0

ATTENTION : La spécification d’une valeur supérieure à celle prise en charge par votre lecteur peut entraîner des erreurs lorsque des créations non prises en charge sont affichées.
vmin_ad_duration int Durée de création minimale autorisée, en secondes.
minbitrate int Vitesse de transmission minimale en Kbits/s.
mf_min_width int Largeur minimale de la vidéo créative.
mf_min_height int Hauteur minimale de la vidéo créative.
aspect_ratios tableau d’objets Proportions créatives qui peuvent servir pour un placement vidéo. Le tableau contient ratio_width et ratio_height.

Pare-chocs vidéo

Ce tableau d’objets contient des informations relatives aux pare-chocs sur un pod publicitaire.

Champ Type Description
video_bumper_type string Type de pare-chocs. Les options suivantes sont disponibles :
- intro
- outro
Par défaut : null
max_duration_secs int Durée maximale du pare-chocs.

Par défaut : null

Allongements

Ce tableau d’objets contient des informations sur les proportions créatives qui peuvent servir pour un placement vidéo.

Champ Type Description
ratio_width int Largeur des proportions
ratio_height int Hauteur des proportions

Types d’annonces

Ce tableau d’objets contient des informations relatives aux types de placement, notamment l’ID de type d’annonce et des informations sur le renderer.

Champ Type Description
id int ID du ad_type.
Valeurs possibles :
1 = Bannière
2 = Vidéo
3 = Natif

Par défaut : null
Obligatoire sur : POST/PUT
renderer_id int ID du renderer.
Valeurs possibles :
1 = bannière outstream
2 = vidéo en flux sortant

Par défaut : null
Obligatoire sur : POST/PUT
name string Nom de dans ad_type toutes les lettres minuscules, par exemple video ou banner.
display_name string Nom d’affichage de , ad_typeaffiché en tant que type d’annonce avec des majuscules initiales, par exemple Video ou Banner.
renderer objet multi Objet constitué de et iddisplay_name du renderer.

Par défaut : null
Obligatoire sur : POST/PUT

Prix plancher des actifs de renderer Tinytag

Ce tableau d’objets est utilisé pour associer des prix plancher à des créations natives qui ont été affectées au placement.

Champ Type (Longueur) Description
renderer_id int ID du renderer.

Obligatoire sur : POST/PUT
ad_type_id int ID du ad_type. Cela sera toujours 3, car vous ne pouvez associer des prix plancher qu’à des créatifs natifs.

Par défaut : 3
Obligatoire sur : POST/PUT
asset_type chaîne Type de ressource.
Les valeurs admises sont les suivantes :
- main_image
- video
Obligatoire sur : POST/PUT
floor_price double Montant de l’offre préférée en échange des impressions de la ressource native.

Obligatoire sur : POST/PUT

Créations par défaut

Vous utilisez ce tableau pour affecter des éléments créatifs par défaut au placement. Notez les conditions suivantes :

  • Un élément créatif par défaut ne doit pas avoir expiré. Pour plus d’informations, consultez le is_expired champ dans Creative Service .

  • Un élément créatif par défaut doit être affecté à un modèle créatif qui correspond à et supported_media_typessupported_media_subtypes du placement. Par exemple, si le placement autorise les éléments créatifs du "Banner" type de média, vous ne pourrez pas associer des éléments créatifs par défaut qui utilisent un modèle créatif pour le "Interstitial" type de média. Pour plus d’informations, consultez le template champ dans Creative Service .

  • Si le placement est dimensionné (les "width" champs et "height" sont définis pour le placement), ce tableau ne doit contenir qu’un seul élément créatif avec les dimensions correspondantes.

Champ Type Description
id int ID de la création par défaut.
width int Largeur du créatif par défaut.
height int Hauteur du créatif par défaut.
price double Prix de réserve pour le créatif par défaut. Une enchère gagnante doit être supérieure à ce prix.
name string En lecture seule. Nom du créatif par défaut.

Valeurs contextuelles

Si est supported_media_type"Pop", ou si est supported_media_subtypes"Popup" ou "Popunder", ces champs doivent être inclus dans le pop_values tableau. Pour obtenir un exemple, voir ci-dessous.

Champ Type Description
pop_freq_times int Nombre de fois où la balise peut être transférée à un ID utilisateur unique en pop_frequency_duration secondes. N’a aucun effet lorsque pop_is_prepop est défini sur true.

Par défaut : No frequency cap
pop_freq_duration int Voir pop_freq_times (en anglais).

Par défaut : No frequency cap
pop_is_prepop Valeur booléenne Si truela valeur est , la balise est une balise de prépop et sert dans une fenêtre que la page de l’éditeur a déjà ouverte.

Par défaut : false
pop_max_width int Si pop_max_width est spécifié, tout élément créatif affiché par la balise doit avoir une largeur égale ou inférieure à pop_max_width

Valeur par défaut : no max width.
pop_max_height int Hauteur maximale du créatif. Si pop_max_height est spécifié, toute création affichée par la balise doit avoir une hauteur égale ou inférieure pop_max_heightà .

Par défaut : no max height

Estimation des prix clairs

Champ Type Description
clear_price int Le montant de l’offre qui a historiquement remporté la majorité (95%) des enchères tierces auxquelles elle participe pour ce placement.
average_price double Il s’agit de la moyenne de toutes les offres soumises pour ce placement.
width int Lors de l’exportation de balises de placement sans taille à servir, cela détermine la largeur du placement.
height int Lors de l’exportation des étiquettes de placement sans taille à servir, cela détermine la hauteur du placement.
verified Valeur booléenne Indique si la création a été vérifiée.
geo_country chaîne Code de pays de l’emplacement géographique associé à l’impression.

Tailles privées

Ce tableau détermine les tailles de placement spécifiques autorisées à servir pour une transaction personnalisée ou dans un package. Le override_size_preference dans le service de transaction ou le service de package doit être défini sur append pour ces tailles privées à servir avec les tailles de placement standard.

Champ Type Description
width int Largeur du placement.
height int Hauteur du placement.

Stats

L’objet stats est déconseillé (depuis le 17 octobre 2016). Utilisez plutôt le service de rapports pour obtenir des informations statistiques.

Barre d’outils & déclaration du plug-in de navigateur

Selon la stratégie de plateforme, les vendeurs doivent identifier l’inventaire de tous les plug-ins de barre d’outils/navigateur et le séparer des autres stocks sur leurs propres emplacements. Pour identifier l’inventaire de la barre d’outils, les vendeurs doivent :

  • Définissez de manière appropriée.inventory_attribute
  • Envoyez les informations requises dans le tableau de barre d’outils, décrit ici :
Paramètre Type Description
name string Nom commercial commun de la barre d’outils.
company string Développeur de la barre d’outils. Veuillez identifier l’entité commerciale légale, et non un nom commercial.
tos_url string Lien vers une page web dans laquelle nos auditeurs peuvent trouver des conditions d’utilisation complètes.
install_url string Lien vers une page web dans laquelle nos auditeurs peuvent installer la barre d’outils.

Exemples

Affichage de tous les emplacements pour l’un de vos éditeurs

$ curl -b cookies -c cookies 'https://api.appnexus.com/placement?publisher_id=88888'

{
    "response": {
        "status": "OK",
        "count": 4,
        "start_element": 0,
        "num_elements": 100,
        "placements": [
            {
                "id": 594595,
                "name": "Test Placement 1",
                "code": null,
                "code2": null,
                "code3": null,
                "state": "active",
                "cost_cpm": null,
                "publisher_id": 88888,
                "site_id": 188040,
                "reserve_price": null,
                "width": 300,
                "height": 250,
                "default_position": "unknown",
                "default_creative_id": null,
                "ad_profile_id": null,
                "acb_code": null,
                "tag_data": null,
                "hide_referer": false,
                "inventory_source_id": null,
                "pixel_url": "",
                "pixel_type": "image",
                "last_modified": "2011-10-24 19:45:31",
                "media_subtypes": [
                    "banner"
                ],
                "intended_audience": "general",
                "audited": true,
                "audit_level": "placement",
                "default_calculation_type": "gross",
                "publisher_name": "National Public Radio",
                "site_name": "[Test Publisher 1] - ROS",
                "site_audit_status": "unaudited",
                "demand_filter_action": "include",
                "is_resizable": true,
                "pixel_url_secure": "",
                "floor_application_target": "all",
                "pop_values": null,
                "inventory_attributes": [
                    {
                        "id": 2,
                        "name": "Political opinion"
                    },
                    {
                        "id": 16,
                        "name": "Blogs"
                    }
                ],
                "supported_media_types": [
                    {
                        "name": "Banner",
                        "id": 1
                    }
                ],
                "supported_media_subtypes": null,
                "content_categories": [
                    {
                        "id": 7,
                        "name": "Arts & Entertainment",
                        "is_system": true
                    },
                    {
                        "id": 17,
                        "name": "News",
                        "is_system": true
                    },
                    {
                        "id": 25,
                        "name": "Society",
                        "is_system": true
                    },
                    {
                        "id": 11445,
                        "name": "Books & Literature",
                        "is_system": true
                    }
                ],
                "segments": null,
                "estimated_clear_prices": [
                    {
                        "clear_price": 1,
                        "average_price": 0.5,
                        "width": 0,
                        "height": 0,
                        "verified": true
                    }
                ],
                "filtered_advertisers": [
                    {
                        "id": 35081,
                        "name": "Test Advertiser 1"
                    }
                ],
                "filtered_line_items": null,
                "filtered_campaigns": null,
                "default_creatives": null
            },
            {
                "id": 605055,
                "name": "Test Placement 2",
                "code": null,
                "code2": null,
                "code3": null,
                "state": "active",
                "cost_cpm": null,
                "publisher_id": 88888,
                "site_id": 188040,
                "reserve_price": null,
                "width": null,
                "height": null,
                "default_position": "unknown",
                "default_creative_id": null,
                "ad_profile_id": null,
                "acb_code": null,
                "tag_data": null,
                "hide_referer": false,
                "inventory_source_id": null,
                "pixel_url": null,
                "pixel_type": "image",
                "last_modified": "2012-03-08 00:49:50",
                "media_subtypes": null,
                "intended_audience": null,
                "audited": false,
                "audit_level": "site",
                "default_calculation_type": "gross",
                "publisher_name": "Test Publisher 1",
                "site_name": "[Test Publisher 1] - ROS",
                "site_audit_status": "unaudited",
                "demand_filter_action": "default",
                "is_resizable": false,
                "pixel_url_secure": null,
                "floor_application_target": "all",
                "pop_values": null,
                "inventory_attributes": null,
                "supported_media_types": [
                    {
                        "id": 1,
                        "name": "Banner"
                    },
                    {
                        "id": 5,
                        "name": "Text"
                    }
                ],
                "supported_media_subtypes": null,
                "content_categories": null,
                "segments": null,
                "estimated_clear_prices": [
                    {
                        "clear_price": 1,
                        "average_price": 0.5,
                        "width": 0,
                        "height": 0,
                        "verified": true
                    }
                ],
                "filtered_advertisers": null,
                "filtered_line_items": null,
                "filtered_campaigns": null,
                "default_creatives": null
            },
            {
                "id": 605056,
                "name": "Test Placement 3",
                "code": null,
                "code2": null,
                "code3": null,
                "state": "active",
                "cost_cpm": null,
                "publisher_id": 88888,
                "site_id": 188040,
                "reserve_price": null,
                "width": null,
                "height": null,
                "default_position": "unknown",
                "default_creative_id": null,
                "ad_profile_id": null,
                "acb_code": null,
                "tag_data": null,
                "hide_referer": false,
                "inventory_source_id": null,
                "pixel_url": null,
                "pixel_type": "image",
                "last_modified": "2012-03-08 00:54:37",
                "media_subtypes": null,
                "intended_audience": null,
                "audited": false,
                "audit_level": "site",
                "default_calculation_type": "gross",
                "publisher_name": "Test Publisher 1",
                "site_name": "[Test Publisher 1] - ROS",
                "site_audit_status": "unaudited",
                "demand_filter_action": "default",
                "is_resizable": false,
                "pixel_url_secure": null,
                "floor_application_target": "all",
                "pop_values": null,
                "inventory_attributes": null,
                "supported_media_types": null,
                "supported_media_subtypes": [
                    {
                        "id": 3,
                        "name": "In-Banner Video",
                        "media_type": {
                            "id": 1
                        }
                    }
                ],
                "content_categories": null,
                "segments": null,
                "estimated_clear_prices": [
                    {
                        "clear_price": 1,
                        "average_price": 0.5,
                        "width": 0,
                        "height": 0,
                        "verified": true
                    }
                ],
                "filtered_advertisers": null,
                "filtered_line_items": null,
                "filtered_campaigns": null,
                "default_creatives": null
            },
            {
                "id": 605057,
                "name": "Test Placement 4",
                "code": null,
                "code2": null,
                "code3": null,
                "state": "active",
                "cost_cpm": null,
                "publisher_id": 88888,
                "site_id": 188040,
                "reserve_price": null,
                "width": 1,
                "height": 1,
                "default_position": "unknown",
                "default_creative_id": null,
                "ad_profile_id": null,
                "acb_code": null,
                "tag_data": null,
                "hide_referer": false,
                "inventory_source_id": null,
                "pixel_url": null,
                "pixel_type": "image",
                "last_modified": "2012-03-08 01:07:47",
                "media_subtypes": null,
                "intended_audience": null,
                "audited": false,
                "audit_level": "site",
                "default_calculation_type": "gross",
                "publisher_name": "Test Publisher 1",
                "site_name": "[Test Publisher 1] - ROS",
                "site_audit_status": "unaudited",
                "demand_filter_action": "default",
                "is_resizable": false,
                "pixel_url_secure": null,
                "floor_application_target": "all",
                "pop_values": null,
                "inventory_attributes": null,
                "supported_media_types": [
                    {
                        "id": 3,
                        "name": "Interstitial"
                    }
                ],
                "supported_media_subtypes": null,
                "content_categories": null,
                "segments": null,
                "estimated_clear_prices": [
                    {
                        "clear_price": 1,
                        "average_price": 0.5,
                        "width": 0,
                        "height": 0,
                        "verified": true
                    }
                ],
                "filtered_advertisers": null,
                "filtered_line_items": null,
                "filtered_campaigns": null,
                "default_creatives": null
            }
        ]
    }
}

Affichage d’un emplacement spécifique

$ curl -b cookies -c cookies 'https://api.appnexus.com/placement?id=605057'

{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": 0,
        "num_elements": 100,
        "placement": {
            "id": 605057,
            "name": "Test Placement 4",
            "code": null,
            "code2": null,
            "code3": null,
            "state": "active",
            "cost_cpm": null,
            "publisher_id": 88888,
            "site_id": 188040,
            "reserve_price": null,
            "width": 1,
            "height": 1,
            "default_position": "unknown",
            "default_creative_id": null,
            "ad_profile_id": null,
            "acb_code": null,
            "tag_data": null,
            "hide_referer": false,
            "inventory_source_id": null,
            "pixel_url": null,
            "pixel_type": "image",
            "last_modified": "2012-03-08 01:07:47",
            "media_subtypes": null,
            "intended_audience": null,
            "audited": false,
            "audit_level": "site",
            "default_calculation_type": "gross",
            "publisher_name": "Test Publisher 1",
            "site_name": "[Test Publisher 1] - ROS",
            "site_audit_status": "unaudited",
            "demand_filter_action": "default",
            "is_resizable": false,
            "pixel_url_secure": null,
            "floor_application_target": "all",
            "pop_values": null,
            "inventory_attributes": null,
            "supported_media_types": [
                {
                    "id": 3,
                    "name": "Interstitial"
                }
            ],
            "supported_media_subtypes": null,
            "content_categories": null,
            "segments": null,
            "estimated_clear_prices": [
                {
                    "clear_price": 1,
                    "average_price": 0.5,
                    "width": 0,
                    "height": 0,
                    "verified": true
                }
            ],
            "filtered_advertisers": null,
            "filtered_line_items": null,
            "filtered_campaigns": null,
            "default_creatives": null
        }
    }
}

Ajout d’un placement qui autorise uniquement les éléments créatifs avec le type de "Interstitial" média

$ cat placement

{
    "placement": {
        "name": "Placement for Interstitials",
        "publisher_id": 88888,
        "supported_media_types": [
            {
                "id": 3
            }
        ],
        "video": 10,
        "supports_skippable": true,
        "player_vast_version" "3.0"
        }
    }
}

$ curl -b cookies -c cookies -X POST -d @placement 'https://api.appnexus.com/placement'

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 605058,
        "start_element": 0,
        "num_elements": 100,
        "placement": {
            "id": 605058,
            "name": "Placement for Interstitials",
            "code": null,
            "code2": null,
            "code3": null,
            "state": "active",
            "cost_cpm": null,
            "publisher_id": 88888,
            "site_id": 188040,
            "reserve_price": null,
            "width": 1,
            "height": 1,
            "default_position": "unknown",
            "default_creative_id": null,
            "ad_profile_id": null,
            "acb_code": null,
            "tag_data": null,
            "hide_referer": false,
            "inventory_source_id": null,
            "pixel_url": null,
            "pixel_type": "image",
            "last_modified": "2012-03-08 01:41:52",
            "media_subtypes": null,
            "intended_audience": null,
            "audited": false,
            "audit_level": "site",
            "default_calculation_type": "gross",
            "publisher_name": "Test Publisher 1",
            "site_name": "[Test Publisher 1] - ROS",
            "site_audit_status": "unaudited",
            "demand_filter_action": "default",
            "is_resizable": false,
            "pixel_url_secure": null,
            "floor_application_target": "all",
            "pop_values": null,
            "inventory_attributes": null,
            "supported_media_types": [
                {
                    "id": 3,
                    "name": "Interstitial"
                }
            ],
            "supported_media_subtypes": null,
            "content_categories": null,
            "segments": null,
            "estimated_clear_prices": [
                {
                    "clear_price": 1,
                    "average_price": 0.5,
                    "width": 0,
                    "height": 0,
                    "verified": true
                }
            ],
            "filtered_advertisers": null,
            "filtered_line_items": null,
            "filtered_campaigns": null,
            "default_creatives": null
        }
    }
}

Ajout d’un placement qui autorise uniquement les éléments créatifs avec le "In-Banner Video" sous-type multimédia

$ cat placement

{
    "placement": {
        "name": "Placement for In-Banner Video",
        "publisher_id": 88888,
        "supported_media_subtypes": [
            {
                "id": 3
            }
        ],
        "video": 10,
        "supports_skippable": true,
        "player_vast_version" "3.0"
        }
    }
}

$ curl -b cookies -c cookies -X POST -d @placement 'https://api.appnexus.com/placement'

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 605059,
        "start_element": 0,
        "num_elements": 100,
        "placement": {
            "id": 605059,
            "name": "Placement for In-Banner Video",
            "code": null,
            "code2": null,
            "code3": null,
            "state": "active",
            "cost_cpm": null,
            "publisher_id": 88888,
            "site_id": 188040,
            "reserve_price": null,
            "width": null,
            "height": null,
            "default_position": "unknown",
            "default_creative_id": null,
            "ad_profile_id": null,
            "acb_code": null,
            "tag_data": null,
            "hide_referer": false,
            "inventory_source_id": null,
            "pixel_url": null,
            "pixel_type": "image",
            "last_modified": "2012-03-08 01:46:43",
            "media_subtypes": null,
            "intended_audience": null,
            "audited": false,
            "audit_level": "site",
            "default_calculation_type": "gross",
            "publisher_name": "Test Publisher 1",
            "site_name": "[Test Publisher 1] - ROS",
            "site_audit_status": "unaudited",
            "demand_filter_action": "default",
            "is_resizable": false,
            "pixel_url_secure": null,
            "floor_application_target": "all",
            "pop_values": null,
            "inventory_attributes": null,
            "supported_media_types": null,
            "supported_media_subtypes": [
                {
                    "id": 3,
                    "name": "In-Banner Video",
                    "media_type": {
                        "id": 1
                    }
                }
            ],
            "content_categories": null,
            "segments": null,
            "estimated_clear_prices": [
                {
                    "clear_price": 1,
                    "average_price": 0.5,
                    "width": 0,
                    "height": 0,
                    "verified": true
                }
            ],
            "filtered_advertisers": null,
            "filtered_line_items": null,
            "filtered_campaigns": null,
            "default_creatives": null
        }
    }
}

Ajout d’un placement qui autorise uniquement les éléments créatifs avec le "Popup" sous-type multimédia

$ cat placement

{
    "placement": {
        "name": "Placement for Popups",
        "publisher_id": 88888,
        "supported_media_subtypes": [
            {
                "id": 2
            }
        ],
        "pop_values":{
            "pop_is_prepop":false,
            "pop_freq_times":4,
            "pop_freq_duration":1440,
            "pop_max_width":500,
            "pop_max_height":100
        }
    }
}

$ curl -b cookies -c cookies -X POST -d @placement 'https://api.appnexus.com/placement?publisher_id=88888'

{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 605076,
        "start_element": 0,
        "num_elements": 100,
        "placement": {
            "id": 605076,
            "name": "Placement for Popups",
            "code": null,
            "code2": null,
            "code3": null,
            "state": "active",
            "cost_cpm": null,
            "publisher_id": 88888,
            "site_id": 188040,
            "reserve_price": null,
            "width": null,
            "height": null,
            "default_position": "unknown",
            "default_creative_id": null,
            "ad_profile_id": null,
            "acb_code": null,
            "tag_data": null,
            "hide_referer": false,
            "inventory_source_id": null,
            "pixel_url": null,
            "pixel_type": "image",
            "last_modified": "2012-03-08 15:56:05",
            "media_subtypes": null,
            "intended_audience": null,
            "audited": false,
            "audit_level": "site",
            "default_calculation_type": "gross",
            "publisher_name": "National Public Radio",
            "site_name": "[National Public Radio] - ROS",
            "site_audit_status": "unaudited",
            "demand_filter_action": "default",
            "is_resizable": false,
            "pixel_url_secure": null,
            "floor_application_target": "all",
            "pop_values": {
                "pop_freq_times": 4,
                "pop_freq_duration": 1440,
                "pop_is_prepop": false,
                "pop_max_width": 500,
                "pop_max_height": 100
            },
            "inventory_attributes": null,
            "supported_media_types": null,
            "supported_media_subtypes": [
                {
                    "id": 2,
                    "name": "Popup",
                    "media_type": {
                        "id": 2
                    }
                }
            ],
            "content_categories": null,
            "segments": null,
            "estimated_clear_prices": [
                {
                    "clear_price": 1,
                    "average_price": 0.5,
                    "width": 0,
                    "height": 0,
                    "verified": true
                }
            ],
            "filtered_advertisers": null,
            "filtered_line_items": null,
            "filtered_campaigns": null,
            "default_creatives": null
        }
    }
}

Ajout d’un placement qui autorise uniquement les éléments créatifs avec le "Video Standard VAST" sous-type multimédia

$ cat placement
{
    "placement": {
        "name": "Placement for Standard VAST Video",
        "publisher_id": 585173,
        "supported_media_subtypes": [
            {
                "id": 64
            }
        ],
        "video": {
        "id": 5,
        "width": 750,
        "max_duration_secs": 30,
        "supports_skippable": true,
        "player_vast_version": "3.0",
        "context": "pre-roll",
        "playback_method": null,
        "frameworks": [
          "vpaid_1_0",
          "vpaid_2_0",
          "mraid_1",
          "ormma",
          "mraid_2"
          ]
      }
    }
}
 
$ curl -b cookies -c cookies -X POST -d @placement 'https://api.appnexus.com/placement?publisher_id=585173'
 
{
  "response": {
    "status": "OK",
    "count": 1,
    "id": 5078562,
    "start_element": 0,
    "num_elements": 100,
    "placement": {
      "id": 5078562,
      "name": "Placement for Standard VAST Video",
      "code": null,
      "code2": null,
      "code3": null,
      "state": "active",
      "cost_cpm": null,
      "publisher_id": 585173,
      "content_retrieval_timeout_ms": 0,
      "enable_for_mediation": true,
      "is_prohibited": false,
      "site_id": 1275896,
      "default_referrer_url": null,
      "reserve_price": null,
      "width": 1,
      "height": 1,
      "default_position": "unknown",
      "default_creative_id": null,
      "ad_profile_id": null,
      "acb_code": null,
      "tag_data": null,
      "hide_referer": false,
      "inventory_source_id": null,
      "pixel_url": null,
      "pixel_type": "image",
      "last_modified": "2015-07-07 20:44:42",
      "media_subtypes": null,
      "intended_audience": null,
      "audited": false,
      "audit_level": "site",
      "default_calculation_type": "gross",
      "publisher_name": "National Public Radio",
      "site_name": "[National Public Radio] - ROS",
      "site_audit_status": "unaudited",
      "member_id": 958,
      "demand_filter_action": "default",
      "visibility_profile_id": null,
      "is_resizable": false,
      "pixel_url_secure": null,
      "floor_application_target": "all",
      "client_js_tracking_pct": 0,
      "use_detected_domain": true,
      "pop_values": null,
      "toolbar": null,
      "inventory_attributes": null,
      "supported_media_types": null,
      "supported_media_subtypes": [
        {
          "id": 64,
          "name": "Standard VAST",
          "media_type": {
            "id": 4
          }
        }
      ],
      "content_categories": null,
      "segments": null,
      "estimated_clear_prices": [
        {
          "clear_price": 1,
          "average_price": 0.5,
          "width": 0,
          "height": 0,
          "verified": true
        }
      ],
      "filtered_advertisers": null,
      "filtered_line_items": null,
      "filtered_campaigns": null,
      "default_creatives": null,
      "private_sizes": null,
      "video": {
        "id": 9,
        "width": 750,
        "max_duration_secs": 30,
        "supports_skippable": true,
        "context": "pre-roll",
        "playback_method": null,
        "frameworks": [
          "vpaid_1_0",
          "vpaid_2_0",
          "mraid_1",
          "ormma",
          "mraid_2"
        ]
      }
    }
  }
}

Ajout d’un placement de pod publicitaire qui autorise un pare-chocs d’introduction

$ cat placement
{
    "placement": {
        "video": {
            "supports_skippable": false,
            "player_vast_version": "3.0",
            "playback_method": null,
            "max_duration_sec": 200,
            "maximum_number_ads": 20,
            "context": "mid-roll",
            "start_delay_secs": 30,
            "frameworks": [
                "vpaid_2_0"
            ],
            "video_bumpers": [
                {
                    "video_bumper_type": "outro",
                    "max_duration_secs": 30
                }
            ]
        }
    }
}
 
$ curl -b cookies -c cookies -X POST -d @placement 'https://api.appnexus.com/placement?publisher_id=626425'
 
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": "11323022",
        "start_element": 0,
        "num_elements": 100,
        "placement": {
            "id": 11323022,
            "name": "Ad Pod Placement",
            "code": null,
            "code2": null,
            "code3": null,
            "state": "active",
            "cost_cpm": null,
            "publisher_id": 626425,
            "content_retrieval_timeout_ms": 0,
            "enable_for_mediation": true,
            "is_prohibited": false,
            "site_id": 1433875,
            "default_referrer_url": null,
            "reserve_price": null,
            "width": 1,
            "height": 1,
            "default_position": "unknown",
            "default_creative_id": null,
            "ad_profile_id": null,
            "acb_code": null,
            "tag_data": null,
            "hide_referer": false,
            "exclusive": false,
            "pixel_url": null,
            "pixel_type": "image",
            "last_modified": "2017-05-23 15:27:18",
            "media_subtypes": null,
            "intended_audience": null,
            "audited": false,
            "audit_level": "site",
            "default_calculation_type": "gross",
            "publisher_name": "New_Publisher",
            "site_name": "[New_Publisher] - ROS",
            "site_audit_status": "unaudited",
            "member_id": 958,
            "demand_filter_action": "default",
            "visibility_profile_id": null,
            "is_resizable": false,
            "pixel_url_secure": null,
            "floor_application_target": "all",
            "client_js_tracking_pct": 0,
            "use_detected_domain": true,
            "auction_timeout_ms": null,
            "pop_values": null,
            "toolbar": null,
            "inventory_attributes": null,
            "supported_media_types": null,
            "supported_media_subtypes": [
                {
                    "id": 64,
                    "is_private": false,
                    "name": "Standard VAST",
                    "media_type": {
                        "id": 4
                    }
                }
            ],
            "content_categories": null,
            "segments": null,
            "estimated_clear_prices": [
                {
                    "clear_price": 1,
                    "average_price": 0.5,
                    "width": 0,
                    "height": 0,
                    "verified": true,
                    "geo_country": ""
                }
            ],
            "filtered_advertisers": null,
            "filtered_line_items": null,
            "filtered_campaigns": null,
            "default_creatives": null,
            "private_sizes": null,
            "video": {
                "id": 282568,
                "width": null,
                "max_duration_secs": null,
                "supports_skippable": false,
                "context": "mid-roll",
                "playback_method": null,
                "maximum_number_ads": 20,
                "maximum_ad_duration_secs": null,
                "start_delay_secs": 30,
                "frameworks": [
                    "vpaid_2_0"
                ],
                "video_bumpers": [
                    {
                        "video_bumper_type": "outro",
                        "max_duration_secs": 30
                    }
                ]
            },
            "ad_types": null
        }
    }
}

Ajout d’un placement avec la fonctionnalité skipoffset activée

{
        "placement": {
            "id": 11633087,
            ...
            "video": {
                "id": 336328,
                "width": null,
                "max_duration_secs": 60,
                "supports_skippable": true,
                "player_vast_version": "3.0",
                "context": "pre-roll",
                "playback_method": null,
                "maximum_number_ads": 3,
                "maximum_ad_duration_secs": null,
                "start_delay_secs": null,
                "use_server_side_trackers": false,
                "frameworks": null,
                "video_bumpers": [
                    {
                        "video_bumper_type": "outro",
                        "max_duration_secs": 15
                    }
                ],
                "skipoffset_seconds": 10
            }
        }
}
  • Last updated on