ネットワーク広告主の分析

Network Advertiser Analytics レポートは、Network Analytics レポートで提供されるデータよりも詳細な特定の広告主のパフォーマンス データを表示するために使用されます。 このレポートは、ネットワーク ユーザーのみが使用できます。 広告主ユーザーは、 広告主分析レポートを 使用できます。

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

時間枠

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

• current_hour
• last_hour
• 今日
• yesterday
• last_48_hours
• last_2_days
• last_7_days
• last_30_days
• month_to_date
• month_to_yesterday
• quarter_to_date
• last_month
• 有効 期間

データ保持期間

このレポートのほとんどのデータは永続的に維持されます (以下に示す例外)。 後：

• 100 日は、時間単位のデータに関するレポートを作成できなくなります。 ただし、日単位、月単位、累積間隔は引き続き使用できます。
• 14 か月間、個人に関するレポートを作成できなくなります。
  • クリエイティブ
  • プレースメント
  • ブランド

場合によっては、特定の広告主またはパブリッシャーの [投資] または [収益化] に表示される統計と一致しない配信がアナリティクス レポートに表示される場合があります。 これは、100 日と 14 か月を超える Analytics レポート データを集計する方法が原因です。 課金レポートのデータは、非集計形式で無期限に保持されます。

Dimensions

一部のディメンションには属性があります。 ディメンション属性は、親ディメンションに関するデータのより詳細な要素です。 ディメンションに属性がある場合、その属性の名前は、次の構文を使用して、その下に表示されます。 dimension_name.attribute_name

指標

例

JSON レポート要求を作成する

JSON ファイルには、 report_type"network_advertiser_analytics"と、取得する列 (ディメンションとメトリック) report_interval が含まれている必要があります。 また、特定のディメンションをフィルター処理し、粒度 (year、、) を定義し、monthdayデータを返す形式 (csv、、excelまたはhtml) を指定することもできます。 JSON ファイルに含めることができるフィールドの詳細については、 レポート サービスに関するページを参照してください。

$ cat network_advertiser_analytics

{"report":
    {
        "report_type":"network_advertiser_analytics",
        "columns":[
            "hour",
            "seller_member_id",
            "campaign_id",
            "imps",
            "clicks",
            "total_convs",
            "ctr",
            "convs_rate"
        ],
        "report_interval":"last_48_hours",
        "format":"csv"
    }
}

POSTReport Service への要求

POST JSON 要求を実行し、レポート ID を取得します。

$ curl -b cookies -X post -d @network_advertiser_analytics "https://api.appnexus.com/report?advertiser_id=690"

{
  "response":{
   "status":"OK",
   "report_id":"09b6979a6a4c3805bdac8921378d3622"
  }
}

GET レポート サービスからのレポートの状態

レポート ID を GET 使用して呼び出しを行って、レポートの状態を取得します。 が "ready"になるまでこの呼び出しをexecution_status続けます。 次に、 レポート ダウンロード サービスを使用して、レポート データをファイルに保存します (次の手順で説明します)。

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

{
  "response":{
   "status":"OK",
   "report":{
     "name":null,
     "created_on":"2010-05-25 19:15:48",
     "json_request":"{\"report\":{\"report_type\":\"network_advertiser_analytics\",\"columns\":
     [\"hour\",\"seller_member_id\",\"campaign_id\",\"imps\",\"clicks\",\"total_convs\",
     \"ctr\",\"convs_rate\"],\"row_per\":[\"hour\",\"seller_member_id\",\"campaign_id\"],
     \"report_interval\":\"last_48_hours\",\"filters\":[{\"advertiser_id\":\"690\"}]}}",
     "url":"report-download?id=b97897a7864dd8f34e7457226c7af592"
   },
   "execution_status":"ready"
  }
}

GET レポート ダウンロード サービスからのレポート データ

レポート データをファイルにダウンロードするには、レポート ID を使用して別 GET の呼び出しを行いますが、今回は レポートダウンロード サービスに対して呼び出します。 サービスとレポート ID は、前GETの応答のフィールドにありますurl。 保存するファイルを識別する場合は、最初POSTの で指定した の"format"ファイル拡張子を使用してください。

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

関連トピック

Report Service