ネットワークパブリッシャー分析
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_date
と end_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 - 10 が 10 最も高い優先順位です。 |
split_id |
int | はい | 342 |
このデータ セット内のインプレッションを購入した分割の ID。 分割は、拡張された明細にのみ適用されます。 キャンペーンを含むレポートの場合、 split_id (含まれている場合) は になります null 。 |
split_name |
string | はい | "Mobile Split A" |
このデータ セット内のインプレッションを購入した分割の名前。 分割は、拡張された明細にのみ適用されます。 キャンペーンを含むレポートの場合、 split_name (含まれている場合) は になります null 。 |
creative_id |
int | はい | 554 |
クリエイティブの ID。 注: - 100 日を超えるインプレッションの場合、クリエイティブは として 1 行 0 creative_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_id 1 行-1 に集計されます。 |
placement_name |
string | いいえ | "300x250 Business" |
配置の名前。 注: 100 日を超えるインプレッションの場合、配置は として placement_name 1 行"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 = フラット CPM1 = Cost Plus CPM2 = コストプラスマージン3 = CPC4 = CPA5 = Revshare6 = 定額料金7 = 変数 CPM8 = 推定 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 = Learn2 = 調整済み3 = 最適化4 = バイアス5 = 最適化 18 = 最適化されたギブアップ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 行の制限があります。