ネットワーク クリエイティブの頻度とリジェンシー

Network Creative Frequency & Recency レポートを使用すると、特定の広告主のクリエイティブ データを、ユーザー ビューの頻度とリジェンシーに基づいて表示できます。 このレポートは 、広告主のクリエイティブ頻度とリジェンシー レポートよりも詳細であり、ネットワーク ユーザーのみが使用できます。

レポートを取得する手順については、 レポート サービス または以下の 例 を参照してください。 このレポートでは、URL の一部として広告主 ID を指定する必要があります。例:

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

時間枠

フィールドは report_interval 、次のいずれかに設定できます。

• last_hour
• 今日
• yesterday
• last_48_hours
• last_2_days
• last_7_days
• last_14_days
• month_to_date
• last_30_days
• last_month
• last_100_days
• カスタム

データ保持期間

このレポートのデータ保持期間は 120 日間です (2017 年 2 月 26 日より前のデータはありません)。

Dimensions

指標

クリエイティブな頻度バケット

クリエイティブなレジェンシー バケット

例

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",
            "booked_revenue",
            "media_cost",
            "profit_ecpm"
        ],
        "report_interval": "last_7_days",
        "emails": ["jsmith@xandr.com"],
        "format": "csv"
    }
}

POST レポート サービスへの要求

$ curl -b cookies -c cookies -X post -d @network_frequency_recency 'https://api.appnexus.com/report?advertiser_id=384'

{
    "response": {
        "status": "OK",
        "report_id": "0f148df60ff2760d57014f607f46fce4"
    }
}

レポート ID を使用してレポート データを取得する

標準応答には、レポート データと、データをファイルに保存するために使用できるダウンロード URL が含まれます。 レポート データを含まないダウンロード URL のみを取得する場合は、クエリ文字列を渡します "without_data" 。

$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=0f148df60ff2760d57014f607f46fce4'

{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2012-02-03 22:00:33",
            "cache_hit": false,
            "fact_cache_hit": false,
            "fact_cache_error": "did not find any cache table for 2,4,44,30,31,66,32,34,9,17,16,36",
            "json_request": "{\"report\":{\"report_type\":\"network_advertiser_frequency_recency\",
             \"columns\":[\"creative_recency_bucket\",\"creative_frequency_bucket\",\"creative_id\",
             \"imps\",\"clicks\",\"total_convs\",\"booked_revenue\",\"media_cost\",\"profit_ecpm\"],
             \"report_interval\":\"last_7_days\",\"emails\":[\"js@email.com\"],\"filters\":
             [{\"buyer_member_id\":\"541\"},{\"advertiser_id\":\"3610\"}]}}",
            "header_info": "Report type:,network_advertiser_frequency_recency\r\n,\r\nRun at:,
             2012-02-03 22:00:33\r\nStart date:,2012-01-27 00:00:00\r\nEnd date:,2012-02-03 00:00:00
             \r\nTimezone:,\r\nUser:,John Smith (9685)\r\n",
            "data": "creative_recency_bucket,creative_frequency_bucket,creative_id,imps,clicks,
             total_convs,booked_revenue,media_cost,profit_ecpm\r\n7-14 days,6-10,753570,1,0,0,.000000,
             .000000,.000000000000000000000000\r\n15-30 minutes,151-250,753571,3,0,0,.000000,.000000,
             .000000000000000000000000\r\n1-2 days,11-20,1316901,12,0,0,.000000,.004200,-.350000000000
             000000000000\r\n1-2 days,11-20,1316886,6,0,0,.000000,.001900,-.316666666666666666667000\r
             \n7-14 days,21-40,773408,3,0,0,.000000,.000160,-.053333333333333333333000\r\n30-60 minutes,
             500+,700464,35,0,0,.000000,.000000,.000000000000000000000000\r\n30-60 minutes,2-5,1317391,
             ...
            "url": "report-download?id=0f1374f60ff2760d57014f607f46fce4"
        },
        "execution_status": "ready"
    }
}

ダウンロード URL を使用してレポート データをファイルに保存する

応答の フィールドを "url" 使用して、レポート データをファイルに保存します。 別の GET 呼び出しを行い、保存する場所とファイルを特定するだけです。 最初POSTの要求で指定した の"format"拡張子を持つファイルを必ず使用してください。

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