カスタム Floodlight 変数は Floodlight コンバージョンに付加される URL パラメータで、Google マーケティング プラットフォームのプロパティを通して管理されます。カスタム Floodlight 変数を使用すると、通常のパラメータだけでは収集できない追加情報を捕捉可能です。広告主様がカスタム Floodlight 変数を使って受け渡しできる情報は多岐に渡りますが、Ads Data Hub に関係するのはマッチングに使用できるデータ（ユーザー ID、外部 Cookie、注文 ID など）だけです。
カスタム Floodlight 変数が配信されるのは、ユーザーがコンバージョンを達成したときだけである点に注意が必要です。このため、カスタム Floodlight 変数によるマッチングが役立つのは、広告に関する疑問を解決したい場合や、コンバージョンの発生に関係するオーディエンスを構築したい場合に限られます。使用ケースとしては、たとえば次のようなものが挙げられます。
- 「最近実施したキャンペーンが、目的の商品の業績を伸ばすのに貢献したかどうか確認したい」
- 「実施したキャンペーンによって得られた収益は？」
- 「高価値ユーザーを集めたオーディエンスを構築したい」
- 「自社のサービスと意味のある形で接触したユーザーを集めたオーディエンスを構築したい」
Ads Data Hub でカスタム Floodlight 変数にアクセスする方法
各カスタム Floodlight 変数は URL にまとめて追加され、adh.cm_dt_activities_attributed テーブルの event.other_data フィールドに文字列として格納されています。文字列から個々の変数を取り出すには、次の正規表現を使用します（「u1」は実際にマッチングに使用する変数に置き換えてください）。
REGEXP_EXTRACT(event.other_data, 'u1=([^;]*)') AS u1_val
サンプル
リーチと費用
指定されたキャンペーンのリーチと費用総額を測定するクエリです。
crm_data のスキーマは次のとおりです。
| フィールド | 説明 |
|---|---|
| order_id | 注文を一意に識別する ID。 |
| order_val | 注文の金額（浮動小数点数）。 |
| order_timestamp | 注文の完了と関連付けられたタイムスタンプ。 |
/* Creates a temporary table containing user IDs and order IDs (extracted u-values)
associated with a given campaign */
WITH floodlight AS (
SELECT user_id, event.campaign_id, REGEXP_EXTRACT(event.other_data, 'u1=([^;]*)') AS order_id
FROM adh.cm_dt_activities_attributed
WHERE event.other_data LIKE "%u1%" AND event.campaign_id = 31459
)
/* Creates a temporary table where each row contains an order ID, the order's value,
and the time the order was placed */
WITH crm_data AS (
SELECT order_id, order_val, order_timestamp
FROM `your_cloud_project.your_dataset.crm_data`
WHERE order_timestamp > FORMAT_TIMESTAMP('%F', TIMESTAMP_MICROS('2020-01-19 03:14:59'), @time_zone)
)
/* Joins both tables on order ID, counts the number of distinct users and sums the
value of all orders */
SELECT DISTINCT(user_id) AS reach, sum(order_val) as order_val
FROM floodlight JOIN crm_data
ON (floodlight.order_id = crm_data.order_id)
利用額が多くエンゲージメント歴がある顧客
2020 年 8 月の利用額が 1,000 ドル超、かつ過去に広告に対するエンゲージメントが発生している顧客のオーディエンスを構築するクエリです。
crm_data のスキーマは次のとおりです。
| フィールド | 説明 |
|---|---|
| your_id | 顧客を一意に識別する ID。 |
| customer_spend_aug_2020_usd | 該当顧客の 2020 年 8 月の累計利用額（浮動小数点数）。 |
/* Creates a temporary table containing IDs you track, alongside IDs Google tracks
for the same user */
WITH floodlight AS (
SELECT user_id, REGEXP_EXTRACT(event.other_data, 'u1=([^;]*)') AS your_id
FROM adh.cm_dt_activities_events
WHERE event.other_data LIKE "%u1%"
)
/* Creates a temporary table containing IDs you track for customers who spent over
$1000 in August 2020 */
WITH crm_data AS (
SELECT your_id
FROM `your_cloud_project.your_dataset.crm_data`
WHERE customer_spend_aug_2020_usd > 1000
)
/* Creates a list (to be used in audience creation) of customers who spent over
$1000 in August 2020 */
SELECT user_id
FROM floodlight
JOIN crm_data ON (floodlight.your_id = crm_data.your_id)
長距離利用またはステータスが「エリート」の乗客
過去に広告でコンバージョンを達成している顧客のうち、2019 年の飛行距離が 100,000 マイルを超えているか、2019 年中の航空会社の顧客ステータスが「エリート」だった顧客のオーディエンスを構築するクエリです。
airline_data のスキーマは次のとおりです。
| フィールド | 説明 |
|---|---|
| your_id | 顧客を一意に識別する ID。 |
| miles_flown_2019 | 顧客が 2019 年に飛行した合計マイル数（整数）。 |
| ye_2019_status | 顧客が 2019 年に獲得した航空会社の顧客ステータス。 |
/* Creates a temporary table containing IDs you track, alongside IDs Google
tracks for the same user */
WITH floodlight AS (
SELECT user_id, REGEXP_EXTRACT(event.other_data, 'u1=([^;]*)') AS your_id
FROM adh.cm_dt_activities_events
WHERE event.other_data LIKE "%u1%"
)
/* Creates a temporary table containing IDs you track for customers who either
flew over 100,000 miles with your airline in 2019, or earned elite status in
2019 */
WITH airline_data AS (
SELECT your_id
FROM `my_cloud_project.my_dataset.crm_data`
WHERE miles_flown_2019 > 100000 or ye_2019_status = "elite"
)
/* Creates a list (to be used in audience creation) of customers who previously
converted on an ad and either earned elite status, or flew over 100,000 miles
in 2019 */
SELECT user_id
FROM floodlight
JOIN airline_data ON (floodlight.your_id = airline_data.your_id)