ネットワーク課金
警告
このレポートは非推奨になりました。 その結果、2015 年 10 月 1 日 より前 の請求アクティビティにのみ使用する必要があります。 2015 年 10 月 1 日以降のレポートについては、 購入請求レポート と 販売請求レポートを参照してください。
Network Billing Analytics レポートを使用すると、次のデータ全体で課金データを表示できます。
- 直接広告主のインプレッション (直接のパブリッシャー間で購入され、リアルタイムインベントリ)
- 直接パブリッシャー (直接広告主やその他のプラットフォーム購入者全体で販売)
レポートを取得する手順については、「 Report Service」を参照してください。
注:
100 日を超えるインプレッションの場合、ネットワーク課金レポートは一部の列で既定値を返すようになりました。
- クリエイティブは、 と と の一般的な
creative_name
をcreative_id
使用して0
1 行に集計されます。 - 配置は、 と 汎用
placement_name
のplacement_id
を使用して-1
1 行に集計されます。 hour
- 1 時間ごとのデータは、"YYYY-MM-DD 00:00:00" の 1 行に集計されます ('YYYY-MM-DD' はアクティビティが発生した UTC 日です)。 これにより、すべてのアクティビティが真夜中に発生したかのように見えるようになります。 100 日を超える日単位のデータはすべて UTC タイム ゾーンで返されます。
時間枠
フィールドは report_interval
、次のいずれかに設定できます。
- current_hour
- last_hour
- 今日
- yesterday
- last_48_hours
- last_2_days
- last_7_days
- last_30_days
- month_to_date
- month_to_yesterday
- quarter_to_date
- last_month
- 有効 期間
データ保持期間
このレポートのデータ保持期間は 30 日間です。
注:
カスタム時間枠のレポートを実行するには、レポート要求の フィールド start_date
と end_date
フィールドを設定します。 これらのフィールドの詳細については、「 Report Service」を参照してください。
Dimensions
Column | 種類 | フィルター。 | 例 | 説明 |
---|---|---|---|---|
entity_member_id |
int | はい | 123 |
-- |
buyer_member_id |
int | はい | 123 |
購入者メンバーの内部 ID |
buyer_member_name |
文字列 | いいえ | "My Network" |
購入者メンバーの表示名 |
buyer_member |
文字列 | いいえ | "My Network (123)" |
非推奨 (2016 年 10 月 17 日現在)。 |
buyer_type |
string | はい | "Real Time" , "Direct" |
購入者の種類 |
buyer_currency |
string | はい | "USD" |
購入者の通貨。 |
seller_member_id |
int | はい | 456 |
販売者メンバーの内部 ID |
seller_member_name |
文字列 | いいえ | "That Seller" |
販売者メンバーの表示名 |
seller_member |
文字列 | いいえ | "That Seller (456)" |
非推奨 (2016 年 10 月 17 日現在)。 |
seller_type |
string | はい | "Real Time" , "Direct" |
販売者の種類 |
insertion_order_id |
int | はい | 451 |
挿入順序の内部 ID |
insertion_order_name |
文字列 | いいえ | "Q1-2014" |
挿入順序の表示名 |
campaign_id |
int | はい | 728 |
キャンペーンの内部 ID |
campaign_name |
文字列 | いいえ | "Test" |
キャンペーンの表示名 |
campaign |
文字列 | いいえ | "Test (728)" |
非推奨 (2016 年 10 月 17 日現在)。 |
creative_id |
int | はい | 554 |
クリエイティブの内部 ID。 注: 100 日を超えるインプレッションの場合、クリエイティブは として creative_id 1 行0 に集計されます。 外部クリックまたはインプレッション トラッカーの場合は、 creative_id または "External Imps" になります"External Clicks" 。 |
creative_name |
文字列 | いいえ | "Q1 2010 - 728x90" |
クリエイティブの表示名。 注: 100 日を超えるインプレッションの場合、クリエイティブは一般的 creative_name な で 1 行に集計されます。 外部クリックまたはインプレッション トラッカーの場合は、 creative_name または "External Imps" になります"External Clicks" 。 |
creative |
文字列 | いいえ | "Q1 2010 - 728x90 (554)" |
非推奨 (2016 年 10 月 17 日現在)。 |
placement_id |
int | はい | 567 |
配置の内部 ID。 注: 100 日を超えるインプレッションの場合、配置は として placement_id 1 行-1 に集計されます。 |
placement_name |
文字列 | いいえ | "Photos 728x90" |
配置の表示名。 注: 100 日を超えるインプレッションの場合、配置は一般的 placement_name な を持つ 1 行に集計されます。 |
placement |
文字列 | いいえ | "Photos 728x90 (567)" |
非推奨 (2016 年 10 月 17 日現在)。 |
imp_type_id |
int | はい | 1 |
インプレッションの種類の ID。 使用可能な値 (かっこ内の関連する型): - 1 ("Blank"): クリエイティブは提供されません。- 2 ("PSA"): 有効な入札がなく、既定のクリエイティブが利用できなかったため、パブリック サービスのお知らせが提供されました。- 3 ("既定のエラー"): タイムアウトの問題が原因で配信された既定のクリエイティブ。- 4 ("Default"): 有効な入札がないため、既定のクリエイティブが配信されました。- 5 ("保持"): 広告主のクリエイティブがパブリッシャーのサイトで配信されました。- 6 ("Resold"): 発行元の印象がサード パーティの購入者に販売されました。- 7 ("RTB"): 広告主のクリエイティブがサード パーティの広告枠で配信されました。- 8 ("PSA エラー"): タイムアウトの問題または既定のクリエイティブがないため、パブリック サービスのお知らせが提供されました。- 9 ("外部インプレッション"): インプレッション トラッカーからのインプレッション。- 10 ("外部クリック"): クリック トラッカーからのクリック。 |
imp_type |
string | はい | "Blank" |
インプレッションの種類。 使用可能な値については、を参照してください imp_type_id 。 |
revenue_type |
string | はい | "CPA" |
メンバーが支払われる基準。 |
revenue_type_id |
int | はい | 4 |
収益の種類の ID。 使用可能な値:-1 = 支払いなし0 = フラット CPM1 = Cost Plus CPM2 = コストプラスマージン3 = CPC4 = CPA5 = Revshare6 = 定額料金7 = 変数 CPM8 = 推定 CPM |
payment_type |
string | はい | "com" , "revshare" |
ブローカーへの支払いの種類。 |
cleared_direct |
int | はい | 0 , 1 |
買い手がメディアのコストのために売り手に直接支払うかどうか。 の場合 0 、Xandr は買い手からメディアのコストを収集し、売り手に支払います。 の場合 1 、買い手は売り手に直接メディアのコストを支払います。 ヒント: 購入者は、"クリアされた直接" トランザクションを除外することで、請求書のメディアのコストを一致させることができます。 |
hour |
time | 不要 | "2010-02-01 06:00:00" |
印象の時間。 注: 100 日を超えるインプレッションの場合、1 時間あたりのデータは 1 行に集計され、"YYYY-MM-DD 00:00:00" は時間 ('YYYY-MM-DD' はアクティビティが発生した UTC 日) になります。 これにより、すべてのアクティビティが真夜中に発生したかのように見えるようになります。 100 日を超える日単位のデータはすべて UTC タイム ゾーンで返されます。 |
day |
time | 不要 | "2010-02-01 " |
印象の日。 |
month |
time | 不要 | "2010-02" |
印象の月。 |
advertiser_id |
int | はい | 789 |
広告主の内部 ID |
advertiser_name |
文字列 | いいえ | "Verizon" |
広告主の表示名 |
advertiser |
文字列 | いいえ | "Verizon (789)" |
非推奨 (2016 年 10 月 17 日現在)。 |
advertiser_currency |
string | はい | "USD" |
広告主の通貨。 |
line_item_id |
int | はい | 932 |
明細の内部 ID |
line_item_name |
文字列 | いいえ | "$3 CPM Verizon Remarketing" |
明細の表示名 |
line_item |
文字列 | いいえ | "$3 CPM Verizon Remarketing (932)" |
非推奨 (2016 年 10 月 17 日現在)。 |
publisher_id |
int | はい | 123 |
パブリッシャーの内部 ID |
publisher_name |
文字列 | いいえ | "Microsoft" |
発行元の表示名 |
publisher |
文字列 | いいえ | "Microsoft (123)" |
非推奨 (2016 年 10 月 17 日現在)。 |
publisher_currency |
string | はい | Yes |
発行元の通貨。 |
salesperson_for_advertiser |
string | はい | "Ray Parcino" |
広告主の営業担当者。 詳細については、"labels" 広告主サービスのフィールドを参照してください。 |
salesperson_for_publisher |
string | はい | "Brian Young" |
発行元の営業担当者。 詳細については、"labels" パブリッシャー サービスのフィールドを参照してください。 |
account_manager_for_advertiser |
string | はい | "Rachel Dina" |
広告主のアカウント マネージャー。 詳細については、"labels" 広告主サービスのフィールドを参照してください。 |
account_manager_for_publisher |
string | はい | "Ami Fisher" |
パブリッシャーのアカウント マネージャー。 詳細については、"labels" パブリッシャー サービスのフィールドを参照してください。 |
trafficker_for_line_item |
string | はい | "Maurice Truman" |
行項目の入稿者。 詳細については、"labels" 明細サービスのフィールドを参照してください。 |
salesrep_for_line_item |
string | はい | "Beverly Heller" |
明細の営業担当者。 詳細については、"labels" 明細サービスのフィールドを参照してください。 |
指標
Column | 型 | 例 | 式 | 説明 |
---|---|---|---|---|
imps |
int | 234123 |
Imps | 合計インプレッション数 |
clicks |
int | 545 |
クリック | すべてのインプレッションに対するクリックの合計数 |
convs |
int | 205 |
total_convs | すべてのインプレッションのコンバージョンの合計数 |
media_cost |
お 金 | 304.36 |
media_cost | 購入した在庫の合計コスト。 |
media_cost_pub_curr |
お 金 | 201.34 |
media_cost_pub_curr | 発行元の通貨で購入した在庫の合計コスト。 |
media_cost_adv_curr |
お 金 | 201.34 |
media_cost_adv_curr | 購入した在庫の合計コスト (広告主の通貨)。 注: Xandr を通じて収益を追跡していない場合、これは になります 0 。 |
net_media_cost |
お 金 | 211.23 |
media_cost - auction_service_deduction | 購入した在庫の合計コスト。購入者のオークション サービス料金の控除を減らします。 |
net_media_cost_adv_curr |
お 金 | 211.23 |
media_cost_adv_curr - auction_service_deduction_adv_curr | 購入した在庫の合計コスト。購入者のオークション サービス料金の控除を広告主の通貨で減らします。 注: Xandr を通じて収益を追跡していない場合、これは になります 0 。 |
ecpm |
お 金 | 1.30 |
(spend/imps) x 1000 | 1,000 インプレッションあたりの支出金額。 |
ecpm_pub_curr |
お 金 | 1.30 |
(spend/imps) x 1000 | パブリッシャーの通貨で、1,000 インプレッションあたりに費やされた金額。 |
ctr |
double | 0.002327 |
clicks/imps | インプレッションに対するクリック数の割合 |
convs_rate |
double | 0.000856 |
total_convs/imps | インプレッションへのコンバージョン率 |
network_revenue |
お 金 | 1201.13 |
network_revenue | 直接広告主を通じて予約され、リアルタイム購入者に転売されるネットワーク収益 |
booked_revenue |
お 金 | 1201.13 |
booked_revenue | 直接広告主を通じて予約されたネットワーク収益。 |
booked_revenue_adv_curr |
お 金 | 970.24 |
booked_revenue_adv_curr | 直接広告主を通じて予約されたネットワーク収益(広告主の通貨)。 |
network_profit |
お 金 | 801.08 |
network_revenue - media_cost | 直接広告主を通じて予約され、リアルタイムバイヤーに転売されたネットワーク利益。 |
network_rpm |
お 金 | 5.13 |
(network_revenue/imps) x 1000 | 1 ミルあたりのネットワーク収益 (1,000 imps) |
network_ppm |
お 金 | 3.42 |
(network_profit/imps) x 1000 | 1 ミルあたりのネットワーク利益 (1000 imps) |
network_roi |
double | 2.94 |
(network_revenue/media_cost) - 1 | ネットワーク投資収益率。 パーセンテージとして返されます(例: 0.94 = 94%) |
advertiser_revenue |
お 金 | advertiser_revenue | 広告主に記録された収益。 | |
advertiser_profit |
お 金 | advertiser_revenue - media_cost | 広告主の利益 | |
advertiser_rpm |
お 金 | (advertiser_revenue/imps) x 1000 | 1 ミルあたりの広告主収益 (1,000 imps) | |
advertiser_ppm |
お 金 | (advertiser_profit/imps) x 1000 | 1 ミルあたりの広告主利益 (1000 imps) | |
advertiser_roi |
お 金 | (advertiser_revenue/media_cost) x 1000 | 広告主の投資収益率 | |
spend |
お 金 | 304.36 |
media_cost | |
creative_overage_fees |
お 金 | creative_overage_fees | クリエイティブのサイズ制限を超えるホスト型クリエイティブに対して請求される合計料金。 | |
creative_overage_fees_adv_curr |
お 金 | creative_overage_fees_adv_curr | 広告のサイズ制限を超えるホスト型クリエイティブに対して請求される合計料金 (広告主の通貨)。 注: Xandr を通じて収益を追跡していない場合、これは になります 0 。 |
|
auction_service_fees |
お 金 | auction_service_fees | サード パーティから購入したインプレッションに対して課金される合計料金。 これらの料金は、購入者のメディアコストに加えて課金されます。 詳細については、収益化に関するドキュメントの 「Buyer Auction Service Charge Mechanics 」を参照してください。 | |
auction_service_fees_adv_curr |
お 金 | auction_service_fees_adv_curr | 第三者から購入したインプレッションに対して、広告主の通貨で請求される合計料金。 これらの料金は、購入者のメディアコストに加えて課金されます。 詳細については、収益化に関するドキュメントの 「Buyer Auction Service Charge Mechanics 」を参照してください。 注: Xandr を通じて収益を追跡していない場合、これは になります 0 。 |
|
auction_service_deduction |
お 金 | auction_service_deduction | サード パーティから購入したインプレッションに対して請求される合計控除。 これらの控除は買い手のメディアコストに含まれ、販売者の支払いを計算するときに差し引かれます。 | |
auction_service_deduction_adv_curr |
お 金 | auction_service_deduction_adv_curr | 第三者から購入したインプレッションに対して、広告主の通貨で請求される合計控除。 これらの控除は買い手のメディアコストに含まれ、販売者の支払いを計算するときに差し引かれます。 注: Xandr を通じて収益を追跡していない場合、これは になります 0 。 |
|
reseller_revenue |
お 金 | 304.23 |
reseller_revenue | 外部 (RTB) バイヤーへの売上を通じて生成される収益。 |
reseller_revenue_pub_curr |
お 金 | 304.23 |
reseller_revenue_pub_curr | 外部 (RTB) 購入者に対する売上を通じて生じた収益を、発行元の通貨で示します。 |
例
JSON 形式のレポート要求を作成する
JSON ファイルには、report_type "network_analytics"
と、取得する列 (ディメンションとメトリック) report_interval
が含まれている必要があります。 また、特定のディメンションをフィルター処理し、粒度 (year
、、) を定義し、month
day
データを返す形式 (csv
、、excel
またはhtml
) を指定することもできます。 JSON ファイルに含めることができるフィールドの詳細については、 レポート サービスに関するページを参照してください。
$ cat network-billing-request.json
{
"report": {
"format": "csv",
"report_interval": "last_48_hours",
"columns": [
"seller_member_id",
"buyer_member_id",
"imps",
"clicks",
"convs_rate"
],
"report_type": "network_billing"
}
}
POST
レポート サービスへの要求
$ curl -b cookies -c cookies -X POST -d @network-billing-request.json 'https://api.appnexus.com/report'
{
"response": {
"status": "OK",
"report_id": "a2add615a52f0ca4ed13f64ce9d94a5c",
"existing": false
}
}
GET
レポート サービスからのレポートの状態
レポート ID を GET
使用して呼び出しを行って、レポートの状態を取得します。 が "ready"
になるまでこの呼び出しをexecution_status
続けます。 次に、 レポート ダウンロード サービスを使用して、レポート データをファイルに保存します (次の手順で説明します)。
$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=097f59fc3ab7d02c5d60db42081d9b69'
{
"response": {
"status": "OK",
"report": {
"name": "",
"created_on": "2014-04-07 15:51:19",
"json_request": "{\"report\":{\"format\":\"csv\",\"report_interval\":\"last_48_hours\",\"columns\":[\"seller_member_id\",\"buyer_member_id\",\"imps\",\"clicks\",\"convs_rate\"],\"report_type\":\"network_billing\",\"filters\":[{\"entity_member_id\":\"1309\"}]}}",
"url": "https://hb.nym1.sand-08.adnxs.net/report-download?id=a2add615a52f0ca4ed13f64ce9d94a5c"
},
"execution_status": "ready"
}
}
GET
レポート ダウンロード サービスからのレポート データ
レポート データをファイルにダウンロードするには、レポート ID を使用して別 GET
の呼び出しを行いますが、今回はサービスに report-download
対して呼び出します。 サービスとレポート ID は、前GET
の応答のフィールドにありますurl
。 保存するファイルを識別する場合は、最初POST
の で指定した の"format"
ファイル拡張子を使用してください。
ヒント
ダウンロード中にエラーが発生した場合、応答ヘッダーには HTTP エラー コードとメッセージが含まれます。 -i
-v
または を呼び出して応答ヘッダーを公開します。
$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=a2add615a52f0ca4ed13f64ce9d94a5c > /tmp/network-billing-report.csv
注:
XLSX および Excel ファイルとしてダウンロードする場合、レポートごとに 100,000 行の制限があります。