Digital Platform API - 販売者の塗りつぶしと配信ネットワーク レポート

販売者の塗りつぶしと配信レポートは、オークションのために Xandr に送信されたすべてのインプレッションに関する詳細な情報を販売者に提供し、タグとドメイン レベルまで配信の問題を診断するのに役立つトラブルシューティング ツールとして設計されました。 新しい説明フィールドを使用すると、Xandr の全体的な塗りつぶし率の近似値を、"合計広告応答数" と "合計広告要求数" メトリックを使用して確認できます。

このレポートに含まれるデータは、次に起因する未翻訳のインプレッションに寄与する問題を特定するのに役立ちます。

• 不適切な既定値/パスバック タグの設定
• IP またはドメインのブロックに関連するインベントリ ブロックリスト
• ビデオ プレーヤーのエラーなど

期限

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

• last_48_hours
• 今日
• yesterday
• last_7_days
• last_24_days
• last_14_days
• last_2_days
• month_to_date
• quarter_to_date
• last_month
• last_available_day
• last_7_available_days
• last_14_available_days

データ保持期間

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

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

Dimensions

指標

例

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

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

$ cat seller_fill_and_delivery_network

{"report":
    {
        "format": "csv",
        "report_interval": "yesterday",
        "row_per": ["geo_country"],
        "columns":["placement_id","imps_kept","total_ad_responses","total_ad_requests","geo_country"],
        "report_type": "seller_fill_and_delivery_network"
    }
}

POST Report Service への要求

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

$ curl -b cookies -c cookies -X post -d @seller_fill_and_delivery_network "https://api.appnexus.com/report"

{
   "response":{
      "status":"OK",
      "report_id":"c445bca183a3d338dc1c5b85a3d484f5"
   }
}

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

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

$ 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\",\"imps_kept\",\"total_ad_responses\",\"total_ad_requests\",\"geo_country\"],\"report_type\":\"seller_fill_and_delivery_network\",\"filters\":[{\"seller_member_id\":\"958\"}]}}",
            "url": "report-download?id=c445bca183a3d338dc1c5b85a3d484f5"
        },
        "execution_status": "ready"
    }
}

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

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

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