Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Avant de créer des objets via l’API, il est recommandé de configurer entièrement le membre en premier. La raison en est qu’il existe des valeurs par défaut qui peuvent être spécifiées au niveau d’un membre qui sont en cascade vers des objets enfants sous le membre.
Il existe un certain nombre de paramètres différents qui peuvent être configurés au niveau du membre :
Aucune priorité de revente
Ce paramètre, stocké dans le "no_reselling_priority" paramètre , spécifie la priorité à laquelle les impressions managées ne seront jamais revendues. Autrement dit, s’il y a une campagne à cette priorité ou au-dessus qui est éligible pour servir, elle servira toujours au-dessus des campagnes RTB d’autres acheteurs. Parmi les campagnes gérées de la même priorité, les mécanismes de vente aux enchères habituels s’appliquent toujours. L’exemple JSON ci-dessous montre comment définir ce paramètre.
{
"member": {
"no_reselling_priority": 5
}
}
Catégories de contenu
Ce paramètre, stocké dans le "content_categories" paramètre , définit la liste des catégories de contenu personnalisées qui peuvent être utilisées pour catégoriser l’inventaire managé.
Remarque
Ces catégories ne seront pas ciblées par d’autres acheteurs.
L’exemple JSON ci-dessous montre comment définir ce paramètre.
{
"member": {
"content_categories": [
{"id":"2950","name":"Animals"},
{"id":"2951","name":"Arts & Humanities"},
... ,
{"id":"2977","name":"Travel"}
]
}
}
Tailles standard
Ce paramètre, stocké dans le "standard_sizes" paramètre , spécifie les tailles de création et de placement qui sont affichées dans. L’exemple JSON ci-dessous montre comment définir ce paramètre.
{
"member": {
"standard_sizes": [
{"width": "120", "height": "600", "is_standard": true},
{"width": "160", "height": "600", "is_standard": true},
... ,
{"width": "728", "height": "90", "is_standard": true},
{"width": "800", "height": "60", "is_standard": false}
]
}
}
Timezone
Ce paramètre, stocké dans le "timezone" champ , définit le fuseau horaire par défaut qui sera appliqué aux objets nouvellement créés, sauf indication contraire au moment de leur création. Pour obtenir la liste des valeurs de fuseau horaire valides, consultez Fuseaux horaires d’API. L’exemple JSON ci-dessous montre comment définir ce paramètre.
{
"member": {
"timezone": "EST5EDT"
}
}
Dongle
Le dongle est utilisé comme mot de passe pour le débogage des enchères. Ce mot de passe est utilisé lors d’un appel de placement sur la chaîne de requête invitant notre plateforme à simuler une enchère et à afficher la façon dont nous enchérons sur cette étiquette. Il est utile pour déterminer pourquoi une campagne n’offre pas certains stocks. L’exemple JSON ci-dessous montre comment définir ce paramètre.
{
"member": {
"dongle": "keepitsecret"
}
}
Exposition de la plateforme
Le paramètre d’exposition de la plateforme détermine la façon dont votre compte est affiché aux autres membres de la plateforme. Il existe trois valeurs qui entraînent des comportements légèrement différents, comme indiqué ci-dessous :
| Valeur d’exposition de la plateforme | Comportement |
|---|---|
| public | Le membre s’affiche à l’aide du nom de facturation. |
| Privé | Le membre est affiché en tant que « Membre 123 », où 123 est l’ID de membre. |
| hidden | Le membre n’est pas affiché. |
L’exemple JSON ci-dessous montre comment définir ce paramètre.
{
"member": {
"platform_exposure": "public"
}
}
Devise par défaut
La devise par défaut, comme le fuseau horaire, est appliquée aux annonceurs et aux éléments de ligne, sauf indication contraire lors de la création de ces objets. L’exemple JSON ci-dessous montre comment définir ce paramètre.
{
"member": {
"default_currency": "USD"
}
}
Utiliser les ordres d’insertion
Ce paramètre, stocké dans le "use_insertion_orders" paramètre , spécifie si les ordres d’insertion doivent être utilisés sur tous les annonceurs au sein du compte. Ce paramètre est également disponible sur une base annonceur par annonceur. L’exemple JSON ci-dessous montre comment définir ce paramètre.
{
"member": {
"use_insertion_orders": false
}
}
Exemple de résumé
Vous trouverez ci-dessous un résumé des exemples JSON ci-dessus dans un objet membre unique. Pour cet exemple, la spécification de membre se trouve dans un fichier texte.
$cat member
{
"member": {
"no_reselling_priority": 5,
"content_categories": [
{"id":"2950","name":"Animals"},
{"id":"2951","name":"Arts & Humanities"},
... ,
{"id":"2977","name":"Travel"}
],
"standard_sizes": [
{"width": "120", "height": "600", "is_standard": true},
{"width": "160", "height": "600", "is_standard": true},
... ,
{"width": "728", "height": "90", "is_standard": true},
{"width": "800", "height": "60", "is_standard": false}
],
"timezone": "EST5EDT",
"dongle": "keepitsecret",
"platform_exposure": "public",
"default_currency": "USD",
"use_insertion_orders": false
}
}
Pour apporter les modifications, vous devez PUT spécifier le membre de l’API.
$ curl -b cookies -c cookies -X PUT --data-binary @member 'https://api.appnexus.com/member?id=123'
{
"response":{
"status": "OK",
"id": 1234
}
}
Pour vérifier que les modifications ont été apportées, vous pouvez extraire le membre de l’API à l’aide d’une GET requête.
$ curl -b cookies -c cookies 'https://api.appnexus.com/member?id=123'
{
"response": {
"status": "OK",
"member": {
"id": 123,
"name": "Member",
"whitelabel_support_email": null,
"reselling_description": null,
"state": "active",
"expose_ixi_support": false,
"enable_advertisers": true,
"no_reselling_priority": 5,
"entity_type": "reseller",
"expose_global_inventory_sources": true,
"buyer_clearing_fee_pct": null,
"default_placement_id": null,
"default_buyer_group_id": 0,
"max_daily_credit_pct": 0,
"interface_domain": null,
"interface_domain_beta": null,
"content_categories": [
{"id":"2950","name":"Animals"},
{"id":"2951","name":"Arts & Humanities"},
... ,
{"id":"2977","name":"Travel"}
],
"dw_member": true,
"contracts": [
{
"id": 75,
"start_date": "2010-01-01 00:00:00",
"end_date": null,
...
}
],
"default_inv_source_id": null,
"default_ad_profile_id": null,
"email_code": null,
"serving_domain": null,
"contract_approved": true,
"reselling_exposure": "public",
"reselling_exposed_on": "0000-00-00 00:00:00",
"last_modified": "2011-07-13 16:00:43",
"standard_sizes": [
{"width": "120", "height": "600", "is_standard": true},
{"width": "160", "height": "600", "is_standard": true},
... ,
{"width": "728", "height": "90", "is_standard": true},
{"width": "800", "height": "60", "is_standard": false}
],
"buyer_credit_limit": 1000000,
"timezone": "EST5EDT",
"seller_revshare_pct": 95,
"is_billable": true,
"note": null,
"default_country": null,
"dongle": "keepitsecret",
"primary_type": "buyer",
"platform_exposure": "public",
"contact_email": null,
"allow_ad_profile_override": true,
"account_owner_user": null,
"default_currency": "USD",
"use_insertion_orders": false,
"expose_optimization_levers": false,
"pops_enabled_UI": false,
"default_accept_supply_partner_usersync": true,
"default_accept_data_provider_usersync": true,
"default_accept_demand_partner_usersync": true,
"short_name": "",
"expose_eap_ecp_placement_settings": false,
"daily_imps_verified": null,
"daily_imps_self_audited": null,
"daily_imps_unaudited": null,
"is_iash_compliant": false,
"deal_types": null,
"allow_non_cpm_payment": true,
"default_allow_cpc": true,
"default_allow_cpa": true,
"visibility_profile_id": 15,
"inventory_trust": {
"default_trust": "appnexus",
"default_allow_unaudited": false,
"default_is_banned": false,
"members": [...]
},
"default_campaign_trust": "appnexus",
"default_campaign_allow_unaudited": false,
"contract_allows_unaudited": true,
"enable_budget_check": false,
"active_contract": {
"auditing_fee_per_creative": 1,
"creative_priority_fee_1": 25,
"creative_priority_fee_2": 25
},
"allow_priority_audit": false,
"enable_mobile_ui": false,
"audit_notify_email": null,
"default_external_audit": false,
"contact_info": null
},
"count": 1,
"start_element": null,
"num_elements": null,
"dbg_info": {
...
}
}
}