次の方法で共有


ネットワーク課金

警告

このレポートは非推奨になりました。 その結果、2015 年 10 月 1 日 より前 の請求アクティビティにのみ使用する必要があります。 2015 年 10 月 1 日以降のレポートについては、 購入請求レポート販売請求レポートを参照してください。

Network Billing Analytics レポートを使用すると、次のデータ全体で課金データを表示できます。

  • 直接広告主のインプレッション (直接のパブリッシャー間で購入され、リアルタイムインベントリ)
  • 直接パブリッシャー (直接広告主やその他のプラットフォーム購入者全体で販売)

レポートを取得する手順については、「 Report Service」を参照してください。

注:

100 日を超えるインプレッションの場合、ネットワーク課金レポートは一部の列で既定値を返すようになりました。

  • クリエイティブは、 と と の一般的な creative_namecreative_id使用して 0 1 行に集計されます。
  • 配置は、 と 汎用 placement_nameplacement_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_dateend_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_id1 行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_id1 行-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 = フラット CPM
1 = Cost Plus CPM
2 = コストプラスマージン
3 = CPC
4 = CPA
5 = Revshare
6 = 定額料金
7 = 変数 CPM
8 = 推定 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、、) を定義し、monthdayデータを返す形式 (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 行の制限があります。