通知

歡迎使用 Search Ads 360 說明中心，這是管理搜尋行銷廣告活動的專屬平台。 本說明中心開放大眾使用，但只有已登入帳戶的訂閱客戶能夠存取 Search Ads 360 產品。如要訂閱或瞭解詳情，請與我們的銷售小組聯絡。

使用 Google 代碼進行 Floodlight 轉換追蹤

Google 代碼和事件程式碼片段的技術細節

Google 代碼可簡化將代碼導入 Google 網站評估、轉換追蹤和再行銷產品的程序。Google 代碼必須包含兩種程式碼片段，才能記錄 Floodlight 轉換：一種是全域程式碼片段 (放置在網站的所有網頁中)，第二種是 Floodlight 事件程式碼片段 (放置在轉換網頁中)。

建立 Floodlight 活動時，Search Ads 360 會自動產生全域程式碼片段和事件程式碼片段。本文將說明 Search Ads 360 產生的程式碼片段中的欄位。

注意：如果您透過 Campaign Manager 360 建立 Floodlight 活動，可能會看到額外的欄位或不同的值。

全域程式碼片段

Accelerated Mobile Pages 需要使用的代碼有別於電腦版和傳統行動版網頁。因此，在實際部署代碼之前，請先判斷您應為網頁設定何種代碼。

非 Accelerated Mobile Pages 類型的網頁

以下是非 Accelerated Mobile Pages 類型網頁的全域程式碼片段例子。請將這個程式碼片段加到網站上所有網頁的 和 代碼之間。

<!-- 
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-1234567"></script>
<script>
 window.dataLayer = window.dataLayer || [];
 function gtag(){dataLayer.push(arguments)};
 gtag('js', new Date());

 gtag('config', 'DC-1234567');
</script>
<!-- End of global snippet: Please do not remove -->

以下詳細說明全域程式碼片段中的主要欄位：

  • src="https://www.googletagmanager.com/gtag/js?id=DCM_FLOODLIGHT_CONFIG_ID"
    這個欄位會顯示產生代碼的原始帳戶 ID。當您透過 Search Ads 360 或 Campaign Manager 360 產生代碼時，這就是 Floodlight 設定 ID。

  • gtag('config', 'DCM_FLOODLIGHT_CONFIG_ID');
    config 指令會指出與代碼相關聯的 Floodlight 設定。如何在 Search Ads 360 中找到這個 ID：

    1. 在左側導覽窗格中，按一下「廣告客戶設定」。
    2. 在「廣告客戶設定」分頁中，「Campaign Manager 360 Floodlight ID」欄位會顯示 Floodlight ID。

    如果您已在多組 Floodlight 設定或多項 Google 產品中使用 Google 代碼，您的網站即已具備內含 config 指令的全域程式碼片段。在此情況下，只要將這個廣告客戶的 config 指令加到網站所有網頁的現有全域程式碼片段中即可。進一步瞭解如何使用 Google 代碼進行 Floodlight 轉換追蹤。

您不得以動態方式將資料傳入全域程式碼片段中的欄位。一旦安裝到您的網站，且內含正確的帳戶 ID，即算是完整的全域程式碼片段。

Accelerated Mobile Pages

以下是 Accelerated Mobile Pages 的全域程式碼片段例子。請將這個程式碼片段加到網站上所有網頁的 和 代碼之間。

 

<!-- Google tag (gtag) -->
<amp-analytics type="gtag" data-credentials="include">
<script type="application/json">
{
 "configRewriter": {
   "varGroups": {
     "dns": {"enabled": true}
  }
 },
 "vars": {
   "gtag_id": "DC-1234567",
   "config": {
     "DC-1234567": {
       "groups": "default",
       "dc_natural_search": {
        "exclusion_parameters": [
          "^foo[_]bar=qux$",
          "^yes=no^"
        ],
        "engines": {
          "aol": "1;2;a",
          "ask": "3;4;b",
          "google": "5;6;c",
          "msn": "7;8;d",
          "yahoo": "9;0;e",
          "yahoo_japan": "11;12;f"
        }
       }
     }
   }
 },
 "triggers": {
 }
}
</script>
</amp-analytics>

以下詳細說明 Google 代碼中的主要欄位：

  • configRewriter
    這個欄位會指出網頁是否已設為針對隨機搜尋結果製作報表。
  • dc_natural_search
    這個欄位包含排除參數以及要指定的引擎清單。

您不得以動態方式將資料傳入 Google 代碼中的欄位。一旦安插到網站，且內含正確的帳戶 ID，即算是完整的 Google 代碼。

事件程式碼片段

以下是 Search Ads 360 為某個交易活動產生的事件程式碼片段範例。您必須將事件程式碼片段放置於內含待追蹤事件的網頁上。事件程式碼片段可放在網頁中全域程式碼片段之後的任何位置，但建議您放在 區段內，提升追蹤的準確率。

您必須運用系統所記錄的轉換資料，以動態方式設定部分欄位的值。在下方範例中，動態值的預留位置會顯示在方括號中，如下所示：[Revenue]。

<!--
Event snippet for Thank You on http://www.example.com/thanks: Please do not remove.
Place this snippet on pages with events you’re tracking. 
Creation date: 11/01/2017
-->
<script>
 gtag('event', 'purchase', {
   'allow_custom_scripts': true,
   'value': '[Revenue]',
   'transaction_id': '[Order ID]',
   'send_to': 'DC-1234567/group1/thank123+transactions',
   'u1': '[Custom Floodlight variable]'
 });
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=1234567;type=group1;cat=thank123;
qty=1;cost=[Revenue];dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;npa=;
ord=[Order ID]?" width="1" height="1" alt="">
</noscript>
<!-- End of event snippet: Please do not remove -->

以下詳細說明事件程式碼片段中的主要欄位：

  • 'allow_custom_scripts' : true
    啟用 Floodlight 動態代碼。在 Search Ads 360 中建立的所有活動都會產生動態代碼，而且這個欄位必須設為 true，動態代碼才能順利運作。
  • 'value': '[Revenue]'
    僅適用於交易事件程式碼片段。轉換所產生的收益金額 (亦即該次銷售活動中交易商品的購買金額)。在多數情況下，最適合輸入的值是產生的收益，而非總購物金額，因為後者可能包含銷售稅、加值稅、運費或其他費用。

    您必須指定不含逗號或貨幣符號的數字，但可視需要使用小數點 (.)。

  • 'transaction_id': '[Order ID]'
    僅適用於交易事件程式碼片段。這是您以動態方式為每筆交易產生的唯一識別碼。訂單 ID 必須是大於零的數字。

    報表製作工具中的轉換路徑 (P2C) 報表會提供訂單 ID。

  • ​'send_to' : 'DC-[floodlightConfigID]/[activityGroupTagString]/[activityTagString]+[countingMethod]'
    指出與此代碼相關聯的 Floodlight 活動以及計數方式。

    • [floodlightConfigID]：指出與事件程式碼片段相關聯的 Floodlight 設定。這個值與全域程式碼片段的 'config' 指令中所顯示的值相同。

    • [activityGroupTagString]/[activityTagString]：指出相關活動和活動群組。Search Ads 360 會在您建立活動和活動群組時產生這些字串。如何在 Search Ads 360 中查看這些字串：

      1. 在左側導覽窗格中，按一下「廣告客戶設定」。
      2. 按一下 [Floodlight▼] 分頁標籤並選取 [Floodlight 活動]。
      3. 報表表格會包含「活動代碼字串」欄和「Floodlight 活動群組代碼字串」欄。
        在列出 Floodlight 活動的表格列中，這些欄的值會與該活動的事件程式碼片段中 send_to 指令所提供的值相符。

    • [countingMethod]：指定活動計算轉換的方式。透過 Search Ads 360 產生的事件程式碼片段必須指定下列其中一種計數方式：

      在 Campaign Manager 360 中產生的事件程式碼片段可能會指定其他計數方式。

      • Standard 會計算每位使用者完成的所有轉換。這是在 Search Ads 360 中產生的操作型活動專用的計數方式。
      • Transactions 會計算交易進行次數，以及每筆交易的金額。舉例來說，假設某位使用者前往您的網站買了五本書，一共 NT$3,300 元，系統會記錄一次轉換事件及這筆消費金額。這種計數方式適用於在 Search Ads 360 中產生的交易型活動。
    • 'u1': '[Custom Floodlight variable]'
      Floodlight 自訂變數可接受任何您選擇傳送的值。您可以在 Search Ads 360 中使用這些值做為指標、維度和區隔。請勿傳遞任何 Search Ads 360 可用做或視為個人識別資訊的資料。

事件程式碼片段中的自訂欄位

您可使用 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 保持同步以進行離線轉換歸因。

  • 比對 ID 長度上限為 50 個字元，且會區分大小寫。
  • 比對 ID 只能包含英文字母、數字、底線、連字號和句號。
 

含有 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 -->

事件程式碼片段的 區段

Search Ads 360 產生的事件程式碼均包括一個內含 Floodlight 圖片代碼的選用 <noscript> 代碼。系統會使用這個代碼，回報在不支援 JavaScript 的瀏覽器中所發生的轉換。 如果您使用 Floodlight iframe 或圖片代碼，建議改用 Google 代碼或搭配轉換連接器使用 Google 代碼管理工具，這樣除了能更準確評估轉換，還能在最新的動態功能和整合功能推出時立即採用。

網站開發人員專用的詳細資訊

如要進一步瞭解如何在網站中加入 Google 代碼 (gtag)，請參閱《gtag.js 開發人員指南》。

這對您有幫助嗎？

我們應如何改進呢？
true
搜尋
清除搜尋內容
關閉搜尋
主選單
14809151172960721770
true
搜尋說明中心
true
true
true
true
true
263
false
false