Google Ads 使用者提供的資料事件

您可使用伺服器端代碼管理工具，將 Google Ads 使用者提供的資料事件代碼從網頁移至伺服器。將這些標記移到伺服器，不但能減少在網頁中執行的程式碼量，還能加快網頁載入速度。本文說明如何設定代碼管理工具網站容器和伺服器容器，以使用 Google Ads 使用者提供的資料事件代碼。

事前準備

這份文件假設您已具備以下條件：

• Google Ads 和 Google 代碼管理工具的管理員權限
• 設定 Google 代碼管理工具
• 已建立伺服器容器
• 設定 Google Analytics (分析)：GA4 用戶端

步驟 1：設定轉換連接器代碼

為了讓 Google Ads 傳送資料至代碼管理工具，您必須設定「轉換連接器」代碼。

如果您已在伺服器容器中設定轉換連接器代碼，可以略過這個步驟。

設定「轉換連接器」代碼的方式如下：

1. 在伺服器容器工作區中，開啟頁面左側的「Tag」選單。
2. 按一下「新增」加入新代碼。
3. 選取「轉換連接器」代碼類型。
4. 設定可讓「轉換連接器」伺服器端代碼觸發的觸發條件。
   在大多數情況下，「所有網頁」觸發條件是最合適的選項。
5. 為代碼命名，然後按一下「儲存」。

步驟 2：在伺服器容器中設定 Google Ads 使用者提供的資料事件代碼

如要設定 Google Ads 使用者提供的資料事件代碼，請按照下列步驟操作：

1. 在伺服器容器工作區中，開啟網頁左側的「Tag」選單。
2. 按一下「新增」加入新代碼。
3. 選取「Google Ads 使用者提供的資料事件」代碼類型。

4. 輸入必要的轉換資訊 (轉換 ID)。您可以在 Google Ads 帳戶中找到這些值。

5. 在「觸發條件」選單中，選取符合您用途的現有觸發條件。如果沒有任何現有的觸發條件涵蓋您的需求，請建立新的自訂觸發條件 。

   如要針對自訂事件觸發代碼，請按照下列步驟操作：

   1. 選擇「自訂事件」觸發條件。
   2. 輸入的事件名稱必須與「Google Analytics (分析)：GA4 事件」代碼中使用的名稱相符。

   如要只在特定網址觸發事件：

   1. 選取要觸發「部分自訂事件」的選項。
   2. 新增「網頁網址」變數，使其和代碼應觸發的網址相同，

6. 為代碼命名，然後按一下「儲存」。

步驟 3：設定使用者資料

代碼仰賴事件中可用的使用者資料，與強化轉換類似

設定使用者提供的資料變數

您可以透過下列 3 種方式在代碼管理工具中導入強化轉換。 您只需要選擇其中一個選項來收集使用者提供的資料。

	自動收集	手動設定	程式碼設定
收集方法	自動根據網站的程式碼收集使用者提供的資料。 如要控管輸入內容的收集位置，可選擇手動或程式碼設定。	指定特定 CSS 屬性或 JavaScript 變數，以收集使用者提供的資料。 如需控管資料格式和雜湊處理作業，請選擇程式碼設定。	在網站上加入程式碼片段，來傳送經雜湊處理的客戶資料以進行比對。 這個方法能讓您在每次轉換標記觸發時傳送一致的格式資料，盡可能提高強化轉換準確度。
複雜度	簡潔	中	複合式
技能	不需要特殊技能	HTML 和 CSS	網站開發

自動資料收集

1. 在網站容器中，開啟「變數」選單。
2. 新建類型為「使用者提供的資料」的「使用者定義變數」。
3. 將「類型」設為「自動收集」。
4. 為變數命名，例如 My user-defined data。
5. 點選「儲存」。

手動設定

1. 在網站容器中，開啟「變數」選單。
2. 新建類型為「使用者提供的資料」的「使用者定義變數」。
3. 將「類型」設為「手動設定」。

4. 針對您想透過強化轉換提供的相關使用者資料欄位，加入新的或現有的變數。

   注意： 如果資料層已設有變數 (無論是使用 CSS 選取器或其他變數類型)，您可以選取這些變數，不必建立新變數。如果無法確定，請繼續按照說明操作。變數可能會經過雜湊處理或未經雜湊處理。

5. 如要透過 DOM 指定元素，請建立「新增變數」>「變數設定」>「DOM 元素」。

6. 在「選取方式」下方，您可以使用 CSS 選取器或 ID。提示：如果您的 CSS 變數會經常變更，請在網站中加入 HTML ID 並使用 ID 變數。

7. 輸入 CSS 選取器或 ID 名稱。「Attribute name」欄位可留空。

8. 命名並儲存 DOM 元素變數。接著，畫面就會回到「使用者提供的資料」設定。

9. 將變數命名為「User-Provided Data」變數，例如 My user-defined data。

10. 點選「儲存」。

程式碼設定

步驟 1：識別並定義強化轉換變數

您可以傳送未經雜湊處理的資料 (Google 會在資料送達伺服器前進行雜湊處理)，或是預先雜湊處理的資料。如果您決定傳送預先經過雜湊處理的資料，請使用十六進位編碼 SHA256 對資料進行編碼。無論選擇哪一種做法，請至少提供以下其中一個欄位：email 或 phone_ number。
如何將「未經雜湊處理」的資料推送至資料層：

1. 在網站上，將使用者提供的資料以鍵/值組合的形式儲存在 JavaScript 變數中。例如：

   var leadsUserData = {
     'email': '[e-mail]',
     'phone_number': '[phone]',
     'address': {
       first_name: 'John',
       last_name: 'Doe',
       street: '123 Lemon',
       city: 'Some city',
       region: 'CA',
       country: 'US',
       postal_code: '12345',
     },
   };
   

2. 使用 dataLayer.push() 將使用者資料與事件一起傳送。例如：

   <script>
     dataLayer.push({
       'event': 'formSubmitted',
       'leadsUserData': {
         'email': '[e-mail]',
         'phone_number': '[phone]',
         'address': {
            first_name: 'John',
            last_name: 'Doe',
            street: '123 Lemon',
            city: 'Some city',
            region: 'CA',
            country: 'US',
           postal_code: '12345',
          },
        },
     });
   <script>
   

Google 代碼管理工具現已提供 leadsUserData 變數。

如要將預先雜湊處理資料推送至資料層，請按照下列步驟操作：

1. 在網站上，使用十六進位編碼 SHA256 對使用者提供的資料進行雜湊處理。編碼資料的金鑰必須以 sha256_ 開頭。例如：

   {'sha256_email_address':await hashEmail(email.trim()),
   }
   

2. 使用 dataLayer.push() 將使用者資料與事件一起傳送。以下範例顯示資料層實作，假設您自行編寫了雜湊函式，而該函式是以非同步方式執行。

   <script>
     dataLayer.push({
       'event': 'formSubmitted',
       'leadsUserData': {
         'sha256_email_address': await hashEmail(email.trim()),
         'sha256_phone_number': await hashPhoneNumber(phoneNumber),
         'address': {
           sha265_first_name: await hashString(firstname),
           sha256_last_name: await hashString(lastname),
           sha256_street: await hashString(streetAddress),
           postal_code: '12345',
          },
        },
     });
   <script>
   

Google 代碼管理工具現已提供 leadsUserData 變數。

步驟 2：建立使用者提供的資料變數

1. 在網站容器中，開啟「變數」選單。
2. 新建類型為「使用者提供的資料」的「使用者定義變數」。
3. 將「Type」設為「Code」。
4. 針對您要提供的相關使用者資料欄位，點選下拉式選單並選取「新增變數」。
5. 在「請選擇變數類型」下方，選取「資料層變數」。
6. 在「資料層變數」中，參照已儲存的使用者資料。例如 leadsUserData。
7. 為資料層變數命名並儲存。接著，畫面就會回到「使用者提供的資料」設定。
8. 將變數命名為「User-Provided Data」變數，例如 My user-defined data。
9. 點選「儲存」。

將變數指派給 Google 代碼

1. 在網站容器中，開啟「代碼」選單。
2. 編輯用來將資料傳送至標記伺服器的 Google 代碼。
3. 在「Configuration settings」下方，新增名為 user_data 的新設定參數。將「Value」設為「User-Provide Data」變數，例如 {{My user-provided data}}。

4. 點選「儲存」儲存變更。代碼應如下所示：

   

步驟 4：驗證設定

開始使用伺服器容器傳送資料後，您可以按照下列步驟檢查作業是否正常運作：

1. 開啟你的網站。
2. 在 Google 代碼管理工具伺服器容器中，選取「預覽」。 Tag Assistant 會啟動並載入伺服器容器。
3. 「代碼」分頁會顯示所有已觸發的代碼。 請務必確認您設定的代碼是否已觸發。
4. 「Console」分頁會顯示資料傳輸至伺服器容器期間發生的任何錯誤。檢查是否有錯誤並予以解決。

如需更多關於代碼管理工具容器的偵錯說明，請參閱預覽和偵錯說明。

後續步驟

Google Ads 使用者提供的資料事件代碼正常運作後，您可以移除網站容器中任何對等的 Google Ads 使用者提供的資料事件代碼，以免資料重複。