次の方法で共有


プラットフォーム販売者レポート

プラットフォーム販売者レポートは、購入者に請求書を送ったり、内部トランザクション レコードを調整したりするために使用できます。 このレポートを使用すると、トランザクション情報をタグ レベルで表示できます。

このレポートを取得する手順については、以下の を参照してください。

時間枠

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

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

Dimensions

Column 種類 グループ。 フィルター。 説明
bidder 文字列 いいえ 不要 廃止。
bidder_id int はい はい 入札者の内部 ID。
bidder_name 文字列 いいえ 不要 入札者の表示名。
buyer_member 文字列 いいえ 不要 廃止。
buyer_member 文字列 いいえ いいえ 購入メンバーの表示名の後に ID (Xandr 形式) が続きます。
buyer_member_id int はい はい 購入メンバーの内部 ID。
buyer_member_name 文字列 いいえ いいえ 購入メンバーの表示名。
buyer_member_name 文字列 いいえ いいえ 購入者メンバーの表示名。
cleared_direct int 不要 はい これが 1 に設定されている場合、インプレッションは直接インベントリで正常に配信されました。 使用可能な値:
- 0 = 直接インベントリではない
- 1 = 直接インベントリ
day date はい はい
gender 文字列 いいえ はい ユーザーの性別。
geo_country 文字列 いいえ はい 国の表示名の後に ID (Xandr 形式) が続きます。
geo_country_name 文字列 いいえ 不要 国。
hour date はい はい オークションの時間。

: 100 日を超えるインプレッションの場合、1 時間ではなく日が返されます。
imp_type 文字列 いいえ はい 配信されたインプレッションの種類。 使用可能な値:
- 1 = 空白
- 2 = PSA
- 3 = 既定のエラー
- 4 = 既定値
- 5 = 保持
- 6 = 再販
- 7 = RTB
- 8 = 既定のエラーに起因する PSA
- 9 = 外部インプレッション
- 10 = 外部クリック
is_delivered ブール値 いいえ はい true の場合、インプレッションは正常に配信されました。
is_dw ブール値 いいえ はい true の場合、インプレッションは Xandr によって提供されました。
month time はい 不要
price_bucket_id int はい 不要 価格バケットの ID。 価格バケットの詳細については、メンバー サービスのフィールドのprice_buckets説明を参照してください。
publisher 文字列 いいえ いいえ 廃止。
publisher_code 文字列 いいえ 不要 外部システム内の発行元コードに対応するために入力された発行元のカスタム コード。
publisher_id int はい はい パブリッシャーの内部 ID。
publisher_name 文字列 いいえ 不要 発行元の表示名。
seller_currency 文字列 いいえ はい 販売者メンバーが選択した通貨。 サポートされている通貨の一覧については、「 サポートされている通貨」を参照してください。
seller_member 文字列 いいえ 不要 廃止。
seller_member_id int はい はい メンバーの内部 ID。
seller_member_name 文字列 いいえ 不要 販売者メンバーの表示名。
site 文字列 いいえ 不要 廃止。
site_code 文字列 いいえ 不要 外部システム内のサイト コードに対応するために入力されたサイトのカスタム コード。
site_id int はい はい サイトの内部 ID。
site_name 文字列 いいえ 不要 サイトの表示名。
size 文字列 いいえ 不要 クリエイティブのサイズ。
supply_type 文字列 いいえ 不要 インベントリの種類。 使用可能な値:
- "web"
- "mobile_web"
- "mobile_app"
tag 文字列 いいえ 不要 廃止。
tag_id int はい 不要 タグの ID。
tag_name 文字列 いいえ 不要 タグの表示名。
year date はい はい 年。

指標

Column 種類 説明
auction_service_deduction お 金 auction_service_deduction RTB の控除は、購入者メンバーの契約で指定されたインプレッションを購入しました。 たとえば、10% の控除で、キャンペーンの予算が $1000 の場合、そのキャンペーンから $100 を受け取り、販売者から在庫を購入するために使用される $900 を買い手に残します。
auction_service_fees お 金 auction_service_fees RTB で請求された料金は、購入者メンバーの契約で指定されたインプレッションを購入しました。 たとえば、10% の手数料で、購入者が在庫に $1000 を費やした場合、100 ドルの手数料が請求されます。
buyer_spend お 金 buyer_spend 買い手がメディアのコストに対して支払う金額。
clear_fees お 金 clear_fees 外部またはパートナーの販売者から購入したインプレッションに対して請求される購入者メンバーの契約で指定された料金。
clicks int clicks クリックの合計数。
creative_overage_fees お 金 creative_overage_fees 購入者メンバーの契約で指定されたクリエイティブ サイズ制限を超えるホストクリエイティブの料金。
imps int imps 合計インプレッション数 (配信数と再販回数)。
imps_delivered int imps_delivered 正常に配信されたインプレッションの合計数。
imps_not_delivered int imps_not_delivered Xandr 以外のユーザーがインプレッションを提供したインプレッションの合計数。
imps_viewed int imps_viewed IAB ビューアビリティ定義に従って表示可能だった測定されたインプレッションの数。これは、1 秒間にピクセルの 50% が表示されている場合に表示可能であることを示します。
seller_ecpm お 金 ( seller_revenue / imps_delivered ) * 1000 売り手の収益は eCPM で表されます。
seller_ecpm_seller_curr お 金 (seller_revenue / imps_delivered) * 1000、売り手の通貨で表されます。 販売者が選択した通貨で、eCPM で表される販売者の収益。 サポートされている通貨の一覧については、「 サポートされている通貨」を参照してください。
seller_revenue お 金 seller_revenue インプレッションあたりの販売者の収益。
seller_revenue_seller_curr お 金 seller_revenueは、販売者の通貨で表されます。 選択した通貨でのインプレッションあたりの販売者の収益。 サポートされている通貨の一覧については、「 サポートされている通貨」を参照してください。
view_measurable_rate double view_measurable_rate 総インプレッション数のうち視認性を測定したインプレッションの割合。 (測定された Imps/Imps を表示する)
view_measured_imps int view_measured_imps 視認性のために測定されたインプレッションの合計数。
view_rate double view_rate 視認性を測定したインプレッションの総数のうち、表示可能だったインプレッションの割合。 (表示された Imps/View Measured Imps)

管理者にのみ表示

Column 種類 説明
forex_allowance お 金 forex_allowance 外貨バッファー許容量。
discrepancy_allowance お 金 discrepancy_allowance 売り手メンバーの契約で指定された RTB 販売インプレッションの控除。 これは、Xandr と供給パートナーが獲得したインプレッションとして記録された過去の不一致に基づいて決定されます。

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

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

$ cat report
{
    "report": {
        "report_type": "platform_seller",
        "timezone": "PST",
        "report_interval": "last_7_days",
        "name": "SSP Monthly Buyer Report",
        "columns": [
            "day",
            "seller_member",
            "publisher_id",
            "publisher_name",
            "publisher_code",
            "buyer_member_id",
            "buyer_member_name",
            "imps",
            "imps_delivered",
            "seller_revenue",
            "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",
  }
}

レポート サービスからレポートの状態を取得する

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

$ 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"
   }
}

レポート ダウンロード サービスからレポート データを取得する

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

ヒント

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

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

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

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

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