Conversiones atributas al anunciante

Artículo
05/18/2024

El informe Conversiones con atributos de anunciante te permite ver los identificadores de píxel de conversión, los identificadores de pedido, los tiempos de clics o impresiones atribuidos y otra información relacionada con las conversiones atribudas de tus 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 pedido 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 se puede atribuir la conversión (vinculada a una creatividad que el usuario ha visto o en la que se ha hecho 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 vista se atribuye a la última impresión de una creatividad asociada al píxel de conversión. Para un píxel híbrido, la conversión se atribuye al último clic o, si no hubo clics, 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, consulte Atribución de conversión en la documentación de la interfaz de usuario.

Para obtener instrucciones sobre cómo recuperar un informe, consulte report service o ejemplos.

Este informe se filtra por identificador de miembro y de anunciante. El identificador de miembro se detecta en función de la autenticación del usuario de red, pero el identificador de anunciante 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 en los últimos 33 días. El timezone campo de la solicitud JSON solo UTCse puede establecer en , pero esto no es necesario, ya que la zona horaria tiene como valor predeterminado UTC 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 desactivó el píxel de conversión.
`day`	time	sí	`11/18/11`	El día del año en que se desactivó el píxel de conversión.
`hour`	time	sí	`11/18/11 6:00`	Hora del día en que se ha desencadenado el píxel de conversión.
`datetime`	date	sí	`11/18/11 6:00`	Fecha y hora en que se ha desencadenado el píxel de conversión.
`pixel_id`	Entero	sí	`9012`	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 identificador de pedido o la SKU se pasan opcionalmente en el píxel de conversión. Para obtener información sobre cómo pasar dinámicamente un identificador de pedido en un píxel de conversión, vea Conversión de píxeles avanzados en la documentación de la interfaz de usuario.
`external_data`	string	sí	`New York`	Opcionalmente, se pasan datos adicionales 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 dinámicamente datos externos en un píxel de conversión, vea Conversión de píxeles avanzados en la documentación de la interfaz de usuario.
`post_click_or_post_view_conv`	enumeración	sí	`Post Click`	Tipo de conversión. Si `"Post Click"`es , la conversión se atribuye a un usuario que hace clic en una creatividad. Si `"Post View"`es , la conversión se atribuye a un usuario que ve una creatividad. El tipo de conversión se define cuando el píxel de conversión se asigna a un elemento de línea.
`user_id`	Entero	sí	`433`	Identificador del usuario que ha hecho clic o ha visto la creatividad. Advertencia: Este campo ha quedado en desuso de la API (en cumplimiento con el RGPD) y ese servicio ha quedado en desuso.
`line_item_id`	Entero	sí	`12345`	Identificador del elemento de línea al que se asigna el píxel de conversión.
`line_item_name`	string	no	`LineItemName`	Nombre del elemento de línea.
`line_item`	string	no	`LineItemName (12345)`	En desuso (a partir del 17 de octubre de 2016).
`creative_id`	Entero	sí	`890123`	Identificador de la creatividad en la que se ha hecho clic o se ha visto. Nota: Para los rastreadores de clics o impresiones externos, `creative_id` será `"External Clicks"` o `"External Imps"`.
`creative_name`	string	no	`CreativeName`	Nombre de la creatividad.
`creative`	string	no	`CreativeName (890123)`	En desuso (a partir del 17 de octubre de 2016).
`campaign_id`	Entero	sí	`456789`	Identificador de la campaña a la que pertenece el creativo.
`campaign_nam`e	string	no	`CampaignName`	Nombre de la campaña a la que pertenece el creativo.
`campaign`	string	no	`CampaignName (456789)`	En desuso (a partir del 17 de octubre de 2016).
`split_id`	Entero	sí	`342`	Identificador de la división que compró las impresiones en este conjunto de datos. Las divisiones solo se aplican a los elementos de línea aumentadas. En el caso de los informes que contengan campañas, el `split_id` valor (si se incluye) será null.
`split_name`	string	sí	`"Mobile Split A"`	Nombre de la división que compró las impresiones en este conjunto de datos. Las divisiones solo se aplican a los elementos de línea aumentadas. En el caso de los informes que contengan campañas, el `split_name` valor (si se incluye) será null.
`imp_time`	date	sí	`11/17/11 3:00`	Fecha y hora de la impresión (cuando se sirvió la creatividad).
`imp_type_id`	Entero	sí	`5`	Identificador del tipo de impresión. Valores posibles (tipos asociados entre paréntesis): - `1 ("Blank")`: no se sirve creativo. - `2 ("PSA")`: se sirvió un anuncio de servicio público porque no había ofertas válidas y no había ninguna creatividad predeterminada disponible. - `3 ("Default Error")`: una creatividad predeterminada que se sirve debido a un problema de tiempo de espera. - `4 ("Default")`: un creativo predeterminado servido porque no había ofertas válidas. - `5 ("Kept")`: la creatividad de su anunciante se ha servido en el sitio de su editor. - `6 ("Resold")`: la impresión del editor se vendió a un comprador de terceros. - `7 ("RTB")`: la creatividad de su anunciante 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 a la falta de una creatividad predeterminada. - `9 ("External Impression")`: una impresión de un rastreador de impresiones. - `10 ("External Click")`: un clic de un seguimiento de clics.
`imp_type`	string	sí	`"Kept"`	Tipo de impresión. Para obtener los valores posibles, vea `imp_type_id`.
`advertiser_id`	Entero	sí	`123`	El identificador del anunciante.
`advertiser_name`	string	no	`AdvertiserName`	Nombre del anunciante.
`advertiser`	string	no	`AdvertiserName (123)`	En desuso (a partir del 17 de octubre de 2016).
`buyer_member_id`	Entero	sí	`4567`	Identificador del miembro que compró la impresión.
`auction_id`	Entero	sí	`6442894461734786633`	Identificador del evento de impresión. Nota: Los clientes que se suscriben a fuentes de distribución de datos de nivel de registro pueden usar este identificador para solicitar información adicional sobre la impresión, como geografía y explorador.

Métricas

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

Ejemplos

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

Uso del 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 dirección 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, use el Servicio de búsqueda para asignar identificadores de objetos a otros datos pertinentes, 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 de informe, pero esta vez al report-download servicio. Puede encontrar el servicio y el identificador de informe en el campo url 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.

$ 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.

Compartir a través de

Conversiones atributas al anunciante

Período de tiempo y zona horaria

Período de retención de datos

Dimensions

Métricas

Ejemplos

Create una solicitud de informe con formato JSON

`POST` la solicitud al servicio de informes

Uso del identificador de informe para recuperar los datos del informe

`GET` los datos del informe del servicio de descarga de informes

Recursos adicionales

Compartir a través de

Conversiones atributas al anunciante

Período de tiempo y zona horaria

Período de retención de datos

Dimensions

Métricas

Ejemplos

Create una solicitud de informe con formato JSON

POST la solicitud al servicio de informes

Uso del identificador de informe para recuperar los datos del informe

GET los datos del informe del servicio de descarga de informes

Recursos adicionales

`POST` la solicitud al servicio de informes

`GET` los datos del informe del servicio de descarga de informes