ネットワークパブリッシャー分析

Network Publisher Analytics レポートを使用すると、Network Analytics レポートで提供されるデータよりも詳細なネットワーク内の特定の発行元のパフォーマンス データを表示できます。 このレポートは、ネットワーク ユーザーのみが使用できます。 パブリッシャー ユーザーは、 Publisher Analytics レポートを 使用できます。

使用手順については、次の を参照してください。 このレポートでは、次のような URL の一部として発行元 ID を指定する必要があることに注意してください。

https://api.appnexus.com/report?publisher_id=PUBLISHER_ID

時間枠

フィールドは 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
  • 有効 期間

データ保持期間

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

注:

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

Dimensions

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

: 100 日を超えるインプレッションの場合、1 時間ではなく日が返されます。
day date いいえ "2010-02-01" オークションの日。
month date いいえ "2010-02" オークションの月。
buyer_member_id int はい 567 購入メンバーの ID。
buyer_member_name string いいえ "Network" 購入メンバーの名前。

: 名前は または "Default Error"である可能性があります"Default"。これは、インプレッションの購入者がいなかったこと、既定のクリエイティブが配信されたことを意味します。
buyer_member string いいえ "Network (567)" 非推奨。
seller_member_id int はい 67 販売メンバーの ID。
advertiser_id int はい 728 広告主の ID。
advertiser_name string いいえ "Test" 広告主の名前。
advertiser string いいえ "Test (123)" 非推奨。
advertiser_code string いいえ "Code" 広告主のカスタム コード。
line_item_id int はい 554 明細の ID。
line_item_name string いいえ "Q1 Pepsi" 行項目の名前。
line_item string いいえ "Q1 Pepsi (554)" 非推奨。
line_item_code string いいえ "Q1 Pepsi Code" 行項目のカスタム コード。
campaign_id int はい 567 キャンペーンの ID。
campaign_name string いいえ "Photos 728x90" キャンペーンの名前。
campaign string いいえ "Photos 728x90 (567)" 非推奨。
campaign_code string いいえ "Photos Code" キャンペーンのカスタム コード。
campaign_priority int いいえ 5 直接在庫を対象とするキャンペーンの入札優先度。 詳細については、UI ドキュメントの 「入札の優先順位 」を参照してください。
使用可能な値: 1 - 1010 最も高い優先順位です。
split_id int はい 342 このデータ セット内のインプレッションを購入した分割の ID。 分割は、拡張された明細にのみ適用されます。 キャンペーンを含むレポートの場合、 split_id (含まれている場合) は になります null
split_name string はい "Mobile Split A" このデータ セット内のインプレッションを購入した分割の名前。 分割は、拡張された明細にのみ適用されます。 キャンペーンを含むレポートの場合、 split_name (含まれている場合) は になります null
creative_id int はい 554 クリエイティブの ID。

:
- 100 日を超えるインプレッションの場合、クリエイティブは として 1 行0creative_idに集計されます。
- 外部クリックまたはインプレッション トラッカーの場合は、 creative_id または "External Imps"になります"External Clicks"
brand_id int はい 3 クリエイティブに関連付けられているブランドの ID。 の場合 imp_type_id = 6、このレポートのフィールドに brand_id 情報はありません。 代わりに 販売者ブランドレビューレポート を参照してください。
brand_name string いいえ "Ace Hardware" クリエイティブに関連付けられているブランドの名前。 の場合 imp_type_id = 6、このレポートのフィールドに brand_name 情報はありません。 代わりに 販売者ブランドレビューレポート を参照してください。
brand string いいえ "Ace Hardware (3)" 非推奨。
publisher_id int はい 6787 発行元を識別する番号。
publisher_code string いいえ "Publisher Code" パブリッシャーを識別するためのカスタム コード。
publisher_currency string はい "USD" 発行元の通貨。
pub_rule_id int いいえ 54 発行元ルールを識別する番号。
pub_rule_name string いいえ "50% Revshare" 発行元ルールの名前。
pub_rule string いいえ "50% Revshare (54)" 非推奨。
pub_rule_code string いいえ "50% Revshare Code" 発行元ルールのカスタム コード。
site_id int はい 194 サイトの ID。

: 100 日を超えるインプレッションの場合、 site_id は になります 0
site_name string いいえ "Site Name" サイトの名前。
site string いいえ "Site Name (593)" 非推奨。
site_code string いいえ "Site Name Code" サイトのカスタム コード。
deal_id int はい 2345 取引の ID。 買い手と売り手の間で交渉された取引の詳細については、「 Deal Service 」と「 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)" 非推奨。
deal_code 文字列 いいえ "External seller deal code" 取引のカスタム コード。
geo_country string はい "US" 地理的国コード。
geo_country_name string いいえ "Unites States" 国の名前。
size string いいえ "300x250" 配信されたクリエイティブのサイズ。
placement_id int はい 546 配置の ID。

: 100 日を超えるインプレッションの場合、配置は として placement_id1 行-1に集計されます。
placement_name string いいえ "300x250 Business" 配置の名前。

: 100 日を超えるインプレッションの場合、配置は として placement_name1 行"All placement data older than 100 days"に集計されます。
placement string はい "300x250 Business (546)" 非推奨。
placement_code string いいえ "300x250 Business Code" 配置のカスタム コード。
imp_type_id int はい 1 インプレッションの種類の ID。 使用可能な値 (かっこ内の関連する型):
1 ("Blank"): クリエイティブは提供されません。
2 ("PSA"): 有効な入札がなく、既定のクリエイティブが利用できなかったため、パブリック サービスのお知らせが提供されました。
3 ("既定のエラー"): タイムアウトの問題が原因で配信された既定のクリエイティブ。
4 ("Default"): 有効な入札がないため、既定のクリエイティブが配信されました。
5 ("保持"): 広告主のクリエイティブがパブリッシャーのサイトで配信されました。
6 ("Resold"): 発行元の印象がサード パーティの購入者に販売されました。
7 ("RTB"): 広告主のクリエイティブがサード パーティの広告枠で配信されました。
8 ("PSA エラー"): タイムアウトの問題または既定のクリエイティブがないため、パブリック サービスのお知らせが提供されました。
9 ("外部インプレッション"): インプレッション トラッカーからのインプレッション。
10 ("外部クリック"): クリック トラッカーからのクリック。
imp_type string はい "Kept" インプレッションの種類。 使用可能な値については、を参照してください imp_type_id
buyer_type string はい "Reseller" Xandr によって設定される購入者の種類。
supply_type string いいえ "web" インベントリの種類。 使用可能な値:
- "web"
- "mobile_web"
- "mobile_app"
payment_type string はい "cpm", "revshare" ブローカーへの支払いの種類。
revenue_type string はい "CPA" メンバーが支払われる基準。
revenue_type_id int はい 4 収益の種類の ID。 使用可能な値:
-1 = 支払いなし
0 = フラット CPM
1 = Cost Plus CPM
2 = コストプラスマージン
3 = CPC
4 = CPA
5 = Revshare
6 = 定額料金
7 = 変数 CPM
8 = 推定 CPM
external_inv_id int はい 4921 広告呼び出しで渡され、パブリッシャーによって事前に定義された外部インベントリ コードの ID。 詳細については、「 外部インベントリ コード サービス」を参照してください。
100 日を超えるインプレッションの external_inv_id 場合、 は になります 0
external_inv_name 文字列 いいえ "External Inv Name" 広告呼び出しで渡され、パブリッシャーによって事前に定義された外部インベントリ コードの名前。 詳細については、「 外部インベントリ コード サービス」を参照してください。
external_inv 文字列 いいえ "External Inv Name (4921)" 非推奨。
media_type string いいえ "Banner", "Pop", "Interstitial", "Video", "Text", "Expandable", "Skin" クリエイティブの一般的な表示スタイル。 メディア タイプ サービスを使用して、 メディアの種類 の完全な一覧を表示できます。
mediatype_id int はい 2 読み取り専用。 サブタイプが属するメディアタイプの ID。
adjustment_id int はい 890 パブリッシャーのレポートに表示されるメディアのコストやインプレッション、クリック数、コンバージョンを変更するために使用される調整の ID。
venue string はい "Venue Name" Xandr の最適化システムが入札評価を決定するために使用するドメイン、サイト、タグ、およびユーザー国のクラスターの名前。 キャンペーンで会場を明示的にターゲットにすることはできません。
predict_rev_type int はい 2 パブリッシャーのインベントリで配信されたキャンペーンの最適化フェーズ。 使用可能な値:
-2 = 予測フェーズなし
-1 = 基本予測フェーズ
0 = 学習の放棄
1 = Learn
2 = 調整済み
3 = 最適化
4 = バイアス
5 = 最適化 1
8 = 最適化されたギブアップ
9 = ギブアップ以下の基本入札

指標

Column 説明
imps_total int 2340 Imps 合計インプレッション数 (配信数と再販回数)。
imps_sold int 42500 imps_sold 他のメンバーに販売したインプレッションの数。
imps_default int 321 imps_default 既定のインプレッション数。
imps_blank int 3 imps_blank 空白で配信されたインプレッションの数。
imps_psa int 5 imps_psa PSA で提供されたインプレッションの数。
imps_psa_error int 0 imps_psa_error 既定のエラーが原因で 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 rtb インプレッションの数。
external_impression int 0 external_impression 外部インプレッションの数。
external_click int 0 external_click 外部クリックの数。
clicks int 545 クリック すべてのインプレッションに対するクリックの合計数。
click_thru_pct double 1.12359550561797 (クリック/インプ) * 100 インプレッションに対するクリック率をパーセンテージで示します。
total_convs int 90 post_click_convs + post_view_convs ポストビューとクリック後のコンバージョンの合計数。
post_view_convs_pixel int 23 ピクセルのポスト ビュー変換。 ビュー後 (およびその他の) コンバージョンの属性の詳細については、「 コンバージョン属性 (Microsoft 収益化) 」または「 コンバージョン属性 (Microsoft Invest)」を参照してください。
post_clicks_convs_pixel int 15 ピクセルのクリックコンバージョンを投稿します。 ピクセルのポスト ビュー変換。 ポストビュー (およびその他の) コンバージョンの属性の詳細については、「 コンバージョンの属性 (収益化) 」または「 コンバージョン属性 (投資)」を参照してください。
ctr double 0.2327836 clicks / imps * 100 インプレッションに対するクリック数の割合。
convs_rate double 0.0384413 total_convs/imps * 100 インプレッションへのコンバージョン率。
convs_per_mm double 221.877080097625 (total_convs/imps) x 1,000,000 100 万インプレッションあたりのコンバージョン数。
network_revenue お 金 1201.13 network_revenue 直接広告主を通じて予約され、リアルタイムバイヤーに再販されたネットワーク収益。
total_network_rpm お 金 2.60548314606741 (network_revenue/imps) x 1000 1000 インプレッションあたりのネットワーク収益。
publisher_revenue お 金 400.05 publisher_revenue パブリッシャーに支払われた収益 (revshare または cpm に基づく)。
publisher_revenue_pub_curr お 金 400.05 publisher_revenue パブリッシャーに支払われた収益 (revshare または cpm に基づく) をパブリッシャーの通貨で指定します。
publisher_rpm_pub_curr お 金 1.71 (publisher_revenue/imps) x 1000 パブリッシャーの通貨での 1,000 インプレッションあたりのパブリッシャー収益。
network_profit お 金 801.08 (予約収益 + リセラー収益) - total_cost 予約収益とリセラー収益の合計から合計コストを差し引いた合計。
network_roi お 金 非推奨となる。 ネットワークの投資収益率。
network_roi_net_commissions double 非推奨となる
network_rpm お 金 3.42 (network_revenue/imps) x 1000 1000 インプレッションあたりのネットワーク収益。
sold_network_rpm double
publisher_rpm お 金 1.71 (publisher_revenue/imps) x 1000 1,000 インプレッションあたりのパブリッシャー収益。
total_publisher_rpm お 金
sold_publisher_rpm double
network_ppm お 金 9.23 (profit/imps) x 1000 非推奨となる。 1000 インプレッションあたりの利益。
network_revenue_net_commissions お 金 非推奨となる
network_profit_net_commissions お 金 非推奨となる
network_rpm_net_commissions お 金 非推奨となる
network_ppm_net_commissions お 金 非推奨となる
media_cost_pub_curr お 金 16.833378 media_cost_pub_curr 発行元の通貨で購入した在庫の合計コスト。
commissions お 金 0 標準明細の手数料、ALI の場合は $0。 予約された収益から発生する料金。 標準明細の手数料、ALI の場合は $0。
serving_fees お 金 0.025143 標準の品目のサービス手数料、ALI の場合は $0。 メディア コストに追加される料金。 標準の品目のサービス手数料、ALI の場合は $0。
imps_viewed int 30,450 imps_viewed IAB ビューアビリティ定義ごとに表示可能だった測定されたインプレッションの数。
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 を表示する)
partner_fees お 金 123.45 パートナー料金サービスを使用して予算化されたサード パーティのコストの合計額。報告された期間に拡張された広告申込情報に計上されます。
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 imps あたりの合計コスト。
total_cost_ecpc お 金 123.45 total_cost/クリック数 クリックあたりの合計コスト。
total_cost_ecpa お 金 123.45 total_cost/変換 コンバージョンあたりの合計コスト。
network_profit_ecpm お 金 123.45 ((booked_revenue + reseller_revenue - 合計コスト)/imps) * 1,000 1,000 imps あたりのネットワーク利益。
network_profit_ecpc お 金 123.45 (booked_revenue + reseller_revenue - 合計コスト)/クリック数 クリックあたりのネットワーク利益。
network_profit_ecpa お 金 123.45 (booked_revenue + reseller_revenue - 合計コスト)/コンバージョン数 コンバージョンあたりのネットワーク利益。
network_profit_margin お 金 123.45 (booked_revenue + reseller_revenue - 合計コスト)/(booked_revenue + reseller_revenue) ネットワーク利益マージン。
buying_currency_total_segment_data_costs お 金 123.45 total_segment_data_costs * advertiser_exchange_rate データ マーケットプレースでのセグメントの使用に関連するすべてのコスト。 特定のセグメントが明細に適用され、関連する価格がプラットフォームに表示される場合に適用されます。 これは、買い手が在庫を購入するために使用した通貨です。
selling_currency_total_segment_data_costs お 金 123.45 total_segment_data_costs * publisher_exchange_rate データ マーケットプレースでのセグメントの使用に関連するすべてのコスト。 特定のセグメントが明細に適用され、関連する価格がプラットフォームに表示される場合に適用されます。 これは、販売者が在庫を販売するために使用する通貨です。

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

{code}$ cat network_publisher_analytics
{
    "report":
    {
        "report_type":"network_publisher_analytics",
        "columns":[
            "hour",
            "buyer_member_id",
            "inventory_source",
            "gender",
            "imps_total",
            "imps_sold",
            "imps_default",
            "clicks",
            "total_convs",
            "ctr",
            "convs_rate"
        ],
        "row_per":[
            "hour",
            "buyer_member_id",
            "inventory_source_id",
            "gender"
        ],
        "report_interval":"last_48_hours",
        "format":"csv"
    }
}
{code}

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

{code}$ curl -b cookies -c cookies -X post -d @network_publisher_analytics "https://api.appnexus.com/report?publisher_id=4642"
{
   "response":{
      "status":"OK",
      "report_id":"f4ebb93755dd01dde4fc157f86198ea9"
   }
}
{code}

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

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

{code}$ curl -b cookies -c cookies "https://api.appnexus.com/report?id=f4ebb93755dd01dde4fc157f86198ea9"
{
   "response":{
      "status":"OK",
      "report":{
         "name":null,
         "created_on":"2010-05-25 19:37:31",
         "json_request":"{\"report\":{\"report_type\":\"network_publisher_analytics\",\"columns\":[\"hour\",\"buyer_member_id\",\"inventory_source\",
            \"gender\",\"imps_total\",\"imps_sold\",\"imps_default\",\"clicks\",\"total_convs\",\"ctr\",\"convs_rate\"],
            \"row_per\":[\"hour\",\"buyer_member_id\",\"inventory_source_id\",\"gender\"],\"report_interval\":\"last_48_hours\",
            \"filters\":[{\"publisher_id\":\"4642\"}]}}",
         "url":"report-download?id=b97897a7864dd8f34e7457226c7af592"
      },
      "execution_status":"ready"
   }
}
{code}

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

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

注:

ダウンロード中にエラーが発生した場合、応答ヘッダーには HTTP エラー コードとメッセージが含まれます。 -i-vまたは を呼び出して応答ヘッダーを公開します。

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

注:

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