次の方法で共有


広告主の分析

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

レポートを取得する手順については、 レポート サービス または以下の を参照してください。 このレポートでは、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 収益化の他の場所で表示される統計と一致しない配信が分析レポートに表示される場合があります。 これは、100 日と 14 か月を超える Analytics レポート データを集計する方法が原因です。 課金レポートのデータは、非集計形式で無期限に保持されます。 詳細については、UI ドキュメント の「レポートの日付と時刻 」を参照してください。

注:

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

Dimensions

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

: 100 日を超えるインプレッションの場合、1 時間ではなく日が返されます。
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 か月を超えるインプレッションの場合、クリエイティブは 0creative_idとして 1 行に集計されます。

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

:
- 14 か月を超えるインプレッションの場合、配置は 1 行に集計され、placement_idとして-1されます。
placement_name 文字列 いいえ "300x250 Business" 配置の名前。

: 14 か月を超えるインプレッションの場合、配置は 1 行に集計され、placement_nameとして"All placement data older than 100 days"されます。
placement 文字列 いいえ "FP 728x90 (567)" 非推奨 (2016 年 10 月 17 日現在)。
deal_id int はい 2345 取引の ID。 販売者と交渉した取引の詳細については、「 Deal Buyer Access Service」を参照してください。
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% clicks/imps クリックしたクリエイティブを表示しているユーザーの割合。
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 特定のピクセルのクリック後のコンバージョンの数。 ビュー後 (およびその他の) コンバージョン、コンバージョン属性 (収益化) またはコンバージョン属性 (投資) の属性の詳細については、こちらの記事を参照してください。
post_click_revenue_pixel お金 184.25 そのpixel_idのpost_click_revenue 特定のピクセルに対して獲得した収益の量。
post_view_conversion_pixel int 174 そのpixel_idのpost_view_convs 特定のピクセルのポスト ビュー変換の数。 ポストビュー (およびその他の) コンバージョンの属性の詳細については、「 コンバージョンの属性 (収益化) 」または「 コンバージョン属性 (投資)」を参照してください。
post_view_revenue_pixel お金 303.54 そのpixel_idのpost_view_revenue 特定のピクセルに対して獲得した収益の量。
ppm お金 0.944966292134831 (profit/imps) x 1000 1000 インプレッションあたりの利益。
rpm お金 2.60548314606741 (revenue/imps) x 1000 1000 インプレッションあたりの収益。
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 clicks/imps インプレッションに対するクリック数の割合。
spend お金 304.36 費やす マーケティング担当者の総支出は、直接およびリアルタイムのメディア購入の両方で行われます。
media_cost お金 2.15 メディア コスト すべてのインプレッションを購入するために費やした合計金額。
ecpm お金 1.30 (spend/imps) x 1000 1,000 インプレッションあたりの効果的な広告主の支出。
ecpc お金 1.25 spend / clicks クリックあたりの有効な広告主の支出。
ecpa お金 1.20 spend / 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 視認性を測定したインプレッションの総数のうち、表示可能だったインプレッションの割合。 (表示された Imps/View Measured Imps)
view_measurement_rate double 45% view_measurement_rate 総インプレッション数のうち視認性を測定したインプレッションの割合。 (測定された Imps/Imps を表示する)
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 は、前の 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 行の制限があります。