Leer en inglés

Compartir a través de


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
    }
}