ネットワーク広告主の分析レポートは、ネットワーク分析レポートで提供されるデータよりも詳細な特定の広告主のパフォーマンス データを表示するために使用されます。 このレポートは、ネットワーク ユーザーのみが利用できます。 広告主ユーザーは、 広告主分析 レポートを使用できます。
注:
使用方法については、以下を参照してください。 このレポートでは、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
- 有効期間
注:
カスタムの時間枠でレポートを実行するには、レポート要求の start_date フィールドと end_date フィールドを設定します。 これらのフィールドの詳細については、「 Report Service」を参照してください。
データ保持期間
このレポートのほとんどのデータは永続的に維持されます (以下に記載の例外)。 後:
- 100 日後、時間ごとのデータをレポートできなくなります。 ただし、日次、月次、および累積の間隔は引き続き使用できます。
- 14 か月後、個々の項目を報告できなくなります。
- クリエイティブ
- プレースメント
- ブランド
場合によっては、分析レポートの配信が、特定の広告主またはパブリッシャーの Invest または Monetizes の他の場所で表示されている統計と一致しないことがあります。 これは、100 日と 14 か月より前のアナリティクス レポート データを集計する方法に起因します。 課金レポートのデータは、集計されていない形式で無期限に保持されます。
Dimensions
一部のディメンションには属性があります。 ディメンション属性は、親ディメンションに関するデータのより詳細な要素です。 ディメンションに属性がある場合、そのディメンションの属性の名前が次の構文を使用してその下に表示されます: dimension_name.attribute_name。
| 列 | 種類 | フィルター? | 例 | 説明 |
|---|---|---|---|---|
hour |
date | 不要 | "2010-02-01 06:00:00" |
オークションの時間。 注: 100 日よりも前のインプレッションの場合は、時間ではなく日が返されます。 |
day |
date | 不要 | 2010-02-01 |
月の日付。 |
month |
date | 不要 | 2010-02 |
年の月。 |
advertiser_code |
文字列 | いいえ | "Advertiser Code" |
広告主のカスタム コード。 |
buyer_member_id |
int | はい | 123 |
インプレッション内の購入メンバーの内部 ID。 |
bidder_id |
int | 不要 | 436537 |
購入者がこのインプレッションの購入に使用した入札者または DSP (デマンド サイド プラットフォーム) の ID。 |
bidder_name |
文字列 | いいえ | "Bidder's name" |
買い手がこのインプレッションの購入に使用した入札者または DSP (デマンド サイド プラットフォーム) の名前。 |
seller_member_id |
int | はい | 567 |
販売メンバーの内部 ID。 |
seller_member_name |
文字列 | いいえ | "AdMeld" |
販売メンバーの表示名。 |
seller_member |
文字列 | いいえ | "AdMeld (567)" |
非推奨です。 |
advertiser_id |
int | はい | 344 |
インプレッションにキャンペーンとクリエイティブを提供した広告主の内部 ID。 |
campaign_id |
int | はい | 728 |
キャンペーンを識別する番号。 |
campaign_name |
文字列 | いいえ | "Test" |
キャンペーンの表示名 |
campaign |
文字列 | いいえ | "Test (123)" |
非推奨です。 |
campaign_code |
文字列 | いいえ | "Campaign Code" |
キャンペーンのカスタム コード |
campaign_priority |
int | 不要 | 5 |
直接在庫を対象とするキャンペーンの入札優先度。 使用可能な値: 10 が最も優先される1 - 10,。 |
split_id |
int | はい | 342 |
このデータ セットのインプレッションを購入した分割の ID。 分割は、拡張広告申込情報にのみ適用されます。 キャンペーンを含むレポートでは、 split_id (含まれている場合) が nullされます。 |
split_name |
string | はい | "Mobile Split A" |
このデータ セットのインプレッションを購入した分割の名前。 分割は、拡張広告申込情報にのみ適用されます。 キャンペーンを含むレポートでは、 split_name (含まれている場合) が nullされます。 |
creative_id |
int | はい | 554 |
クリエイティブの ID。 注: - 14 か月以上経過したインプレッションの場合、クリエイティブは creative_idとして 0 を使用して 1 つの行に集約されます。- 外部クリックまたはインプレッション トラッカーの場合、 creative_id は "External Clicks" または "External Imps"になります。 |
creative_name |
文字列 | いいえ | "Q1 2010 728x90" |
クリエイティブの名前。 注: - 14 か月以上経過したインプレッションの場合、クリエイティブは creative_nameとして "All creative data older than 100 days" を使用して 1 つの行に集約されます。- 外部クリックまたはインプレッション トラッカーの場合、 creative_name は "External Clicks" または "External Imps"になります。 |
creative_code |
文字列 | いいえ | "12655" |
クリエイティブのコード。 注: - 100 日を超えるインプレッションの場合、クリエイティブは "All creative data older than 100 days" を creative_nameとして 1 つの行に集約されます。- 外部クリックまたはインプレッション トラッカーの場合、 creative_code は "External Clicks" または "External Imps"になります。 |
creative |
文字列 | いいえ | "Q1 2010 728x90 (554)" |
非推奨です。 |
site_id |
int | はい | 194 |
サイトの ID。 注: 14 か月以上経過したインプレッションの場合、 site_id は 0になります。 |
site_name |
文字列 | いいえ | "Site Name" |
サイトの名前。 |
site |
文字列 | いいえ | "Site Name (593)" |
非推奨です。 |
placement_id |
int | はい | 567 |
配置の ID。 注: 14 か月以上経過したインプレッションの場合、プレースメントは -1 を placement_idとして 1 つの行に集約されます。 |
placement_name |
文字列 | いいえ | "Photos 728x90" |
プレースメントの名前。 注: 14 か月以上経過したインプレッションの場合、プレースメントは "All placement data older than 14 months" を placement_nameとして 1 つの行に集約されます。 |
placement |
文字列 | いいえ | "Photos 728x90 (123)" |
非推奨です。 |
placement_code |
文字列 | いいえ | "Placement Code" |
配置のカスタム コード。 |
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)" |
非推奨です。 |
deal_code |
文字列 | いいえ | "External seller deal code" |
取引のカスタム コード。 外部供給パートナーとの取引の場合、これは通常、取引を識別するために使用する文字列です。 |
size |
string | はい | "728x90" |
クリエイティブ/プレースメントのサイズ |
geo_country |
string | はい | "US" |
地理的な国/地域コード |
geo_country_name |
文字列 | いいえ | "Unites States" |
国/地域の名前 |
creative_recency_bucket |
string | はい | "11-20" |
非推奨です。 このディメンションを要求すると、既定値のみが返されます。 クリエイティブの最新性データを表示するには、[ Network Creative Frequency & Recency (ネットワーク クリエイティブの頻度の最新性 )] レポートを使用してください。 |
creative_recency_bucket_id |
文字列 | いいえ | "4" |
非推奨です。 このディメンションを要求すると、既定値のみが返されます。 クリエイティブの最新性データを表示するには、[ Network Creative Frequency & Recency (ネットワーク クリエイティブの頻度の最新性 )] レポートを使用してください。 |
creative_frequency_bucket |
string | はい | "15-30 minutes" |
非推奨です。 このディメンションを要求すると、既定値のみが返されます。 クリエイティブの頻度データを表示するには、 ネットワーク クリエイティブ & 頻度 レポートを使用してください。 |
creative_frequency_bucket_id |
文字列 | いいえ | "3" |
非推奨です。 このディメンションを要求すると、既定値のみが返されます。 クリエイティブの頻度データを表示するには、 ネットワーク クリエイティブ & 頻度 レポートを使用してください。 |
insertion_order_id |
int | はい | 654 |
広告掲載オーダーの ID。 |
insertion_order_name |
文字列 | いいえ | "Insertion Order Name" |
広告掲載オーダーの名前。 |
insertion_order |
文字列 | いいえ | "Insertion Order Name (654)" |
非推奨です。 |
insertion_order_code |
文字列 | いいえ | "Insertion Order Code" |
広告掲載オーダーのカスタム コード。 |
insertion_order.type |
文字列 | いいえ | "Legacy IO" |
インプレッションに関連付けられている広告掲載オーダーのタイプ (例: レガシー、シームレス)。 |
insertion_order.state |
文字列 | いいえ | "active" |
インプレッションに関連付けられている広告掲載オーダーの状態。 |
insertion_order.start_date |
date | 不要 | インプレッションに関連付けられている非シームレス広告掲載オーダーの開始日。 シームレスな注文については、「 billing_period.start_date」を参照してください。 |
|
insertion_order.end_date |
date | 不要 | インプレッションに関連付けられている非シームレス広告掲載オーダーの終了日。 シームレスな注文については、「 billing_period.end_date」を参照してください。 |
|
insertion_order.booked_impressions_budget_daily |
int | 不要 | 2000 |
広告掲載オーダーの 1 日のインプレッション予算。 |
insertion_order.booked_impressions_budget_lifetime |
int | 不要 | 20000 |
広告掲載オーダーの生涯インプレッション予算。 |
insertion_order.booked_revenue_budget_daily |
金銭 | 不要 | 200.00 |
広告掲載オーダーの 1 日あたりの予算 (収益)。 |
insertion_order.booked_revenue_budget_lifetime |
金銭 | 不要 | 10000.00 |
広告掲載オーダーの有効期間予算 (収益)。 |
insertion_order.billing_code |
文字列 | いいえ | "E4567" |
広告掲載オーダーに関連付けられている請求コード。 |
type_for_insertion_order |
string | はい | "Retargeting IO" |
広告掲載オーダーの種類を説明するカスタム レポート フィールド。 詳しくは、広告掲載オーダー サービスの [labels] フィールドを参照してください。 1 つのレポートにつき 1 つのレポート ラベルのみを選択できます。 |
salesrep_for_insertion_order |
string | はい | "Patricia Martin" |
広告掲載オーダーの販売員を含むカスタム レポート フィールド。 詳しくは、広告掲載オーダー サービスの [labels] フィールドを参照してください。 1 つのレポートにつき 1 つのレポート ラベルのみを選択できます。 |
trafficker_for_insertion_order |
string | はい | "George Martin" |
広告掲載オーダーのトラッカーを含むカスタム レポート フィールド。 詳しくは、広告掲載オーダー サービスの [labels] フィールドを参照してください。 1 つのレポートにつき 1 つのレポート ラベルのみを選択できます。 |
billing_period.start_date |
日付型 | 不要 | "2015-05-25 19:19:53" |
広告掲載オーダーの請求期間の最も早い日付。 注: アルファ ベータ版に関する通知: このフィールドまたは機能は、現在アルファ版またはベータ版のどちらかにある機能の一部です。 そのため、変更される可能性があります。 |
billing_period.end_date |
日付型 | 不要 | "2015-05-30 19:19:53" |
広告掲載オーダーの請求期間の最終日。 注: アルファ ベータ版 通知: このフィールドまたは機能は、現在アルファ版またはベータ版のどちらかにある機能の一部です。 そのため、変更される可能性があります。 |
billing_period.booked_imps_budget_daily |
int | 不要 | 3500 |
広告掲載オーダーの請求期間の 1 日のインプレッション予算。 |
billing_period.booked_imps_budget_lifetime |
int | 不要 | 30000 |
広告掲載オーダーの請求期間の有効期間インプレッション予算。 |
billing_period.booked_revenue_budget_daily_buying_currency |
金銭 | 不要 | 250.00 |
広告掲載オーダーの請求期間の 1 日の収益予算。 |
billing_period.booked_revenue_budget_lifetime_buying_currency |
金銭 | 不要 | 2500.00 |
広告掲載オーダーの請求期間の有効期間収益予算。 |
billing_period.external_code |
文字列 | いいえ | "houseware245" |
請求期間のカスタム コード (budget_interval)。 |
payment_type |
string | はい | "CPM" |
インプレッションに対する購入者の支払い方法。 使用可能な値: - "No payment"- "CPM"- "CPC"- "CPA"- "Owner CPM"- "Owner revshare" |
supply_type |
文字列 | いいえ | "web" |
インプレッション内の供給の種類。 使用可能な値: - "web": デスクトップ ブラウザーで表示されたサイト。- "mobile_web": モバイル ブラウザーで表示されたサイト。- "mobile_app": モバイル デバイスで実行されるアプリ。 |
line_item_id |
int | はい | 932 |
品目を識別する番号。 |
line_item_name |
文字列 | いいえ | "$3 CPM Verizon Remarketing" |
品目の表示名。 |
line_item |
文字列 | いいえ | "$3 CPM Verizon Remarketing (932)" |
非推奨です。 |
line_item_code |
文字列 | いいえ | "Line Item Code" |
品目のカスタム コード。 |
line_item.type |
文字列 | いいえ | "standard" |
品目の種類 (標準、拡張など)。 |
line_item.status |
文字列 | いいえ | "active" |
品目の状態 (例: active、 inactive)。 |
line_item.start_date |
日付型 | 不要 | 2017-02-06 00:00:00 EST5EDT |
非拡張品目の開始日。 拡張品目 (ALI) については、「 flight.start_date」を参照してください。 |
line_item.end_date |
日付型 | 不要 | 2017-02-09 23:00:00 EST5EDT |
拡張されていない明細行品目の終了日。 拡張品目 (ALI) については、「 flight.end_date」を参照してください。 |
line_item.booked_impressions_budget_daily |
int | 不要 | 2000 |
ライン アイテムの 1 日のインプレッション予算。 |
line_item. booked_impressions_budget_lifetime |
int | 不要 | 20000 |
ライン アイテムの生涯インプレッション予算。 |
line_item.booked_revenue_budget_daily_adv_curr |
金銭 | 不要 | 1200.00 |
ライン アイテムの収益の 1 日あたりの予算。 |
line_item.booked_revenue_budget_lifetime_adv_curr |
金銭 | 不要 | 23000.00 |
明細行品目の有効期間予算収益。 |
line_item.comments |
文字列 | いいえ | "extension of Feb spend" |
この品目に関連するすべてのコメント。 |
type_for_line_item |
string | はい | "Branding IO" |
品目の種類を説明するカスタム レポート フィールド。 詳細については、明細行品目サービスのlabels フィールドを参照してください。 1 つのレポートにつき 1 つのレポート ラベルのみを選択できます。 |
salesrep_for_line_item |
string | はい | "Patricia Martin" |
品目の販売員を含むカスタム レポート フィールド。 詳細については、明細行品目サービスのlabels フィールドを参照してください。 1 つのレポートにつき 1 つのレポート ラベルのみを選択できます。 |
trafficker_for_line_item |
string | はい | "George Martin" |
品目のトラッカーを含むカスタム レポート フィールド。 詳細については、明細行品目サービスのlabels フィールドを参照してください。 1 つのレポートにつき 1 つのレポート ラベルのみを選択できます。 |
pixel_id |
int | はい | 1942 |
コンバージョン ピクセルの ID。 注: この次元では、最大 10 個の変換ピクセルが返されます。 また、フィルター処理できます 10 個以下の変換ピクセル。 |
flight |
int | はい | 123475 |
ライン アイテムのフライト ID。 |
flight.start_date |
日付型 | 不要 | 2017-02-06 00:00:00 EST5EDT |
品目のフライトの開始日。 |
flight.end_date |
日付型 | 不要 | 2017-02-09 23:00:00 EST5EDT |
品目のフライトの終了日。 |
flight.booked_impressions_budget_daily |
int | 不要 | 20000 |
ライン アイテムのフライトの 1 日のインプレッション予算。 |
flight.booked_impressions_budget_lifetime |
int | 不要 | 200000 |
ライン アイテムのフライトの生涯インプレッション予算。 |
flight.booked_revenue_budget_daily_advertiser_currency |
金銭 | 不要 | 200.00 |
ライン アイテムのフライトの収益の 1 日あたりの予算。 |
flight.booked_revenue_budget_lifetime_advertiser_currency |
金銭 | 不要 | 20000.00 |
製品のフライトの有効期間予算 (収益)。 |
publisher_id |
int | はい | 321 |
発行元を識別するための番号。 |
publisher_name |
文字列 | いいえ | "Test" |
発行元の表示名。 |
publisher |
文字列 | いいえ | "Test (123)" |
非推奨です。 |
publisher_code |
文字列 | いいえ | "Publisher Code" |
発行元のカスタム コード。 |
imp_type_id |
int | はい | 1 |
インプレッションのタイプ。 次のように変換される整数値: - 1 = 空白 - 2 = PSA - 3 = 既定のエラー - 4 = 既定値 - 5 = 保持 - 6 = 転売 - 7 = RTB - 8 = PSA エラー - 9 = 外部インプレッション - 10 = 外部クリック。 |
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" |
seller_type |
string | はい |
"Real Time", "Direct" |
販売者が販売するメディアの種類。 |
media_type |
string | はい |
"Banner", "Pop", "Interstitial", "Video", "Text", "Expandable", "Skin" |
クリエイティブの一般的な表示スタイル。 メディア タイプ サービスを使用して、メディア タイプの完全なリストを表示できます。 |
mediatype_id |
int | はい | 2 |
読み取り専用です。 サブタイプが属するメディア タイプの ID。 |
venue_id |
int | はい | 1805 |
Xandr 最適化システムが入札評価を決定するために使用するドメイン、サイト、タグ、ユーザーの国/地域のクラスターの ID。 |
venue |
string | はい | "Venue Name" |
Xandr 最適化システムが入札評価を決定するために使用するドメイン、サイト、タグ、ユーザーの国/地域のクラスターの名前。 |
predict_type_rev |
int | はい | 2 |
キャンペーンの最適化フェーズ。 使用可能な値:-2 = 予測フェーズなし-1 = ベース予測フェーズ0 = ギブアップを学ぶ1 = 詳細2 = Throttled3 = 最適化4 = バイアス5 = 最適化 18 = 最適化されたギブアップ9 = ギブアップを下回る基本入札単価 |
advertiser_type |
string | はい | "Local" |
広告主のタイプ。 詳細については、広告主サービスの"labels" フィールドを参照してください。 |
user_group_for_campaign |
string | はい | "Test" |
キャンペーンのテスト/コントロール ユーザー グループ。 詳細については、キャンペーンサービスの"labels"フィールドを参照してください。 |
line_item_type |
string | はい | "Performance" |
ユーザーによって提供される品目を説明するフィールド。 詳細については、明細行品目サービスの"labels" フィールドを参照してください。 |
insertion_order_type |
string | はい | "Client A Insertion Order" |
ユーザーによって提供される広告掲載オーダーを説明するフィールド。 詳しくは、広告掲載オーダー サービスの ["labels"] フィールドを参照してください。 |
adjustment_id |
int | はい | 890 |
広告主のレポートに表示されるメディア コストやインプレッション、クリック、コンバージョンを変更するために使用される調整の ID。 |
revenue_type |
文字列 | いいえ | "CPA" |
メンバーが支払われる基準。 |
revenue_type_id |
int | はい | 4 |
収益の種類の ID。 使用可能な値: -1 = 支払いなし 0 = 一律 CPM 1 = コストと CPM 2 = コストと利益 3 = CPC 4 = CPA 5 = Revshare 6 = 定額料金 7 = 可変 CPM 8 = 推定 CPM。 |
is_takeover |
ブール値 | はい | "Yes" |
マルチ広告要求の広告の少なくとも 1 つが引き継ぎであったために、インプレッションが Blanked か Defaulted かを示します。 インプレッションが引き継ぎ要求の一部である場合は true を返し、それ以外の場合は false を返します。 |
指標
| 列 | 型 | 例 | 式 | 説明 |
|---|---|---|---|---|
imps |
int | 234123 |
imps | 提供されたインプレッションの合計数。 |
clicks |
int | 545 |
クリック数 | すべてのインプレッションにわたるクリックの合計数。 |
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 |
booked_revenue | 合計収益。 |
total_revenue_adv_curr |
金銭 | 300.00 |
total_revenue_adv_curr | 広告主の通貨での合計収益 |
total_convs |
int | 90 |
post_click_convs + post_view_convs | 表示後とクリック後のコンバージョンの合計数。 |
convs_rate |
double | 0.0003844 |
total_convs / imps | インプレッションに対するコンバージョン率。 |
post_view_convs_rate |
double | 0.000320 |
post_view_convs / imps | インプレッションに対するポストビュー コンバージョンの割合。 |
post_click_convs_rate |
double | 0.000064 |
post_click_convs / imps | インプレッションに対するクリック後のコンバージョンの割合。 |
ctr |
double | 0.2327836 |
クリック数/インプ | クリック数対インプレッション数の割合。 |
profit |
金銭 | 0.084102 |
booked_revenue - total_cost | booked 収益から総コストを差し引いた金額。 |
click_convs_rate |
double | 0.1651376 |
total_convs/クリック数 | クリックに対するコンバージョンの割合。 |
advertiser_currency |
string | Yes |
advertiser_currency | 広告主が希望する通貨。 この設定は、 広告主サービスを使用して設定できます。 |
revenue_ecpm |
金銭 | 1.9221 |
booked_revenue / クリック数 | インプレッション 1,000 回あたりの総収益。 |
revenue_ecpm_adv_curr |
金銭 | 1.50 |
revenue_ecpm_adv_curr | 広告主の通貨での 1,000 インプレッションあたりの合計収益。 |
cost_ecpm |
金銭 | 0.4271259 |
media_cost / imps * 1000 | インプレッション 1,000 回あたりのコスト。 |
profit_ecpm |
金銭 | 0.4949 |
利益 / IMP * 1,000 | インプレッション 1,000 回あたりの利益。 "利益" は、簿記収益から総コストを差し引いたものとして定義されます。 |
revenue_ecpc |
金銭 | 0.8256 |
booked_revenue / クリック数 | クリックあたりの合計収益。 |
revenue_ecpc_adv_curr |
金銭 | 0.50 |
revenue_ecpc_adv_curr | 広告主の通貨でのクリックあたりの合計収益。 |
revenue_ecpa |
金銭 | 5.00 |
booked_revenue / total_convs | コンバージョンあたりの合計収益。 |
revenue_ecpa_adv_curr |
金銭 | 3.00 |
revenue_ecpa_adv_curr | 広告主の通貨でのコンバージョンあたりの合計収益。 |
cost_ecpc |
金銭 | 0.1834 |
media_cost/クリック数 | クリック単価。 |
cost_ecpa |
金銭 | 1.1111 |
media_cost/total_convs | 取得/コンバージョンあたりのコスト。 |
profit_margin |
金銭 | 0.7778 |
利益/booked_revenue | 購入者の利益率。 "利益" は、簿記収益から総コストを差し引いたものとして定義されます。 |
media_cost |
金銭 | 100.00 |
media_cost | 消費した合計金額。 |
media_cost_buying_currency |
金銭 | 120.00 |
media_cost_buying_currency | 購入通貨で表される消費総額。 |
convs_per_mm |
double | 384.4 |
(total_convs/imps) * 1,000,000 | インプレッション 100 万回あたりのコンバージョン数です。 |
click_thru_pct |
double | 2.756% |
(クリック数/インプ) * 100 | インプレッションに対するクリックの割合。割合で表されます。 つまり、クリックにつながったインプレッションの割合です。 |
commissions |
金銭 | 0 |
標準品目の手数料、ALI の手数料は $0。 | 予約された収益から発生する料金。 標準品目の手数料、ALI の手数料は $0。 |
serving_fees |
金銭 | 0.025143 |
標準品目のサービス料金、ALI の場合は $0。 | メディア コストに追加される料金。 標準品目のサービス料金、ALI の場合は $0。 |
profit_including_fees |
金銭 | 250.00 |
booked_revenue_dollars - 手数料 - media_cost_dollars - サービス料金 | 非推奨です。 利益から手数料とサービス料金を差し引いたもの。 |
total_revenue_including_fees |
金銭 | 450.00 |
booked_revenue_dollars - 手数料 | 非推奨です。 手数料引いた後の総収益。 |
total_revenue_including_fees_adv_currency |
金銭 | 370.00 |
booked_revenue_adv_curr - commissions_adv_curr | 非推奨です。 手数料を差し引いた後の合計収益 (広告主の通貨)。 |
revenue_ecpa_including_fees |
金銭 | 2.50 |
(post_click_convs + post_view_convs) > 0 の場合、(booked_revenue_dollars - 手数料) / (post_click_convs + post_view_convs) (post_click_convs + post_view_convs) = 0 の場合、(booked_revenue_dollars - 手数料) / 1 |
非推奨です。 手数料後のコンバージョンあたりの収益。 |
revenue_ecpa_including_fees_adv_currency |
金銭 | 3.25 |
(post_view_convs + post_click_convs) > 0 の場合、(booked_revenue_adv_cur - commissions_adv_revenue) / (post_view_convs + post_click_convs) (post_view_convs + post_click_convs) = 0 の場合、(booked_revenue_adv_cur - commissions_adv_revenue) / 1 |
非推奨です。 手数料差し引いた後のコンバージョンあたりの収益 (広告主の通貨)。 |
revenue_ecpc_including_fees |
金銭 | 0.7256 |
クリック > 0 の場合、(booked_revenue_dollars - 手数料/クリック数 クリック数 = 0 の場合、(booked_revenue_dollars - 手数料 / 1 |
非推奨です。 手数料を差し引いた後のクリック単価。 |
revenue_ecpc_including_fees_adv_currency |
金銭 | 0.7256 |
クリック > 0 の場合、(booked_revenue_adv_curr - commissions_adv_curr) / クリック数 クリック数 = 0 の場合、(booked_revenue_adv_curr - commissions_adv_curr) / 1 |
非推奨です。 手数料を差し引いた後のクリックあたりの収益 (広告主の通貨)。 |
revenue_ecpm_including_fees |
金銭 | 1.3131 |
インプ > 0 の場合、(booked_revenue_dollars - コミッション) / (インプ) * 1000 imps = 0 の場合、(booked_revenue_dollars - 手数料) / 1000 |
非推奨です。 手数料後の 1,000 インプレッションあたりの収益。 |
revenue_ecpm_including_fees_adv_currency |
金銭 | 1.3456 |
imps > 0 の場合、 (booked_revenue_dollars_adv_curr - commissions_adv_curr) / (imps) * 1000 imps = 0 の場合、(booked_revenue_dollars_adv_curr - commissions_adv_curr) / 1000 |
非推奨です。 手数料を差し引いた後のインプレッション 1,000 回あたりの収益 (広告主の通貨で)。 |
cost_ecpa_including_fees |
金銭 | 1.1111 |
(post_click_convs + post_view_convs) > 0 の場合、(media_cost_dollars + serving_fees) / (post_click_convs + post_view_convs) (post_click_convs + post_view_convs) = 0 の場合、(media_cost_dollars + serving_fees) / 1 |
非推奨です。 サービス料金を含むコンバージョンあたりのコスト。 |
cost_ecpc_including_fees |
金銭 | 0.7925 |
クリック > 0 の場合、(media_cost_dollars + サービス料金) / クリック数 クリック数 = 0 の場合、(media_cost_dollars + サービス料金) / 1 |
非推奨です。 サービス料金を含むクリック単価。 |
cost_ecpm_including_fees |
金銭 | 0.4271259 |
imps が 0 > 場合、(media_cost_dollars + serving_fees) / imps imps = 0 の場合、(media_cost_dollars + serving_fees) / 1 |
非推奨です。 1,000 インプレッションあたりの総サービス料金。 |
profit_net_including_fees |
金銭 | 200.00 |
booked_revenue_dollars - 手数料 - media_cost_dollars - サービス料金 | 非推奨です。 手数料とサービス手数料を差し引いた後の純利益。 |
profit_ecpm_including_fees |
金銭 | 0.4141 |
インプ > 0の場合、(booked_revenue_dollars - コミッション - media_cost_dollars - serving_fees) / インプ * 1000 imps = 0 の場合、(booked_revenue_dollars - 手数料 - media_cost_dollars - serving_fees) / 1000 |
非推奨です。 手数料とサービス料金を差し引いた後の 1,000 インプレッションあたりの利益。 |
profit_margin_including_fees |
金銭 | 0.7778 |
(booked_revenue_dollars - 手数料) > 0 の場合、(booked_revenue_dollars - 手数料 - media_cost_dollars - serving_fees) / (booked_revenue_dollars - 手数料) (booked_revenue_dollars - 手数料) = 0 の場合、(booked_revenue_dollars - 手数料 - media_cost_dollars - serving_fees) / 1 |
非推奨です。 手数料とサービス料を差し引いた後の利益率。 |
post_view_convs_pixel |
int | 23 |
ピクセルのポスト ビュー コンバージョン。 表示後のコンバージョン (およびその他の) コンバージョンのアトリビューション方法の詳細については、「 コンバージョン アトリビューション (Monetize) 」または 「コンバージョン アトリビューション (Invest)」を参照してください。 | |
post_clicks_convs_pixel |
int | 15 |
ピクセルのクリック後のコンバージョン。 ビュー後のコンバージョン (およびその他の) コンバージョンの属性付け方法の詳細については、「コンバージョン属性 (収益化) 」または 「コンバージョン属性 (Invest)」を参照してください。 | |
total_revenue_pixel |
金銭 | 118.50 |
ピクセルの合計収益。 | |
total_revenue_including_fees_pixel |
金銭 | 94.80 |
非推奨です。 手数料を差し引いた後のピクセルの合計収益 | |
imps_viewed |
int | 30,450 |
imps_viewed | IAB の視認性の定義に従って表示可能だった測定インプレッション数。 |
view_measured_imps |
int | 10,120 |
view_measured_imps | 視認性について測定されたインプレッションの合計数。 |
view_rate |
double | 58% |
view_rate | 視認性について測定されたインプレッションの総数のうち、視認可能なインプレッションの割合。 (表示されたインプ/測定されたインプの表示) |
view_measurement_rate |
double | 45% |
view_measurement_rate | インプレッションの総数に対する視認性について測定されたインプレッションの割合。 (測定されたインプ/インプを表示) |
cost_ecpvm |
金銭 | 2.25 |
(media_cost / imps_viewed) * 1000 | 視認可能なインプレッション 1,000 回あたりのコスト。 |
avg_bid_reduction |
double | 18% |
広告申込情報またはキャンペーンで獲得した入札単価の引き下げの平均額。 この値は、入札単価と、獲得したインプレッションに対して支払った実際のメディア コスト (入札単価の引き下げなどによるもの) との差 (割合) を表します。 この値は RTB 入札にのみ有効です (つまり、マネージドではありません)。 現時点では、 payment_auction_event_type フィールドが 2 に設定されている明細行品目については、この値は正確には計算されません。 |
|
partner_fees |
金銭 | 123.45 |
まもなく。 パートナー料金サービスを使用して予算化され、報告された期間に拡張された品目に発生したサード パーティのコストの合計金額。 | |
total_cost |
金銭 | 123.45 |
total_cost = media_cost + data_costs + partner_fees + コミッション + serving_fees + publisher_revenue | まもなく。 報告された期間に発生したコストの合計金額。 これには通常、予算コスト (メディア コスト、データ コスト、パートナー料金、サービス料金、手数料) とプラットフォームでパブリッシャーの支払いを追跡する場合のパブリッシャー収益の 2 種類のコストが含まれます。 注:重大変更期間(7月17日〜重大変更期間後)に第三者手数料が二重にカウントされないようにするロジックを追加しました。 |
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_ecpc |
金銭 | 123.45 |
(booked_revenue - total_cost)/クリック数 | まもなく。 クリックあたりの利益。 |
profit_ecpa |
金銭 | 123.45 |
( booked_revenue - total_cost)/コンバージョン | まもなく。 コンバージョンあたりの利益。 |
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 レポート要求の作成
JSON ファイルには、取得する列 (ディメンションとメトリック) とreport_intervalだけでなく、"network_advertiser_analytics"のreport_typeを含める必要があります。 また、特定のディメンションをフィルター処理したり、粒度 (year、 month、 day) を定義したり、データを返す形式 (csv、 excel、 html) を指定したりすることもできます。 JSON ファイルに含めることができるフィールドの詳細については、「 レポート サービス」を参照してください。
$ cat network_advertiser_analytics
{"report":
{
"report_type":"network_advertiser_analytics",
"columns":[
"hour",
"seller_member_id",
"campaign_id",
"imps",
"clicks",
"total_convs",
"ctr",
"convs_rate"
],
"report_interval":"last_48_hours",
"format":"csv"
}
}
POST
レポート サービスへの要求
JSON 要求 POST すると、レポート ID が返されます。
$ curl -b cookies -X post -d @network_advertiser_analytics "https://api.appnexus.com/report?advertiser_id=690"
{
"response":{
"status":"OK",
"report_id":"09b6979a6a4c3805bdac8921378d3622"
}
}
GET レポート サービスからのレポートの状態
レポート ID を使用して GET 呼び出しを行い、レポートの状態を取得します。
execution_statusが"ready"されるまでこの呼び出しを続けます。 次に、 レポート ダウンロード サービスを使用して、レポート データをファイルに保存します (次の手順で説明します)。
$ curl -b cookies 'https://api.appnexus.com/report?id=09b6979a6a4c3805bdac8921378d3622'
{
"response":{
"status":"OK",
"report":{
"name":null,
"created_on":"2010-05-25 19:15:48",
"json_request":"{\"report\":{\"report_type\":\"network_advertiser_analytics\",\"columns\":
[\"hour\",\"seller_member_id\",\"campaign_id\",\"imps\",\"clicks\",\"total_convs\",
\"ctr\",\"convs_rate\"],\"row_per\":[\"hour\",\"seller_member_id\",\"campaign_id\"],
\"report_interval\":\"last_48_hours\",\"filters\":[{\"advertiser_id\":\"690\"}]}}",
"url":"report-download?id=b97897a7864dd8f34e7457226c7af592"
},
"execution_status":"ready"
}
}
GET レポート ダウンロード サービスからのレポート データ
レポート データをファイルにダウンロードするには、レポート ID を使用して別の GET 呼び出しを行います。今回は レポート ダウンロード サービスに対して呼び出します。 サービス ID とレポート ID は、前の GET 応答の url フィールドにあります。 保存するファイルを特定する際は、最初のPOSTで指定した"format"のファイル拡張子を使用してください。
注:
ダウンロード中にエラーが発生した場合、応答ヘッダーには HTTP エラー コードとメッセージが含まれます。 呼び出しで -i または -v を使用して、応答ヘッダーを公開します。
$ curl -b cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/network_advertiser_analytics.csv
注:
XLSX および Excel ファイルとしてダウンロードする場合、レポートごとに 100,000 行の制限があります。