次の方法で共有

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

  • [アーティクル]

このページの販売者プラットフォーム課金レポートについて説明します。 サプライヤーは、販売者プラットフォーム課金レポートを使用して取引情報を収集し、購入者に請求書を送るか、内部トランザクション レコードを調整します。

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

期限

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

列 種類 群。 フィルター。 説明
bidder 文字列 いいえ いいえ 非推奨。
bidder_id int はい はい 入札者の内部 ID。
bidder_name 文字列 いいえ いいえ 入札者の表示名。
buyer_currency 文字列 いいえ はい 購入者メンバーが選択した通貨。 サポートされている通貨の一覧については、「 サポートされている通貨」を参照してください。
buyer_member 文字列 いいえ いいえ 非推奨。
buyer_member_id int はい はい 購入者メンバーの内部 ID。
buyer_member_name 文字列 いいえ いいえ 購入者メンバーの表示名。
cleared_direct int いいえ はい これが 1 に設定されている場合、インプレッションは直接インベントリで正常に配信されました。
使用可能な値:
- 0 = 直接在庫ではありません
- 1 = 直接在庫
day date はい はい 日
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 はい いいえ 月
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 文字列 いいえ いいえ サイトの表示名。
year date はい はい 年。

指標

列 種類 式 説明
imps int imps 合計インプレッション数 (配信数と再販回数)。
imps_delivered int imps_delivered 正常に配信されたインプレッションの合計数。
imps_not_delivered int imps_not_delivered Xandr 以外のユーザーがインプレッションを提供したインプレッションの合計数。
imps_appnexus_cleared int imps_appnexus_cleared Xandr がメディアのコストを収集し、この購入者と売り手のペア間のトランザクションに対して販売者の支払いを行うインプレッションの合計数。
imps_direct_cleared int imps_direct_cleared Xandr がメディアのコストを収集したり、この購入者と売り手のペア間の取引に対して売り手の支払いを支払ったりしないインプレッションの合計数。
seller_revenue お金 seller_revenue インプレッションあたりの販売者の収益。
seller_revenue_appnexus_cleared お金 seller_revenue for imps_appnexus_cleared Xandr が販売者の支払いを行うインプレッションの販売者の収益。
seller_revenue_direct_cleared お金 seller_revenue for imps_direct_cleared 販売者の支払いが AppNexus を通じてではなく、この購入者と販売者のペアの間で直接取引されるインプレッションの販売者の収益。
seller_ecpm お金 seller_revenue x 1000 / imps_delivered 売り手の収益は eCPM で表されます。
seller_revenue_seller_curr お金 seller_revenue, expressed in the seller's currency. 選択した通貨でのインプレッションあたりの販売者の収益。 サポートされている通貨の一覧については、「 サポートされている通貨」を参照してください。
seller_revenue_appnexus_cleared_seller_curr お金 seller_revenue for imps_appnexus_cleared, expressed in the seller's currency. Xandr が選択した通貨で販売者の支払いをインプレッションごとに支払うインプレッションの販売者の収益。 サポートされている通貨の一覧については、「 サポートされている通貨」を参照してください。
seller_revenue_direct_cleared_seller_curr お金 seller_revenue for imps_direct_cleared, expressed in the seller's currency. 売り手の支払いが、選択した通貨で、インプレッションごとに Xandr を通じてではなく、この購入者と販売者のペアの間で直接取引されるインプレッションの販売者の収益。 サポートされている通貨の一覧については、「 サポートされている通貨」を参照してください。
seller_revenue_direct_cleared_buyer_curr お金 seller_revenue for imps_direct_cleared, expressed in the buyer's currency. 売り手の支払いがこの購入者と売り手のペアの間で直接取引され、購入者が選択した通貨で、インプレッションごとに Xandr を通じて取引されないインプレッションの販売者の収益。 サポートされている通貨の一覧については、「 サポートされている通貨」を参照してください。
seller_ecpm_seller_curr お金 (seller_revenue / imps_delivered) * 1000, expressed in the seller's currency 販売者が選択した通貨で、eCPM で表される販売者の収益。 サポートされている通貨の一覧については、「 サポートされている通貨」を参照してください。

例

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

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

$ cat report {
            "report": { "report_type": "seller_invoice_report", "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" ] }
            }

注:

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

POST Reporting Service への要求

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

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

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

$ curl -b cookies -c
            cookies 'https://api.appnexus.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 呼び出しを行いますが、今回は *report-download* サービスに呼び出します。 サービスとレポート ID は、前のGET応答の [{{url}}] フィールドにあります。 保存するファイルを特定するときは、最初の POSTで指定した "形式" のファイル拡張子を使用してください。

  • ダウンロード中にエラーが発生した場合、応答ヘッダーには HTTP エラー コードとメッセージが含まれます。 応答ヘッダーを公開するには、呼び出しで {{-i}} または {{-v}} を使用します。
  • レポートを最初に投稿したときの応答で指定された ID を使用します。
$ curl -b cookies -c cookies
                  'https://api.appnexus.com/report-download?id=bfe2ba2ea54a51115db942d591a7b5d9' >
               report.csv

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

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