カスタム入札スクリプトのリファレンス

このトピックで説明する機能とシグナルを使用すると、カスタム入札モデルに情報を指定するときに、改善が必要な重要業績評価指標（KPI）を正確に示すカスタム入札スクリプトを作成できます。

この記事の内容

構文ルール

自社データを使用してカスタム入札スクリプトに情報を指定し、インプレッション値を改善できます。ディスプレイ＆ビデオ 360 では、以下から取得した自社データを使用できます。

カスタム入札スクリプトを作成する際は、次の構文ルールを使用します。

  • 条件はすべて角かっこ [ ] で囲みます。
  • カンマ , は「および」を表します。

例

このスクリプト例の criteria1 は、criteria_a と criteria_b が両方とも true の場合のみ true を返します。一方、criteria2 は、criteria_a が true の場合に true を返します。
return aggregate_function([
([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

例 1
次のスクリプトは、カスタム入札モデルから日付を除外します。

# 日付を除外

if date == 20180711:

return None

カスタム入札モデルをトレーニングするときに除外したいインプレッションは、「None」を返すもので特定できます。None を返すステートメントを使用して、カスタム入札モデルのトレーニング時に除外するインプレッションを指定できます。

例 2

例 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

bool(x)

ブール値（true または false）を返します。

float

float(x)

数値または文字列のデータ型を変換し、浮動小数点数を返します。

例: float(1) は 1.0 を返します。

int

int(x)

数値または文字列のデータ型を変換し、整数を返します。

例: int(1.0) は 1 を返します。

str

str(object)

データ型を変換し、文字列を返します。

例: str(1) は文字列の「1」を返します。
数学関数

log

log(x[, base])

引数が 1 つだけの場合: x の自然対数（基数 e）を返します。

2 つの引数がある場合: 指定された数を基数とする x の対数を返します（log(x)/log(base)）。

 

シグナル

ディスプレイ＆ビデオ 360 のカスタム入札機能では、次のシグナル カテゴリのデータを使用できます。

  • ディメンション変数: 変数に基づいてスコア付けするスクリプトで使用されるシグナル。
  • コンバージョン: コンバージョンの結果に基づいてスコア付けするスクリプトで使用されるシグナル。
  • Google アナリティクス: Google アナリティクス 4 または Google アナリティクス 360 のデータに基づいてスコア付けするスクリプトで使用されるシグナル。

ディメンション変数

カテゴリ

シグナル

型

詳細
全般

advertiser_id

整数

ディスプレイ＆ビデオ 360 の広告主 ID。

insertion_order_id

整数

ディスプレイ＆ビデオ 360 の広告掲載オーダー ID。

line_item_id

整数

ディスプレイ＆ビデオ 360 の広告申込情報 ID。
日時

date

整数

インプレッションが発生した日付。

形式: yyyymmdd

day_of_week

整数

インプレッションが発生した曜日の数値コード。

  • 0（日曜日）
  • 1（月曜日）
  • 2（火曜日）
  • 3（水曜日）
  • 4（木曜日）
  • 5（金曜日）
  • 6（土曜日）

hour_of_day

整数

ブラウザの現地タイムゾーン（24 時間形式）でのインプレッションが発生した時間。

有効な入力値: 0～23

utc_date

整数

協定世界時（UTC）でのインプレッションが発生した日付。

形式: yyyymmdd

utc_hour_of_day

整数

協定世界時（UTC）の 24 時間形式でのインプレッションが発生した時間。

有効な入力値: 0～23
地域

city_id

整数

市区町村の ID。

city_id は、Display & Video 360 API を使用するか、SDF メタデータをダウンロードして生成できます。

country_code

文字列

国または地域コード。

参照用に国または地域コードのマッピングを記載した PDF をダウンロードできます。

country_id

整数

国または地域 ID。

参照用に国または地域 ID のマッピングを記載した PDF をダウンロードできます。

dma_id

整数

指定マーケット エリア（DMA）の ID。

これらの ID を入手するには、カスタム入札 ID シート（.xlsx 形式）をダウンロードします。

zip_postal_code

文字列

郵便番号。

利用可能な郵便番号のリストは、Display & Video 360 API　を使用するか、SDF メタデータをダウンロードして確認できます。
クリエイティブ（全般）

ad_type

整数

広告フォーマットを表す数値コード。

  • 0（ディスプレイ）
  • 1（動画）
  • 2（オーディオ）

creative_height

整数

クリエイティブの高さ（ピクセル単位）。

注: ディスプレイ クリエイティブのみが対象です。

creative_id

整数

ディスプレイ＆ビデオ 360 に表示されるクリエイティブ ID。

creative_width

整数

クリエイティブの幅（ピクセル単位）。

注: ディスプレイ クリエイティブのみが対象です。
コンピュータ システム

browser_id

整数

ブラウザの ID。

これらの ID を入手するには、カスタム入札 ID シート（.xlsx 形式）をダウンロードします。

browser_timezone_offset_minutes

整数

ブラウザのアクティブなタイムゾーンと GMT-12 の差（分単位）。

例:

1320 は GMT+10 のブラウザ タイムゾーンを表します。

device_type

整数

デバイスタイプを表す数値コード。

  • 0（パソコン）
  • 1（不明）
  • 2（スマートフォン）
  • 3（タブレット）
  • 4（スマートテレビ）
  • 5（コネクテッド テレビ）
  • 6（セットトップ ボックス）
  • 7（コネクテッド デバイス）

environment

整数

広告の配信環境を表す数値コード。

  • 10（デバイス向けに最適化されたウェブ）
  • 11（デバイス向けに最適化されていないウェブ）
  • 12（アプリ）

isp_id

整数

インターネット サービス プロバイダ（ISP）の ID。

これらの ID を入手するには、カスタム入札 ID シート（.xlsx 形式）をダウンロードします。

language

文字列

ブラウザの言語設定。

これらの ID を入手するには、カスタム入札 ID シート（.xlsx 形式）をダウンロードします。

mobile_make_id

整数

モバイル メーカーの ID。

これらの ID を入手するには、カスタム入札 ID シート（.xlsx 形式）をダウンロードします。
mobile_model_id 整数

モバイルモデルの ID。

これらの ID を入手するには、カスタム入札 ID シート（.xlsx 形式）をダウンロードします。

net_speed

整数

インプレッションの発生時に検出されたネットワーク速度を表す数値コード。

  • 1（ブロードバンド / 4G（2 Mbps 以上））
  • 2（ダイヤルアップ（56 kbps 以下））
  • 3（接続速度不明）
  • 4（EDGE / 2G（57 kbps 以上））
  • 5（UMTS / 3G（384 kbps 以上））
  • 6（ベーシック DSL（768 kbps 以上））
  • 7（HSDPA / 3.5G（1.8 Mbps 以上））

operating_system_id

整数

オペレーティング システムの ID。

これらの ID を入手するには、カスタム入札 ID シート（.xlsx 形式）をダウンロードします。
配信（全般）

ad_position

整数

広告のプレースメントの位置を表す数値コード。

  • 0（不明な位置）
  • 1（スクロールせずに見える範囲）
  • 2（スクロールしなければ見えない範囲）

adx_page_categories

整数のリスト

ページカテゴリの ID。

カテゴリ ID すべてのマッピングのリストは、AdWords API リファレンスで確認できます。

channels

整数のリスト

ディスプレイ＆ビデオ 360 のチャネル ID。

domain

文字列

注: コネクテッド テレビ広告申込情報ではドメインを使用できません。

ドメイン名とトップレベル ドメインで構成されるルートドメイン名。

例: URL が http://www.domain.com の場合、ルートドメインは domain.com です。

exchange_id

整数

エクスチェンジ ID。

これらの ID を入手するには、カスタム入札 ID シート（.xlsx 形式）をダウンロードします。

site_id

整数

サイト ID。
アクティブ ビュー

active_view_measurable

ブール値

広告が配信されたときにアクティブ ビューでインプレッションが測定可能だった場合に true として 1 が返されます。

なんらかの要因によりインプレッション数がカウントされないことがあります。インプレッションが測定不能だった場合、false として 0 が返されます。

active_view_viewed

ブール値

 アクティブ ビューで広告が視聴されたことが検出されると、true として 1 が返されます。それ以外の場合は、false として 0 が返されます。
イベント

click

ブール値

広告がクリックされた場合は true として 1 が返されます。それ以外の場合は、false として 0 が返されます。

time_on_screen_seconds

整数

広告が画面に表示された時間（秒単位）。
動画

audible

ブール値

注: リアルタイム ビッダー（RTB）の動画でのみサポートされています。

動画が視聴されたときに動画の音声がオンだった場合、true として 1 が返されます。それ以外の場合は、false として 0 が返されます。

completed_in_view_audible

ブール値

注: リアルタイム ビッダー（RTB）の動画でのみサポートされています。

動画が視聴されたときに音声がオンだった場合、true として 1 が返されます。それ以外の場合は、false として 0 が返されます。

video_completed

ブール値

注: 動画広告タイプにのみ適用されます。動画以外のインプレッションにはラベルは付けられません。

動画の再生が完了した場合は true として 1 が返されます。それ以外の場合、false として 0 が返されます。

video_player_height_start

整数

最初のフレームでの動画プレーヤーの高さ（ピクセル単位）。

video_player_size

整数

動画プレーヤーのサイズに基づく、ターゲットとする動画広告枠を表す数値コード。

  • 0（不明）
  • 1（小）
  • 2（大）
  • 3（高画質（HD））

詳しくは、動画ターゲティングをご覧ください。

video_player_width_start

整数

最初のフレームでの動画プレーヤーの幅（ピクセル単位）。

video_resized

バイナリ

再生中に動画プレーヤーのサイズが変更された場合、true として 1 が返されます。それ以外の場合、false として 0 が返されます。

viewable_on_complete

ブール値

注: リアルタイム ビッダー（RTB）の動画でのみサポートされています。

動画が最後まで再生された場合、true として 1 が返されます。それ以外の場合、false として 0 が返されます。
  video_content_duration_bucket 整数

注: 動画広告タイプにのみ適用されます。動画以外のインプレッションにはラベルは付けられません。

動画のバケットを表す数値コード。長さに基づいて動画を分類するために使用します。範囲の上限の長さはその範囲に含まれません。

例

長さが 1 分の動画:

  • 「1～5 分」のバケットに分類され、
  • 「0～1 分」のバケットには分類されません。1 分以上の動画はこのバケットには含まれません。
  • 0（不明）
  • 1（0～1 分）
  • 2（1～5 分）
  • 3（5～15 分）
  • 4（15～30 分）
  • 5（30～60 分）
  • 7（60 分以上）
  video_genre_ids 整数のリスト

注: 動画広告タイプにのみ適用されます。動画以外のインプレッションにはラベルは付けられません。

オーディオ広告枠と動画広告枠の関連グループに基づいて広告をターゲティングするための動画ジャンル ID のリストを表します。

詳しくは、ジャンルに基づくターゲティングをご覧ください。
  video_livestream ブール値

注: 動画広告タイプにのみ適用されます。動画以外のインプレッションにはラベルは付けられません。

動画がライブ配信の場合は、true を返します。それ以外の場合は、false を返します。

コンバージョン

カテゴリ

シグナル

型

詳細
コンバージョン シグナル

total_conversion_count(Floodlight アクティビティ ID, アトリビューション モデル ID)

倍精度

ID ペアのコンバージョン イベントの合計数。独自のモデルを使用するか、モデル ID に「0」を入力して「最後の接点」のアトリビューションを使用します。

total_conversion_value(
Floodlight アクティビティ ID, アトリビューション モデル ID)

倍精度

Floodlight セールスタグで追跡されるアクティビティから収益値を取得します。独自のモデルを使用するか、モデル ID に「0」を入力して「最後の接点」のアトリビューションを使用します。

total_conversion_quantity(Floodlight アクティビティ ID, アトリビューション モデル ID)

倍精度

特定の ID ペアに結び付けられたコンバージョンの合計数。独自のモデルを使用するか、モデル ID に「0」を入力して「最後の接点」のアトリビューションを使用します。

conversion_custom_variable(
Floodlight アクティビティ ID, アトリビューション モデル ID, カスタム変数のインデックス)

文字列

インプレッションに対して結び付けられた最新のコンバージョンのカスタム変数の文字列値。それ以外の場合は、None を返します（コンバージョンがない場合や値が設定されていない場合）。独自のモデルを使用するか、モデル ID に「0」を入力して「最後の接点」のアトリビューションを使用します。

conversion_variable_num(
Floodlight アクティビティ ID, アトリビューション モデル ID)

整数

貢献度が正の最新のコンバージョンを取得し、count_micros が正の値である場合は「num」Floodlight 変数を取得します（存在する場合）。それ以外の場合は、None を返します。

conversion_variable_ord(Floodlight アクティビティ ID, アトリビューション モデル ID)

文字列

貢献度が正の最新のコンバージョンを取得し、count_micros が正の値である場合は「ord」Floodlight 変数を取得します（存在する場合）。それ以外の場合は、None を返します。

動画のジャンルのマッピング

ジャンル 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 のコンバージョンまたは Google アナリティクス 360 の目標を使用してカスタム入札モデルに情報を指定するには、コンバージョン データを共有する必要があります。手順の詳細については、以下のリンク先をご覧ください。
カテゴリ シグナル 型 詳細
Google アナリティクス 4

has_ga4_conversions(
property_id, conversion_event_name)

ブール値

 特定のインプレッションに結び付けられた、プロパティ ID とコンバージョン イベントを持つコンバージョンが少なくとも 1 つある場合、true を返します。それ以外の場合は、false を返します。

ga4_conversions_count(
property_id, conversion_event_name)

整数

 特定のインプレッションに結び付けられた、プロパティ ID とコンバージョン イベントを持つコンバージョン数を返します。

ga4_conversions_max_value(
property_id, conversion_event_name)*

倍精度

特定のインプレッションに結び付けられた、プロパティ ID とコンバージョン イベントを持つコンバージョンに割り当てられた最も高い値を返します。

最も高いコンバージョン値が 0 の場合、または結び付けられたコンバージョンがない場合は 0 を返します。

ga4_conversions_max_value_usd(
property_id, conversion_event_name)

倍精度

注: Google アナリティクス 4 アカウントの場合、米ドル通貨が使用されます。

特定のインプレッションに結び付けられた、プロパティ ID とコンバージョン ID を持つコンバージョンに割り当てられた最も高い値を返します。

最も高いコンバージョン値が 0 の場合、または結び付けられたコンバージョンがない場合は 0 を返します。

ga4_conversions_total_value(GA4 property ID, conversion_event_name)

 倍精度

特定のインプレッションに結び付けられた、プロパティ ID とコンバージョン イベントを持つコンバージョンに割り当てられたウェイト値の合計を返します。

最も高いコンバージョン値が 0 の場合、または結び付けられたコンバージョンがない場合は 0 を返します。

ga4_conversions_total_value_usd(
property_id, conversion_event_name)

 倍精度

注: Google アナリティクス 4 アカウントの場合、米ドル通貨が使用されます。

特定のインプレッションに結び付けられた、プロパティ ID とコンバージョン イベントを持つコンバージョンに割り当てられたウェイト値の合計を返します。

最も高いコンバージョン値が 0 の場合、または結び付けられたコンバージョンがない場合は 0 を返します。
Google アナリティクス 360

has_ga_goal(GA ビュー ID, GA 目標 ID)

ブール値

特定のインプレッションに結び付けられた、GA ビュー ID の下の GA 目標 ID を持つ目標が少なくとも 1 つある場合、true を返します。それ以外の場合は、false を返します。

ga_goals_count(GA ビュー ID, GA 目標 ID)

整数

特定のインプレッションに結び付けられた、GA 目標 ID と GA ビュー ID に関連付けられている目標の数を返します。

ga_goals_max_value(GA ビュー ID, GA 目標 ID)

整数

具体的なインプレッションに結び付けられた、GA 目標 ID と GA ビュー ID に関連付けられている値の最大値を返します。

この値は、記録された目標の値の実際の合計を参照する場合か、そのような目標が結び付けられていない場合は、0 になります。

ga_goals_total_value(GA ビュー ID, GA 目標 ID)

整数

特定のインプレッションに結び付けられた、GA 目標 ID と GA ビュー ID に関連付けられている値の合計を返します。

この値は、記録された目標の値の実際の合計を参照する場合か、そのような目標が結び付けられていない場合は、0 になります。

制限事項

以下はカスタム入札スクリプトではサポートされていません。

  • 名前付き引数を渡す（例: 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 演算子

この情報は役に立ちましたか？

改善できる点がありましたらお聞かせください。

さらにサポートが必要な場合

次の手順をお試しください。

お問い合わせ 詳しい情報をお知らせください。解決に向けてサポートいたします
true
2024 年プライバシー準備ガイド

サードパーティ Cookie のない時代に備え、持続性のある
適切なオーディエンスと測定ソリューションを採用して、
AI の可能性を引き出しましょう。
今すぐ始める

検索
検索をクリア
検索を終了
メインメニュー
337497742330231564
true
ヘルプセンターを検索
true
true
true
true
true
69621
false
false