パブリッシャー ブランド レビュー レポート

このレポートでは、特定の発行元のインベントリ全体のブランドのパフォーマンスを表示します。 このレポートは、ネットワーク ユーザーとパブリッシャー ユーザーの両方で使用できます。 次の操作を行うことができます:

• 特定の発行元の広告枠で配信されたクリエイティブと、その実行方法を確認します。
• 監査状態でクリエイティブのパフォーマンスを確認します。

このレポートでは、次のように URL の一部として発行元 ID を指定する必要があります。

https://api.appnexus.com/report?publisher_id=PUBLISHER_ID

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

時間枠

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

• yesterday
• last_7_days
• last_30_days
• month_to_date
• last_month

データ保持期間

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

Dimensions

指標

例

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

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

$ cat publisher_brand_review

{"report": 
    {
        "format": "csv",
        "report_interval": "yesterday",
        "row_per": ["placement_id"],
        "columns": ["placement_id","imp_type","creative_id","brand_id"],
        "report_type": "publisher_brand_review"
    }
}

POSTReport サービスへの要求

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

$ curl -b cookies -c cookies -X post -d @publisher_brand_review "https://api.appnexus.com/report?publisher_id=384186"

{
   "response":{
      "status":"OK",
      "report_id":"97a181df6d77a8f3cd5a45eff4ea3dab"
   }
}

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

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

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

{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2014-11-19 21:57:00",
            "json_request": "{\"report\":{\"format\":\"csv\",\"report_interval\":\"yesterday\",\"row_per\":[\"placement_id\"],\"columns\":[\"placement_id\",\"imp_type\",\"creative_id\",\"brand_id\"],\"report_type\":\"publisher_brand_review\",\"filters\":[{\"seller_member_id\":\"958\"},{\"publisher_id\":\"384186\"}]}}",
            "url": "report-download?id=97a181df6d77a8f3cd5a45eff4ea3dab"
        },
        "execution_status": "ready"
    }
}

GET Report Download サービスからのレポート データ

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

curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=97a181df6d77a8f3cd5a45eff4ea3dab' > /tmp/publisher_brand_review.csv