デジタル プラットフォーム API - 販売者ブランド レビュー レポート

このレポートでは、すべてのインベントリでブランドのパフォーマンスが表示されます。 次の操作を行うことができます:

• 広告枠で配信されたクリエイティブとそのパフォーマンスを確認します。
• 監査状態でクリエイティブのパフォーマンスを確認します。
• すべてのインベントリでクライアント ブランド カテゴリのパフォーマンスを確認します。

time_granularityデータの は ですdaily。 レポートを取得する手順については、 レポート サービス または以下の 例 を参照してください。

時間枠

JSON 要求のフィールドは report_interval 、次のいずれかに設定する必要があります。

• yesterday
• last_7_days
• last_30_days
• month_to_date
• last_month

データ保持期間

このレポートのデータ保持期間は 428 日です。

Dimensions

指標

例

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

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

$ cat seller_brand_review
{"report":
    {
        "format": "csv",
        "report_interval": "yesterday",
        "row_per": ["geo_country"],
        "columns": ["placement_id","imp_type_id","creative_id","brand_id","geo_country"],
        "report_type": "seller_brand_review"
    }
}

POSTReport Service への要求

POST レポート ID を取得するための JSON 要求。

$ curl -b cookies -c cookies -X post -d @seller_brand_review "https://api.appnexus.com/report"
{
   "response":{
      "status":"OK",
      "report_id":"c445bca183a3d338dc1c5b85a3d484f5"
   }
}

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

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

$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=c445bca183a3d338dc1c5b85a3d484f5'
{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2014-11-19 22:33:31",
            "json_request": "{\"report\":{\"format\":\"csv\",\"report_interval\":\"yesterday\",\"row_per\":[\"geo_country\"],\"columns\":[\"placement_id\",\"imp_type_id\",\"creative_id\",\"brand_id\",\"geo_country\"],\"report_type\":\"seller_brand_review\",\"filters\":[{\"seller_member_id\":\"958\"}]}}",
            "url": "report-download?id=c445bca183a3d338dc1c5b85a3d484f5"
        },
        "execution_status": "ready"
    }
}

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

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

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