Búsqueda creativa de red

Nota:

Este servicio está disponible actualmente para un conjunto limitado de clientes y empleados de Microsoft.

El informe Búsqueda creativa de red se puede usar para ver la lista de creatividades que han servido en el inventario dentro de la red.

Para obtener instrucciones sobre cómo recuperar un informe, consulte Report Service o el ejemplo siguiente.

Período de tiempo

El report_interval campo de la solicitud JSON se puede establecer en uno de los siguientes:

  • "hoy"
  • "Ayer"
  • "last_7_days"
  • "last_30_days"
  • "last_100_days"

Dimensions

Column Tipo Ejemplo Descripción
day time "2010-02-01" El día de la subasta.

Filtro: No
month time "2010-02" El mes de la subasta.

Filtro: No
buyer_member_id Entero 123 Identificador del miembro de compra. Si no se compró la impresión, este campo muestra uno de los valores siguientes:
229 = PSA
0 = En blanco
319 = Valor predeterminado

Filtro: Sí
seller_member_id Entero 456 Identificador del miembro vendedor.

Filtro: Sí
publisher_id Entero 321 Identificador del publicador.

Filtro: Sí
creative_id Entero 654 Identificador de la creatividad.

Filtro: Sí
site_id Entero 194 Identificador del sitio.

Nota: Para las impresiones RTB anteriores a 30 días, site_id será 0.

Filtro: Sí
brand_id Entero 3 Identificador de la marca asociada a la creatividad.

Filtro: Sí
width Entero 250 Ancho de la creatividad.

Filtro: Sí
height Entero 300 El alto de la creatividad.

Filtro: Sí
tag_id Entero 491 Identificador de la etiqueta.

Filtro: Sí
media_subtype_id Entero 491 Identificador del subtipo multimedia asociado a la creatividad.

Filtro: Sí
audit_status string "audited" Estado de auditoría del creativo. Posibles valores:
- "pending"
- "audited"
- "unauditable"

Filtro: Sí
format string "raw-html" El formato de la creatividad. Posibles valores:
- "image"
- "raw-js"
- "raw-html"
- "iframe-html"

Filtro: Sí

Métricas

Column Tipo Ejemplo Fórmula Descripción
imps Entero 2340 Duendes El número total de impresiones (servidas y revendidas).

Ejemplo

  1. Creación de una solicitud de informe con formato JSON

    El archivo JSON debe incluir , report_type"network_creative_search"así como las columnas (dimensiones y métricas) y report_interval que desea recuperar. También puede filtrar por dimensiones específicas, definir granularidad (month, day) y especificar el formato en el que se deben devolver los datos (csv, excelo html). Para obtener una explicación completa de los campos que se pueden incluir en el archivo JSON, consulte Report Service.

    $ cat network_creative_search
{
        "report":
        {
                "report_type":"network_creative_search",
                "columns":[
                        "day",
                        "seller_member_id",
                        "buyer_member_id",
                        "publisher_id",
                        "creative_id",
                        "brand_id",
                        "media_subtype_id",
                        "imps"
                ],
                "report_interval":"today",
                "format":"csv"
        }
}

  2. POST la solicitud al servicio de informes

    $ curl -b cookies -c cookies -X POST -d @network_creative_search 'https://api.appnexus.com/report'
{
   "response":{
      "status":"OK",
      "report_id":"9b52ff138e5f9c822bdd8eee4119acf2"
   }
}

  3. GET estado del informe del servicio de informes

    Realice una GET llamada con el identificador de informe para recuperar el estado del informe. Continúe realizando esta GET llamada hasta que execution_status esté "listo". A continuación, use el servicio de descarga de informes para guardar los datos del informe en un archivo, como se describe en el paso siguiente.

    $ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=9b52ff138e5f9c822bdd8eee4119acf2'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on": "2013-03-19 18:42:33",
         "json_request": "{\"report\":{\"report_type\":\"network_creative_search\",\"columns\" [\"day\",\"seller_member_id\",\"buyer_member_id\",\"publisher_id\",\"creative_id\",
         \"brand_id\",\"media_subtype_id\",\"imps\"],\"report_interval\":\"today\",\"format\":\"csv\",\"filters\":[{\"seller_member_id\":\"1066\"}]}}",
         "url": "report-download?id=9b52ff138e5f9c822bdd8eee4119acf2"
      },
      "execution_status":"ready"
   }
}

  4. GET los datos del informe del servicio de descarga de informes

    Para descargar los datos del informe en un archivo, realice otra GET llamada con el identificador de informe, pero esta vez al servicio de descarga de informes . Puede encontrar el servicio y el identificador de informe en el url campo de la respuesta anterior GET . Al identificar el archivo en el que desea guardar, asegúrese de usar la extensión de archivo de "format" que especificó en su inicial POST.

    Nota:

    Si se produce un error durante la descarga, el encabezado de respuesta incluirá un código de error HTTP y un mensaje. Use -i o -v en la llamada para exponer el encabezado de respuesta.

    $ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=9b52ff138e5f9c822bdd8eee4119acf2' > /tmp/network_creative.csv
  • Last updated on