広告主のクリエイティブの頻度とリジェンシー
広告主のクリエイティブ頻度 & リジェンシー レポートを使用すると、ユーザー ビューの頻度とリジェンシーに基づいて、特定の広告主のクリエイティブ データを表示できます。 このレポートは、広告主とネットワーク ユーザーが利用できます。
レポートを取得する手順については、 Report Service を参照するか、次の 例 を参照してください。 広告主ユーザーの場合、広告主 ID はユーザーの認証に基づいて検出されます。 ただし、ネットワーク ユーザーの場合、このレポートでは、URL の一部として広告主 ID を指定する必要があります(例:
https://api.appnexus.com/report?advertiser_id=ADVERTISER_ID
注:
ルックバック ウィンドウ
頻度データとレジェンシー データは 120 日間使用できます (2017 年 2 月 26 日より前のデータはありません)。
時間枠
JSON 要求のフィールドは report_interval 、次のいずれかに設定できます。
- last_hour
- 今日
- yesterday
- last_48_hours
- last_2_days
- last_7_days
- last_14_days
- month_to_date
- last_30_days
- last_month
- last_100_days
- カスタム
データ保持期間
このレポートのデータ保持期間は 120 日です。
注:
カスタム時間枠のレポートを実行するには、レポート要求の フィールド start_date と end_date フィールドを設定します。 これらのフィールドの詳細については、「 Report Service」を参照してください。
Dimensions
| Column | 種類 | フィルター。 | 例 | 説明 |
|---|---|---|---|---|
hour |
time | 不要 | "2010-02-01 06:00:00" |
オークションの時間。 |
day |
time | 不要 | "2010-02-01" |
オークションの日。 |
month |
time | 不要 | "2010-02" |
オークションの月。 |
creative_id |
int | はい | 554 |
クリエイティブの ID。 注: 外部クリックまたはインプレッション トラッカーの場合は、 creative_id または "External Imps"になります"External Clicks"。 |
creative_name |
string | いいえ | "Q1 2010 728x90" |
クリエイティブの名前。 注: 外部クリックまたはインプレッション トラッカーの場合は、 creative_name または "External Imps"になります"External Clicks"。 |
creative |
string | いいえ | "Q1 2010 728x90 (554)" |
非推奨 (2016 年 10 月 17 日現在)。 |
creative_recency_bucket |
string | はい | "15-30 minutes" |
クリエイティブが表示された最近のバケット。 使用可能な値については 、以下の「Creative Recency Buckets 」を参照してください。 |
creative_recency_bucket_id |
string | いいえ | "4" |
クリエイティブのレジェンシー バケットの ID。 使用可能な値については 、以下の「Creative Recency Buckets 」を参照してください。 |
creative_frequency_bucket |
string | はい | "11-20" |
クリエイティブが表示された頻度のバケット。 使用可能な値については 、以下の「クリエイティブ頻度バケット 」を参照してください。 |
creative_frequency_bucket_id |
string | いいえ | "3" |
クリエイティブ頻度バケットの ID。 使用可能な値については 、以下の「クリエイティブ頻度バケット 」を参照してください。 |
buyer_member_id |
int | はい | 123 |
購入メンバーの ID。 インプレッションが購入されなかった場合、このフィールドには次のいずれかの値が表示されます。229 = PSA0 = 空白319 = 既定値。 |
advertiser_id |
int | はい | 789 |
広告主の ID。 値が の場合は 0、インプレッションが外部購入者によって購入されたか、既定値または PSA が表示されました。 |
Advertiser_name |
文字列 | いいえ | "Verizon Wireless" |
広告主の名前。 |
advertiser |
文字列 | いいえ | "Verizon Wireless (789)" |
非推奨 (2016 年 10 月 17 日現在)。 |
advertiser_code |
文字列 | いいえ | "Virizon Wireless Code" |
広告主のカスタム コード。 |
insertion_order_id |
int | はい | 321 |
挿入順序の ID。 |
insertion_order_name |
文字列 | いいえ | "Insertion Order" |
挿入順序の名前。 |
insertion_order |
文字列 | いいえ | "Insertion Order (321)" |
非推奨 (2016 年 10 月 17 日現在)。 |
insertion_order_code |
文字列 | いいえ | "Insertion Order Code" |
挿入順序のカスタム コード。 |
line_item_id |
int | はい | 111 |
明細の ID。 |
line_item_name |
文字列 | いいえ | "Default Line Item" |
行項目の名前。 |
line_item |
文字列 | いいえ | "Default Line Item (111)" |
非推奨 (2016 年 10 月 17 日現在)。 |
line_item_code |
文字列 | いいえ | "Default Line Item Code" |
行項目のカスタム コード。 |
campaign_id |
int | はい | 222 |
キャンペーンの ID。 |
campaign_name |
文字列 | いいえ | "Default Campaign" |
キャンペーンの名前。 |
campaign |
文字列 | いいえ | "Default Campaign (222)" |
非推奨 (2016 年 10 月 17 日現在)。 |
campaign_code |
文字列 | いいえ | "Default Campaign Code" |
キャンペーンのカスタム コード。 |
campaign_priority |
int | 不要 | 5 |
直接在庫を対象とするキャンペーンの入札優先度。 使用可能な値: 1 - 10が 10 最も高い優先順位です。 |
split_id |
int | はい | 342 |
このデータ セット内のインプレッションを購入した分割の ID。 分割は、拡張された明細にのみ適用されます。 キャンペーンを含むレポートの場合、 split_id (含まれている場合) は になります null。 |
split_name |
string | はい | "Mobile Split A" |
このデータ セット内のインプレッションを購入した分割の名前。 分割は、拡張された明細にのみ適用されます。 キャンペーンを含むレポートの場合、 split_name (含まれている場合) は になります null。 |
size |
string | はい | "728x90" |
配信されたプレースメント/クリエイティブのサイズ。 |
is_remarketing |
int | はい | 0, 1 |
キャンペーンがリマーケティングであるかどうか |
bid_type |
string | はい | "Manual" |
このインプレッションの入札時にノードが行っていた最適化フェーズ。 注: そのインプレッションの評価額が会場の "ギブアップ価格" を下回る場合は、以下の入札タイプに "ギブアップ" という用語が追加されます。 有効な値は次のとおりです。 - "Manual": ベース、EAP、ECP のいずれであっても、CPM 目標で入札する場合に適用されます。- "Learn": 最適化 (CPA、CPC、またはマージン) で入札していて、入札に最適化された十分なデータがまだない場合に適用されます。- "Optimized": 最適化 (CPA、CPC、またはマージン) で入札していて、入札に最適化された十分なデータがある場合に適用されます。- "Unknown": ノードが不明な最適化フェーズにあった。- "Optimized give up"- "Learn give up"- "Manual give up" |
media_type |
文字列 | いいえ | "Banner", "Pop", "Interstitial", "Video", "Text", "Expandable", "Skin" |
クリエイティブの一般的な表示スタイル。 メディア タイプ サービスを使用して、 メディアの種類 の完全な一覧を表示できます。 |
mediatype_id |
int | はい | 1 |
クリエイティブの一般的な表示スタイルの ID。 |
user_group_for_campaign |
string | はい | "Test" |
キャンペーンのテスト/制御ユーザー グループ。 詳細については、"labels"キャンペーン サービスのフィールドを参照してください。 |
指標
| Column | 型 | 例 | 式 | 説明 |
|---|---|---|---|---|
imps |
int | 2340 |
Imps | 合計インプレッション数 (配信数と再販回数)。 |
clicks |
int | 1 |
クリック | すべてのインプレッションに対するクリックの合計数。 |
total_convs |
int | 9 |
post_click_convs + post_view_convs | ポストビューとクリック後のコンバージョンの合計数。 |
convs_rate |
double | 0.000221877080097626 |
total_convs/imps | インプレッションへのコンバージョン率。 |
click_convs_rate |
double | 0.1651376 |
total_convs/クリック | クリックへのコンバージョン率。 |
click_conv_rate |
double | 0.000064 |
total_convs/クリック | クリックへのコンバージョン率。 注: このフィールドは と同じです click_convs_rate。 |
ctr |
double | 0.000221877080097626 |
clicks/imps | インプレッションに対するクリック数の割合。 |
click_thru_pct |
double | 1.12359550561797% |
(クリック/インプ) x 100 | インプレッションに対するクリック率をパーセンテージで示します。 |
post_click_convs |
int | 4 |
post_click_convs | クリック後に記録されたコンバージョンの合計数。 |
post_click_convs_rate |
double | 0.0002 |
post_click_convs/imps | クリック後のインプレッションへのコンバージョン率。 |
post_click_revenue |
お 金 | 150.00 |
post_click_revenue | 記録されたクリック後コンバージョン収益の合計金額。 |
post_view_convs |
int | 5 |
post_view_convs | 記録されたポストビューコンバージョンの合計数。 |
post_view_convs_rate |
double | 0.00013 |
post_view_convs/imps | 表示後のインプレッションへのコンバージョン率。 |
post_view_revenue |
お 金 | 300.00 |
post_view_revenue | 記録されたビュー後コンバージョン収益の合計金額。 |
media_cost |
お 金 | 100 |
media_cost | 合計支出額 |
クリエイティブな頻度バケット
| バケット ID | バケット名 |
|---|---|
-2 |
"no-cookie-data" (Cookie 参照に失敗しました) |
-1 |
"no-cookie" (ユーザーが Cookie を有効にしていない) |
0 |
"0" |
1 |
"1" |
2 |
"2-5" |
3 |
"6-10" |
4 |
"11-20" |
5 |
"21-40" |
6 |
"41-60" |
7 |
"61-100" |
8 |
"101-150" |
9 |
"151-250" |
10 |
"251-500" |
11 |
"500+" |
クリエイティブなレジェンシー バケット
| バケット ID | バケット名 |
|---|---|
-2 |
"no-cookie-data" (Cookie 参照に失敗しました) |
-1 |
"no-cookie" (ユーザーが Cookie を有効にしていない) |
0 |
"< 1 minute" |
1 |
"1-5 minutes" |
2 |
"5-15 minutes" |
3 |
"15-30 minutes" |
4 |
"30-60 minutes" |
5 |
"1-4 hours" |
6 |
"4-12 hours" |
7 |
"12-24 hours" |
8 |
"1-2 days" |
9 |
"2-7 days" |
10 |
"8-14 days" |
11 |
"14-30 days" |
例
JSON 形式のレポート要求を作成する
$ cat network_advertiser_frequency_recency {
"report":
{
"report_type": "network_advertiser_frequency_recency",
"columns": [
"creative_recency_bucket",
"creative_frequency_bucket",
"creative_id",
"imps",
"clicks",
"total_convs"
],
"report_interval": "last_7_days",
"emails": ["js@email.com"],
"format": "csv"
}
}
POST レポート サービスへの要求
$ curl -b cookies -c cookies -X POST -d @network_advertiser_frequency_recency "https://api.appnexus.com/report?advertiser_id=384"
{
"response": {
"status": "OK",
"report_id": "c458f71c084a2a3b51dcd749132bcf87",
"dbg_info": {
...
}
}
}
レポート ID を使用してレポート データを取得する
標準応答には、レポート データと、データをファイルに保存できるダウンロード URL が含まれています。 レポート データを含まないダウンロード URL のみを取得する場合は、クエリ文字列を渡します "without_data" 。
$ curl -b cookies -c cookies "https://api.appnexus.com/report?id=c458f71c084a2a3b51dcd749132bcf87"
{
"response": {
"status": "OK",
"report": {
"name": null,
"created_on": "2012-02-03 21:43:27",
"cache_hit": true,
"fact_cache_hit": false,
"fact_cache_error": null,
"json_request": "{\"report\":{\"report_type\":\"network_advertiser_frequency_recency\",
\"columns\":[\"creative_recency_bucket\",\"creative_frequency_bucket\",\"creative_id\",
\"imps\",\"clicks\",\"total_convs\"],\"report_interval\":\"last_7_days\",\"emails\":
[\"js@email.com\"],\"filters\":[{\"buyer_member_id\":\"541\"},{\"advertiser_id\":
\"3610\"}]}}",
"header_info": null,
"data": "creative_recency_bucket,creative_frequency_bucket,creative_id,imps,clicks,
total_convs\r\nno-cookie,no-cookie,700454,47,0,0\r\n2-7 days,2-5,773422,31,0,
0\r\n5-15 minutes,6-10,1298720,1,0,0\r\n14-30 days,151-250,700464,8,0,0\r\n7-14 days,
21-40,711929,5,0,0\r\n1-4 hours,6-10,1317518,826,2,0\r\n1-4 hours,1,1317473,996,14,
0\r\n12-24 hours,11-20,1317436,139,0,0\r\n15-30 minutes,6-10,773408,12,0,0\r\nno-cookie,
no-cookie,1318994,3,0,0\r\n1-5 minutes,101-150,711932,898,0,0\r\n2-7 days,2-5,773408,45,
0,0\r\n1-5 minutes,2-5,610381,7990,23,0\r\n12-24 hours,1,1316895,4790,30,0\r\n1-4 hours,
...
"url": "report-download?id=c447d71c084a2a3b51dcd749132bcf87"
},
"execution_status": "ready",
"dbg_info": {
...
}
}
}
ダウンロード URL を使用してレポート データをファイルに保存する
応答の フィールドを "url" 使用して、レポート データをファイルに保存します。 別の GET 呼び出しを行い、保存する場所とファイルを特定するだけです。 最初POSTの要求で指定した の"format"拡張子を持つファイルを必ず使用してください。
$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=c447d71c084a2a3b51dcd749132bcf87' > /tmp/network_advertiser_frequency_recency.csv
注:
XLSX および Excel ファイルとしてダウンロードする場合、レポートごとに 100,000 行の制限があります。