Digital Platform API - 購入者の入札エラー レポート

  • [アーティクル]

買い手入札エラー レポートを使用すると、買い手側と売り側の設定のトラブルシューティングを行うと、オークション エラーが発生し、支出がブロックされます。 目標は、将来的にエラーを排除するのに役立ちます。 所有者に関する情報、原因、推奨される解決方法については、「 入札エラー コード」を参照してください。 購入者入札エラー レポートは、Xandr プラットフォームでログに記録されたエラーの 5% のランダムに選択されたセットを通じて、拒否された需要に関する分析情報を得るのに役立ちます。 エラー数に 100 を乗算して、5% のサンプリングを考慮しました。

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

期限

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

  • カスタム
  • last_hour
  • 今日
  • last_24_hours
  • yesterday
  • last_2_days
  • last_7_days
  • last_30_days

データ保持期間

このレポートのデータは 33 日間保持されます。

注:

カスタム時間枠のレポートを実行するには、レポート要求の start_date フィールドと end_date フィールドを設定します。 これらのフィールドの詳細については、「 Report Service」を参照してください。

Dimensions

Column 種類 フィルター。 例 説明
ad_profile_id int はい 1432 エラーの影響を受ける販売者メンバーの広告プロファイル ID。
bidder_id string はい 101 入札者に関連付けられている ID。
bidder_name int いいえ “DBM” 購入者メンバーを代表し、エラーの影響を受けるテクノロジ プロバイダー。
brand 文字列 いいえ "Ace Hardware(3)" ブランドの名前と ID。
brand_id int はい 3 クリエイティブに関連付けられているブランドの ID。
brand_name 文字列 いいえ "Ace Hardware" Xandr システムに登録され、エラーの影響を受けるクリエイティブに関連付けられているブランド。
buyer_member_id int はい 123 購入者メンバーの ID。
buyer_member_name 文字列 いいえ "My Network" エラーの影響を受ける購入者メンバー。
buyer_seat_code 文字列 いいえ "SCID001" インプレッションの入札に使用されたカスタム 購入者シート ID (DSP によって送信)
buyer_seat_id int はい 350 エラーの影響を受ける購入者メンバーのシートの識別子。
buyer_seat_name 文字列 いいえ "FirstSeatCodeID" 購入者シート コードの表示名。
creative_category_id Int はい 784 クリエイティブ カテゴリの ID。
creative_category_name 文字列 いいえ “Beauty” エラーの影響を受けるブランドとクリエイティブの両方に割り当てられた分類。
creative_code string はい "CC001" エラーの影響を受ける購入者メンバーに関連付けられているクリエイティブの代替識別子。
creative_id int はい 554 エラーの影響を受ける購入者メンバーに関連付けられているクリエイティブ識別子。
creative_size 文字列 いいえ "728x90" エラーの影響を受けるクリエイティブのサイズ。
curated_deal 文字列 いいえ "Renault Curator Deal (111)" 影響を受けるキュレーションされた取引の名前と ID。
curated_deal_id int はい 991 エラーの影響を受けるキュレーションされた取引の ID
curated_deal_name 文字列 いいえ "Renault Curator Deal" 影響を受けるキュレーション取引の名前。
curator_member 文字列 いいえ "OMD - Renault Group (CURATOR) (12148)" エラーに関連付けられているキュレーター名と ID。
curator_member_name 文字列 いいえ "OMD - Renault Group (CURATOR)" エラーに関連付けられているキュレーター メンバーの名前。
day time いいえ "2010-02-01" オークションの日。
deal 文字列 いいえ "My Deal(2345)" 影響を受ける取引の名前と ID。
deal_id int はい 2345 エラーの影響を受ける取引の ID (取引 ID = 0 が関与していない場合)。
deal_name 文字列 いいえ "My Deal" 影響を受ける取引の名前。
error_id int はい 101 ImpBus で発生し、ログに記録された特定のエラー (エラー メッセージとの関係)。
error_message varchar いいえ “Creative brand banned by member's ad profile” 発生したエラー (エラー ID との関係) を示す汎用エラー メッセージ。
hour time いいえ "2010-02-01 06:00:00" オークションの時間。
language 文字列 いいえ "English(1)" 言語の名前。
language_id int はい 1 言語の ID。
language_name 文字列 いいえ "English" 言語の名前。
month time いいえ "2010-02" オークションの月。
placement_id int はい 7890 配置の ID。
placement_name 文字列 いいえ "My placement" エラーに関連付けられている販売者メンバーの配置。
publisher_id int はい 321 エラーの影響を受ける発行元の ID。
seller_member 文字列 いいえ "My Network(122)" 販売者メンバーの名前と ID。
seller_member_id int はい 122 販売者メンバーの ID。
seller_member_name 文字列 いいえ "My Network" エラーの影響を受ける販売者メンバー。
technical_attribute 文字列 いいえ “Flash(350)” Technical 属性の名前と ID。
technical_attribute_id int はい 350 Technical 属性の ID。
technical_attribute_name 文字列 いいえ “Flash” エラーの影響を受ける、画像、フラッシュ、ビデオ、エキスパンドなど、クリエイティブの機能。

指標

Column 種類 例 式 説明
error_count int 2340 sum(error_count)*100 選択した期間に Xandr プラットフォームでログに記録されたエラーの量 (サンプリングを考慮して、ランダムに選択されたエラーの 5% に 100 を乗算したセット)。

例

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

JSON ファイルには、 report_type"buyer_bid_error_report"と、取得する columns (ディメンションとメトリック) と report_interval が含まれている必要があります。 また、特定のディメンションをフィルター処理し、粒度 (年、月、日) を定義し、データを返す形式 (csv、excel、または html) を指定することもできます。 JSON ファイルに含めることができるフィールドの詳細については、「 Report Service」を参照してください。

$ cat buyer_bid_error_report

{
    "report":
    {
        "report_type":"buyer_bid_error_report",
        "columns":[
            "hour",
            "bidder",
            "buyer_member",
            "error_count"
        ],
        "report_interval":"last_48_hours",
        "format":"csv"
    }
}

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

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

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

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

$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=097f59fc3ab7d02c5d60db42081d9b69'
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2010-05-25 19:19:53",
         "json_request":"{\"report\":{\"report_type\":\"buyer_bid_error_report\",\"columns\":[\"hour\",\"bidder\",
            \"buyer_member\",\"error_count\",
            \"report_interval\":\"last_48_hours\"}}",
         "url": "report-download?id=b97897a7864dd8f34e7457226c7af592"
      },
      "execution_status":"ready"
   }
}

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

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

注:

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

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

注:

XLSX および Excel ファイルとしてダウンロードする場合、レポートごとに 100,000 行の制限があります。