API de plataforma digital: informe de dominio del sitio de vendedores
El informe de dominio del sitio de vendedores está diseñado para proporcionar a los vendedores información sobre qué tipo de inventario está llegando a través de un publicador. Por ejemplo, como vendedor, puede distribuir etiquetas de selección de ubicación a los publicadores y, a continuación, quiere comprobar que esas etiquetas se ejecutan en el inventario previsto. Además, este informe le permite:
- Vea qué tipo de inventario está llegando a través de un publicador para que pueda entender cómo valorarlo.
- Garantizar un cierto grado de calidad de inventario a los compradores administrados
- Optimización en dominios para campañas administradas
- Descripción del impacto empresarial de la auditoría y categorización de Xandr
Período de tiempo
El report_interval campo de la solicitud JSON se puede establecer en uno de los siguientes:
- yesterday
- last_7_days
- last_30_days
- last_month
- month_to_date
Nota:
Ninguno de los intervalos de tiempo disponibles incluirá los datos de hoy. Los datos más recientes serán de ayer.
Sugerencia
Para ejecutar un informe para un período de tiempo personalizado, establezca los campos y end_date en la start_date solicitud de informe. Para obtener más información sobre estos campos, vea Report Service.
Período de retención de datos
El período de retención de datos para este informe es de 60 días.
Dimensions
| Column | Tipo | ¿Filtro? | Ejemplo | Descripción |
|---|---|---|---|---|
month |
time | "2012-08-01" |
Mes en el que se produjo una impresión en esta ubicación. | |
day |
time | "2012-08-23" |
El día en que se produjo una impresión en esta ubicación. | |
seller_member_id |
Entero | Yes | 2718 |
Id. de miembro Xandr del vendedor. |
seller_member_name |
string | "MegaSeller" |
El nombre del vendedor. | |
seller_member |
string | "MegaSeller (2718)" |
En desuso (a partir del 17 de octubre de 2016). | |
content_category_id |
Entero | Yes | 23 |
Identificador de la categoría de contenido universal asociada al dominio auditado. |
content_category_name |
string | "Entertainment" |
Nombre de la categoría de contenido universal asociada al dominio auditado. | |
content_category |
string | "Entertainment (23)" |
En desuso (a partir del 17 de octubre de 2016). | |
site_id |
Entero | Yes | 223936 |
Identificador del sitio que contiene esta ubicación. |
site_name |
string | "Total-Web Email" |
Nombre del sitio donde se produjo la impresión. | |
site |
string | "Total-Web Email (223936)" |
En desuso (a partir del 17 de octubre de 2016). | |
site_domain |
string | Sí | "gwar-rules-forever.org" |
Dominio donde se produjo la impresión. Hay dos valores adicionales que pueden aparecer en lugar de un dominio, específicamente: "deals.unknown" o "managed.unknown". Esto significa que no recibimos un dominio válido como referencia. Por ejemplo, el dominio puede estar en blanco o de otro modo malformado.Nota: En algunos casos, este campo se rellenará con un dominio distinto de donde se produjo realmente la impresión, como un dominio de servidor de anuncios. Para obtener más información sobre por qué sucede esto, vea Pasar dominios entre IFrames a continuación. |
placement_id |
Entero | Yes | 737099 |
Identificador de la ubicación donde se produjo la impresión. Nota: placement_id de 0 puede aparecer para los rastreadores de impresiones de terceros. Para obtener más información sobre los rastreadores de impresiones, consulte el Servicio de seguimiento de impresiones. |
placement_name |
string | "Webmail.com ROS 728x90" |
Nombre de la ubicación donde se produjo la impresión. | |
placement |
string | "Webmail.com ROS 728x90 (737099)" |
En desuso (a partir del 17 de octubre de 2016). | |
publisher_id |
Entero | Yes | 44389 |
Identificador asociado al publicador en cuyo sitio se produjo la impresión. |
publisher_name |
string | "LOL - US" |
Nombre del publicador en cuyo sitio se produjo la impresión. | |
publisher |
string | "LOL - US (44389)" |
En desuso (a partir del 17 de octubre de 2016). | |
imp_type_id |
Entero | Yes | 6 |
Identificador del tipo de impresión. Valores posibles (tipos asociados entre paréntesis):1 ("En blanco"): sin creatividad.2 ("PSA"): un anuncio de servicio público se sirvió porque no había ofertas válidas y no había ninguna creatividad predeterminada disponible.3 ("Error predeterminado"): una creatividad predeterminada que se sirve debido a un problema de tiempo de espera.4 ("Valor predeterminado"): una creatividad predeterminada que se sirve porque no había pujas válidas.5 ("Guardado"): la creatividad de su anunciante se ha servido en el sitio del editor.6 ("Reventa"): la impresión del editor se vendió a un comprador de terceros.7 ("RTB"): la creatividad de su anunciante se ha servido en el inventario de terceros.8 ("Error de PSA"): un anuncio de servicio público servido debido a un problema de tiempo de espera o a la falta de una creatividad predeterminada.9 ("Impresión externa"): una impresión de un rastreador de impresiones.10 ("Clic externo"): un clic de un rastreador de clics. |
imp_type_name |
string | "Resold" |
Nombre del tipo de impresión que se produjo. Para obtener valores posibles y más información sobre cada tipo, vea imp_type_id. |
|
imp_type |
string | "Resold (6)" |
En desuso (a partir del 17 de octubre de 2016). | |
audit_type_id |
Entero | Yes | 3 |
Identificador del tipo de auditoría realizada en el dominio donde se produjo la impresión. |
audit_type_name |
string | "By AppNexus" |
Nombre del tipo de auditoría realizada en el dominio donde se produjo la impresión. Valores permitidos: - "By Seller": el dominio se auditó por sí mismo.- "By AppNexus": Xandr auditó el dominio.- "By Seller & AppNexus": el dominio fue auditado por el vendedor y Xandr.- "Unknown Audit Type": esto suele significar que el dominio no está auditado. En algunos casos, esto significa que el dominio no era auditable por razones técnicas. |
|
audit_type |
string | "By Seller (1)" |
En desuso (a partir del 17 de octubre de 2016). | |
exposed_for_resale_id |
Entero | Yes | 0 |
Entero que indica si este inventario se expone para reventa. Valores permitidos:0 (False)1 (True) |
exposed_for_resale |
string | "Not Exposed" |
Si este inventario se expone para reventa. Valores permitidos: - "Exposed"- "Not Exposed" |
|
domains_exposed_id |
Entero | Yes | 1 |
Entero que indica si los dominios de este inventario se exponen para que los compradores los dirijan. Valores permitidos: - 0 (False)- 1 (True) |
domains_exposed |
string | "Exposed" |
Si los dominios de este inventario se exponen para que los compradores los dirijan. Valores permitidos: - "Exposed"- "Not exposed" |
|
supply_type |
string | Sí | mobile_web |
El canal clasificado por el vendedor para denominar el suministro en términos de web, web optimizado para dispositivos móviles e impresiones de aplicaciones móviles. Los valores posibles son: - 'web' - 'mobile_app' - 'mobile_web' |
mobile_application_id |
string | Sí | ‘343200656’ (iOS) or ‘com.rovio.angrybirds’ (Android) |
Un identificador de apple App Store de destino, un nombre de paquete de Google Play o un identificador de aplicación de Windows. |
mobile_application_name |
string | Sí | Angry Birds |
Nombre de la aplicación móvil tal como aparece en Apple App y Google Play Stores. |
mobile_application |
string | No | Angry Birds (com.rovio.angrybirds) |
En desuso (a partir del 17 de octubre de 2016). |
fold_position_id |
Entero | Yes | 0 |
Identificador de la posición del pliegue, es decir, dónde se encuentra la ubicación en la página. Valores posibles para las impresiones: - 0 = "unknown"- 1 = "arriba"- 2 = "abajo" |
fold_position |
string | Sí | "Unknown" |
La posición del plegado, es decir, donde se encuentra la ubicación en la página. Para ver los valores permitidos, vea fold_position_id. |
age_bucket |
string | Sí | "25-34" |
Cubo para la antigüedad del usuario. Consulte Age Buckets (Depósitos de edad) a continuación para ver los valores posibles. Nota: Para las impresiones anteriores a 100 días, age_bucket será "unknown". |
age_bucket_id |
string | No | "3" |
Identificador del cubo de edad. Consulte Age Buckets (Depósitos de edad) a continuación para ver los valores posibles. Nota: Para las impresiones anteriores a 100 días, age_bucket_id será 0. |
gender |
string | Sí | "m", "f", "u" |
El sexo del usuario. Nota: Para las impresiones anteriores a 100 días, gender será "u". |
is_remarketing |
Entero | Yes | 0, 1 |
Si 1es , la campaña es de remarketing. Si 0es , la campaña no es de remarketing.Nota: Para las impresiones anteriores a 100 días, is_remarketing será -1. |
imps_filtered_reason_id |
Entero | Yes | "3" |
El identificador numérico asociado al motivo por el que los controles de calidad de inventario de Xandr filtraron la solicitud de impresión y no se realizó la subasta. Consulte imps_filtered_reason a continuación para obtener más información. |
imps_filtered_reason |
string | Sí | "Invalid Domain" |
La razón por la que la solicitud de impresión fue filtrada por los controles de calidad de inventario de Xandr y no se realizó la subasta. Las razones posibles son: - "Invalid Domain" (1)- "Invalid IP" (2)- "Suspected Domain Detection Tampering" (3, 4, 5)- "Unknown" (6, 7)- “White Ops: General IVT” (17) - consiste en el tráfico identificado a través de medios rutinarios de filtración, ejecutado mediante la aplicación de listas o con otras comprobaciones de parámetros estandarizadas.- “White Ops: Sophisticated IVT” (18) - consiste en situaciones más difíciles de detectar que requieren análisis avanzados, corroboración/coordinación multipunto, intervención humana significativa, etc., para analizar e identificar.- "Valid Impression" (0) es también un motivo válido de solicitud filtrada, pero en ese caso, se celebró una subasta y no se filtró. |
operating_system_id |
Entero | Yes | 24 |
Identificador del sistema operativo del dispositivo. - Use el servicio de familia de sistema operativo para obtener una lista de familias de sistemas operativos. - Use el servicio extendido del sistema operativo para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada. |
operating_system_name |
string | Sí | "Android 2.3.5 Gingerbread" |
Identificador del sistema operativo del dispositivo. - Use el servicio de familia de sistema operativo para obtener una lista de familias de sistemas operativos. - Use el servicio extendido del sistema operativo para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada. |
operating_system_family_id |
Entero | Yes | 2 |
Identificador del sistema operativo del dispositivo. - Use el servicio de familia de sistema operativo para obtener una lista de familias de sistemas operativos. - Use el servicio extendido del sistema operativo para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada. |
operating_system_family_name |
string | Sí | "Android" |
Identificador del sistema operativo del dispositivo. - Use el servicio de familia de sistema operativo para obtener una lista de familias de sistemas operativos. - Use el servicio extendido del sistema operativo para buscar qué versiones del sistema operativo se encuentran dentro de una familia de sistemas operativos determinada. |
Pasar dominios entre IFrames
Los editores prefieren publicar anuncios dentro de iFrames por varias razones, entre las que se incluyen:
Mayor seguridad: por motivos de seguridad, el explorador prohíbe la comunicación entre iFrames que sirven desde dominios diferentes. Esto se conoce como la "misma directiva de origen". Para obtener más información, vea la página De la misma directiva de origen de W3C.
Velocidad de carga de página: se garantiza que la velocidad de carga de la página no se ve afectada por los anuncios dentro de iFrames porque los iFrames permiten la carga asincrónica del contenido de la página y los anuncios. Esto garantiza que el usuario no tenga que esperar a que el resto de la página se cargue en caso de que el servicio de un anuncio se produzca más lentamente de lo esperado.
Por estas y otras razones, algunas redes proporcionan a sus editores un iFrame en el que mostrar anuncios. Si este iFrame entrega su contenido desde el dominio de la red y no desde el publicador, puede dar lugar a dificultades para determinar el dominio en el que se produjo realmente una impresión.
Por ejemplo, a un publicador se le asigna un fragmento de código HTML para colocar en sus páginas que incluye un iFrame que hace referencia al dominio de una red, best-network.net:
<!-- Publisher's Web Page >
<iframe src="http://best-network.net"> <!-- iFrame Referencing Network Domain >
<script src="http://cooladexchange.net/tag?id=12345"></script> <!-- Ad Exchange Placement serving on Network Domain >
</iframe>
El iFrame se encuentra en la página web del publicador, pero está sirviendo su contenido desde el dominio de la red. Dado que la página y el iFrame se hospedan en dominios diferentes, se aplican las restricciones de seguridad de la "directiva de mismo origen" y se prohíbe la comunicación entre la página del publicador y el iFrame de la red. Por lo tanto, la red no puede determinar el dominio real de la página del publicador. Como resultado, la red pasa a lo largo de su propio dominio como la dirección URL de referencia a la ubicación.
Depósito de edad
| Id. de bucket | Nombre del cubo |
|---|---|
0 |
"unknown" |
1 |
"13-17" |
2 |
"18-24" |
3 |
"25-34" |
4 |
"35-44" |
5 |
"45-54" |
6 |
"55-64" |
7 |
"65+" |
Métricas
| Column | Tipo | Ejemplo | Descripción |
|---|---|---|---|
imps |
Entero | 200942 |
El número de impresiones que llegan a través de este sitio o ubicación. |
clicks |
Entero | 1982 |
Número de clics que llegan a través de este sitio o ubicación. |
network_revenue |
Dinero | 1876.595304 |
La cantidad de ingresos de red que llegan a través de este sitio o ubicación. |
publisher_revenue |
Dinero | 93.489302 |
La cantidad de ingresos del publicador que llegan a través de este sitio o ubicación. |
imps_viewed |
Entero | 30,450 |
El número de impresiones medidas que se pueden ver según la definición de visualización de IAB, que indica que una impresión es visible si el 50 % de los píxeles se ven durante 1 segundo consecutivo. |
view_measured_imps |
Entero | 10,120 |
Número total de impresiones que se midieron para la visibilidad. |
view_rate |
double | 58% |
Porcentaje de impresiones que se pudieron ver del número total de impresiones medidas para la visibilidad. (Imps/View Measured Imps) |
view_measurement_rate |
double | 45% |
Porcentaje de impresiones medidas para la visibilidad del número total de impresiones. (Ver imps/imps medidos) |
imps_filtered |
Entero | 2,024 |
El número total de solicitudes de puja para las que Xandr no celebró una subasta debido a problemas de calidad del inventario. Consulte imps_filtered_reason_id y imps_filtered_reason (en Dimensiones) para obtener una lista de los posibles motivos. |
Ejemplo
Create una solicitud de informe con formato JSON
$ cat report-request.json
{
"report": {
"report_type": "seller_site_domain",
"columns": [
"seller_member_id",
"seller_member_name",
"placement_id",
"publisher_id",
"publisher_name",
"imps",
"imp_type_name",
"audit_type_id",
"audit_type_name",
"site_name",
"site_domain",
"exposed_for_resale_id",
"exposed_for_resale",
"domains_exposed_id",
"domains_exposed"
],
"filters": [
"seller_member_id",
"audit_type_id"
],
"report_interval": "last_7_days",
"format": "csv"
}
}
POST la solicitud al servicio de informes
$ curl -b cookies -X POST -d @report-request.json "https://api.appnexus.com/report"
{
"response": {
"report_id": "8d3697d23c87e5bebd44370630162990",
"status": "OK"
}
}
Descargar los datos del informe directamente en un archivo
La manera más común de descargar datos de informes implica usar report_id en una llamada al servicio de descarga de informes, que devuelve los datos de informes directamente en el formato de archivo especificado. En todo curl lo siguiente, usamos la -o opción para especificar que el informe se guarde en un archivo denominado huge-report.csv. Para obtener más información, consulte la sección Uso de cURL en Semántica de API.
$ curl -b cookies -o huge-report.csv "https://api.appnexus.com/report-download?id=8d3697d23c87e5bebd44370630162990"
Nota:
Hay un límite de 100 000 filas por informe cuando se descargan como archivos XLSX y Excel.
Recuperar los datos del informe encapsulados en JSON (opcional)
Casi siempre querrá usar el método descrito en Descargar los datos del informe directamente en un archivo anterior. Sin embargo, si por algún motivo prefiere recibir los datos de informes encapsulados en una respuesta JSON, puede pasarlo report_id directamente al servicio de informes .
$ curl -b cookies "https://api.appnexus.com/report?id=8d3697d23c87e5bebd44370630162990"