ネットワーク デバイス分析

ネットワーク デバイス分析レポートでは、インプレッションが配信されたデバイスに基づいてバイサイドおよびセルサイドのパフォーマンス データを取得できます。 これは、アプリのインストールを促すクリエイティブをトラフィックするため、クリエイティブがアプリと互換性のあるデバイスをターゲットにしていることの確認を求めるアプリ内広告主と連携しているネットワークにとって特に重要です。 また、次の質問に答えるのにも役立ちます。

  • 特定のデバイス メーカーやモデルで何回表示されたことがありますか?
  • 特定の接続タイプ (Wifi/静的、キャリアベースなど) で何回のインプレッションを確認しましたか?
  • 特定の種類のデバイス (タブレットとスマートフォンなど) と比較してパフォーマンスはどうですか?
  • デバイスの特定のメーカーやモデルは、他のメーカーやモデル (Android と Apple など) と比較してどのように機能しますか?
  • 特定の種類の接続は、他の種類の接続と比較してどのように機能しますか (つまり、WiFi/静的接続とキャリアベース)?

時間枠とタイム ゾーン

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

  • 今日
  • yesterday
  • last_2_days
  • last_7_days
  • last_14_days
  • last_30_days
  • month_to_date
  • month_to_yesterday

または、[ start_date ] フィールドと [ end_date ] フィールドを過去 30 日以内の範囲に設定することもできます。 ただし、このレポートでは時間ごとのデータを使用できないため、start_dateend_dateを同じにすることはできません。"YYYY-MM-DD HH:MM:SS"ではなく"YYYY-MM-DD"として書式設定する必要があります。 JSON 要求の timezone フィールドは "UTC" にのみ設定できますが、指定しない場合、タイムゾーンは既定で "UTC" になるため、これは必要ありません。

データ保持期間

このレポートのデータの保持期間は次のとおりです。

  • 時間単位のリテンション期間: 100 日
  • 1 日あたりのリテンション期間: 500 日

Dimensions

種類 フィルター? 説明
month time はい "2010-02" オークションの月。
day time はい "2010-02-01" オークション当日。
device_make_id int はい 1 インプレッションが配信されたデバイス メーカーの ID。 メーカーは、通常、デバイスの製造元 (Apple) です。 デバイス製造 ID と名前の完全な一覧を取得するには、 デバイス製造サービスを使用します。
device_make_name 文字列 いいえ "4G Systems" インプレッションが配信されたデバイス メーカーの名前。 メーカーは、通常、デバイスの製造元 (Apple) です。
device_make 文字列 いいえ "4G Systems (1)" 推奨です
device_model_id int はい 15 インプレッションが配信されたデバイス モデルの ID。 モデルは、通常、特定の製品 (iPhone など) です。 デバイス モデル ID と名前の完全な一覧を取得するには、 デバイス作成サービスを使用します。
device_model_name 文字列 いいえ "DX650" インプレッションが配信されたデバイス モデルの名前。 モデルは、通常、特定の製品 (つまり、 iPhone) です。
device_model 文字列 いいえ "DX650 (15)" 推奨です
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"
operating_system_id int はい 24 デバイスのオペレーティング システムの ID。
- オペレーティング・システム・ファミリー・サービス を使用して、オペレーティング・システム・ファミリーのリストを取得します。
- オペレーティング・システム拡張サービス を使用して、特定のオペレーティング・システム・ファミリー内のオペレーティング・システム・バージョンを検索します。
operating_system_name string はい "Android 2.3.5 Gingerbread" デバイスのオペレーティング システムの名前。
- オペレーティング・システム・ファミリー・サービス を使用して、オペレーティング・システム・ファミリーのリストを取得します。
- オペレーティング・システム拡張サービス を使用して、特定のオペレーティング・システム・ファミリー内のオペレーティング・システム・バージョンを検索します。
operating_system_family_id int はい 2 インプレッションが配信されたデバイスに関連付けられているオペレーティング システム ファミリの ID。
- オペレーティング・システム・ファミリー・サービス を使用して、オペレーティング・システム・ファミリーのリストを取得します。
- オペレーティング・システム拡張サービス を使用して、特定のオペレーティング・システム・ファミリー内のオペレーティング・システム・バージョンを検索します。
operating_system_family_name string はい "Android" インプレッションが配信されたデバイスに関連付けられているオペレーティング システム ファミリの名前。
- オペレーティング・システム・ファミリー・サービス を使用して、オペレーティング・システム・ファミリーのリストを取得します。
- オペレーティング・システム拡張サービス を使用して、特定のオペレーティング・システム・ファミリー内のオペレーティング・システム・バージョンを検索します。
browser_id int はい インプレッションが配信されたブラウザーの ID。 ブラウザー ID と名前の完全な一覧を取得するには、 ブラウザー サービスを使用します。
browser_name string はい インプレッションが配信されたブラウザーの ID。
browser string はい 推奨です
entity_member_id int はい 123 imp_type が次の条件である場合:
1 (空白)
2 (PSA)
3 (既定のエラー)
4 (既定)
6 (Resold)
8 (PSA Result by Default Error)、購入メンバーの ID。それ以外の場合は、販売メンバーの ID。
buyer_member_id int はい 123 購入メンバーの ID。 インプレッションが購入されていない場合、このフィールドには次のいずれかの値が表示されます。
229 = PSA
0 = 空白
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" キャンペーンのカスタム コード。
deal_name string はい "My New Deal" インプレッションのトランザクションに関連付けられている取引の名前。
split_id int はい 342 このデータ セットのインプレッションを購入した分割の ID。 分割は、拡張広告申込情報にのみ適用されます。 キャンペーンを含むレポートでは、 split_id (含まれている場合) が nullされます。
split_name string はい "Mobile split A" このデータ セットのインプレッションを購入した分割の名前。 分割は、拡張広告申込情報にのみ適用されます。 キャンペーンを含むレポートでは、 split_name (含まれている場合) が nullされます。
deal_id int はい 123 インプレッションのトランザクションに関連付けられている取引の ID。
pixel_id int はい 3849 コンバージョン ピクセルの ID。
media_type string はい "Banner" クリエイティブのメディア タイプ。 使用可能な値:
- "Banner"
- "Pop"
- "Interstitial"
- "Video"
- "Text"
- "Expandable"
- "Skin"
メディア タイプの完全なリストを取得するには、 メディア タイプ サービスを使用します。
mediatype_id int はい 1 クリエイティブのメディア タイプの ID。
size string はい "728x90" 配信されるプレースメント/クリエイティブのサイズ。
geo_country string はい "US" 国/地域のコード。
geo_country_name 文字列 いいえ "United States" 国/地域の名前です。
payment_type string はい "cpm", "revshare" ブローカーへの支払いの種類。
revenue_type 文字列 いいえ "CPA" 広告主がメンバーに支払う基準。
revenue_type_id int はい 4 収益の種類の ID。 使用可能な値:
-1 = 支払いなし
0 = 一律 CPM
1 = コストと CPM
2 = コストと利益
3 = CPC
4 = CPA
5 = Revshare
6 = 定額料金
7 = 可変 CPM
8 = 推定 CPM
publisher_name 文字列 いいえ "AppSite" 発行元の名前。
publisher string はい "AppSite (123)" 発行元の名前の後に ID (Xandr 形式) が続きます。
publisher_code 文字列 いいえ "AS123" 発行元のカスタム コード。
pub_rule_name 文字列 いいえ "Publisher Rule Name" パブリッシャー ルールの名前。
pub_rule 文字列 いいえ "Publisher Rule Name (555)" パブリッシャー ルールの名前の後に ID (Xandr 形式) が続きます。
pub_rule_code 文字列 いいえ "AppSitePR123" パブリッシャー ルールのカスタム コード。
bid_type string はい "Manual" インプレッションに入札した時点でノードがいた最適化フェーズ。

: そのインプレッションの評価額が会場の「あきらめた価格」を下回る場合は、以下の入札タイプに「あきらめん」という用語が追加されます。 有効な値は次のとおりです。
- "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 ("Default Error"): タイムアウトの問題で提供される既定のクリエイティブ。
4 ("Default"): 有効な入札単価がなかったために提供されたデフォルトのクリエイティブ。
5 ("保持"): 発行元のサイトで提供される広告主のクリエイティブ。
6 ("転売"): パブリッシャーのインプレッションが第三者の購入者に販売されました。
7 ("RTB"): サードパーティのインベントリで提供される広告主のクリエイティブ。
8 ("PSA エラー"): タイムアウトの問題または既定のクリエイティブがないために配信された公共サービスアナウンス。
9 ("外部インプレッション"): インプレッション トラッカーからのインプレッション。
10 ("外部クリック"): クリック トラッカーからのクリック。
imp_type string はい "Resold" インプレッションのタイプ。 有効な値については、「 imp_type_id」を参照してください。
venue string はい "Venue Name" 最適化システムが入札評価を決定するために使用するドメイン、サイト、タグ、ユーザーの国/地域のクラスターの名前。 キャンペーンで明示的に会場をターゲットにすることはできません。
operating_system_family_id int はい 2 インプレッションが配信されたデバイスに関連付けられているオペレーティング システム ファミリの ID。
- オペレーティング・システム・ファミリー・サービス を使用して、オペレーティング・システム・ファミリーのリストを取得します。
- オペレーティング・システム拡張サービス を使用して、特定のオペレーティング・システム・ファミリー内のオペレーティング・システム・バージョンを検索します。
operating_system_family_name string はい "Android" インプレッションが配信されたデバイスに関連付けられているオペレーティング システム ファミリの名前。
- オペレーティング・システム・ファミリー・サービス を使用して、オペレーティング・システム・ファミリーのリストを取得します。
オペレーティング システム拡張サービスを使用して、特定のオペレーティング システム ファミリ内のオペレーティング システム バージョンを検索します。

指標

説明
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.12359550<br>561797% (クリック数/インプ) x 100 インプレッションに対するクリックの割合 (パーセンテージで表されます)。
ctr double 0.00022187
7080097626
クリック数/インプ クリック数対インプレッション数の割合。
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.877080
097625
(total_convs / imps) x 1,000,000 インプレッション 100 万回あたりのコンバージョン数です。
convs_rate double 0.00022187
7080097626
total_convs / imps インプレッションに対するコンバージョン率。
cost 金銭 16.833378 cost 直接パブリッシャーと購入したサードパーティ インベントリのメディア コストの合計金額。
cpm 金銭 1.66051685
393258
(コスト/インプ) x 1000 インプレッション 1,000 回あたりのメディア コスト。
revenue 金銭 25.767257 booked_revenue + reseller_revenue 直接の広告主 (広告申込情報) と直接のパブリッシャー (再販インプレッション) を通じて予約された合計収益。
booked_revenue 金銭 25.767257 booked_revenue 直接の広告主を通じて予約された合計収益 (ライン アイテム)。
reseller_revenue 金銭 0 reseller_revenue 直接パブリッシャーを通じて再販されたインプレッションの合計収益。
total_rpm 金銭 2.60548314
606741
(収益/IMPS) x 1000 インプレッション 1,000 回あたりの収益。 この値は米国ドルで表示され、買い通貨と売り通貨 (これらの寸法を選択した場合) が表示される可能性があります。
profit 金銭 0.084102 booked_revenue - total_cost booked 収益から総コストを差し引いた金額。
ppm 金銭 0.94496629
2134831
(利益/ imps) x 1000 推奨です。 インプレッション 1,000 回あたりの利益。
total_publisher_rpm 金銭 1.6605168
5393258
(コスト/インプ) x 1000 直接のパブリッシャーとサードパーティのパブリッシャーに支払われたインプレッション 1,000 件あたりのコスト (エラーを含む)。
sold_publisher_rpm double 147.786 (コスト/IMPS) x 1000 -----エラーなし 直接のパブリッシャーとサードパーティのパブリッシャーに支払われたインプレッション 1,000 回あたりのコスト (エラーを含まない)。
sold_network_rpm double 231.888 (収益/INPS) 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 インプあたりの合計コスト。
total_cost_ecpc 金銭 123.45 total_cost/クリック数 クリック単価の合計。
total_cost_ecpa 金銭 123.45 total_cost/コンバージョン コンバージョンあたりの総コスト。
network_profit 金銭 123.45 (booked_revenue + reseller_revenue) - total_cost booked 収益とリセラー収益の合計から総コストを差し引いたもの。
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 インプあたりの利益。
profit_ecpc 金銭 123.45 (booked_revenue - total_cost)/クリック数 クリックあたりの利益。
profit_ecpa 金銭 123.45 (booked_revenue - total_cost)/コンバージョン コンバージョンあたりの利益。
profit_margin 金銭 123.45 (booked_revenue - total_cost)/booked_revenue 購入者の利益率。
device_type string Tablets,mobile phones これは、使用されているデバイスの種類です。
convs_device_make string Apple (26) これは、変換が行われたデバイスです。 これをデバイス メーカーと比較して、インプレッションが発生したデバイスを判断できます。
device_make string Apple (26) これはデバイスのブランド名です。
convs_device_type string Tablets, mobile phones これをデバイス タイプと比較して、コンバージョンが発生したデバイスを判断できます。
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 ファイルには、取得する列 (ディメンションとメトリック) とreport_intervalだけでなく、report_type"network_device_analytics"も含まれている必要があります。 また、特定のディメンションをフィルター処理したり、粒度 (yearmonthday) を定義したり、データを返す形式 (csvexcelhtml) を指定したりすることもできます。 JSON ファイルに含めることができるフィールドの詳細については、「 レポート サービス」を参照してください。 この例では、過去 14 日間の各広告主 1459 の米国インプレッションに関するパフォーマンス データを確認します。 具体的には、デバイスメーカー、デバイスモデル、接続タイプ、インプレッションタイプの各組み合わせについて、インプレッション数、クリック数、費やした合計金額、1000インプレッションあたりの費用、広告主から支払われた金額、および総利益(稼いだお金-費やしたお金)が必要です。

$ cat network_device_analytics

{
    "report": {
        "report_type": "network_device_analytics",
        "filters": [
            {
                "advertiser_id": 1459
            },
            {
                "geo_country": "US"
            }
        ],
        "columns": [
            "day",
            "connection_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_device_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_device_analytics\",\"filters\":[{\"advertiser_id\":1459},
             {\"geo_country\":\"US\"}],\"columns\":[\"day\",\"device_make_id\",\"device_model_id\",\"connection_type\",
             \"imp_type\",\"imps\",\"clicks\",\"cost\",\"cpm\",\"booked_revenue\",\"profit\"],\"format\":\"csv\"]}}",
         "url": "report-download?id=b97897a7864dd8f34e7457226c7af592"
      },
      "execution_status":"ready"
   }
}

レポート 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_device_analytics\",\"filters\":[{\"advertiser_id\":1459},
             {\"geo_country\":\"US\"}],\"columns\":[\"day\",\"device_make_id\",\"device_model_id\",\"connection_type\",
             \"imp_type\",\"imps\",\"clicks\",\"cost\",\"cpm\",\"booked_revenue\",\"profit\"],\"format\":\"csv\"]}}",
         "url": "report-download?id=b97897a7864dd8f34e7457226c7af592"
      },
      "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=b97897a7864dd8f34e7457226c7af592' > /tmp/network_device_analytics.csv

注:

XLSX および Excel ファイルとしてダウンロードする場合、レポートごとに 100,000 行の制限があります。