Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 | sí | 11/1/11 |
El mes y el año en que se activó el píxel de conversión. |
day |
time | sí | 11/18/11 |
El día del año en que se activó el píxel de conversión. |
hour |
time | sí | 11/18/11 6:00 |
La hora del día en que se activó el píxel de conversión. |
datetime |
date | sí | 11/18/11 6:00 |
La fecha y hora en que se activó el píxel de conversión. |
pixel_id |
Entero | sí | 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 | sí | 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 | sí | 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 | sí | 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 | sí | 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 | sí | 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 | sí | 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 | sí | 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 | sí | 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 | sí | "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 | sí | 11/17/11 3:00 |
La fecha y hora de la impresión (cuando se sirvió la creatividad). |
imp_type_id |
Entero | sí | 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 | sí | "Kept" |
El tipo de impresión. Para conocer los posibles valores, consulta imp_type_id. |
advertiser_id |
Entero | sí | 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 | sí | 4567 |
El Id. del miembro que compró la impresión. |
auction_id |
Entero | sí | 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.