為確保 Campaign Manager 360 能夠有效評估轉換,建議您針對 Floodlight 活動代碼採用全域網站代碼 (gtag.js) 格式。
關於全域網站代碼
Google 代碼是適用於整個網站的網路代碼庫,支援 Google 網站和各項轉換評估產品,更方便您管理和導入。
- 輕鬆快速地與其他 Google 產品整合:Google 代碼不僅適用於 Google Marketing Platform 廣告產品 (Display & Video 360、Search Ads 360 和 Campaign Manager 360),還可供其他 Google 產品使用,例如 Google Ads 和 Google Analytics (分析)。使用這些產品時,Google 代碼的標記方式並無不同,因此在導入方面也就更簡單。
- 轉換追蹤更準確:使用 Google 代碼時,系統會在您的網域內設定新的 Cookie,藉此確保 Google Marketing Platform 可以更準確地評估轉換。如果您目前使用 iframe 或圖片代碼,而不是 Google 代碼,Google Marketing Platform 就無法監控所有轉換。
不支援的環境
- 全域網站代碼並非針對行動應用程式內的運作所設計。進一步瞭解搭配應用程式使用 Floodlight 的選項。
- Campaign Manager 360 不支援 Accelerated Mobile Pages (AMP)。您應繼續按照現有程序在 AMP 上使用 Floodlight。
- 在不支援 JavaScript 的瀏覽器中,不會觸發全域網站代碼。如果瀏覽器不支援 JavaScript,則會載入代碼所提供的
區段。詳情請參閱下文。
全域網站代碼所設定的 Cookie
使用 Floodlight 活動的 Google 代碼時,代碼會在您的網域設定新的 Cookie,並透過 Cookie 儲存使用者的專屬 ID 或將使用者導向您網站的廣告點擊。
- Search Ads 360:將使用者重新導向至您的網站前,Search Ads 360 會在到達網頁網址中加入 GCLID (「Google 點擊 ID」) 參數,而 Cookie 可從該參數中取得廣告點擊資訊。
- Display & Video 360 和 Campaign Manager 360:將使用者重新導向至您的網站前,Display & Video 360 和 Campaign Manager 360 會在到達網頁網址中加入 DCLID (「DoubleClick 點擊 ID」) 參數,而 Cookie 可從該參數中取得廣告點擊資訊。
如果您不希望 Google 代碼在網站網域上設定第一方 Cookie,請將下方標明的部分加到全域程式碼片段的 config
指令中:
gtag('config', 'DC-1234567', {'conversion_linker': false});
我們不建議您停用,原因是這麼做會導致轉換評估準確度降低。
由於 Google 代碼會在網域內設定新 Cookie,並使用該 Cookie 收集到的資訊,請務必提供清楚詳盡的資訊,讓使用者瞭解相關資料收集活動,並依法取得使用者同意。
全域網站代碼收集的再行銷資料
完成標準再行銷或動態再行銷的 Google Ads 代碼設定後,您即可將 Google 代碼和選用的事件程式碼片段部署至整個網站,追蹤特定的再行銷事件。
您可以利用 allow_ad_personalization_signals 參數,為不想看到個人化廣告的使用者停用再行銷資料的收集行為。這項參數可讓您停止將資料用於個人化廣告,而該參數的預設值是 True;一旦您將值改設為 false,這些資料就不會用來放送個人化廣告。
如果不希望 Google 代碼收集再行銷資料,請將下方醒目提示的 gtag('set') 指令新增至 Google 代碼 gtag('js') 指令的上方:
<!--
Start of global snippet: Please do not remove
Place this snippet between the <head> and </head> tags on every page of your site.
-->
<!-- Google tag (gtag.js) - DoubleClick -->
<script async src="https://www.googletagmanager.com/gtag/js?id=DC-[floodlightConfigID]"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('set', 'allow_ad_personalization_signals', false);
gtag('js', new Date());
gtag('config', 'DC-[floodlightConfigID]');
</script>
<!-- End of global snippet: Please do not remove -->
導入 Google 代碼
Google 代碼是由「全域程式碼片段」和「事件程式碼片段」這兩種 JavaScript 程式碼片段組成。請在網站的所有網頁上,將 Google 代碼插入 與
標記之間。您必須將全域程式碼片段放置於所有網頁,並將事件程式碼片段另外放置於包含所追蹤事件的網頁。網站管理員必須將值傳送到 Google 代碼中的特定欄位。
步驟 1:將全域程式碼片段加到網站的所有網頁中
您必須在網站的所有網頁上,將全域程式碼片段放置於 與
代碼之間。在網站的所有網頁上安裝全域程式碼片段之後,就不必再次新增全域程式碼片段。如果您已經安裝其他 Google 產品或 Floodlight 設定的全域程式碼片段,請按照下列指示修改多項產品的全域程式碼片段。
以下提供全域程式碼片段的範例:
<!--
Start of global snippet: Please do not remove
Place this snippet between the <head> and </head> tags on every page of your site.
-->
<!-- Google tag (gtag.js) - DoubleClick -->
<script async src="https://www.googletagmanager.com/gtag/js?id=DC-[floodlightConfigID]"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', 'DC-[floodlightConfigID]');
</script>
<!-- End of global snippet: Please do not remove -->
步驟 2:將事件程式碼片段加到內含所追蹤事件的網頁中
您必須將事件程式碼片段加到內含您所追蹤事件的網頁中。這樣可以追蹤轉換事件,或是將使用者加到目標對象名單中。事件程式碼片段可放在網頁中全域程式碼片段之後的任何位置,但建議您將其放在 區段內,以提升追蹤的準確率。
視代碼類型、計算方法以及傳送到代碼的其他資料而定,事件程式碼片段中的欄位會有所差異。如要進一步瞭解事件程式碼片段中的欄位,請參閱以下章節。
以下是事件程式碼片段的範例:
<!--
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,
'u1': '[variable]',
'send_to': 'DC-[floodlightConfigID]/[activityGroupTagString]/[activityTagString]+[countingMethod]'
});
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=[floodlightConfigID];type=[activityGroupTagString];cat=[activityTagString];dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;ord=1?" width="1" height="1" alt=""/>
</noscript>
<!-- End of event snippet: Please do not remove -->
將資料傳送到全域網站代碼中的欄位
全域程式碼片段中的欄位
全域程式碼片段會載入 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 -->
事件程式碼片段的
區段
所有事件程式碼片段都包含 區段。如果因瀏覽器不支援 JavaScript 而無法使用全域網站代碼的主要區段,系統就會改用這個區段。在此情況下,系統會改用圖片代碼。
請務必以處理圖片代碼相同的方式填入 區段中的參數。這些參數的值必須與代碼