Nielsen Digital Ad Ratings (DAR) - 対象ユーザー プロファイル レポートを使用すると、広告申込情報のインプレッションと、配信元のデモグラフに関する分析情報が得られます。 広告申込情報でこのレポートを利用するには、対象ユーザーの人口統計測定を有効にする必要があります。
レポートを取得する手順については、 Report Service または以下の 例 を参照してください。
期限
JSON 要求の report_interval フィールドは、次のいずれかに設定できます。
- 習慣
- last_7_days
- last_14_days
- month_to_date
- last_30_days
- quarter_to_date
- last_100_days
- last_365_days
- year_to_date
データ保持期間
このレポートのデータ保持期間は 365 日です。 このレポートのデータには、毎日の時間粒度と有効期間の保持があります。 このレポートには、米国東部タイム ゾーンの下のデータも表示されます。
注:
カスタム時間枠のレポートを実行するには、レポート要求の start_date フィールドと end_date フィールドを設定します。 これらのフィールドの詳細については、「 Report Service」を参照してください。
Dimensions
| 列 | 種類 | フィルター。 | 例 | 説明 |
|---|---|---|---|---|
insertion_order_id |
int | はい | 553515 |
挿入順序の ID。 |
advertiser_id |
int | はい | 4919231 |
広告主の ID。 |
line_item |
int | はい | 13731149 |
明細の ID。 |
line_item.name |
string | はい | "My Line Item" |
行項目の名前。 |
ymd |
date | はい | 2021-05-02 |
データに対して最後に使用できる日の年、月、日。 |
member_id |
int | はい | 14545978 |
メンバーの ID。 |
country_code |
string | はい | "DE" - Germany |
広告申込情報のインプレッションが発生した国/地域の対応するコード。 |
demographic_group |
string | はい | "male 25-29" |
性別と年齢範囲で並べ替えられた人口統計グループ。 |
platform |
string | はい |
"desktop"、"mobile"、または "connected device" |
使用するデバイスの種類をフィルター処理します。 |
nielsen_campaign_ref |
文字列 | いいえ | "scm1521250" |
Nielsen キャンペーンの参照 ID。 |
start_agg_date |
date | いいえ | 2021-04-26 |
Nielsen が最初にデータの収集を開始した日付。 |
country_name |
文字列 | いいえ | "United States" |
インプレッションが記録された国/地域。 |
指標
| 列 | 型 | 例 | 式 | 説明 |
|---|---|---|---|---|
population |
int | 11080000 |
該当なし | 国勢調査が提供するデータに基づいて、特定の人口統計に含まれる国/地域のユーザー数 |
total_imps |
int | 132297 |
該当なし | 広告申込情報が行ったインプレッションの合計数。 |
on_target_imps |
int | 10588 |
ターゲットインプレッション数 = ターゲットの人口統計÷広告申込情報の合計インプレッション数で表示されるインプレッション数 | 選択したレポート ディメンション内にある目的の人口統計グループに配信されたインプレッションの数。 |
imps_share |
double | 5.910942802935819 |
インプレッションシェア (%) = 人口統計インプレッション数 ÷ すべての人口統計グループ × 100 全体のインプレッションの総数 | 広告申込情報の合計インプレッション数に基づいて、対象となる人口統計に対して配信された割合。 |
imps_index |
double | 51.47677411571988 |
インプレッション インデックス = インプレッション シェア (%) ÷ Demographic-Specific人口 × 100 | 広告申込情報のインプレッションをすべての人口統計に分割する方法に基づくターゲット設定の成功スコア。 |
on_target_pct |
double | 5.678014273984716 |
ターゲット率 (%) = 広告申込情報のターゲット人口統計÷合計インプレッション数で表示されるインプレッション数 × 100 | 対象となる人口統計に対して配信されたインプレッションの割合。 |
population_share |
double | 7.7502 |
人口シェア (%) = 人口統計人口 ÷ すべての人口統計の人口 × 100 | 総人口に対する人口統計内のユーザーの割合。 |
audience_share |
double | 23.64 |
対象ユーザー共有 (%) = 行レベルの対象ユーザー数 ÷ キャンペーンの合計対象ユーザー数 × 100 | 特定の人口統計グループ内で行項目が到達した総対象ユーザーの割合。 この測定値は小数点以下 2 桁に丸められます。 |
audience_reach |
double | 0.00067472306143 |
対象ユーザーのリーチ (%) = 一意の対象ユーザー ÷ 人口統計人口 × 100 | 特定の人口統計内に到達した人口の割合。 |
unique_audience |
int | 132297 |
該当なし | 広告申込情報に到達した対象ユーザーの一意の個人の合計 |
audience_index |
double | 152.4298 |
Audience Index = Audience Share (%) ÷ Population Share (%) × 100 | 対象ユーザー共有に基づくターゲット設定の成功スコア。 これは常に整数です。 |
ave_frequency |
double | 10.271604938271604 |
平均頻度 = 一意の対象ユーザー÷インプレッション数 | 一意のオーディエンス メンバーが広告申込情報のクリエイティブを表示した平均回数。 |
grp (総評価ポイント) |
double | 0.0084979838709677 |
GRP = (平均ビューアーが広告を見た回数×少なくとも 1 回広告を見た人口の割合) × 100 | 広告申込情報が実際に選択した人口統計の対象ユーザーに到達した回数。 |
例
JSON 形式のレポート要求を作成する
JSON ファイルには、"video_indemo_audience_profile"のreport_typeと、取得する列 (ディメンションとメトリック) とreport_intervalが含まれている必要があります。 また、特定のディメンションをフィルター処理し、粒度 (year、 month、 day) を定義し、データを返す "format" ("csv"、 "excel"、または "html") を指定することもできます。 JSON ファイルに含めることができるフィールドの詳細については、 レポート サービスに関するページを参照してください。
$ cat video_indemo_audience_profile
{
"report":
{
"report_type":"video_indemo_audience_profile",
"columns":[
"nielsen_campaign_ref",
"line_item",
"line_item.name",
"start_agg_date",
"audience_reach",
"audience_index",
"grp",
"demographic_group",
"total_imps",
"on_target_imps"
],
"report_interval":"last_7_days",
"format":"csv"
}
}
POST レポート サービスへの要求
$ curl -b cookies -c cookies -X POST -d @video_indemo_audience_profile 'https://api.appnexus.com/report'
{
"response":{
"status":"OK",
"report_id":"097f59fc3ab7d02c5d60db42081d9b69"
}
}
GET レポート サービスからのレポートの状態
レポート ID を使用して GET 呼び出しを行って、レポートの状態を取得します。
execution_statusが"ready"されるまで、このGET呼び出しを行い続けます。 次の手順で説明するように、 レポート ダウンロード サービスを使用してレポート データをファイルに保存します。
$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=097f59fc3ab7d02c5d60db42081d9b69'
{
"response":{
"status":"OK",
"report":{
"name":null,
"created_on":"2021-05-25 19:19:53",
"json_request":"{\"report\":{\"report_type\":\"video_indemo_audience_profile\",\"columns\":[\"nielsen_campaign_ref\",
\"line_item\",\"line_item.name\",\"start_agg_date\",\"audience_reach\",\"audience_reach_index\",\"grp\",\"demographic_group\",\"total_imps\",\"on_target_imps\"],
\"report_interval\":\"last_7_days\"}}",
"url": "report-download?id=b97897a7864dd8f34e7457226c7af592"
},
"execution_status":"ready"
}
}
GET レポート ダウンロード サービスからのレポート データ
レポート データをファイルにダウンロードするには、レポート ID を使用して別の GET 呼び出しを行いますが、今回は レポート ダウンロード サービスに呼び出します。 サービスとレポート ID は、前のGET応答の [url] フィールドにあります。 保存するファイルを特定するときは、最初のPOSTで指定した"format"のファイル拡張子を使用してください。
注:
ダウンロード中にエラーが発生した場合、応答ヘッダーには HTTP エラー コードとメッセージが含まれます。 応答ヘッダーを公開するには、呼び出しで -i または -v を使用します。
$ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=b97897a7864dd8f34e7457226c7af592' > /tmp/video_indemo_audience_profile.csv