Fréquence et récence de la créativité de l’annonceur

Le rapport Fréquence de création & Récence de l’annonceur peut être utilisé pour afficher les données créatives d’un annonceur spécifique en fonction de la fréquence et de la récurrence des vues des utilisateurs. Ce rapport est disponible pour les annonceurs et les utilisateurs du réseau.

Pour obtenir des instructions sur la récupération d’un rapport, consultez Service de rapports ou consultez l’exemple ci-dessous. Pour un utilisateur annonceur, l’ID de l’annonceur est détecté en fonction de l’authentification de l’utilisateur. Toutefois, pour un utilisateur réseau, ce rapport nécessite de spécifier l’ID de l’annonceur dans le cadre de l’URL, par exemple :

https://api.appnexus.com/report?advertiser_id=ADVERTISER_ID

Période

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

• last_hour
• aujourd’hui
• yesterday
• last_48_hours
• last_2_days
• last_7_days
• last_14_days
• month_to_date
• last_30_days
• last_month
• last_100_days
• Personnalisé

Période de conservation des données

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

Dimensions

Mesures

Compartiments de fréquence de création

Compartiments de récence créatifs

Exemple

Create une demande de rapport au format JSON

$ cat network_advertiser_frequency_recency {
    "report":
    {
        "report_type": "network_advertiser_frequency_recency",
        "columns": [
            "creative_recency_bucket",
            "creative_frequency_bucket",
            "creative_id",
            "imps",
            "clicks",
            "total_convs"
        ],
        "report_interval": "last_7_days",
        "emails": ["js@email.com"],
        "format": "csv"
    }
}

POST la demande au service de création de rapports

$ curl -b cookies -c cookies -X POST -d @network_advertiser_frequency_recency "https://api.appnexus.com/report?advertiser_id=384"

{
    "response": {
        "status": "OK",
        "report_id": "c458f71c084a2a3b51dcd749132bcf87",
        "dbg_info": {
            ...
        }
    }
}

Utiliser l’ID de rapport pour récupérer les données du rapport

La réponse standard inclut les données du rapport et une URL de téléchargement que vous pouvez nous permettre d’enregistrer les données dans un fichier. Si vous souhaitez obtenir uniquement l’URL de téléchargement sans les données du rapport, transmettez "without_data" la chaîne de requête.

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

{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2012-02-03 21:43:27",
            "cache_hit": true,
            "fact_cache_hit": false,
            "fact_cache_error": null,
            "json_request": "{\"report\":{\"report_type\":\"network_advertiser_frequency_recency\",
             \"columns\":[\"creative_recency_bucket\",\"creative_frequency_bucket\",\"creative_id\",
             \"imps\",\"clicks\",\"total_convs\"],\"report_interval\":\"last_7_days\",\"emails\":
             [\"js@email.com\"],\"filters\":[{\"buyer_member_id\":\"541\"},{\"advertiser_id\":
             \"3610\"}]}}",
            "header_info": null,
            "data": "creative_recency_bucket,creative_frequency_bucket,creative_id,imps,clicks,
             total_convs\r\nno-cookie,no-cookie,700454,47,0,0\r\n2-7 days,2-5,773422,31,0,
             0\r\n5-15 minutes,6-10,1298720,1,0,0\r\n14-30 days,151-250,700464,8,0,0\r\n7-14 days,
             21-40,711929,5,0,0\r\n1-4 hours,6-10,1317518,826,2,0\r\n1-4 hours,1,1317473,996,14,
             0\r\n12-24 hours,11-20,1317436,139,0,0\r\n15-30 minutes,6-10,773408,12,0,0\r\nno-cookie,
             no-cookie,1318994,3,0,0\r\n1-5 minutes,101-150,711932,898,0,0\r\n2-7 days,2-5,773408,45,
             0,0\r\n1-5 minutes,2-5,610381,7990,23,0\r\n12-24 hours,1,1316895,4790,30,0\r\n1-4 hours,
             ...
             "url": "report-download?id=c447d71c084a2a3b51dcd749132bcf87"
        },
        "execution_status": "ready",
        "dbg_info": {
            ...
        }
    }
}

Utiliser l’URL de téléchargement pour enregistrer les données du rapport dans un fichier

Vous utilisez le "url" champ dans la réponse pour enregistrer les données du rapport dans un fichier. Effectuez simplement un autre GET appel et identifiez l’emplacement et le fichier dans lesquels vous souhaitez enregistrer. Veillez à utiliser le fichier l’extension du "format" que vous avez spécifié dans votre demande initiale POST .

$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=c447d71c084a2a3b51dcd749132bcf87' > /tmp/network_advertiser_frequency_recency.csv