ネットワーク デバイス分析レポートでは、インプレッションが配信されたデバイスに基づいてバイサイドおよびセルサイドのパフォーマンス データを取得できます。 これは、アプリのインストールを促すクリエイティブをトラフィックするため、クリエイティブがアプリと互換性のあるデバイスをターゲットにしていることの確認を求めるアプリ内広告主と連携しているネットワークにとって特に重要です。 また、次の質問に答えるのにも役立ちます。
- 特定のデバイス メーカーやモデルで何回表示されたことがありますか?
- 特定の接続タイプ (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_dateとend_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.000221877080097626 |
クリック数/インプ | クリック数対インプレッション数の割合。 |
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 |
cost | 直接パブリッシャーと購入したサードパーティ インベントリのメディア コストの合計金額。 |
cpm |
金銭 | 1.66051685393258 |
(コスト/インプ) 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.60548314606741 |
(収益/IMPS) x 1000 | インプレッション 1,000 回あたりの収益。 この値は米国ドルで表示され、買い通貨と売り通貨 (これらの寸法を選択した場合) が表示される可能性があります。 |
profit |
金銭 | 0.084102 |
booked_revenue - total_cost | booked 収益から総コストを差し引いた金額。 |
ppm |
金銭 | 0.944966292134831 |
(利益/ imps) x 1000 | 非推奨です。 インプレッション 1,000 回あたりの利益。 |
total_publisher_rpm |
金銭 | 1.66051685393258 |
(コスト/インプ) 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"も含まれている必要があります。 また、特定のディメンションをフィルター処理したり、粒度 (year、 month、 day) を定義したり、データを返す形式 (csv、 excel、 html) を指定したりすることもできます。 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 行の制限があります。