このトピックで説明する機能とシグナルを使用すると、カスタム入札モデルに情報を指定するときに、改善が必要な重要業績評価指標(KPI)を正確に示すカスタム入札スクリプトを作成できます。
この記事の内容
構文ルール
自社データを使用してカスタム入札スクリプトに情報を指定し、インプレッション値を改善できます。ディスプレイ&ビデオ 360 では、以下から取得した自社データを使用できます。
- Floodlight: 詳しくは、Floodlight データを使用するスクリプト例をご覧ください。
- インプレッション単位のデータ: 詳しくは、インプレッション単位のデータを使用するスクリプト例をご覧ください。
- Google アナリティクス: 詳しくは、Google アナリティクスのデータを使用するスクリプト例をご覧ください。
カスタム入札スクリプトを作成する際は、次の構文ルールを使用します。
- 条件はすべて角かっこ
[ ]
で囲みます。 - カンマ
,
は「および」を表します。
例
criteria1
は、criteria_a
と criteria_b
が両方とも true
の場合のみ true を返します。一方、criteria2
は、criteria_a
が true
の場合に true
を返します。([criteria_a, criteria_b], score), #criteria1
([criteria_a], score) #criteria2
])
コメント
コメントを使用して、スクリプトに説明を追加できます。たとえば、スクリプトの意図を伝えるコメントを追加できます。
コメントには次の構文を使用できます。
- 1 行のコメントを追加するには、
#
を使用します。 - 複数行のコメントを追加するには、コメントを
"""
または'''
で囲みます。
例
# これは 1 行のコメントです
"""
これは複数行のコメントです
"""
'''
これも複数行のコメントです
'''
演算子
スクリプトでは次の演算子を使用できます。
- 算術演算子:
+
、-
、*
、/
、%
、**
、//
- 代入演算子:
=
、+=
、-=
、*=
、/=
、%=
、**=
、//=
- 比較演算子:
==
、!=
、<
、>
、>=
、<=
- 論理演算子:
and
、or、not - メンバーシップ演算子: in、not in
メンバーシップ演算子
スクリプトでメンバーシップ演算子(in および not in)を使用して、要素がフィールドにあるかどうかを確認できます。
in
: 要素がフィールドで見つかった場合に true を返します。not in
: 要素がフィールドで見つからない場合に true を返します。
例
if 123 in channel_id: #123 がチャネル ID 内にあるかどうかを確認
return y
比較演算子
比較演算子を使用すると、モデルの要素を追加または除外できます。
例 1
# 日付を除外
if date == 20180711:
return None
カスタム入札モデルをトレーニングするときに除外したいインプレッションは、「None
」を返すもので特定できます。None
を返すステートメントを使用して、カスタム入札モデルのトレーニング時に除外するインプレッションを指定できます。
例 2
次のスクリプトは、カスタム入札モデルから広告タイプを除外します。
# スライスを除外(ad_type == 1 は VIDEO を意味します)
if ad_type != 1:
return None
使用可能な関数とシグナル
カスタム入札スクリプトで使用できる関数のリストは下記のとおりです。表には次の情報が含まれています。
- フィールド: スクリプトで使用する関数またはシグナルの名前。
- 型: 出力データ型。カスタム入札では、以下のデータ型がサポートされています。
- ブール値:
true
またはfalse
の値が含まれます。 - バイナリ: バイナリデータが含まれます。
- 倍精度: 浮動小数点値が含まれます(例:
1.0
)。 - 整数のリスト: 一群の整数が含まれます。
- 整数: 正または負の整数が含まれます(例:
1
または-1
)。 - 文字列: 最小文字数が 0 以上の UTF-8 文字が含まれます(例:
country_code
で文字列「US
」を出力)。
- ブール値:
- 詳細: 詳細情報と例へのリンクが含まれます。
詳しくは、Display & Video 360 API を確認するか、構造化データファイル(SDF)をダウンロードしてください。
関数
ディスプレイ&ビデオ 360 のカスタム入札では、次の関数がサポートされています。
これらの関数では、1 つ以上のシグナルを使用して、カスタム入札スクリプトで重要業績評価指標(KPI)を正確に示すことができます。
カテゴリ | 関数 | 型 | 詳細 |
---|---|---|---|
集計関数 | first_match_aggregate |
倍精度 | true を返す配列内の最初の条件に割り当てられたウェイト値を返します。 |
max_aggregate |
倍精度 | true を返す条件に割り当てられた最も高いウェイト値を返します。 |
|
sum_aggregate |
倍精度 | true を返すすべての条件に割り当てられたすべての値の合計を返します。 |
|
キャスト関数 |
|
bool(x) |
ブール値( |
|
float(x) |
数値または文字列のデータ型を変換し、浮動小数点数を返します。 例: |
|
|
int(x) |
数値または文字列のデータ型を変換し、整数を返します。 例: |
|
|
str(object) |
データ型を変換し、文字列を返します。 例: |
|
数学関数 |
|
log(x[, base]) |
引数が 1 つだけの場合: x の自然対数(基数 e)を返します。 2 つの引数がある場合: 指定された数を基数とする x の対数を返します(log(x)/log(base))。 |
シグナル
ディスプレイ&ビデオ 360 のカスタム入札機能では、次のシグナル カテゴリのデータを使用できます。
- ディメンション変数: 変数に基づいてスコア付けするスクリプトで使用されるシグナル。
- コンバージョン: コンバージョンの結果に基づいてスコア付けするスクリプトで使用されるシグナル。
- Google アナリティクス: Google アナリティクス 4 のデータに基づいてスコア付けするスクリプトで使用されるシグナル。
ディメンション変数
カテゴリ |
シグナル |
型 |
詳細 |
全般 |
|
整数 |
ディスプレイ&ビデオ 360 の広告主 ID。 |
---|---|---|---|
|
整数 |
ディスプレイ&ビデオ 360 の広告掲載オーダー ID。 |
|
|
整数 |
ディスプレイ&ビデオ 360 の広告申込情報 ID。 |
|
日時 |
|
整数 |
インプレッションが発生した日付。 形式: yyyymmdd |
|
整数 |
インプレッションが発生した曜日の数値コード。
|
|
|
整数 |
ブラウザの現地タイムゾーン(24 時間形式)でのインプレッションが発生した時間。 有効な入力値: 0~23 |
|
|
整数 |
協定世界時(UTC)でのインプレッションが発生した日付。 形式: yyyymmdd |
|
|
整数 |
協定世界時(UTC)の 24 時間形式でのインプレッションが発生した時間。 有効な入力値: 0~23 |
|
地域 |
|
整数 |
市区町村の ID。 city_id は、Display & Video 360 API を使用するか、SDF メタデータをダウンロードして生成できます。 |
|
文字列 |
国または地域コード。 参照用に国または地域コードのマッピングを記載した PDF をダウンロードできます。 |
|
|
整数 |
国または地域 ID。 参照用に国または地域 ID のマッピングを記載した PDF をダウンロードできます。 |
|
|
整数 |
指定マーケット エリア(DMA)の ID。 |
|
|
文字列 |
郵便番号。 利用可能な郵便番号のリストは、Display & Video 360 API を使用するか、SDF メタデータをダウンロードして確認できます。 |
|
クリエイティブ(全般) |
|
整数 |
広告フォーマットを表す数値コード。
|
|
整数 |
クリエイティブの高さ(ピクセル単位)。 注: ディスプレイ クリエイティブのみが対象です。 |
|
|
整数 |
ディスプレイ&ビデオ 360 に表示されるクリエイティブ ID。 |
|
|
整数 |
クリエイティブの幅(ピクセル単位)。 注: ディスプレイ クリエイティブのみが対象です。 |
|
コンピュータ システム |
|
整数 |
ブラウザの ID。 |
|
整数 |
ブラウザのアクティブなタイムゾーンと GMT-12 の差(分単位)。 例: 1320 は GMT+10 のブラウザ タイムゾーンを表します。 |
|
|
整数 |
デバイスタイプを表す数値コード。
|
|
|
整数 |
広告の配信環境を表す数値コード。
|
|
|
整数 |
インターネット サービス プロバイダ(ISP)の ID。 |
|
|
文字列 |
ブラウザの言語設定。 |
|
|
整数 |
モバイル メーカーの ID。 |
|
mobile_model_id |
整数 |
モバイルモデルの ID。 |
|
|
整数 |
インプレッションの発生時に検出されたネットワーク速度を表す数値コード。
|
|
|
整数 |
オペレーティング システムの ID。 |
|
配信(全般) |
|
整数 |
広告のプレースメントの位置を表す数値コード。
|
|
整数のリスト |
ページカテゴリの ID。 カテゴリ ID すべてのマッピングのリストは、AdWords API リファレンスで確認できます。 |
|
|
整数のリスト |
ディスプレイ&ビデオ 360 のチャネル ID。 |
|
|
文字列 |
注: コネクテッド テレビ広告申込情報ではドメインを使用できません。コネクテッド テレビ広告申込情報の場合は ドメイン名とトップレベル ドメインで構成されるルートドメイン名。 例: URL が http://www.domain.com の場合、ルートドメインは domain.com です。 |
|
|
整数 |
エクスチェンジ ID。 |
|
|
整数 |
サイト ID。 |
|
アクティブ ビュー |
|
ブール値 |
広告が配信されたときにアクティブ ビューでインプレッションが測定可能だった場合に true として なんらかの要因によりインプレッション数がカウントされないことがあります。インプレッションが測定不能だった場合、false として |
|
ブール値 |
アクティブ ビューで広告が視聴されたことが検出されると、true として 1 が返されます。それ以外の場合は、false として 0 が返されます。 |
|
イベント |
|
ブール値 |
広告がクリックされた場合は true として |
|
整数 |
広告が画面に表示された時間(秒単位)。 |
|
動画 |
|
ブール値 |
注: リアルタイム ビッダー(RTB)の動画でのみサポートされています。 動画が視聴されたときに動画の音声がオンだった場合、true として |
|
ブール値 |
注: リアルタイム ビッダー(RTB)の動画でのみサポートされています。 動画が視聴されたときに音声がオンだった場合、true として |
|
|
ブール値 |
注: 動画広告タイプにのみ適用されます。動画以外のインプレッションにはラベルは付けられません。 動画の再生が完了した場合は true として |
|
|
整数 |
最初のフレームでの動画プレーヤーの高さ(ピクセル単位)。 |
|
|
整数 |
動画プレーヤーのサイズに基づく、ターゲットとする動画広告枠を表す数値コード。
詳しくは、動画ターゲティングをご覧ください。 |
|
|
整数 |
最初のフレームでの動画プレーヤーの幅(ピクセル単位)。 |
|
|
バイナリ |
再生中に動画プレーヤーのサイズが変更された場合、true として |
|
|
ブール値 |
注: リアルタイム ビッダー(RTB)の動画でのみサポートされています。 動画が最後まで再生された場合、true として |
|
video_content_duration_bucket |
整数 |
注: 動画広告タイプにのみ適用されます。動画以外のインプレッションにはラベルは付けられません。
動画のバケットを表す数値コード。長さに基づいて動画を分類するために使用します。範囲の上限の長さはその範囲に含まれません。 例長さが 1 分の動画:
|
|
video_genre_ids |
整数のリスト |
注: 動画広告タイプにのみ適用されます。動画以外のインプレッションにはラベルは付けられません。 オーディオ広告枠と動画広告枠の関連グループに基づいて広告をターゲティングするための動画ジャンル ID のリストを表します。 詳しくは、ジャンルに基づくターゲティングをご覧ください。 |
|
video_livestream |
ブール値 |
注: 動画広告タイプにのみ適用されます。動画以外のインプレッションにはラベルは付けられません。 動画がライブ配信の場合は、true を返します。それ以外の場合は、false を返します。 |
コンバージョン
カテゴリ |
シグナル |
型 |
詳細 |
コンバージョン シグナル |
|
倍精度 |
ID ペアのコンバージョン イベントの合計数。独自のモデルを使用するか、モデル ID に「0」を入力して「最後の接点」のアトリビューションを使用します。 |
---|---|---|---|
|
倍精度 |
Floodlight セールスタグで追跡されるアクティビティから収益値を取得します。独自のモデルを使用するか、モデル ID に「0」を入力して「最後の接点」のアトリビューションを使用します。 |
|
|
倍精度 |
特定の ID ペアに結び付けられたコンバージョンの合計数。独自のモデルを使用するか、モデル ID に「0」を入力して「最後の接点」のアトリビューションを使用します。 |
|
|
文字列 |
インプレッションに対して結び付けられた最新のコンバージョンのカスタム変数の文字列値。それ以外の場合は、 |
|
|
整数 |
貢献度が正の最新のコンバージョンを取得し、count_micros が正の値である場合は「num」Floodlight 変数を取得します(存在する場合)。それ以外の場合は、 |
|
|
文字列 |
貢献度が正の最新のコンバージョンを取得し、 |
動画のジャンルのマッピング
ジャンル ID |
ジャンル名 |
2 |
/アダルト |
3 |
/アート、エンターテインメント |
317 |
/アート、エンターテインメント/コミック、アニメーション/アニメ、マンガ |
319 |
/アート、エンターテインメント/コミック、アニメーション/カートゥーン |
1108 |
/アート、エンターテインメント/娯楽産業/映画、テレビ業界/映画、テレビ賞 |
569 |
/アート、エンターテインメント/イベント情報 |
1273 |
/アート、エンターテインメント/イベント情報/スポーツ中継イベント |
895 |
/アート、エンターテインメント/ユーモア/お笑いライブ |
1097 |
/アート、エンターテインメント/映画/アクション、アドベンチャー映画 |
1099 |
/アート、エンターテインメント/映画/アクション、アドベンチャー映画/西部劇 |
1095 |
/アート、エンターテインメント/映画/コメディ映画 |
615 |
/アート、エンターテインメント/映画/ホラー映画 |
1105 |
/アート、エンターテインメント/映画/ミュージカル映画 |
1310 |
/アート、エンターテインメント/映画/恋愛映画 |
616 |
/アート、エンターテインメント/映画/SF、ファンタジー映画 |
1096 |
/アート、エンターテインメント/映画/スリラー、犯罪、ミステリー映画 |
35 |
/アート、エンターテインメント/音楽、オーディオ |
449 |
/アート、エンターテインメント/オフビート/オカルト、超常現象 |
23 |
/アート、エンターテインメント/舞台芸術 |
894 |
/アート、エンターテインメント/舞台芸術/劇場、映画館 |
581 |
/アート、エンターテインメント/舞台芸術/ダンス |
1185 |
/アート、エンターテインメント/舞台芸術/オペラ |
358 |
/アート、エンターテインメント/テレビ、動画/テレビ番組 |
1047 |
/アート、エンターテインメント/テレビ、動画/テレビ番組/お笑い番組 |
1411 |
/アート、エンターテインメント/テレビ、動画/テレビ番組/ドキュメンタリー、ノンフィクション番組 |
1193 |
/アート、エンターテインメント/テレビ、動画/テレビ番組/テレビドラマ |
1111 |
/アート、エンターテインメント/テレビ、動画/テレビ番組/テレビドラマ/犯罪捜査ドラマ番組 |
357 |
/アート、エンターテインメント/テレビ、動画/テレビ番組/テレビドラマ/メロドラマ |
1110 |
/アート、エンターテインメント/テレビ、動画/テレビ番組/ファミリー向け番組 |
1050 |
/アート、エンターテインメント/テレビ、動画/テレビ番組/クイズ番組 |
1049 |
/アート、エンターテインメント/テレビ、動画/テレビ番組/リアリティ番組 |
1112 |
/アート、エンターテインメント/テレビ、動画/テレビ番組/SF、ファンタジー番組 |
1410 |
/アート、エンターテインメント/テレビ、動画/テレビ番組/テレビ タレント、バラエティ番組 |
1048 |
/アート、エンターテインメント/テレビ、動画/テレビ番組/トーク番組 |
24 |
/アート、エンターテインメント/ビジュアル アート、デザイン |
47 |
/自動車、車両 |
1191 |
/自動車、車両/自転車、パーツ |
1405 |
/自動車、車両/自転車、パーツ/マウンテン バイク |
273 |
/産業分野/自動車、車両/自動車(種類別)/オートバイ |
148 |
/産業分野/自動車、車両/自動車(種類別)/オフロード車 |
185 |
/美容、フィットネス/ファッション、スタイル |
94 |
/美容、フィットネス/フィットネス |
241 |
/美容、フィットネス/フィットネス/ボディビル |
1418 |
/美容、フィットネス/フィットネス/フィットネス指導、個人向けトレーニング |
46 |
/ビジネス、産業/農業、林業 |
5 |
/コンピュータ、電化製品 |
122 |
/食品、飲料/料理、レシピ |
39 |
/ゲーム/カード ゲーム |
924 |
/ゲーム/カード ゲーム/ポーカー、カジノ ゲーム |
924 |
/ゲーム/カード ゲーム/ポーカー、カジノ ゲーム |
41 |
/ゲーム/コンピュータ ゲーム、テレビゲーム |
698 |
/ゲーム/ギャンブル/スポーツ賭博/競馬、ドッグレース |
939 |
/ゲーム/テーブル ゲーム/ビリヤード |
940 |
/ゲーム/テーブル ゲーム/卓球 |
45 |
/健康 |
284 |
/趣味、レジャー/工芸 |
688 |
/趣味、レジャー/アウトドア |
462 |
/趣味、レジャー/アウトドア/釣り |
461 |
/趣味、レジャー/アウトドア/狩猟、射撃 |
461 |
/趣味、レジャー/アウトドア/狩猟、射撃 |
461 |
/趣味、レジャー/アウトドア/狩猟、射撃 |
999 |
/趣味、レジャー/レジャー飛行 |
678 |
/趣味、レジャー/行事/休暇、年中行事 |
459 |
/趣味、レジャー/ウォーター アクティビティ/ボート |
11 |
/家庭、園芸 |
158 |
/家庭、園芸/リフォーム |
966 |
/法律、行政/政府/地方自治体、役所 |
75 |
/法律、行政/法律 |
366 |
/法律、行政/軍事 |
16 |
/ニュース |
784 |
/ニュース/ビジネス ニュース |
396 |
/ニュース/政治 |
1201 |
/ニュース/政治/社説、コラム |
1077 |
/ニュース/スポーツ ニュース |
785 |
/ニュース/テクノロジー関連のニュース |
63 |
/ニュース/天気 |
113 |
/人々、社会/民族、性認識/同性愛者、両性愛者、性転換者 |
58 |
/人々、社会/家族、人間関係/家族/育児 |
59 |
/人々、社会/信仰 |
870 |
/人々、社会/自己啓発 |
57 |
/人々、社会/社会問題、支援運動/チャリティ、慈善活動 |
82 |
/人々、社会/社会問題、支援運動/エコライフ、環境問題 |
886 |
/ペット、動物/ペット/犬 |
888 |
/ペット、動物/ペット/馬 |
119 |
/ペット、動物/野生動物 |
119 |
/ペット、動物/野生動物 |
690 |
/資料/一般資料/伝記、引用 |
694 |
/資料/一般資料/ハウツー、DIY、専門コンテンツ |
433 |
/資料/人文科学/歴史 |
1288 |
/資料/人文科学/歴史/戦史 |
174 |
/科学 |
18 |
/ショッピング |
64 |
/ショッピング/アンティーク、コレクション |
292 |
/ショッピング/オークション |
69 |
/ショッピング/消費者向けリソース |
1666 |
/スポーツ/動物競技 |
568 |
/スポーツ/動物競技/馬術 |
515 |
/スポーツ/格闘技/ボクシング |
516 |
/スポーツ/格闘技/武術 |
1674 |
/スポーツ/格闘技/武術/総合格闘技 |
512 |
/スポーツ/格闘技/レスリング |
1681 |
/スポーツ/格闘技/レスリング/プロレス |
554 |
/スポーツ/エクストリーム スポーツ |
1206 |
/スポーツ/エクストリーム スポーツ/ドラッグ レース、ストリート レース |
1000 |
/スポーツ/個人競技 |
1016 |
/スポーツ/個人競技/ボウリング |
458 |
スポーツ/個人競技/サイクリング |
261 |
スポーツ/個人競技/ゴルフ |
519 |
スポーツ/個人競技/体操 |
262 |
/スポーツ/個人競技/ラケット スポーツ |
1376 |
/スポーツ/個人競技/ラケット スポーツ/テニス |
541 |
/スポーツ/個人競技/ランニング、ウォーキング |
1126 |
/スポーツ/個人競技/スケート競技 |
518 |
/スポーツ/個人競技/陸上競技 |
513 |
/スポーツ/スポーツ世界大会/オリンピック |
180 |
/スポーツ/モーター スポーツ |
1595 |
/スポーツ/モーター スポーツ/オートレース |
1596 |
/スポーツ/モーター スポーツ/オートバイ レース |
1001 |
/スポーツ/団体競技 |
258 |
/スポーツ/団体競技/アメリカン フットボール |
259 |
/スポーツ/団体競技/野球 |
264 |
/スポーツ/団体競技/バスケットボール |
534 |
/スポーツ/団体競技/チアリーディング |
296 |
/スポーツ/団体競技/クリケット |
1017 |
/スポーツ/団体競技/ハンドボール |
260 |
/スポーツ/団体競技/ホッケー |
517 |
/スポーツ/団体競技/ラグビー |
294 |
/スポーツ/団体競技/サッカー |
699 |
/スポーツ/団体競技/バレーボール |
118 |
/スポーツ/ウォーター スポーツ |
1593 |
/スポーツ/ウォーター スポーツ/サーフィン |
1594 |
/スポーツ/ウォーター スポーツ/水泳 |
265 |
/スポーツ/ウィンター スポーツ |
1149 |
/スポーツ/ウィンター スポーツ/アイススケート |
1148 |
/スポーツ/ウィンター スポーツ/スキー、スノーボード |
67 |
/旅行、交通 |
Google アナリティクス
カテゴリ | シグナル | 型 | 詳細 |
---|---|---|---|
Google アナリティクス 4 |
|
ブール値 |
特定のインプレッションに結び付けられた、プロパティ ID とコンバージョン イベントを持つコンバージョンが少なくとも 1 つある場合、true を返します。それ以外の場合は、false を返します。 |
|
整数 |
特定のインプレッションに結び付けられた、プロパティ ID とコンバージョン イベントを持つコンバージョン数を返します。 | |
|
倍精度 |
特定のインプレッションに結び付けられた、プロパティ ID とコンバージョン イベントを持つコンバージョンに割り当てられた最も高い値を返します。 最も高いコンバージョン値が0 の場合、または結び付けられたコンバージョンがない場合は 0 を返します。 |
|
|
倍精度 |
注: Google アナリティクス 4 アカウントの場合、米ドル通貨が使用されます。 特定のインプレッションに結び付けられた、プロパティ ID とコンバージョン ID を持つコンバージョンに割り当てられた最も高い値を返します。 最も高いコンバージョン値が |
|
|
倍精度 |
特定のインプレッションに結び付けられた、プロパティ ID とコンバージョン イベントを持つコンバージョンに割り当てられたウェイト値の合計を返します。 最も高いコンバージョン値が |
|
|
倍精度 |
注: Google アナリティクス 4 アカウントの場合、米ドル通貨が使用されます。 特定のインプレッションに結び付けられた、プロパティ ID とコンバージョン イベントを持つコンバージョンに割り当てられたウェイト値の合計を返します。 最も高いコンバージョン値が |
制限事項
以下はカスタム入札スクリプトではサポートされていません。
- 名前付き引数を渡す(例:
func(arg1 = “abc”, arg2 = “def")
) - サブスクリプトとスライス(例:
userlists[1:3]
) - 属性の参照(例:
domain.length
) - 変数名と関数名を事前に定義されたセットから取得できる
- 再帰
- 高度なカスタム変数の割り当て:
- 複数の割り当て
- 拡張割り当て
- アノテーション付きの割り当て
カスタム変数の割り当てでサポートされていない構文の例
_a, _b = 1, 2
_a, _b = _b, _a
_a = _b = 2
_idx += 1
- サポートされていないキーワード:
global
、nonlocal
、exec
キーワードclass
とクラス定義def
と関数の定義Import
とキーワードからのインポートlambda
とラムダのサポートbreak
continue
yield
raise
assert
try
finally
except
async
await
del
Pass
ellipsis
- サポートされていないループ:
for
、while
ループ
- サポートされていない演算子:
*
と**
の算術以外のステートメントでの使用<<
と>>
のシフト演算子- ビット演算子
@
デコレータis
、not is
の ID 演算子