Conversiones atribuidas del anunciante

El informe Conversiones atribuidas del anunciante le permite ver los identificadores de píxel de conversión, los identificadores de pedido, las horas de clics o impresiones atribuidos y otra información relacionada con las conversiones atribuidas de sus anunciantes.

Nota:

Los píxeles de conversión se usan para realizar un seguimiento de las acciones en las páginas web de los anunciantes, como registrarse o realizar una compra. Se pueden configurar para pasar valores de identificador de orden dinámicos, lo que ayuda a las redes a conciliarse con los anunciantes. Una vez que se activa un píxel de conversión, Xandr determina si la conversión se puede atribuir (vinculada a una creatividad que el usuario vio o en la que hizo clic anteriormente). Una conversión posterior al clic se atribuye al último clic en una creatividad asociada al píxel de conversión. Una conversión posterior a la visualización se atribuye a la última impresión de una creatividad asociada al píxel de conversión. En el caso de un píxel híbrido, la conversión se atribuye al último clic o, si no los hubo, a la última impresión de una creatividad asociada al píxel de conversión.

Para obtener más información sobre nuestro proceso de atribución, consulta Atribución de conversiones en la documentación de la interfaz de usuario.

Para obtener instrucciones sobre cómo recuperar un informe, consulte el servicio de informes o los ejemplos.

Este informe se filtra por id. de miembro e id. de anunciante. El id. de miembro se detecta en función de la autenticación del usuario de red, pero debe especificarse como parte de la dirección URL, por ejemplo:

https://api.appnexus.com/report?advertiser_id=ADVERTISER_ID

Período de tiempo y zona horaria

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

  • current_hour
  • last_hour
  • hoy
  • yesterday
  • last_48_hours
  • last_7_days
  • last_30_days
  • month_to_yesterday
  • month_to_date
  • last_30_days

Como alternativa, los start_date campos y end_date se pueden establecer en un intervalo de los últimos 33 días. El timezone campo de la solicitud JSON solo se puede establecer en UTC, pero esto no es necesario, ya que la zona horaria se UTC establece de forma predeterminada si no se especifica.

Período de retención de datos

Este informe puede recuperar datos de los últimos 90 días y solo en la zona horaria UTC.

Dimensions

Column Tipo ¿Filtro? Ejemplo Descripción
month time 11/1/11 El mes y el año en que se activó el píxel de conversión.
day time 11/18/11 El día del año en que se activó el píxel de conversión.
hour time 11/18/11 6:00 La hora del día en que se activó el píxel de conversión.
datetime date 11/18/11 6:00 La fecha y hora en que se activó el píxel de conversión.
pixel_id Entero 9012 El identificador del píxel de conversión.
pixel_name string no PixelName Nombre del píxel de conversión.
pixel string no PixelName (9012) En desuso (a partir del 17 de octubre de 2016).
order_id Entero 678 El id. de pedido o SKU que se pasa opcionalmente en el píxel de conversión. Para obtener información sobre cómo pasar dinámicamente un ID de pedido en un píxel de conversión, consulte Píxeles de conversión avanzados en la documentación de la interfaz de usuario.
external_data string New York Datos adicionales que se pasan opcionalmente en el píxel de conversión, por ejemplo, la geografía de conversión, un código de afiliado u otra información relacionada con la venta o el usuario. Para obtener información sobre cómo pasar datos externos dinámicamente en un píxel de conversión, consulte Píxeles de conversión avanzados en la documentación de la interfaz de usuario.
post_click_or_post_view_conv enumeración Post Click El tipo de conversión que se ha producido.
- Posterior al clic: la conversión se atribuye a que un usuario hace clic en una creatividad.
- Vista posterior: la conversión se atribuye a un usuario que está viendo una creatividad.
- Entre dispositivos: se especifica adicionalmente, la conversión se atribuye a tener habilitado entre dispositivos.
- IP: especificada adicionalmente, la conversión se atribuye a tener habilitada la atribución de IP.
user_id Entero 433 Id. del usuario que ha hecho clic en la creatividad o la ha visto.

Advertencia: Este campo ha quedado en desuso de la API (en cumplimiento del RGPD) y ese servicio ha quedado en desuso.
line_item_id Entero 12345 El identificador del elemento de línea de pedido al que se asigna el píxel de conversión.
line_item_name string no LineItemName El nombre de la línea de pedido.
line_item string no LineItemName (12345) En desuso (a partir del 17 de octubre de 2016).
creative_id Entero 890123 El id. de la creatividad en la que se ha hecho clic o en la que se ha visto.

Nota: Para los rastreadores de clics o impresiones externas, creative_id será "External Clicks" o ."External Imps"
creative_name string no CreativeName El nombre del creativo.
creative string no CreativeName (890123) En desuso (a partir del 17 de octubre de 2016).
campaign_id Entero 456789 El identificador de la campaña a la que pertenece la creatividad.
campaign_name string no CampaignName El nombre de la campaña a la que pertenece la creatividad.
campaign string no CampaignName (456789) En desuso (a partir del 17 de octubre de 2016).
split_id Entero 342 El identificador de la división que compró las impresiones de este conjunto de datos. Las divisiones solo se aplican a las líneas de pedido aumentadas. Para cualquier informe que contenga campañas, el split_id valor (si se incluye) será nulo.
split_name string "Mobile Split A" El nombre de la división que compró las impresiones de este conjunto de datos. Las divisiones solo se aplican a las líneas de pedido aumentadas. Para cualquier informe que contenga campañas, el split_name valor (si se incluye) será nulo.
imp_time date 11/17/11 3:00 La fecha y hora de la impresión (cuando se sirvió la creatividad).
imp_type_id Entero 5 El identificador del tipo de impresión. Valores posibles (tipos asociados entre paréntesis):
- 1 ("Blank"): No se sirve ningún creativo.
- 2 ("PSA"): Se ha publicado un anuncio de servicio público porque no había pujas válidas y no había ningún creativo predeterminado disponible.
- 3 ("Default Error"): una creatividad predeterminada servida debido a un problema de tiempo de espera.
- 4 ("Default"): se publicó una creatividad predeterminada porque no había pujas válidas.
- 5 ("Kept"): El creativo de su anunciante se sirve en el sitio de su editor.
- 6 ("Resold"): La impresión del editor se vendió a un comprador externo.
- 7 ("RTB"): el recurso creativo del anunciante que se sirve en el inventario de terceros.
- 8 ("PSA Error"): Un anuncio de servicio público servido debido a un problema de tiempo de espera o falta de una creatividad predeterminada.
- 9 ("External Impression"): una impresión de un rastreador de impresiones.
- 10 ("External Click"): un clic de un rastreador de clics.
imp_type string "Kept" El tipo de impresión. Para conocer los posibles valores, consulta imp_type_id.
advertiser_id Entero 123 El identificador del anunciante.
advertiser_name string no AdvertiserName El nombre del anunciante.
advertiser string no AdvertiserName (123) En desuso (a partir del 17 de octubre de 2016).
buyer_member_id Entero 4567 El Id. del miembro que compró la impresión.
auction_id Entero 6442894461734786633 El id. del evento de impresión.

Nota: los clientes que se suscriban a fuentes de datos de nivel de registro pueden usar este ID para solicitar información adicional sobre la impresión, como la geografía y el explorador.

Métricas

Column Tipo Ejemplo Descripción
post_click_or_post_view_revenue dinero 3.00 Los ingresos se pasan opcionalmente en el píxel de conversión mediante el "value" parámetro.

Ejemplos

Crear una solicitud de informe con formato JSON

En este ejemplo, establecemos un filtro para obtener información sobre el píxel de conversión 9012.

$ cat attributed_conversions  {
    "report":
    {
        "report_type": "attributed_conversions",
        "columns": [
            "datetime",
            "pixel_id",
            "order_id",
            "post_click_or_post_view_conv",
            "post_click_or_post_view_revenue",
            "line_item_id",
            "creative_id",
            "campaign_id",
            "imp_time",
            "imp_type_id",
            "advertiser_id",
            "buyer_member_id"
        ],
        "filters": [{"pixel_id": 9012}],
        "report_interval": "last_7_days",
        "emails": ["js@email.com"],
        "format": "csv"
    }
}

POST la solicitud al servicio de informes

$ curl -b cookies -c cookies -X POST -d @attributed_conversions 'https://api.appnexus.com/report?advertiser_id=123'

{
    "response":{
        "status":"OK",
        "report_id":"07af1282c9485adcef49c95fa5d7496b"
    }
}

Usar el identificador de informe para recuperar los datos del informe

La respuesta estándar incluye los datos del informe y una dirección URL de descarga que puede usar para guardar los datos en un archivo. Si desea obtener solo la URL de descarga sin los datos del informe, pase "without_data" la cadena de consulta.

$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=07af1282c9485adcef49c95fa5d7496b'

{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2011-11-22 23:51:22",
            "cache_hit": false,
            "fact_cache_hit": false,
            "json_request": "{\"report\":{\"report_type\":\"attributed_conversions\",\"columns\":
             [\"datetime\",\"pixel_id\",\"order_id\",\"post_click_or_post_view_conv\",
             \"post_click_or_post_view_revenue\",\"line_item_id\",\"creative_id\",\"campaign_id\",
             \"imp_time\",\"imp_type_id\",\"advertiser_id\",\"buyer_member_id\"],
             \"report_interval\":\"lifetime\",\"emails\":[\"js@email.com\"],\"filters\":
             [{\"buyer_member_id\":\"4567\"},{\"advertiser_id\":\"123\"}]}}",
            "header_info": "Report type:,conversion_pixel\u000d\u000a,\u000d\u000aRun at:,
             2011-11-22 23:51:22\u000d\u000aStart date:,2011-11-15 00:00:00\u000d\u000aEnd date:,
             2011-11-22 00:00:00\u000d\u000aTimezone:,\u000d\u000aUser:,John Smith (1432)
             \u000d\u000a",
            "data": "datetime,pixel_id,order_id,post_click_or_post_view_conv,
             post_click_or_post_view_revenue,line_item_id,creative_id,campaign_id,imp_time,
             imp_type_id,advertiser_id,buyer_member_id\u000d\u000a11704,8225230493273032227,
             123,8.7654A+32,4567,2011-11-18 06:00:13,2011-11-17 03:00:02,5,12345,678,9012,
             Post Click,.3.00\u000d\u000a11704,
             ..."
        },
        "execution_status": "ready",
        "dbg_info": {
            ...
        }
    }
}

Si es necesario, utilice el servicio de búsqueda para asignar identificadores de objetos a otros datos relevantes, como nombres, códigos y estados.

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 del informe, pero esta vez al report-download servicio. Puede encontrar el servicio y el ID del informe en el campo URL de la respuesta anterior GET . Al identificar el archivo en el que desea guardarlo, asegúrese de usar la extensión de archivo que especificó en POSTel "format" archivo .

$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/attributed_conversions.csv 

Nota:

Hay un límite de 100 000 filas por informe cuando se descargan como archivos XLSX y Excel.