為確保 Campaign Manager 360 能夠有效評估轉換,建議您使用 Google 代碼 (gtag.js) 做為 Floodlight 活動代碼格式。進一步瞭解 Google 代碼,以及如何設定 Google 代碼。
不支援的環境
- Google 代碼不適用於行動應用程式。進一步瞭解搭配應用程式使用 Floodlight 的選項。
- Campaign Manager 360 不支援 Accelerated Mobile Pages (AMP)。您應繼續按照現有程序在 AMP 上使用 Floodlight。
- 在不支援 JavaScript 的瀏覽器中,Google 代碼不會觸發。如果瀏覽器不支援 JavaScript,系統會載入代碼的
區段,詳情請參閱下文。
將資料傳送到 Google 代碼中的欄位
全域程式碼片段中的欄位
全域程式碼片段會載入 Google 代碼的追蹤程式庫,並設定代碼傳送資料的來源帳戶。
讓我們進一步瞭解全域程式碼片段中的部分主要欄位:
-
src="https://www.googletagmanager.com/gtag/js?id=DC-[floodlightConfigID]"
這個部分會顯示產生代碼的原始帳戶 ID。如果您透過 Campaign Manager 360 產生代碼,這就是 Floodlight 設定 ID。 -
gtag('config', 'DC-[floodlightConfigID]')
config
指令會顯示與 Google 代碼相關聯的特定帳戶。如果您透過 Campaign Manager 360 產生代碼,這就是 Floodlight 設定 ID。
如果您在多項 Floodlight 設定或 Google 產品中使用 Google 代碼,可能會看到多個 config
指令,以及 src=
字串中的多個不同 ID,詳情請參閱下文。
您不得以動態方式傳送資料到全域程式碼片段中的欄位。一旦安裝到您的網站,且內含正確的帳戶 ID,即算是完整的全域程式碼片段。
事件程式碼片段中的欄位:總覽
事件程式碼片段是專為每個 Floodlight 活動及該活動所追蹤的對應事件而設。部分欄位是由所有事件程式碼片段共用,但其他欄位則視與代碼相關聯的 Floodlight 活動設定而定。
您必須以動態方式傳送資料到事件程式碼片段中的欄位。以下簡要說明事件程式碼片段中的主要欄位,以及這些欄位適用的代碼類型。如要進一步瞭解每個欄位,請參閱以下章節。
欄位名稱 | 值的格式 | 代碼類型與計數方式 | 總覽 |
---|---|---|---|
allow_custom_scripts |
布林值 | 全部 | 啟用動態代碼。 |
u1 、u2 等 |
字串 | 全部 | 表示自訂 Floodlight 變數。 |
send_to |
字串 | 全部 | 對應 Floodlight 設定、活動群組、活動代碼和計數方法的路由 ID。 |
session_id |
字串 | 計數器:單次工作階段 | 設定各工作階段的專屬 ID。 |
value |
數字 | 所有銷售 | 傳送交易產生的收益。 |
transaction_id |
數字 | 所有銷售 | 設定交易的專屬 ID。 |
quantity |
數字 | 銷售:已售商品 | 列出交易期間售出的商品數量。 |
所有事件程式碼片段中的欄位
下列欄位會顯示在 Campaign Manager 360 產生的所有事件程式碼片段中:
-
'allow_custom_scripts': true
這個欄位會啟用 Floodlight 動態代碼,讓您可整合第三方工具與代碼。此欄位必須設為true
,動態代碼才能順利運作。我們建議您在初次建立 Floodlight 活動時,利用活動的設定來啟用動態代碼。不過,這個欄位的值會覆寫 Campaign Manager 360 中相關聯 Floodlight 活動的動態代碼設定。如果您不想讓事件程式碼片段支援動態代碼,請將此欄位設為false
,或者將它從事件程式碼片段中整個移除。 -
'send_to': 'DC-[floodlightConfigID]/[activityGroupTagString]/[activityTagString]+[countingMethod]'
send_to
欄位包含 Floodlight 設定、活動群組、活動代碼和計數方法的路由 ID。-
DC-[floodlightConfigID]
這個欄位會指出與代碼相關聯的 Floodlight 設定。在 iframe 和圖片代碼中所對應的是src=
參數。 -
[activityGroupTagString]
這個欄位會指出與代碼相關聯的 Floodlight 活動群組。您可以自行設定此欄位的值,也可以使用預設值。預設值包含活動群組名稱的前 5 個字母,以及 3 個隨選英數字元、底線和連字號所構成的字串 (如果活動名稱的長度不到 5 個字元,英數字元前會加上其他字母,補足 8 個字元)。這個值會區分大小寫。在 iframe 和圖片代碼中所對應的是type=
參數。 -
[activityTagString]
這個欄位會指出與代碼相關聯的 Floodlight 活動。您可以自行設定此欄位的值,也可以使用預設值。預設值包含活動名稱的前 5 個字母,以及 3 個隨機英數字元、底線和連字號所構成的字串 (如果活動名稱的長度不到 5 個字元,系統會在英數字元前加上其他字母,補足 8 個字元)。這個值會區分大小寫。在 iframe 和圖片代碼中所對應的是cat=
參數。
-
-
'u1': '[variable]'
Floodlight 自訂變數可接受任何您選擇傳送的值。您可以利用這些值來建立目標對象名單。您不得向 Google Marketing Platform 傳送任何 Google Marketing Platform 可用作或視為個人識別資訊的資料。瞭解詳情
事件程式碼片段中適用於計數器代碼的欄位
計數器代碼的用途是計算與事件相關的轉換次數。計數器代碼會按照您的活動設定方式來計算所有轉換事件,或針對計數方式設限,讓系統在每日或每個使用者工作階段中,只為每位使用者計入一次轉換。以下是計數器代碼專用的欄位:
-
'session_id': '[SessionID]'
如果您搭配單次工作階段計數方法使用計數器代碼,可利用這個欄位插入不重複工作階段 ID。工作階段 ID 會指示 Campaign Manager 360 將您網站上的每個工作階段只計為一個事件。至於工作階段的定義,則完全由您決定。舉例來說,您可以將使用者登入您的網站時視為工作階段開始,然後將工作階段逾時視為工作階段結束。在 iframe 和圖片代碼中所對應的是ord=
參數。
計數器:標準活動的事件程式碼片段範例
<!--
Event snippet for Activity Name on http://foo.com: Please do not remove.
Place this snippet on pages with events you’re tracking.
Creation date: 10/30/2017
-->
<script>
gtag('event', 'conversion', {
'allow_custom_scripts': true,
'send_to': 'DC-[floodlightConfigID]/[activityGroupTagString]/[activityTagString]+standard'
});
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=[floodlightConfigID];type=[activityGroupTagString];cat=[activityTagString];ord=1?" width="1" height="1" alt=""/>
</noscript>
<!-- End of event snippet: Please do not remove -->
計數器:不重複活動的事件程式碼片段範例
<!--
Event snippet for Activity Name on http://foo.com: Please do not remove.
Place this snippet on pages with events you’re tracking.
Creation date: 10/30/2017
-->
<script>
gtag('event', 'conversion', {
'allow_custom_scripts': true,
'send_to': 'DC-[floodlightConfigID]/[activityGroupTagString]/[activityTagString]+unique'
});
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=[floodlightConfigID];type=[activityGroupTagString];cat=[activityTagString];ord=1;num=1?" width="1" height="1" alt=""/>
</noscript>
<!-- End of event snippet: Please do not remove -->
計數器:單次工作階段活動的事件程式碼片段範例
<!--
Event snippet for Activity Name on http://foo.com: Please do not remove.
Place this snippet on pages with events you’re tracking.
Creation date: 10/30/2017
-->
<script>
gtag('event', 'conversion', {
'allow_custom_scripts': true,
'session_id': '[SessionID]',
'send_to': 'DC-[floodlightConfigID]/[activityGroupTagString]/[activityTagString]+per_session'
});
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=[floodlightConfigID];type=[activityGroupTagString];cat=[activityTagString];ord=[SessionID]" width="1" height="1" alt=""/>
</noscript>
<!-- End of event snippet: Please do not remove -->
事件程式碼片段中適用於銷售代碼的欄位
銷售代碼通常會放在銷售活動的確認網頁中,並提供要傳送到代碼的銷售活動相關資訊。以下是數個銷售代碼專用的欄位:
-
'value': '[Revenue]'
您可利用這個欄位傳送交易所產生的收益 (亦即該次銷售活動中交易商品的購買金額)。最適合輸入的值通常是產生的收益而非總購物金額,因為後者可能包含銷售稅、加值稅或運費。這個欄位可接受不含逗號或貨幣符號的數值,但您可視需要使用小數點 (.)。在 iframe 和圖片代碼中所對應的是cost=
參數。 -
'transaction_id': '[OrderID]'
您可利用這個欄位為每筆交易插入一個專屬數字 ID。訂單 ID 會列在轉換路徑 (P2C) 報表中。在 iframe 和圖片代碼中所對應的是ord=
參數。 -
'quantity': '[Quantity]'
您可利用這個欄位傳送交易期間售出的商品數量:如果您將每筆交易計為一次轉換,這個值就是 1。
如果您將單筆交易的每個售出商品都計為一次轉換,請插入每筆交易期間所售商品的數量當做此欄位的值。
這個值必須為大於零的整數。Campaign Manager 360 會將這個值乘以轉換事件數,得出銷售代碼的轉換次數。如果其值為零,或者此欄位包含非數字的值,代表系統將不會計算任何轉換。
銷售:交易活動的事件程式碼片段範例
<!--
Event snippet for Activity Name on http://foo.com: Please do not remove.
Place this snippet on pages with events you’re tracking.
Creation date: 10/30/2017
-->
<script>
gtag('event', 'purchase', {
'allow_custom_scripts': true,
'value': '[Revenue]',
'transaction_id': '[OrderID]',
'send_to': 'DC-[floodlightConfigID]/[activityGroupTagString]/[activityTagString]+transactions'
});
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=[floodlightConfigID];type=[activityGroupTagString];cat=[activityTagString];qty=1;cost=[Revenue];dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;ord=[OrderID]" width="1" height="1" alt=""/>
</noscript>
<!-- End of event snippet: Please do not remove -->
銷售:已售商品活動的事件程式碼片段範例
<!--
Event snippet for Activity Name on http://foo.com: Please do not remove.
Place this snippet on pages with events you’re tracking.
Creation date: 10/30/2017
-->
<script>
gtag('event', 'purchase', {
'allow_custom_scripts': true,
'value': '[Revenue]',
'transaction_id': '[OrderID]',
'quantity': '[Quantity]',
'send_to': 'DC-[floodlightConfigID]/[activityGroupTagString]/[activityTagString]+items_sold'
});
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=[floodlightConfigID];type=[activityGroupTagString];cat=[activityTagString];qty=[Quantity];cost=[Revenue];dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;ord=[OrderID]?" width="1" height="1" alt=""/>
</noscript>
<!-- End of event snippet: Please do not remove -->
強化轉換功能事件程式碼片段中的欄位
強化轉換功能可輔助現有的轉換代碼,以保護隱私權的做法,傳送網站上經雜湊處理的第一方轉換資料。進一步瞭解如何開啟強化轉換功能。
user_data
變數僅適用於開啟了強化轉換功能的事件程式碼片段。
‘user_data’: {
‘email’: ‘[Email]’
‘phone_number’: [PhoneNumber]’,
‘address’: {
‘first_name’: ‘[FirstName]’,
‘last_name’: ‘[LastName]’ ,
‘street’: {Street]’,
‘city’: ‘[City]’,
‘region’: ‘[Region]’,
‘postal_code’: ‘[PostalCode]’,
‘country’: ‘[Country]’
}
您可在網頁上利用這個欄位,傳送使用者的電子郵件地址、電話號碼和地址。
您可使用 dc_custom_params
欄位,在事件程式碼片段中插入自訂資料。
這個欄位可接受任何您想傳送到 Google Marketing Platform 的值。您不得向 Google Marketing Platform 傳遞任何 Google Marketing Platform 可用作或視為個人識別資訊的資料。以下列出幾個可搭配 dc_custom_params
欄位使用的常用欄位:
欄位名稱 | 值的格式 | 計數方式 | 說明 |
---|---|---|---|
ord |
數字 | 全部 | 全域網站代碼會自動替您處理快取清除。如果您選擇覆寫這個值並手動控制快取清除,可以使用 ord 欄位。請根據代碼類型和計數方式加上 ord 欄位的值,方法與您對 iframe 代碼的處理方式相同。 |
num |
數字 | 計數器:不重複 | 全域網站代碼會自動替您處理快取清除。如果您選擇覆寫這個值並手動控制快取清除,可以使用 num 欄位。請加上 num 欄位的值,方法與您對 iframe 代碼的處理方式相同。 |
dc_lat |
0 或 1 | 全部 | 這個欄位適用於行動裝置上的代碼,接受的值為 0 或 1。如果這個值為 1,表示使用者已啟用 IDFA 或 AdID 的「限制廣告追蹤」選項,藉此停用按照興趣顯示的廣告和再行銷功能;如果這個值為 0,則表示「限制廣告追蹤」處於停用狀態。如果缺少或未填入這個值,系統會按照預設在這個欄位填入 0。 |
tag_for_child_directed_treatment |
0 或 1 | 全部 | 這個欄位適用於行動裝置上的代碼,接受的值為 0 或 1。如果這個值為 1,表示這項特定要求可能是由未滿 13 歲的使用者發出 (遵守 COPPA 規定)。 |
tfua |
0 或 1 | 全部 | 接受的值為 0 或 1。如果這個值為 1,表示這項特定要求可能是由未滿 16 歲的使用者 (具體年齡依國家/地區而異) 發出 (遵循歐盟地區的《一般資料保護規則》(GDPR) 或其他規定)。 |
npa |
0 或 1 | 全部 | 接受的值為 0 或 1。如果這個值為 1,表示這項特定要求可能是由希望選擇停用再行銷的使用者發出。如果缺少或未填入這個值,系統會按照預設在這個欄位填入 0。 |
match_id |
字串 | 全部 |
由廣告客戶建立的不重複 ID (經由 Floodlight 傳遞),可與 Google 保持同步以進行離線轉換歸因。
|
含有 dc_custom_params
欄位的事件程式碼片段範例
<!--
Event snippet for Activity Name on http://foo.com: Please do not remove.
Place this snippet on pages with events you’re tracking.
Creation date: 10/30/2017
-->
<script>
gtag('event', 'purchase', {
'allow_custom_scripts': true,
'value': '[Revenue]',
'transaction_id': '[OrderID]',
'send_to': 'DC-[floodlightConfigID]/[activityGroupTagString]/[activityTagString]+[countingMethod]',
'dc_custom_params': {
'ord': '1',
'num': '1234',
'dc_lat': '1',
'tag_for_child_directed_treatment': '0',
'tfua': '1',
'npa': '1',
'match_id':[your_match_id],
}
});
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=[floodlightConfigID];type=[activityGroupTagString];cat=[activityTagString];qty=1;cost=[Revenue];dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;npa=;ord=[OrderID]?" width="1" height="1" alt=""/>
</noscript>
<!-- End of event snippet: Please do not remove -->
事件程式碼片段的
區段
所有事件程式碼片段都包含 區段。如果 Google 代碼的主要區段因瀏覽器不支援 JavaScript 而無法使用,系統就會改用這個區段。在此情況下,系統會改用圖片代碼。
請務必以處理圖片代碼相同的方式填入 區段中的參數。這些參數的值必須與代碼