Partager via

API De plateforme numérique - Rapport audits créatifs terminés

Le rapport d’audits créatifs terminés est conçu pour vous donner un aperçu de la façon dont vos créations passent par le processus d’audit. Ce rapport vous permet de découvrir les éléments suivants :

  • Combien de vos créations ont été auditées sur une période donnée ?
  • Parmi vos créateurs, lequel a terminé l’audit ?
  • Combien seront vos frais d’audit créatifs ?

Pour obtenir des instructions sur la récupération de ce rapport, consultez les exemples ci-dessous.

Remarque

Pour plus d’informations sur le fonctionnement de la création de rapports, consultez service de rapports.

Période

Le report_interval champ dans la requête JSON doit être défini sur l’une des valeurs suivantes :

  • yesterday
  • last_7_days
  • month_to_date
  • last_month
  • last_30_days
  • last_14_days

Période de conservation des données

La période de conservation des données pour ce rapport est de 365 jours.

Remarque

Pour exécuter un rapport pour une période personnalisée, définissez les start_date champs et end_date dans votre demande de rapport. Pour plus d’informations sur ces champs, consultez Service de rapports.

Dimensions

Column Type Filtre? Description
day date Oui Jour où les audits ont été effectués (alias pour audit_completion_date).
creative_id int Oui ID de la création auditée.
creative_name string Oui Nom de la création qui a été auditée.
advertiser_id int Oui ID de l’annonceur associé à la création auditée.
advertiser_name string Oui Nom de l’annonceur associé à la création auditée.
member_id int Oui ID du membre dont la création a été auditée.
audit_reason_id int Oui Code entier pour le type d’audit. Il existe deux valeurs autorisées :
- 1: Audit initial
- 2: Reaudit
audit_reason string Oui Type d’audit. Il s’agit de "Initial" ou "Reaudit".
audit_type_id int Oui Code entier pour la priorité de l’audit. Valeurs autorisées :
- 1:Standard
- 2:Priorité
audit_type string Oui Priorité de l’audit. Valeurs autorisées :
- "standard"
- "priority"
member_name string Oui Nom du membre dont la création a été auditée.
audit_completion_date date Oui Le jour où les vérifications ont été effectuées.

Mesures

Column Type Description
num_audits_completed int Nombre d’audits effectués dans le regroupement spécifié.
total_audit_fee double Total des frais pour les audits dans le regroupement spécifié.

Exemples

Create la demande de rapport 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 les données de requête au service de rapports

$ curl -b cookies -X POST -d @completed-creative-audits.json https://api.appnexus.com/report

{
    "response":{
        
         "existing":true,
         "report_id":"c2c682185b62ec9afd019536a8d947cc",
         "status":"OK"
    }
}

GETle rapport status

$ curl -b cookies https://api.appnexus.com/report?id=c2c682185b62ec9afd019536a8d947cc


{
    "response":{
         "execution_status":"ready",
         "status":"OK"
    }
}

GET les données du rapport

curl -b cookies https://api.appnexus.com/report-download?id=c2c682185b62ec9afd019536a8d947cc > /tmp/completed_creative_audits.csv

Remarque

Il existe une limite de 100 000 lignes par rapport lorsque vous les téléchargez en tant que fichier XLSX et Excel.

  • Last updated on