広告主の分析

広告主分析レポートを使用すると、特定の広告主のクリエイティブとキャンペーン全体のパフォーマンス、収益、および利益データを表示できます。 このレポートは、ネットワーク ユーザーと広告主のユーザーが利用できます。

レポートを取得する手順については、「 Report Service 」または次の を参照してください。 このレポートでは、URL の一部として広告主 ID を指定する必要があります。次に例を示します。

https://api.appnexus.com/report?advertiser_id=ADVERTISER_ID

時間枠

JSON 要求の 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
  • 有効期間

データ保持期間

このレポートのほとんどのデータは永続的に維持されます (以下に記載の例外)。 後:

  • 100 日後、時間ごとのデータをレポートできなくなります。 ただし、日次、月次、および累積の間隔は引き続き使用できます。
  • 14 か月後、個々の項目を報告できなくなります。
    • クリエイティブ
    • プレースメント
    • ブランド

場合によっては、分析レポートに、特定の広告主またはパブリッシャーについて Microsoft Invest または Microsoft Monetize の他の場所で表示されている統計と一致しない配信が表示されることがあります。 これは、100 日と 14 か月より前のアナリティクス レポート データを集計する方法に起因します。 課金レポートのデータは、集計されていない形式で無期限に保持されます。 詳細については、UI ドキュメントの 「レポートの日付と時刻 」を参照してください。

注:

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

Dimensions

種類 フィルター? 説明
hour time 不要 "2010-02-01 06:00" オークションの時間。

: 100 日よりも前のインプレッションの場合は、時間ではなく日が返されます。
day time 不要 "2010-02-01" オークション当日。
month time 不要 "2010-02" オークションの月。
adjustment_id int はい 890 パブリッシャーのレポートに表示されるメディア コストやインプレッション、クリック、コンバージョンの変更に使用される調整の一意の識別番号。
advertiser_code 文字列 いいえ "Advertiser Code" 広告主のカスタム コード。
advertiser_currency string はい "USD" 広告主が使用する金銭の種類。
advertiser_id int はい 3 各広告主の一意の識別番号。
buyer_member_id int はい 210 購入者メンバーの一意の識別番号。
seller_member_id int はい 765 販売メンバーの一意の識別番号。
seller_member_name 文字列 いいえ "AdMeld" 販売メンバーの名前。
seller_member 文字列 いいえ "AdMeld (765)" 推奨です (2016 年 10 月 17 日現在)。
campaign_id int はい 728 キャンペーンの一意の識別番号。
campaign_name 文字列 いいえ "Test" キャンペーンの名前。
campaign 文字列 いいえ "Test (123)" 推奨です (2016 年 10 月 17 日現在)。
campaign_code 文字列 いいえ "Campaign Code" キャンペーンのカスタム コード。
campaign_priority int 不要 4 ダイレクト インベントリを対象とするキャンペーンの入札単価の優先度。 スケールは 1 から 10 で、1 が最も低く、10 が最高です。
split_id int はい 342 このデータ セットのインプレッションを購入した分割の ID。 分割は、拡張広告申込情報にのみ適用されます。 キャンペーンを含むレポートでは、 split_id (含まれている場合) は null になります。
split_name string はい "Mobile Split A" このデータ セットのインプレッションを購入した分割の名前。 分割は、拡張広告申込情報にのみ適用されます。 キャンペーンを含むレポートでは、 split_name (含まれている場合) が nullされます。
creative_id int はい 554 クリエイティブの一意の識別番号。

:
- 14 か月以上経過したインプレッションの場合、クリエイティブはcreative_idとして 0 を使用して 1 つの行に集約されます。

- 外部クリックまたはインプレッション トラッカーの場合、 creative_id"External Clicks" または "External Imps"になります。
creative_name 文字列 いいえ "Q1 2010 728x90" クリエイティブの表示名。
:
- 14 か月以上経過したインプレッションの場合、クリエイティブはcreative_nameとして "All creative data older than 14 months" を使用して 1 つの行に集約されます。
- 外部クリックまたはインプレッション トラッカーの場合、 creative_name"External Clicks" または "External Imps"になります。
creative 文字列 いいえ "Q1 2010 - 728x90 (554)" 推奨です (2016 年 10 月 17 日現在)。
placement_id int はい 546 配置の一意の識別番号。

:
- 14 か月以上経過したインプレッションの場合、プレースメントは -1placement_idとして 1 つの行に集約されます。
placement_name 文字列 いいえ "300x250 Business" プレースメントの名前。

: 14 か月以上経過したインプレッションの場合、プレースメントは "All placement data older than 100 days"placement_nameとして 1 つの行に集約されます。
placement 文字列 いいえ "FP 728x90 (567)" 推奨です (2016 年 10 月 17 日現在)。
deal_id int はい 2345 取引の ID。 販売者と交渉した取引の詳細については、「 取引購入者アクセス サービス」を参照してください。
deal_name 文字列 いいえ "Private deal for buyer 1085 with floor of $2.50" 取引の名前。
deal 文字列 いいえ "Private deal for buyer 1085 with floor of $2.50 (45)" 推奨です (2016 年 10 月 17 日現在)。
deal_code 文字列 いいえ "External seller deal code" 取引のカスタム コード。 外部供給パートナーとの取引の場合、これは通常、取引を識別するために使用する文字列です。
placement_code 文字列 いいえ "FP 728x90" 配置のカスタム コード。
size string はい "728x90" 配信されるプレースメント/クリエイティブのサイズ。
geo_country string はい "US" 対象の国または地域のコード。
geo_country_name 文字列 いいえ "United States" 対象の国または地域の名称。
creative_recency_bucket string はい "15-30 minutes" 推奨です。 このディメンションを要求すると、既定値のみが返されます。 広告主のクリエイティブの間隔 & 間隔レポートを使用して、クリエイティブの間隔データを表示します。
creative_recency_bucket_id 文字列 いいえ 3 推奨です。 このディメンションを要求すると、既定値のみが返されます。 広告主のクリエイティブの間隔 & 間隔レポートを使用して、クリエイティブの間隔データを表示します。
creative_frequency_bucket string はい "11-20" 推奨です。 このディメンションを要求すると、既定値のみが返されます。 広告 主のクリエイティブの頻度 & の間隔レポート を使用して、クリエイティブの頻度データを表示します。
creative_frequency_bucket_id 文字列 いいえ 4 推奨です。 このディメンションを要求すると、既定値のみが返されます。 広告 主のクリエイティブの頻度 & の間隔レポート を使用して、クリエイティブの頻度データを表示します。
gender string はい "m", "f", "u" ユーザーの性別。

:
100 日を超えるインプレッションの場合、性別は "u"になります。
性別の値は、入札要求のパブリッシャーによって定義されます。 Xandr は、値の処理以外にそれを制御できません。
imp_type_id int はい 1 インプレッションの種類の ID。 使用可能な値 (かっこ内の関連付けられた型):
- 1 ("Blank"): クリエイティブは配信されません。
- 2 ("PSA"): 有効な入札単価がなく、既定のクリエイティブがなかったために提供された公共広告。
- 3 ("Default Error"): タイムアウトの問題で提供される既定のクリエイティブ。
- 4 ("Default"): 有効な入札単価がなかったために提供された既定のクリエイティブ。
- 5 ("Kept"): 発行元のサイトで提供される広告主のクリエイティブ。
- 6 ("Resold"): パブリッシャーのインプレッションがサード パーティの購入者に販売されました。
- 7 ("RTB"): サードパーティのインベントリで提供される広告主のクリエイティブ。
- 8 ("PSA Error"): タイムアウトの問題または既定のクリエイティブがないために配信された公共サービスアナウンス。
- 9 ("External Impression"): インプレッション トラッカーからのインプレッション。
- 10 ("External Click"): クリック トラッカーからのクリック。
imp_type string はい "Kept" インプレッションのタイプ。 有効な値については、「 imp_type_id」を参照してください。
bid_type string はい "Manual" ノードがこのインプレッションに入札したときの最適化フェーズ。

: そのインプレッションの評価額が会場の「あきらめた価格」を下回る場合は、以下の入札タイプに「あきらめん」という用語が追加されます。 有効な値は次のとおりです。
- "Manual": 基本、EAP、ECP のいずれであっても、CPM 目標で入札する場合に適用されます。
- "Learn": 最適化 (CPA、CPC、またはマージン) を使用して入札しており、最適化された入札を行うのに十分なデータがまだない場合に適用されます。
- "Optimized": 最適化 (CPA、CPC、またはマージン) を使用して入札し、最適化された入札を行うのに十分なデータがある場合に適用されます。
- "Unknown": ノードは不明な最適化フェーズにありました。
- "Optimized give up"
- "Learn give up"
- "Manual give up"
insertion_order_id int はい 648359 広告掲載オーダーの一意の識別番号。
insertion_order_name 文字列 いいえ "InsertionOrderABC" 広告掲載オーダーの名前。
insertion_order 文字列 いいえ "InsertionOrderABC648359" 推奨です (2016 年 10 月 17 日現在)。
insertion_order_code 文字列 いいえ "Insertion Order Code" 広告掲載オーダーのカスタム コード。
line_item_id int はい 947764 品目の一意の識別番号。
line_item_name 文字列 いいえ "LineItemDEF" 明細行品目の名前。
line_item 文字列 いいえ "LineItemDEF947764" 推奨です (2016 年 10 月 17 日現在)。
line_item_code 文字列 いいえ "Line Item Code" 品目のカスタム コード。
supply_type 文字列 いいえ "web" インベントリの種類。 使用可能な値:
- "web"
- "mobile_web"
- "mobile_app".
pixel_id int はい 1942 コンバージョン ピクセルの一意の識別番号。

: この次元では、最大 10 個の変換ピクセルが返されます。 また、10 個以下の変換ピクセルでフィルター処理できます。
publisher_id int はい 374967 発行元の一意の識別番号。
publisher_name 文字列 いいえ "Publisher XYZ" 発行元の名前。
publisher 文字列 いいえ "Publisher XYZ 347967" 推奨です (2016 年 10 月 17 日現在)。
publisher_code 文字列 いいえ "Publisher Code" 発行元のカスタム コード。
seller_type string はい "Real Time", "Direct" 販売者の種類。
supply_type string はい "web" インベントリの種類。 使用可能な値:
- "web"
- "mobile_web"
- "mobile_app".
media_type 文字列 いいえ "Banner", "Pop", "Interstitial", "Video", "Text", "Expandable", "Skin" クリエイティブの一般的な表示スタイル。 メディア タイプ サービスを使用して、メディア タイプの完全なリストを表示できます。
mediatype_id int はい 2 サブタイプが属するメディア タイプの一意の識別番号。
user_group_for_campaign string はい "Test" キャンペーンのテスト/コントロール ユーザー グループ。 詳細については、キャンペーンサービスの"labels"フィールドを参照してください。
venue int はい 321512 Xandr の最適化システムが入札評価を決定するために使用するドメイン、サイト、タグ、ユーザーの国/地域のクラスターの名前。 キャンペーンで明示的に会場をターゲットにすることはできません。
billing_period_start_date 日付型 不要 "2015-05-25 19:19:53" 広告掲載オーダーの請求期間の最も早い日付。

注: Alpha-Beta 通知
このフィールドまたは機能は、現在アルファ フェーズまたはベータ フェーズにある機能の一部です。 そのため、変更される可能性があります。
billing_period_end_date 日付型 不要 "2015-05-30 19:19:53" 広告掲載オーダーの請求期間の最終日。

注: Alpha-Beta 通知
このフィールドまたは機能は、現在アルファ フェーズまたはベータ フェーズにある機能の一部です。 そのため、変更される可能性があります。
billing_period_external_code 文字列 いいえ "houseware245" 請求期間のカスタム コード (budget_interval)。

指標

説明
imps int 234123 imps 提供されたインプレッションの合計数。
attributed_revenue 金銭 10.45 post_view_revenue + post_click_revenue 記録されたすべての投稿ビューと投稿クリックからの収益額。
attributed_pc_revenue 金銭 121.68 post_click_revenue 記録されたすべての投稿ビューからの収益額。
attributed_pv_revenue 金銭 14 post_view_revenue 記録されたすべての投稿クリックからの収益の金額。
clicks int 545 クリック数 すべてのインプレッションに対するクリックの総数。
click_convs_rate double 0.057 total_convs/クリック数 クリックに対するコンバージョンの割合。
click_conv_rate double 0.000064 total_convs/クリック数 クリックに対するコンバージョンの割合。

: このフィールドは click_convs_rate と同じです。
click_thru_pct double 0.000% クリック数/インプ クリエイティブを表示してクリックしたユーザーの割合。
cpa 金銭 1.25 booked_revenue_dollars / (post_view_convs + post_click_convs) 取得あたりのコスト。
cpc 金銭 0.45 booked_revenue_dollars/クリック数 クリック単価。
cpm 金銭 0.18 (booked_revenue_dollars / imps) * 1000 インプレッション 1,000 回あたりのコスト。
post_view_convs int 75 post_view_convs 記録された投稿ビューのコンバージョンの合計数。
post_view_revenue 金銭 150.00 post_view_revenue 記録された投稿ビュー収益の合計金額。
post_click_convs int 15 post_click_convs 記録されたクリック後のコンバージョンの合計数。
post_click_revenue 金銭 300.00 post_click_revenue 記録されたクリック後の収益の合計金額。
total_revenue 金銭 450.00 post_view_revenue + post_click_revenue 投稿ビューと投稿クリック収益の合計金額。
total_convs int 90 post_view_convs + post_click_convs 投稿ビューと投稿クリックのコンバージョンの合計数。
conv_rate double 0.018654 (post_click_convs + post_view_convs) / imps インプレッションに対する投稿クリックと投稿ビューのコンバージョン率。
convs_rate double 0.0003844 total_convs / imps インプレッションに対するコンバージョン率。
convs_per_mm double 221.877080097625 (total_convs / imps) x 1,000,000 インプレッション 100 万回あたりのコンバージョン数です。
ecpa_adv_curr 金銭 1.13 booked_revenue_adv_curr / (post_view_convs + post_click_convs) 広告主の通貨タイプでの取得あたりのコスト。
ecpc_adv_curr 金銭 0.16 booked_revenue_adv_curr/クリック数 広告主の通貨タイプでのクリック単価。
ecpm_adv_curr 金銭 0.014 booked_revenue_adv_curr / imps * 1000 広告主の通貨タイプで表された 1,000 インプレッションあたりのコスト。
post_view_convs_rate double 0.000320 post_view_convs / imps インプレッションに対する投稿ビューのコンバージョン率。
post_click_convs_rate double 0.000064 post_click_convs / imps インプレッションに対するポストクリックのコンバージョン率。
post_click_conversion_pixel int 52 そのpixel_idのpost_click_convs 特定のピクセルのクリック後のコンバージョン数。 ビュー後のコンバージョン (およびその他のコンバージョン)、 コンバージョン属性 (Monetize)、 または コンバージョン属性 (Invest) の属性付け方法の詳細をご確認ください。
post_click_revenue_pixel 金銭 184.25 そのpixel_idのpost_click_revenue 特定のピクセルに対して獲得された収益の金額。
post_view_conversion_pixel int 174 そのpixel_idのpost_view_convs 特定のピクセルのポスト ビューのコンバージョン数。 表示後のコンバージョン (およびその他の) コンバージョンのアトリビューション方法の詳細については、「 コンバージョン アトリビューション (Monetize) 」または 「コンバージョン アトリビューション (Invest)」を参照してください。
post_view_revenue_pixel 金銭 303.54 そのpixel_idのpost_view_revenue 特定のピクセルに対して獲得された収益の金額。
ppm 金銭 0.944966292134831 (利益/ imps) x 1000 インプレッション 1,000 回あたりの利益。
rpm 金銭 2.60548314606741 (収益/IMPS) x 1000 インプレッション 1,000 回あたりの収益。
spend_adv_curr 金銭 357.18 booked_revenue_adv_curr 広告主が希望する通貨で広告主が費やした合計金額。
total_revenue_pixel 金銭 41.253 そのpixel_idの post_click_revenue + post_view_revenue 特定のピクセルに対して獲得された合計収益。
ctr double 0.002327 クリック数/インプ クリック数対インプレッション数の割合。
spend 金銭 304.36 支出 マーケターのダイレクトバイイングとリアルタイムメディアバイイングの両方における総支出額。
media_cost 金銭 2.15 メディア コスト すべてのインプレッションの購入に費やした合計金額。
ecpm 金銭 1.30 (消費 / インプ) x 1000 1,000 インプレッションあたりの効果的な広告主の支出。
ecpc 金銭 1.25 支出 / クリック数 広告主の効果的なクリック単価額。
ecpa 金銭 1.20 支出/total_convs コンバージョン/獲得あたりの広告主の効果的な支出。
imps_viewed int 30,450 imps_viewed IAB ビューアビリティの定義に従って、ビューイングであった測定されたインプレッション数。これは、連続した 1 秒間にピクセルの 50% がビュー内にある場合にインプレッションが表示可能であることを示します。
view_measured_imps int 10,120 view_measured_imps 視認性について測定されたインプレッションの合計数。
view_rate double 58% view_rate 視認性について測定されたインプレッションの総数のうち、視認可能なインプレッションの割合。 (表示されたインプ/測定されたインプの表示)
view_measurement_rate double 45% view_measurement_rate インプレッションの総数に対する視認性について測定されたインプレッションの割合。 (測定されたインプ/インプを表示)
avg_bid_reduction double 18% avg_bid_reduction 広告申込情報またはキャンペーンで獲得した入札単価の引き下げの平均額。 この値は、入札単価と、獲得したインプレッションに対して支払った実際のメディア コスト (入札単価の引き下げなどによるもの) との差 (割合) を表します。 この値は RTB 入札にのみ有効です (つまり、マネージドではありません)。 現時点では、 payment_auction_event_type フィールドが 2 に設定されている明細行品目については、この値は正確には計算されません。
video_skips int 10 video_skips ユーザーが動画をスキップした合計回数。 スキップ可能な在庫を購入する際のレポートに、このメトリックを使用します。
video_starts int 11 video_starts ビデオ クリエイティブの最初のセグメントがダウンロードされて開始された合計回数。
video_25_pcts int 10 video_25_pcts 動画クリエイティブが動画を完成した合計回数 (動画全体の 25%)。
video_50_pcts int 10 video_50_pcts 動画クリエイティブが動画全体の再生時間の 50% を完了した合計回数。
video_75_pcts int 10 video_75_pcts 動画クリエイティブが動画全体の再生時間の 75% を完了した合計回数。
video_completions int 12 video_completions 動画クリエイティブが全時間に再生された合計回数。
video_served int 10 video_served プレイヤーに提供されたビデオ応答の合計数。 広告応答は、要求に応答して VAST ドキュメント (XML) が提供されたときに発生します。 広告の応答は、必ずしもインプレッションの成功を示すわけではありません。 インプレッションの場合、動画の最初のフレームを配信する必要があります。
video_errors int 2 video_errors ビデオ エラーが発生した合計回数。
revenue_per_video_complete 金銭 25.76 revenue_per_video_complete ビデオの完了あたりの収益。
cost_per_video_complete 金銭 22.76 cost_per_video_complete ビデオの完了あたりのコスト。
video_completion_rate double 1.12359550561797% (動画の完成数/総インプレッション数) x 100 インプレッションに対する動画の完成度の比率。割合で表されます。
video_start_rate double 1.12359550561797% video_start_rate ビデオ クリエイティブの最初のセグメントがダウンロードされて開始された回数の割合。
video_skip_rate double 1.12359550561797% video_skip_rate ユーザーが動画のスキップを選択した回数の割合。

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

$ cat advertiser_analytics 
 
{ 
    "report": { 
        "report_type":"advertiser_analytics", 
        "columns": [ 
            "hour", 
            "seller_member_id", 
            "campaign_id", 
            "gender", 
            "imps", 
            "clicks", 
            "total_convs", 
            "ctr", 
            "convs_rate"
        ], 
        "report_interval": "last_48_hours", 
        "format":"csv" 
    } 
}

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

JSON 要求 POST すると、レポート ID が返されます。

$ curl -b cookies -c cookies -X post -d @advertiser_analytics "https://api.appnexus.com/report?advertiser_id=690" 
 
{
    "response": {
        "status": "OK",
        "report_id": "2790c6627d058cd467f4267add49bedc",
        "existing": true,
        "dbg_info": {
            ...
        }
    }
}

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

レポート ID を使用して GET 呼び出しを行い、レポートの状態を取得します。 execution_status"ready"されるまでこの呼び出しを続けます。 次に、 report-download サービスを使用して、レポート データをファイルに保存します (次の手順で説明します)。

$ curl -b cookies -c cookies "https://api.appnexus.com/report?id=dc0314bda06597582518c5fc3e1c47ef" 
 
{
    "response": {
        "status": "OK",
        "report": {
            "name": null,
            "created_on": "2014-04-17 01:26:00",
            "cache_hit": false,
            "fact_cache_hit": false,
            "fact_cache_error": "did not find any cache table for 1,3,6,44,30,31,32,34,15",
            "json_request": "{\"report\":{\"report_type\":\"advertiser_analytics\",\"columns\":[\"hour\",\"seller_member_id\",\"campaign_id\",\"gender\",\"imps\",\"clicks\",\"total_convs\",\"ctr\",\"convs_rate\"],\"report_interval\":\"last_48_hours\",\"format\":\"csv\",\"filters\":[{\"buyer_member_id\":\"948\"},{\"advertiser_id\":\"78216\"},{\"imp_type_id\":{\"operator\":\"!=\",\"value\":6}}]}}",
            "header_info": "Report ID:,2790c6627d058be467f4267add49bedc\r\nRun at:,2014-04-17 01:26:00\r\nStart date:,2014-04-15 01:00:00\r\nEnd date:,\r\nTimezone:,\r\nUser:,Jesse Seldess (9685)\r\n",
            "row_count": "0",
            "report_size": "75",
            "user_id": "9685",
            "entity_id": "0",
            "started_on": "2014-04-17 01:26:03",
            "finished_on": "2014-04-17 01:28:02",
            "query_time": "118",
            "url": "report-download?id=2790c6627d058be467f4267add49bedc"
        },
        "execution_status": "ready",
        "dbg_info": {
            ...
        }
    }
}

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

レポート データをファイルにダウンロードするには、レポート ID を使用して別の GET 呼び出しを行います。今回は レポート ダウンロード サービスに対して呼び出します。 サービス ID とレポート ID は、前の GET 応答の url フィールドにあります。 保存するファイルを特定する際は、最初のPOSTで指定した"format"のファイル拡張子を使用してください。

$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/advertiser_analytics.csv 

注:

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