Compartir a través de

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.

  • Last updated on