地理分析レポート

Geo Analytics レポートでは、キャンペーンのデリバリーとパフォーマンスを地理的エリア別に分類できます。 このレポートのユース ケースの例を次に示します。

  • キャンペーンの最適化を望む購入者
  • キャンペーン配信についてクライアントの広告主または代理店に報告する必要がある購入者

このレポートでは、以下の地理的境界に沿ってキャンペーンのパフォーマンスを分類できます:

使用可能なデータ フィールドとその定義の詳細については、以下の「 ディメンション と メトリック 」を参照してください。

このレポートの実行手順については、「 例」を参照してください。

注:

IP アドレスによるユーザーの地理的場所の特定の精度について

地理データの精度、特に外部の供給パートナーから購入したインプレッションの精度には制限があります。 一部の外部供給パートナー (Google アド マネージャーなど) はユーザーの IP の最後のオクテットを切り捨てるため、IP geo 参照を実行するときに使用する IP の精度が低くなります。 そのため、これらの供給ソースから購入されたインプレッションについては、地理データが細かいレベル (地域や DMA など) で完全に正確であるとは限りません。

時間枠

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

  • 今日
  • yesterday
  • last_7_days

データ保持期間

このレポートのデータ保持期間は 180 日です。

注:

カスタムの時間枠でレポートを実行するには、レポート要求の start_date フィールドと end_date フィールドを設定します。 これらのフィールドの詳細については、「 Report Service」を参照してください。

Dimensions

列 種類 フィルター? 説明
month date はい オークションが行われた年と月。
day date はい オークションが行われた年、月、日。
hourly date はい オークションが行われた時間。
member_id int はい メンバーの ID。
advertiser_currency string はい 広告主が使用する通貨の種類。
insertion_order_id int はい 広告掲載オーダーの ID。
campaign_id int はい キャンペーン ID。
campaign_name 文字列 いいえ オークションに関連付けられているキャンペーンの名前。
campaign 文字列 いいえ 非推奨です。
advertiser_id int はい 広告主 ID。 値が 0 の場合は、インプレッションが外部購入者によって購入されたか、既定または PSA が表示された場合です。
line_item_id int はい 品目 ID。
advertiser_name 文字列 いいえ 広告主の名前。
advertiser 文字列 いいえ 非推奨です。
split_id int はい このデータ セットのインプレッションを購入した分割の ID。 分割は、拡張広告申込情報にのみ適用されます。 キャンペーンを含むレポートでは、 split_id (含まれている場合) が nullされます。
split_name string はい このデータ セットのインプレッションを購入した分割の名前。 分割は、拡張広告申込情報にのみ適用されます。 キャンペーンを含むレポートでは、 split_name (含まれている場合) が nullされます。
campaign_code 文字列 いいえ キャンペーンを識別するために使用されるユーザー割り当てコード。
advertiser_code 文字列 いいえ 広告主に関連付けられているユーザー割り当てコード。
geo_country_code string はい 国別サービスによって定義されている、ユーザーの場所の国コード。
geo_country_id int はい Country Service によって定義されているユーザーの場所の国 ID。 250 国がわからない場合、または国がデータベース内の場所に正しくマップされていない場合に表示されます。
geo_region_code 文字列 いいえ リージョン サービスによって定義されている、ユーザーの場所のリージョン コード。
geo_region_id int はい リージョン サービスによって定義されている、ユーザーの場所のリージョン ID。 4291 は、地域が不明な場合、または地域がデータベース内の場所に正しくマップされない場合に表示されます。
geo_dma_id int はい 指定マーケット エリア サービスによって定義されている、ユーザーの指定されたマーケット エリアの場所の ID。

注: DMA ID が 1 と表示されるのはなぜですか?
Microsoft のレポートでは、オークションに登録された都市から DMA を取得しています。 ただし、 DMA が 決定された場合でも、ジオ プロバイダーがインプレッションに関連付けられた IP アドレスから都市を特定できない場合があります。 そのため、レポートで DMA が 1 であることを示すインプレッション数が特定の DMA を対象とするキャンペーンが存在する場合があります。
geo_dma_name 文字列 いいえ 指定マーケット エリア サービスによって定義されている、ユーザーの指定されたマーケット エリアの場所の名前。
geo_postal_code string はい ユーザーの場所の郵便番号。 郵便番号については、「 郵便番号サービス」を参照してください。
geo_city_id int はい ユーザーの所在地の ID。 都市 ID については、「 City Service」を参照してください。
geo_city_name string はい ユーザーの市区町村の名前。 都市名については、「 City Service」を参照してください。
insertion_order_name 文字列 いいえ 広告掲載オーダーの名前。
insertion_order_code 文字列 いいえ 広告掲載オーダーに関連付けられているユーザー定義コード。
line_item_name 文字列 いいえ 明細行品目の名前。
line_item_code 文字列 いいえ 明細行品目に関連付けられているユーザー定義コード。
geo_country_name 文字列 いいえ Country Service によって定義されているユーザーの国名。
geo_region_name 文字列 いいえ リージョン サービスによって定義されている、ユーザーの場所のリージョンの名前。
insertion_order 文字列 いいえ 非推奨です。
line_item 文字列 いいえ 非推奨です。
geo_country 文字列 いいえ 非推奨です。
geo_region 文字列 いいえ 非推奨です。
geo_dma 文字列 いいえ 非推奨です。
pixel_id int はい コンバージョン ピクセルの一意の識別番号。

注: この次元では、最大 10 個の変換ピクセルが返されます。 また、10 個以下の変換ピクセルでフィルター処理できます。 pixel_idはグループ化可能ですが、このディメンションでグループ化することはお勧めしません。そうすることで、コンバージョン イベントがインプレッション イベントやクリック イベントとは別の行に表示されるようになります。 通常は、コンバージョン レートとコンバージョンあたりのコストの計算で正確な集計値を取得できるように、これらのイベントのすべてを 1 つの行に表示することを前提としています。 そのため、代わりに最も関連性の高いピクセル ID のコンバージョン数と関連メトリクスを取得できるように、 pixel_id で絞り込むことをお勧めします。
buying_currency string はい 購入者がこのインプレッションを購入するために使用した取引通貨。
uk_constituent_country 文字列 いいえ ユーザーの構成国。 これは英国に適用されます。 次の値を指定できます。
- England
- Scotland
- Wales
- Northern Ireland
congressional_district_id int はい 下院議員選挙区の ID
congressional_district_name 文字列 いいえ 下院議員選挙区の名前
state_house_district_id int はい 州議会選挙区の ID
state_senate_district_id int はい 州上院選挙区の ID
state_house_district_name 文字列 いいえ 州議会選挙区の名前
state_senate_district_name 文字列 いいえ 州上院選挙区の ID

指標

列 型 例 式 説明
imps int imps インプレッションの合計数 (配信と再販)。
clicks int クリック数 すべてのインプレッションに対するクリックの総数。
cost 金銭 cost 購入した在庫の合計コスト。
booked_revenue 金銭 booked_revenue 直接の広告主を通じて予約された合計収益 (ライン アイテム)。
cpm 金銭 cpm インプレッション 1,000 回あたりのコスト。
total_convs int total_convs 表示後とクリック後のコンバージョンの合計数。
convs_rate double total_convs / imps インプレッションに対するコンバージョンの比率。
post_view_convs int post_view_convs 記録された視聴後のコンバージョンの合計数。
post_click_convs int post_click_convs 記録されたクリック後のコンバージョンの合計数。
profit 金銭 booked_revenue - total_cost booked 収益から総コストを差し引いた金額。
click_thru_pct double (クリック数/インプ) x 100 インプレッションに対するクリックの割合。割合で表されます。
external_imps int external_imps 外部 (ネットワーク以外) インプレッションの数。
external_clicks int external_clicks 外部 (ネットワーク以外) クリックの数。
booked_revenue_adv_curr 金銭 booked_revenue_adv_curr 直接の広告主を通じて予約された合計収益。その広告主の通貨で表されます。
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/コンバージョン コンバージョンあたりの総コスト。
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 購入者の利益率。
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% ユーザーが動画のスキップを選択した回数の割合。
booked_revenue_buying_currency 金銭 このインプレッションを購入するために購入者が予約した収益。
cost_buying_currency 金銭 直接パブリッシャーと購入されたリアルタイム インベントリのメディア コストの金額 (購入者がインベントリの購入に使用した通貨)。

注: 為替レートはまだレポートで利用できません。
cpm_buying_currency 金銭 インプレッション 1,000 回あたりのコスト (購入者が在庫の購入に使用した通貨)。

注: 為替レートはまだレポートで利用できません。
cost_ecpa_buying_currency 金銭 購入者が在庫の購入に使用した通貨での取得/変換あたりのコスト。
cost_ecpc_buying_currency 金銭 購入者がインベントリの購入に使用した通貨でのクリック単価。
revenue_ecpm_buying_currency 金銭 購入通貨でのインプレッション 1,000 回あたりの収益。
revenue_ecpc_buying_currency 金銭 購入通貨でのクリックあたりの収益。
revenue_ecpa_buying_currency 金銭 購入通貨でのコンバージョンあたりの収益。
total_cost_buying_currency 金銭 購入 (広告主) の通貨でのメディア コスト、データ コスト、パートナー料金の合計

例

JSON 形式のレポート要求を作成する

このファイルには、取得する列とreport_intervalだけでなく、"geo_analytics"のreport_typeが含まれている必要があります。 ファイルに含めることができるフィールドの詳細については、 Report Service を参照してください。

グループ化するディメンションが多いほど、返されるデータ セットが大きくなることに注意してください。 データ セットが大きいほど処理にかなり時間がかかる場合があるため、必要な次元でのみグループ化してください。

$ cat geo_analytics

{
    "report":{
        "report_type":"geo_analytics",
        "timezone":"EST5EDT",
        "report_interval":"last_7_days",
        "groups":[
            "advertiser_id"
        ],
        "columns":[
            "advertiser_id",
            "imps",
            "clicks",
            "click_thru_pct",
            "total_convs",
            "convs_rate",
            "booked_revenue",
            "cost",
            "profit",
            "cpm"
        ],
        "orders":[
            "advertiser_id",
            "imps",
            "clicks",
            "click_thru_pct",
            "total_convs",
            "convs_rate",
            "booked_revenue",
            "cost",
            "profit",
            "cpm"
        ]
    }
}

POST レポート サービスへの要求

$ curl -b cookies -X POST -d @geo_analytics 'https://api.appnexus.com/report'
{
  "response": {
    "status": "OK",
    "report_id": "58e7a1db8d0ccf222e21ffc7c3cd01fb"
  }
}

GET レポート サービスからのレポートの状態

レポート ID を使用して GET 呼び出しを行い、レポートの状態を取得します。 execution_statusが"ready"されるまで、この GET 呼び出しを定期的に行います。 次に、次の手順に示すように、 レポート ダウンロード サービスを使用して、レポート データをファイルに保存します。

$ curl -b cookies "https://api.appnexus.com/report?id=58e7a1db8d0ccf222e21ffc7c3cd01fb"

{
    "response": {
        
        "execution_status": "ready",
        "report": {
            "url": "https://hb.nym1.sand-08.adnxs.net/report-download?id=58e7a1db8d0ccf222e21ffc7c3cd01fb",
            "query_time": "0",
            "finished_on": "2013-02-19 18:28:51",
            "started_on": "2013-02-19 18:28:48",
            "entity_id": "0",
            "user_id": "2027",
            "report_size": "93",
            "row_count": "0",
            "header_info": "Report ID:,58e7a1db8d0ccf222e21ffc7c3cd01fb
Run at:,2013-02-19 18:28:46
Start date:,2013-02-12 05:00:00
End date:,2013-02-19 05:00:00
Timezone:,EST5EDT
User:,Ursula Nimbus (2027)
",
            "json_request": "{"report":{"report_type":"geo_analytics","timezone":"EST5EDT","report_interval":"last_7_days","groups":["advertiser_id"],"columns":["advertiser_id","imps","clicks","click_thru_pct","total_convs","convs_rate","booked_revenue","cost","profit","cpm"],"pivot_report":false,"fixed_columns":[],"orders":["advertiser_id","imps","clicks","click_thru_pct","total_convs","convs_rate","booked_revenue","cost","profit","cpm"],"name":" Report - 02\/19\/2013","ui_columns":["advertiser_id","imps","clicks","click_thru_pct","total_convs","convs_rate","booked_revenue","cost","profit","cpm"]}}",
            "fact_cache_error": "did not find any cache table for 30,31,36,66,32,34",
            "fact_cache_hit": false,
            "cache_hit": false,
            "created_on": "2013-02-19 18:28:46",
            "name": " Report - 02/19/2013"
        },
        "status": "OK"
    }
}

GET レポート ダウンロード サービスからのレポート データ

レポートのダウンロード サービスを使用して、データをファイルにダウンロードします。 サービス名とレポート ID は、応答の url フィールドから抽出できます。

$ curl -b cookies "https://api.appnexus.com/report-download?id=58e7a1ddb80ccf222e21ffc7c3cd01fb" > /tmp/geo_analytics.csv

注:

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

  • 最終更新: