Conversions d’attributs de l’annonceur

Le rapport Conversions attribuées par l’annonceur vous permet d’afficher les ID de pixels de conversion, les ID de commande, les temps de clics ou d’impressions attribués et d’autres informations relatives aux conversions attributées de vos annonceurs.

Pour obtenir des instructions sur la récupération d’un rapport, consultez service de rapports ou exemples.

Ce rapport est filtré par ID de membre et ID d’annonceur. L’ID de membre est détecté en fonction de l’authentification de l’utilisateur réseau, mais l’ID de l’annonceur doit être spécifié dans le cadre de l’URL, par exemple :

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

Période et fuseau horaire

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

• current_hour
• last_hour
• aujourd’hui
• yesterday
• last_48_hours
• last_7_days
• last_30_days
• month_to_yesterday
• month_to_date
• last_30_days

Vous pouvez également définir les start_date champs et end_date sur une plage au cours des 33 derniers jours. Le timezone champ dans la requête JSON peut être défini uniquement UTCsur , mais ce n’est pas nécessaire, car le fuseau horaire est défini par défaut UTC sur s’il n’est pas spécifié.

Période de conservation des données

Ce rapport peut récupérer des données pour les 90 derniers jours et uniquement dans le fuseau horaire UTC.

Dimensions

Mesures

Exemples

Create une demande de rapport au format JSON

Dans cet exemple, nous définissons un filtre pour obtenir des informations sur le pixel de conversion 9012.

$ cat attributed_conversions  {
    "report":
    {
        "report_type": "attributed_conversions",
        "columns": [
            "datetime",
            "pixel_id",
            "order_id",
            "post_click_or_post_view_conv",
            "post_click_or_post_view_revenue",
            "line_item_id",
            "creative_id",
            "campaign_id",
            "imp_time",
            "imp_type_id",
            "advertiser_id",
            "buyer_member_id"
        ],
        "filters": [{"pixel_id": 9012}],
        "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 @attributed_conversions 'https://api.appnexus.com/report?advertiser_id=123'

{
    "response":{
        "status":"OK",
        "report_id":"07af1282c9485adcef49c95fa5d7496b"
    }
}

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 utiliser pour 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=07af1282c9485adcef49c95fa5d7496b'

{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2011-11-22 23:51:22",
            "cache_hit": false,
            "fact_cache_hit": false,
            "json_request": "{\"report\":{\"report_type\":\"attributed_conversions\",\"columns\":
             [\"datetime\",\"pixel_id\",\"order_id\",\"post_click_or_post_view_conv\",
             \"post_click_or_post_view_revenue\",\"line_item_id\",\"creative_id\",\"campaign_id\",
             \"imp_time\",\"imp_type_id\",\"advertiser_id\",\"buyer_member_id\"],
             \"report_interval\":\"lifetime\",\"emails\":[\"js@email.com\"],\"filters\":
             [{\"buyer_member_id\":\"4567\"},{\"advertiser_id\":\"123\"}]}}",
            "header_info": "Report type:,conversion_pixel\u000d\u000a,\u000d\u000aRun at:,
             2011-11-22 23:51:22\u000d\u000aStart date:,2011-11-15 00:00:00\u000d\u000aEnd date:,
             2011-11-22 00:00:00\u000d\u000aTimezone:,\u000d\u000aUser:,John Smith (1432)
             \u000d\u000a",
            "data": "datetime,pixel_id,order_id,post_click_or_post_view_conv,
             post_click_or_post_view_revenue,line_item_id,creative_id,campaign_id,imp_time,
             imp_type_id,advertiser_id,buyer_member_id\u000d\u000a11704,8225230493273032227,
             123,8.7654A+32,4567,2011-11-18 06:00:13,2011-11-17 03:00:02,5,12345,678,9012,
             Post Click,.3.00\u000d\u000a11704,
             ..."
        },
        "execution_status": "ready",
        "dbg_info": {
            ...
        }
    }
}

Si nécessaire, utilisez le service de recherche pour mapper les ID d’objets à d’autres données pertinentes, telles que les noms, les codes et les états.

GET les données de rapport du service de téléchargement de rapports

Pour télécharger les données du rapport dans un fichier, effectuez un autre GET appel avec l’ID de rapport, mais cette fois au report-download service. Vous trouverez le service et l’ID de rapport dans le champ URL de la réponse précédente GET . Lorsque vous identifiez le fichier dans lequel vous souhaitez enregistrer, veillez à utiliser l’extension de fichier du "format" que vous avez spécifié dans votre initial POST.

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