API de plataforma digital: informe de auditorías creativas completadas
El informe de auditorías creativas completadas está diseñado para proporcionarle información sobre cómo se mueven las creatividades a través del proceso de auditoría. Con este informe, puede averiguar lo siguiente:
- ¿Cuántos de sus creativos se han auditado en un período de tiempo determinado?
- ¿Cuál de las creatividades ha completado la auditoría?
- ¿Cuánto serán las cuotas de auditoría creativas?
Para obtener instrucciones sobre cómo recuperar este informe, consulte los ejemplos siguientes.
Nota:
Para obtener más información sobre cómo funcionan los informes, consulte el servicio de informes.
Período de tiempo
El report_interval campo de la solicitud JSON debe establecerse en uno de los siguientes:
- yesterday
- last_7_days
- month_to_date
- last_month
- last_30_days
- last_14_days
Período de retención de datos
El período de retención de datos para este informe es de 365 días.
Nota:
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.
Dimensions
| Column | Tipo | ¿Filtro? | Description |
|---|---|---|---|
day |
date | Yes | Día en el que se completaron las auditorías (alias para audit_completion_date). |
creative_id |
Entero | Yes | Identificador de la creatividad que se auditó. |
creative_name |
string | Sí | Nombre de la creatividad que se auditó. |
advertiser_id |
Entero | Yes | El identificador del anunciante asociado al creativo que se auditó. |
advertiser_name |
string | Sí | Nombre del anunciante asociado a la creatividad auditada. |
member_id |
Entero | Yes | Identificador del miembro cuya creatividad se auditó. |
audit_reason_id |
Entero | Yes | Código entero para el tipo de auditoría. Hay dos valores permitidos: - 1: auditoría inicial- 2: reaudit |
audit_reason |
string | Sí | Tipo de auditoría. Será o "Initial""Reaudit". |
audit_type_id |
Entero | Yes | Código entero para la prioridad de la auditoría. Valores permitidos: - 1:Estándar- 2:Prioridad |
audit_type |
string | Sí | Prioridad de la auditoría. Valores permitidos: - "standard"- "priority" |
member_name |
string | Sí | Nombre del miembro cuya creatividad se auditó. |
audit_completion_date |
date | Sí | El día en que se completaron las auditorías. |
Métricas
| Column | Tipo | Description |
|---|---|---|
num_audits_completed |
Entero | Número de auditorías completadas en la agrupación especificada. |
total_audit_fee |
double | Las tarifas totales de las auditorías en la agrupación especificada. |
Ejemplos
Create la solicitud de informe JSON
$ cat completed_creative_audits.json
{
"report": {
"format": "csv",
"report_interval": "yesterday",
"filters": [
{
"member_id": 88
}
],
"columns": [
"day",
"creative_id",
"creative_name",
"advertiser_name",
"member_id",
"audit_completion_date",
"audit_type",
"num_audits_completed",
"total_audit_fee",
"audit_completion_date"
],
"report_type": "completed_creative_audits"
}
}
POST los datos de solicitud al servicio de informes
$ curl -b cookies -X POST -d @completed-creative-audits.json https://api.appnexus.com/report
{
"response":{
"existing":true,
"report_id":"c2c682185b62ec9afd019536a8d947cc",
"status":"OK"
}
}
GET estado del informe
$ curl -b cookies https://api.appnexus.com/report?id=c2c682185b62ec9afd019536a8d947cc
{
"response":{
"execution_status":"ready",
"status":"OK"
}
}
GET los datos del informe
curl -b cookies https://api.appnexus.com/report-download?id=c2c682185b62ec9afd019536a8d947cc > /tmp/completed_creative_audits.csv
Nota:
Hay un límite de 100 000 filas por informe cuando se descargan como archivos XLSX y Excel.