Bidder Platform Buyer レポート

  • [アーティクル]

Bidder Platform Buyer Report は、購入者に詳細なトランザクション情報を提供します (タグ レベルまで)。 このレポートを取得する手順については、以下の 例を 参照してください。

ヒント

90 日を超えるデータが必要ですか?

bidder_platform_buyer型とplatform_seller型は、過去 90 日間のデータを格納するテーブルからプルします。 過去 90 日間を超えるデータについては、 buyer_platform_billing と seller_platform_billing のレポートの種類を使用します。

期限

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

  • current_hour
  • last_hour
  • last_48_hours
  • today
  • yesterday
  • last_7_days
  • month_to_date
  • quarter_to_date
  • last_month
  • lifetime
  • mtd
  • month_to_yesterday

Dimensions

Column 種類 フィルター。 説明
month time はい カウントされるイベントが発生した年の月。
day date はい カウントされるイベントが発生した年の日。
hour date はい カウントされるイベントが発生した時間。
year date はい カウントされるイベントが発生した年。
buyer_member_id int はい 購入者メンバーの内部 ID。
seller_member_id int はい 販売者メンバーの内部 ID。
seller_member_name string はい 販売者メンバーの表示名。
seller_member string はい 非推奨。
tag_id int はい タグの ID。
publisher_id int はい パブリッシャーの内部 ID。
publisher_name string はい 発行元の表示名。
publisher string はい 非推奨。
size string はい クリエイティブのサイズ。
geo_country string はい 国の表示名の後に ID (Xandr 形式) が続きます。
geo_country_name string はい カウントされるイベント (クリックなど) が発生した国。
content_category_id int はい インプレッションが発生したインベントリが関連付けられたコンテンツ カテゴリの ID。 コンテンツ カテゴリの詳細については、「 コンテンツ カテゴリ サービス」を参照してください。
content_category_name string はい インプレッションが発生したインベントリに関連付けられたコンテンツ カテゴリの名前。 コンテンツ カテゴリの詳細については、「 コンテンツ カテゴリ サービス」を参照してください。
content_category string はい 非推奨。
imp_type string はい 配信されたインプレッションの種類。 使用可能な値:
- 1 = 空白
- 2 = PSA
- 3 = 既定のエラー
- 4 = 既定値
- 5 = 保持
- 6 = 再販
- 7 = RTB
- 8 = 既定のエラーの結果の PSA
- 9 = 外部インプレッション
- 10 = 外部クリック
creative_id int はい カウント中の "イベント" が発生したインプレッションで配信されたクリエイティブの ID。 クリエイティブの詳細については、 クリエイティブ サービスに関するページを参照してください。
creative_name string はい カウント中の "イベント" が発生したインプレッションで配信されたクリエイティブの名前。 クリエイティブの詳細については、 クリエイティブ サービスに関するページを参照してください。
creative string はい 非推奨。
bidder_id int はい 報告する "イベント" が発生したインプレッションを購入した入札者の ID。 入札者の詳細については、 Bidder サービスに関するページを参照してください。
bidder_name string はい 報告する "イベント" が発生したインプレッションを購入した入札者の名前。 入札者の詳細については、 Bidder サービスに関するページを参照してください。
bidder string はい 非推奨。
site_id int はい サイトの内部 ID。
site_name string はい サイトの表示名。
site string はい 非推奨。
tag_name string はい タグの表示名。
tag string はい 非推奨。
buyer_currency string はい 購入者メンバーが選択した通貨。 サポートされている通貨の一覧については、「 サポートされている通貨」を参照してください。
supply_type 文字列 いいえ インベントリの種類。 使用可能な値:
- "web"
- "mobile_web"
- "mobile_app"
publisher_code string はい 外部システム内の発行元コードに対応するために入力された発行元のカスタム コード。
site_code string はい 外部システム内のサイト コードに対応するために入力されたサイトのカスタム コード。
buyer_member_name string はい 購入者メンバーの表示名。
buyer_member string はい 非推奨。
buyer_seat_code string はい インプレッションの入札に使用されたカスタム 購入者シート ID (DSP によって送信)。
buyer_seat_name string はい 購入者シート コードの表示名。

指標

Column 種類 式 説明
imps_bought int imps_bought 正常に購入されたインプレッションの合計数。
buyer_spend お金 buyer_spend 買い手がメディアのコストに対して支払う金額。
clicks int clicks クリックの合計数。

手記： 外部需要パートナーのクリックは記録されません。
click_rate_sold double (clicks / imps_bought) "クリックスルー率" (CTR)。

手記： 外部需要パートナーのクリックは記録されません。
buyer_ecpm お金 ( buyer_spend / imps_bought ) * 1000 eCPM で表されるインプレッションあたりの購入者のコスト。
buyer_spend_buyer_curr お金 buyer_spendは、購入者の通貨で表されます。 選択した通貨での購入者の合計支出。 サポートされている通貨の一覧については、「 サポートされている通貨」を参照してください。
buyer_ecpm_buyer_curr お金 buyer_ecpmは、購入者の通貨で表されます。 選択した通貨でのインプレッションあたりの購入者のコスト。 サポートされている通貨の一覧については、「 サポートされている通貨」を参照してください。
imps_viewed int imps_viewed IAB ビューアビリティ定義に従って表示可能だった測定されたインプレッションの数。これは、1 秒間にピクセルの 50% が表示されている場合に表示可能であることを示します。
view_measured_imps int view_measured_imps 視認性のために測定されたインプレッションの合計数。
view_rate double view_rate 視認性を測定したインプレッションの総数のうち、表示可能だったインプレッションの割合。 (表示された Imps/View Measured Imps)
view_measurable_rate double view_measurable_rate 総インプレッション数のうち視認性を測定したインプレッションの割合。 (測定された Imps/Imps を表示する)

例

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

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

$ cat report
{
    "report": {
        "report_type": "bidder_platform_buyer",
        "timezone": "PST",
        "report_interval": "last_7_days",
        "name": "Example Buyer Report",
        "columns": [
            "day",
            "publisher_id",
            "publisher_name",
            "publisher_code",
            "buyer_member_id",
            "buyer_member_name",
            "buyer_ecpm",
            "buyer_spend"
        ]
    }
}

注:

日順を指定するには、"columns" 配列の後にこのオブジェクトを JSON ファイルに挿入します。

"orders": ["day"]

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

$ curl -b cookies -c cookies -X POST -d @report 'https://api.adnxs.com/report'
{
  "response": {
    "status": "OK",
    "report_id": "bfe2ba2ea54a51115db942d591a7b5d9",
  }
}

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

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

$ curl -b cookies -c cookies 'https://api.adnxs.com/report?id=bfe2ba2ea54a51115db942d591a7b5d9'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2010-05-25 19:19:53",
         "url": "report-download?id=bfe2ba2ea54a51115db942d591a7b5d9"
      },
      "execution_status":"ready"
   }
}

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

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

注:

ダウンロード中にエラーが発生した場合、応答ヘッダーには HTTP エラー コードとメッセージが含まれます。 応答ヘッダーを公開するには、呼び出しで {{-i}} または {{-v}} を使用します。

curl -b cookies -c cookies 'https://api.adnxs.com/report-download?id=bfe2ba2ea54a51115db942d591a7b5d9' > report.csv

注:

レポートを最初に投稿したときの応答で指定された ID を使用します。

頻繁に実行されるレポートをスケジュールする

定期的にプルするレポートをスケジュールできます。 詳細については、「 保存されたレポート サービス」を参照してください。