ネットワーク通信事業者の分析
Network Carrier Analytics レポートを使用すると、デバイスの通信事業者に基づいて、購入側および販売側のパフォーマンス データを取得できます。 これは、通信事業者がキャンペーンのパフォーマンスと広告主の支払いに与える影響を分析するのに特に役立ちます。 また、広告主が各通信事業者に特定のランディング ページを設定する場合は、このレポートを使用して、キャンペーンが実行された通信事業者を特定できます。
このレポートを要求および取得する手順については、以下の 例 を参照してください。
期限
report_interval フィールドは、次のいずれかに設定できます (UTC タイムゾーン)。
- 今日
- yesterday
- last_2_days
- last_7_days
- last_30_days
- month_to_date
- month_to_yesterday
または、 start_date フィールドと end_date フィールドを過去 14 日以内の範囲に設定することもできます。 ただし、このレポートでは時間単位のデータを使用できないため、start_dateとend_dateは同一ではなく、"YYYY-MM-DD HH:MM:SS"ではなく"YYYY-MM-DD"形式にする必要があります。 JSON 要求の timezone フィールドは "UTC"にのみ設定できますが、タイムゾーンが既定で指定されていない場合は "UTC" に設定されるため、これは必要ありません。
データ保持期間
レポートのデータ保持期間は 46 日間です。
Dimensions
| 列 | 種類 | フィルター。 | 例 | 説明 |
|---|---|---|---|---|
month |
time | はい | "2010-02" |
オークションの月。 |
day |
time | はい | "2010-02-01" |
オークションの日。 |
carrier_id |
int | はい | 20 |
インプレッションが配信されたデバイスの通信事業者の ID。 通信事業者 ID と名前の完全な一覧を取得するには、 Carrier Service を使用します。 |
carrier_name |
文字列 | いいえ | "Sprint - FR" |
インプレッションが配信されたデバイスの通信事業者の名前。 |
carrier |
文字列 | いいえ | "Sprint - FR (20)" |
非推奨。 |
device_type |
string | はい | "tablets" |
インプレッションが配信されたデバイスの種類。 使用可能な値は次のとおりです。 - "desktops & laptops"- "tablets"- "mobile phones"- "tv"- "game consoles"- "set top box"- "media players"- "other devices" |
connection_type |
string | はい | "Carrier-based" |
インプレッション時のインターネット接続の種類。 使用可能な値: "Carrier-based" または "Wifi or Static"。 |
entity_member_id |
int | はい | 123 |
imp_typeが1 (空白)、2 (PSA)、3 (既定のエラー)、4 (既定値)、6 (Resold)、または8 (PSA の既定のエラーの結果) である場合は、購入メンバーの ID、それ以外の場合は販売メンバーの ID。 |
buyer_member_id |
int | はい | 123 |
購入メンバーの ID。 インプレッションが購入されなかった場合、このフィールドには次のいずれかの値が表示されます。229 = PSA0 = 空白319 = 既定値 |
buyer_member_name |
文字列 | いいえ | "My Network" |
購入メンバーの名前。 |
buyer_member |
文字列 | いいえ | "My Network (123)" |
非推奨。 |
seller_member_id |
int | はい | 456 |
販売メンバーの ID。 |
seller_member_name |
文字列 | いいえ | "That Seller" |
販売メンバーの名前。 |
seller_member |
文字列 | いいえ | "That Seller (456)" |
非推奨。 |
buyer_type |
string | はい | "Real Time" |
購入者メンバーが購入したメディアの種類。 使用可能な値: "Real Time" または "Direct"。 |
seller_type |
string | はい | "Real Time" |
販売者メンバーが販売するメディアの種類。 使用可能な値: "Real Time" または "Direct"。 |
advertiser_id |
int | はい | 789 |
広告主の ID。 値が 0の場合は、インプレッションが外部バイヤーによって購入されたか、デフォルトまたはPSAが表示されました。 |
advertiser_name |
文字列 | いいえ | "Mobile Zombies" |
広告主の名前。 |
advertiser |
文字列 | いいえ | "Mobile Zombies (789)" |
非推奨。 |
advertiser_code |
文字列 | いいえ | "MZB1010" |
広告主のカスタム コード。 |
insertion_order_id |
int | はい | 321 |
挿入順序の ID。 |
insertion_order_name |
文字列 | いいえ | "Mobile Insertion Order" |
挿入順序の名前。 |
insertion_order |
文字列 | いいえ | "Mobile Insertion Order (321)" |
非推奨。 |
insertion_order_code |
文字列 | いいえ | "Mobile Insertion Order Code" |
挿入順序のカスタム コード。 |
line_item_id |
int | はい | 111 |
明細の ID。 |
line_item_name |
文字列 | いいえ | "Mobile Line Item" |
行項目の名前。 |
line_item |
文字列 | いいえ | "Mobile Line Item (111)" |
非推奨。 |
line_item_code |
文字列 | いいえ | "Mobile Line Item Code" |
行項目のカスタム コード。 |
campaign_id |
int | はい | 222 |
キャンペーンの ID。 |
campaign_name |
文字列 | いいえ | "Mobile Campaign" |
キャンペーンの名前。 |
campaign |
文字列 | いいえ | "Mobile Campaign (222)" |
非推奨。 |
campaign_code |
文字列 | いいえ | "Mobile Campaign Code" |
キャンペーンのカスタム コード。 |
split_id |
int | はい | 342 |
このデータ セット内のインプレッションを購入した分割の ID。 分割は、拡張された明細にのみ適用されます。 キャンペーンを含むレポートの場合、 split_id (含まれている場合) が nullされます。 |
split_name |
string | はい | "Mobile Split 2" |
このデータ セット内のインプレッションを購入した分割の名前。 分割は、拡張された明細にのみ適用されます。 キャンペーンを含むレポートの場合、 split_name (含まれている場合) が nullされます。 |
pixel_id |
int | はい | 3849 |
変換ピクセルの ID。 |
media_type |
string | はい | "Banner" |
クリエイティブのメディアの種類。 使用可能な値: - "Banner" - "Pop"- "Interstitial" - "Video" - "Text" - "Expandable" - "Skin". メディアの種類の完全な一覧を取得するには、 Media Type Service を使用します。 |
mediatype_id |
int | はい | 1 |
クリエイティブのメディアタイプの ID。 |
size |
string | はい | "728x90" |
配信されたプレースメント/クリエイティブのサイズ。 |
geo_country |
string | はい | "US" |
国/地域のコード。 |
geo_country_name |
文字列 | いいえ | "United States" |
国/地域の名前です。 |
payment_type |
string | はい |
"com", "revshare" |
ブローカーへの支払いの種類。 |
revenue_type |
文字列 | いいえ | "CPA" |
広告主がメンバーに支払う基準。 |
revenue_type_id |
int | はい | 4 |
収益の種類の ID。 使用可能な値:-1 = 支払いなし0 = フラット CPM1 = Cost Plus CPM2 = コストプラスマージン3 = CPC4 = CPA5 = Revshare6 = 定額料金7 = 変数 CPM8 = 推定 CPM。 |
publisher |
string | はい | "AppSite (123)" |
非推奨。 |
publisher_code |
文字列 | いいえ | "Publisher Code" |
発行元のカスタム コード。 |
pub_rule_name |
文字列 | いいえ | "Publisher Rule Name" |
発行元ルールの名前。 |
pub_rule |
文字列 | いいえ | "Publisher Rule Name (555)" |
非推奨。 |
pub_rule_code |
文字列 | いいえ | "AppSitePR123" |
発行元ルールのカスタム コード。 |
bid_type |
string | はい | "Manual" |
ノードがインプレッションの入札時に行っていた最適化フェーズ。 そのインプレッションの評価額が会場の "ギブアップ価格" を下回る場合は、以下の入札タイプに "ギブアップ" という用語が追加されることに注意してください。 詳細については、UI ドキュメントの「 会場とは」 と「 価格を放棄 する」を参照してください。 有効な値は次のとおりです。 - "Manual": ベース、EAP、ECP のいずれであっても、CPM 目標で入札する場合に適用されます。- "Learn": 最適化 (CPA、CPC、またはマージン) で入札していて、入札に最適化された十分なデータがまだない場合に適用されます。- "Optimized": 最適化 (CPA、CPC、またはマージン) で入札していて、入札に最適化された十分なデータがある場合に適用されます。- "Unknown": ノードが不明な最適化フェーズにあった。- "Optimized give up"- "Learn give up"- "Manual give up" |
imp_type_id |
int | はい | 6 |
インプレッションの種類の ID。 使用可能な値 (かっこ内の関連する型):1 ("Blank"): クリエイティブは提供されません。2 ("PSA"): 有効な入札がなく、既定のクリエイティブが利用できなかったため、パブリック サービスのお知らせが提供されました。3 ("既定のエラー"): タイムアウトの問題が原因で配信された既定のクリエイティブ。4 ("Default"): 有効な入札がないため、既定のクリエイティブが配信されました。5 ("保持"): 広告主のクリエイティブがパブリッシャーのサイトで配信されました。6 ("Resold"): 発行元の印象がサード パーティの購入者に販売されました。7 ("RTB"): 広告主のクリエイティブがサード パーティの広告枠で配信されました。8 ("PSA エラー"): タイムアウトの問題または既定のクリエイティブがないため、パブリック サービスのお知らせが提供されました。9 ("外部インプレッション"): インプレッション トラッカーからのインプレッション。10 ("外部クリック"): クリック トラッカーからのクリック。 |
imp_type |
string | はい | "Resold" |
インプレッションの種類。 使用可能な値については、「 imp_type_id」を参照してください。 |
venue |
string | はい | "Venue Name" |
Xandr の最適化システムが入札評価を決定するために使用するドメイン、サイト、タグ、ユーザーの国/地域のクラスターの名前。 キャンペーンで会場を明示的にターゲットにすることはできません。 |
指標
| 列 | 型 | 例 | 式 | 説明 |
|---|---|---|---|---|
imps |
int | 2340 |
imps | 合計インプレッション数 (配信数と再販回数)。 |
imps_blank |
int | 3 |
imps_blank | 空白で配信されたインプレッションの数。 |
imps_psa |
int | 5 |
imps_psa | PSA を提供したインプレッションの数。 |
imps_default_error |
int | 0 |
imps_default_error | タイムアウトの問題が原因で既定に設定されたインプレッションの数。 |
imps_default_bidder |
int | 0 |
imps_default_bidder | 有効な入札がないために既定値に設定されたインプレッションの数。 |
imps_kept |
int | 0 |
imps_kept | 広告主がパブリッシャーから購入したインプレッションの数。 |
imps_resold |
int | 0 |
imps_resold | パブリッシャーがサード パーティに販売したインプレッションの数。 |
imps_rtb |
int | 2332 |
imps_rtb | 広告主がサード パーティから購入したインプレッションの数。 |
clicks |
int | 1 |
クリック | すべてのインプレッションに対するクリックの合計数。 |
click_thru_pct |
double | 1.12359550561797% |
(クリック/インプ) x 100 | インプレッションに対するクリック率をパーセンテージで示します。 |
ctr |
double | 0.000221877080097626 |
clicks/imps | インプレッションに対するクリック数の割合。 |
total_convs |
int | 1 |
total_convs | ポストビューとクリック後のコンバージョンの合計数。 |
post_view_convs |
int | 15 |
post_view_convs | 記録されたポストビューコンバージョンの合計数。 |
post_click_convs |
int | 15 |
post_click_convs | クリック後に記録されたコンバージョンの合計数。 |
convs_per_mm |
double | 221.877080097625 |
(total_convs/imps) x 1,000,000 | 100 万インプレッションあたりのコンバージョン数。 |
convs_rate |
double | 0.000221877080097626 |
total_convs/imps | インプレッションへのコンバージョン率。 |
cost |
お金 | 16.833378 |
費用 | 直接発行元とサード パーティのインベントリを購入したメディア コストの合計金額。 |
cpm |
お金 | 1.66051685393258 |
(cost/imps) x 1000 | 1000 インプレッションあたりのメディア コスト。 |
revenue |
お金 | 25.767257 |
booked_revenue + reseller_revenue | 直接広告主 (広告申込情報) と直接パブリッシャー (再販インプレッション) を通じて予約された合計収益。 |
booked_revenue |
お金 | 25.767257 |
booked_revenue | 直接広告主 (広告申込情報) を通じて予約された合計収益。 |
reseller_revenue |
お金 | 0 |
reseller_revenue | 直接パブリッシャーを通じて再販されたインプレッションの合計収益。 |
rpm |
お金 | 2.60548314606741 |
(revenue/imps) x 1000 | 1000 インプレッションあたりの収益。 |
profit |
お金 | 0.084102 |
booked_revenue - total_cost | 予約済み収益から合計コストを差し引いた金額。 |
ppm |
お金 | 0.944966292134831 |
(profit/imps) x 1000 | 非推奨となる。 1000 インプレッションあたりの利益。 |
total_publisher_rpm |
お金 | 1.66051685393258 |
(cost/imps) x 1000 | ダイレクトおよびサード パーティのパブリッシャーに支払われた 1,000 インプレッションあたりのコスト (エラーを含む)。 |
sold_publisher_rpm |
double | 147.786 |
(コスト/imps) x 1000 -----エラーなし | 直接およびサード パーティのパブリッシャーに支払われた 1,000 インプレッションあたりのコスト。エラーは含まれません。 |
sold_network_rpm |
double | 231.888 |
(revenue/imps) x 1000 -----エラーなし | エラーではない 1,000 インプレッションあたりの収益。 |
total_cost |
お金 | 123.45 |
total_cost = media_cost + data_costs + partner_fees + 手数料 + serving_fees + publisher_revenue | 報告された期間に発生したコストの合計金額。 これには一般に、プラットフォームでパブリッシャーの支払いを追跡する場合、予算コスト (メディア コスト、データ コスト、パートナー手数料、サービス手数料、手数料) の 2 種類のコストとパブリッシャー収益が含まれます。 注: 破壊的変更期間中にサードパーティの料金を二重にカウントしないようにロジックを追加しました。 |
total_cost_ecpm |
お金 | 123.45 |
(total_cost/imps) * 1,000 | 1,000 imps あたりの合計コスト。 |
total_cost_ecpc |
お金 | 123.45 |
total_cost/クリック数 | クリックあたりの合計コスト。 |
total_cost_ecpa |
お金 | 123.45 |
total_cost/変換 | コンバージョンあたりの合計コスト。 |
network_profit |
お金 | 123.45 |
(booked_revenue + reseller_revenue) - total_cost | 予約収益とリセラー収益の合計から合計コストを差し引いた合計。 |
network_profit_ecpm |
お金 | 123.45 |
(network_profit/imps) * 1,000 | 1,000 imps あたりのネットワーク利益。 |
network_profit_ecpc |
お金 | 123.45 |
network_profit/クリック数 | クリックあたりのネットワーク利益。 |
network_profit_ecpa |
お金 | 123.45 |
network_profit/変換 | コンバージョンあたりのネットワーク利益。 |
network_profit_margin |
お金 | 123.45 |
network_profit/(booked_revenue + reseller_revenue) | ネットワーク利益マージン。 |
profit_ecpm |
お金 | 123.45 |
((booked_revenue - total_cost)/imps) * 1,000 | 1,000 imps あたりの利益。 |
profit_ecpc |
お金 | 123.45 |
(booked_revenue - total_cost)/クリック | クリックあたりの利益。 |
profit_ecpa |
お金 | 123.45 |
(booked_revenue - total_cost)/conversions | コンバージョンあたりの利益。 |
profit_margin |
お金 | 123.45 |
(booked_revenue - total_cost)/booked_revenue | 買い手の利益マージン。 |
video_skips |
int | 10 |
ユーザーがビデオをスキップした回数の合計。 スキップ可能な在庫を購入する際のレポートには、このメトリックを使用します。 | |
video_starts |
int | 11 |
ビデオ クリエイティブの最初のセグメントがダウンロードされ、開始された合計回数。 | |
video_25_pcts |
int | 10 |
ビデオ クリエイティブが再生時間全体の 25% を完了した合計回数。 | |
video_50_pcts |
int | 10 |
ビデオ クリエイティブが再生時間全体の 50% を完了した合計回数。 | |
video_75_pcts |
int | 10 |
ビデオ クリエイティブが再生時間全体の 75% を完了した合計回数。 | |
video_completions |
int | 12 |
ビデオ クリエイティブの再生時間全体の合計回数。 | |
video_served |
int | 10 |
プレイヤーに提供されたビデオ応答の合計数。VAST ドキュメント (XML) が要求に応答して配信されると、広告応答が発生します。広告応答は、必ずしも成功した印象を示すわけではありません。 インプレッションの場合は、ビデオの最初のフレームを提供する必要があります。 | |
video_errors |
int | 2 |
ビデオ エラーが発生した合計回数。 | |
revenue_per_video_complete |
お金 | 25.76 |
ビデオ完了あたりの収益。 | |
cost_per_video_complete |
お金 | 22.76 |
ビデオの完了あたりのコスト。 | |
video_completion_rate |
double | 1.12359550561797% |
(ビデオ入力候補/合計インプレッション数) x 100 | ビデオの完了とインプレッションの比率。割合で表されます。 |
video_start_rate |
double | 1.12359550561797% |
ビデオ クリエイティブの最初のセグメントがダウンロードされて開始された時間の割合。 | |
video_skip_rate |
double | 1.12359550561797% |
ユーザーがビデオをスキップすることを選択した時間の割合。 |
例
JSON 形式のレポート要求を作成する
JSON ファイルには、"network_carrier_analytics"のreport_typeと、取得する列 (ディメンションとメトリック) とreport_intervalが含まれている必要があります。 また、特定のディメンションをフィルター処理し、粒度 (year、 month、 day) を定義し、データを返す "format" (csv、 excel、または html) を指定することもできます。 JSON ファイルに含めることができるフィールドの詳細については、 レポート サービスに関するページを参照してください。 この例では、3 つの特定の通信事業者の携帯電話とタブレットでキャンペーンがどのように実行されているかを確認します。 具体的には、通信事業者とデバイスの種類の組み合わせごとに、インプレッション数、クリック数、合計使用金額、1,000 インプレッションあたりの支出金額、広告主が支払ったお金、および総利益 (獲得した金額 ) が必要です。
$ cat network_carrier_analytics
{
"report": {
"report_type": "network_carrier_analytics",
"filters": [
{
"carrier_id": [
345,
567,
837
]
},
{
"device_type": [
"mobile phones",
"tablets"
]
}
],
"columns": [
"day",
"carrier_id",
"device_type",
"imp_type",
"imps",
"clicks",
"cost",
"cpm",
"booked_revenue",
"profit"
],
"report_interval": "last_14_days",
"format": "csv"
}
}
POST レポート サービスへの要求
POST レポート ID を取得するための JSON 要求。
$ curl -b cookies -c cookies -X POST -d @network_carrier_analytics 'https://api.appnexus.com/report'
{
"response":{
"status":"OK",
"report_id":"097f59fc3ab7d02c5d60db42081d9b69"
}
}
GET レポート サービスからのレポートの状態
レポート ID を使用して GET 呼び出しを行って、レポートの状態を取得します。
execution_statusが"ready"されるまで、このGET呼び出しを行い続けます。 次の手順で説明するように、 レポート ダウンロード サービスを使用してレポート データをファイルに保存します。
$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=097f59fc3ab7d02c5d60db42081d9b69'
{
"response":{
"status":"OK",
"report":{
"name":null,
"created_on":"2013-02-01 12:19:53",
"json_request": "{\"report\":{\"report_type\":\"network_carrier_analytics\",\"filters\":[{\"advertiser_id\":1459},
{\"geo_country\":\"US\"}],\"columns\":[\"day\",\"carrier_id\",\"device_make\",\"device_model\",\"connection_type\",
\"imp_type\",\"imps\",\"clicks\",\"cost\",\"cpm\",\"booked_revenue\",\"profit\"],\"format\":\"csv\"]}}",
"url": "report-download?id=097f59fc3ab7d02c5d60db42081d9b69"
},
"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=097f59fc3ab7d02c5d60db42081d9b69' > /tmp/network_carrier_analytics.csv
注:
XLSX および Excel ファイルとしてダウンロードする場合、レポートごとに 100,000 行の制限があります。