Configuración de miembro
Antes de crear cualquier objeto a través de la API, se recomienda configurar completamente el miembro primero. El motivo es que hay valores predeterminados que se pueden especificar en un nivel de miembro que se convierten en cascada en objetos secundarios en el miembro.
Hay varios parámetros diferentes que se pueden configurar en el nivel de miembro:
No hay prioridad de reventa
Esta configuración, almacenada en el "no_reselling_priority" parámetro , especifica la prioridad a la que nunca se revenderán las impresiones administradas. Dicho de otro modo, si hay una campaña en o por encima de esta prioridad que es apta para servir, siempre servirá por encima de cualquier campaña RTB de otros compradores. Entre las campañas administradas de la misma prioridad, siguen aplicándose las mecánicas habituales de las subastas. En el json de ejemplo siguiente se muestra cómo establecer este parámetro.
{
"member": {
"no_reselling_priority": 5
}
}
Categorías de contenido
Este parámetro, almacenado en el "content_categories" parámetro , define la lista de categorías de contenido personalizadas que se pueden usar para clasificar el inventario administrado.
Nota:
Estas categorías no serán dirigidas por otros compradores.
En el json de ejemplo siguiente se muestra cómo establecer este parámetro.
{
"member": {
"content_categories": [
{"id":"2950","name":"Animals"},
{"id":"2951","name":"Arts & Humanities"},
... ,
{"id":"2977","name":"Travel"}
]
}
}
Tamaños estándar
Esta configuración, almacenada en el "standard_sizes" parámetro , especifica los tamaños creativos y de ubicación que se muestran en . En el json de ejemplo siguiente se muestra cómo establecer este parámetro.
{
"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
Este parámetro, almacenado en el "timezone" campo, define la zona horaria predeterminada que se aplicará a los objetos recién creados a menos que se especifique lo contrario en el momento de su creación. Para obtener una lista de valores de zona horaria válidos, consulte Zonas horarias de API. En el json de ejemplo siguiente se muestra cómo establecer este parámetro.
{
"member": {
"timezone": "EST5EDT"
}
}
Dongle
El dongle se usa como contraseña para las subastas de depuración. Esta contraseña se usa en una llamada de selección de ubicación en la cadena de consulta que solicita a nuestra plataforma que simule una subasta y muestre cómo estamos pujando por esa etiqueta. Es útil para determinar por qué una campaña no está pujando por cierto inventario. En el json de ejemplo siguiente se muestra cómo establecer este parámetro.
{
"member": {
"dongle": "keepitsecret"
}
}
Exposición de la plataforma
La configuración de exposición de la plataforma determina cómo se muestra la cuenta a otros miembros de la plataforma. Hay tres valores que dan lugar a comportamientos ligeramente diferentes, como se describe a continuación:
| Valor de exposición de la plataforma | Comportamiento |
|---|---|
| public | El miembro se muestra con el nombre de facturación. |
| Privado | El miembro se muestra como "Miembro 123", donde 123 es el identificador de miembro. |
| hidden | No se muestra el miembro. |
En el json de ejemplo siguiente se muestra cómo establecer este parámetro.
{
"member": {
"platform_exposure": "public"
}
}
Moneda predeterminada
La moneda predeterminada, como la zona horaria, se aplica a anunciantes y artículos de línea a menos que se especifique lo contrario al crear esos objetos. En el json de ejemplo siguiente se muestra cómo establecer este parámetro.
{
"member": {
"default_currency": "USD"
}
}
Uso de pedidos de inserción
Esta configuración, almacenada en el "use_insertion_orders" parámetro , especifica si se deben usar o no pedidos de inserción en todos los anunciantes de la cuenta. Esta configuración también está disponible para anunciante por anunciante. En el json de ejemplo siguiente se muestra cómo establecer este parámetro.
{
"member": {
"use_insertion_orders": false
}
}
Ejemplo de resumen
A continuación se muestra un resumen de los ejemplos JSON anteriores en un único objeto miembro. En este ejemplo, la especificación de miembro está en un archivo de texto.
$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
}
}
Para realizar las modificaciones, debe PUT especificar el miembro en la API.
$ curl -b cookies -c cookies -X PUT --data-binary @member 'https://api.appnexus.com/member?id=123'
{
"response":{
"status": "OK",
"id": 1234
}
}
Para comprobar que se realizaron los cambios, puede extraer el miembro de la API mediante una GET solicitud.
$ 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": {
...
}
}
}