Servicio de etiquetas
Este servicio de solo lectura le permite ver las etiquetas que se pueden aplicar a los anunciantes, pedidos de inserción, artículos de línea, campañas y publicadores. También permite ver las etiquetas que ya se han aplicado.
Un ejemplo de etiqueta de anunciante es "Salesperson". Puede usar esta etiqueta para especificar el nombre del vendedor responsable de cada uno de los anunciantes. Después, puede ejecutar el informe de Network Analytics filtrado por "salesperson_for_advertiser" para centrarse en los anunciantes de los que es responsable un vendedor determinado o agruparlo por "salesperson_for_advertiser" para clasificar el rendimiento de los vendedores.
Actualmente, los informes siguientes admiten etiquetas: Network Analytics, Network Advertiser Analytics y Advertiser Analytics. Para obtener la lista completa de columnas de informe asociadas a etiquetas, consulte "report_field" a continuación.
API de REST
| Http (método) | Endpoint | Description |
|---|---|---|
GET |
https://api.appnexus.com/label | Ver todas las etiquetas disponibles. |
GET |
https://api.appnexus.com/label?id=LABEL_ID | Ver una etiqueta específica. |
GET |
https://api.appnexus.com/label?show_values=true&object_type=OBJECT_TYPE | Vea las etiquetas que se aplican a un tipo de objeto específico. Nota: Están disponibles los siguientes tipos de objeto: advertiser, publisher, line_item, campaigny insertion_order. |
Campos JSON
| Campo | Tipo | Descripción |
|---|---|---|
id |
Entero | Identificador de la etiqueta. Valores posibles: 1, 2, , 43, 5, 7, 8, , 9, 11, 12, 14, , 15. 16 |
is_user_associated |
booleano | Este campo es específico de . Si truees , la etiqueta está asociada a una persona (es decir, "Salesperson" o "Account Manager") y permitirá la finalización automática del valor de la etiqueta por el nombre, apellido de un usuario. |
is_reporting_enabled |
booleano | Si truees , la etiqueta está disponible para su uso en los informes. |
last_modified |
Timestamp | Fecha y hora en que se modificó por última vez la etiqueta. |
member_id |
Entero | Dado que todas las etiquetas están disponibles actualmente para todos los miembros, este campo siempre será NULL. En el futuro, puede ser posible que un miembro cree etiquetas únicas, en cuyo caso este campo devolverá el identificador del miembro propietario. |
name |
string | Nombre de la etiqueta. Valores posibles: "Salesperson", "Account Manager", "Trafficker", "Sales Rep", "Test/Control", o "Campaign Type""Advertiser Type". Para obtener id/object_type/nameasignaciones, consulte el primer ejemplo siguiente. |
object_type |
enumeración | Tipo de objeto al que se puede aplicar la etiqueta. Valores posibles: "advertiser", "insertion_order", "line_item", "campaign"o "publisher". Para obtener id/object_type/nameasignaciones, consulte el primer ejemplo siguiente. |
report_field |
string | Columna de informe con la que puede informar en la etiqueta. Posibles columnas de informe (con informes correspondientes): - salesperson_for_advertiser (Análisis de red)- salesperson_for_publisher (Análisis de red)- account_manager_for_advertiser (Análisis de red)- account_manager_for_publisher (Análisis de red)- trafficker_for_line_item (Network Analytics, Network Advertiser Analytics)- salesrep_for_line_item (Network Analytics, Network Advertiser Analytics)- user_group_for_campaign (Análisis de red, Análisis de anunciantes de red, Análisis de anunciantes)- advertiser_type (Network Analytics, Network Advertiser Analytics)- line_item_type (Network Analytics, Network Advertiser Analytics)- insertion_order_type (Network Analytics, Network Advertiser Analytics) |
values |
matriz de objetos | Este campo se devuelve cuando se usa la solicitud GEThttps://api.appnexus.com/label?show_values=true& object_type=OBJECT_TYPE. Para obtener más información, vea Valores y el segundo ejemplo siguiente. |
Valores
| Campo | Tipo | Descripción |
|---|---|---|
object_id |
Entero | Identificador del objeto al que se aplica la etiqueta. Por ejemplo, si object_type es "advertiser", object_id sería el ID del anunciante. |
value |
string | Valor asignado a la etiqueta. Por ejemplo, para la etiqueta del publicador "Salesperson" , sería un nombre como "Michael Sellers". |
Ejemplos
Ver todas las etiquetas disponibles
$ curl -b cookies -c cookies 'https://api.appnexus.com/label'
{
"response": {
"status": "OK",
"labels": [
{
"id": 1,
"name": "Salesperson",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "advertiser",
"report_field": "salesperson_for_advertiser",
"last_modified": "2010-09-14 22:12:38"
},
{
"id": 2,
"name": "Salesperson",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "publisher",
"report_field": "salesperson_for_publisher",
"last_modified": "2010-09-14 22:12:43"
},
{
"id": 3,
"name": "Account Manager",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "advertiser",
"report_field": "account_manager_for_advertiser",
"last_modified": "2010-09-14 22:12:47"
},
{
"id": 4,
"name": "Account Manager",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "publisher",
"report_field": "account_manager_for_publisher",
"last_modified": "2010-09-14 22:12:51"
},
{
"id": 5,
"name": "Region",
"member_id": null,
"is_user_associated": false,
"is_reporting_enabled": true,
"object_type": "advertiser",
"report_field": "region_for_advertiser",
"last_modified": "2011-01-21 19:39:37"
},
{
"id": 7,
"name": "Trafficker",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "line_item",
"report_field": "trafficker_for_line_item",
"last_modified": "2011-05-31 16:11:21"
},
{
"id": 8,
"name": "Sales Rep",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "line_item",
"report_field": "salesrep_for_line_item",
"last_modified": "2011-05-31 16:11:29"
},
{
"id": 9,
"name": "Test/Control",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "campaign",
"report_field": "user_group_for_campaign",
"last_modified": "2011-12-06 18:07:44"
},
...
],
"count": 10,
"start_element": 0,
"num_elements": 100
}
}
Visualización de las etiquetas que se aplican a los anunciantes
$ curl -b cookies -c cookies 'https://api.appnexus.com/label?show_values=true&object_type=advertiser'
{
"response": {
"status": "OK",
"labels": [
{
"id": 1,
"name": "Salesperson",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "advertiser",
"report_field": "salesperson_for_advertiser",
"values": [
{
"object_id": "7669",
"value": "Phillip Turner"
},
{
"object_id": "7670",
"value": "Ami Kraft"
},
{
"object_id": "7713",
"value": "Michelle Jacobs"
},
{
"object_id": "7719",
"value": "Michelle Jacobs"
},
{
"object_id": "7759",
"value": "Phillip Turner"
},
{
"object_id": "7760",
"value": "Phillip Turner"
},
{
"object_id": "7761",
"value": "Ami Kraft"
}
],
"last_modified": "2011-12-18 20:13:32"
},
{
"id": 3,
"name": "Account Manager",
"member_id": null,
"is_user_associated": true,
"is_reporting_enabled": true,
"object_type": "advertiser",
"report_field": "account_manager_for_advertiser",
"values": [
{
"object_id": "7669",
"value": "Tina Rivera"
},
{
"object_id": "7670",
"value": "Richard Seiken"
},
{
"object_id": "7713",
"value": "Richard Seiken"
},
{
"object_id": "7719",
"value": "Norman Fischer"
},
{
"object_id": "7759",
"value": "Norman Fischer"
},
{
"object_id": "7760",
"value": "Tina Revera"
},
{
"object_id": "7761",
"value": "Norman Fisher"
}
],
"last_modified": "2010-09-28 20:13:32"
}
],
"count": 2,
"start_element": null,
"num_elements": null
}
}