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.
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 , campaign y insertion_order . |
Campo | Tipo | Descripción |
---|---|---|
id |
Entero | Identificador de la etiqueta. Valores posibles: 1 , 2 , , 4 3 , 5 , 7 , 8 , , 9 , 11 , 12 , 14 , , 15 . 16 |
is_user_associated |
booleano | Este campo es específico de . Si true es , 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 true es , 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 /name asignaciones, 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 /name asignaciones, 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 GET https://api.appnexus.com/label?show_values=true& object_type=OBJECT_TYPE. Para obtener más información, vea Valores y el segundo ejemplo siguiente. |
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" . |
$ 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
}
}
$ 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
}
}