使用「轉換」功能控制代碼可用的事件參數

本文件旨在協助伺服器端標記控管哪些事件參數會提供給代碼。

伺服器端容器包含可接受傳入 HTTP 要求的用戶端。HTTP 要求中的資訊會轉譯為事件資料物件。您的伺服器端代碼會讀取事件資料物件。

什麼是轉型？

您可以利用轉換功能來納入、排除或修改來自用戶端的輸出參數，然後在這些標記公開給標記。透過轉換，您可以保護機密資訊，並精確控制可用於進一步處理的事件參數。

您可以運用轉換來建立規則：

• 僅允許與代碼明確共用事件參數。
• 建立規則來編輯或新增事件參數，藉此擴增事件參數。
• 從代碼中排除事件參數，藉此遮蓋傳入資訊。

您可以將轉換套用至所有代碼、整個代碼類型或個別選取的組合。 此外，您可以套用一組在執行轉換之前必須符合的條件。

每次執行轉換時，都會評估變數。視您的轉換用途而定，變數可能會解析為不同的值。

允許代碼使用事件參數

允許參數轉換可讓您指定要向標記公開的特定事件參數。系統會捨棄未明確定義的事件參數。

注意： 「允許參數」轉換會移除未明確指定的所有事件參數，甚至是 Google 代碼所需的值。建立此轉換前，請先檢查代碼使用的事件參數，請務必加入所有必要的事件參數。否則您的評估結果可能會受損。詳情請參閱事件資料參考資料和 Measurement Protocol 事件。

如要允許代碼使用特定事件參數，請按照下列步驟操作：

1. 在工作區中開啟 「轉換」選單。
2. 建立「新增」轉換規則。
3. 按一下「轉換設定」，然後選取「允許參數」。
4. 新增代碼可使用的事件參數。查看所有常見事件參數。
5. 選用：「Matching Conditions」(比對條件) 可讓您定義啟用轉換的時機。根據預設，轉換規則一律會套用。
6. 在「受影響的標記」中，選擇會回應這項轉換規則的標記類型或個別標記。根據預設，轉換會套用至所有標記。
7. 為轉換規則命名並儲存。

範例：將選取資訊記錄至 BigQuery 資料表

掌控所記錄的參數可讓您：

• 確保內部資料儲存庫不會記錄機密資訊。
• 避免過度記錄，藉此節省儲存空間和雲端費用。
• 儲存與監控和報表相關的指標。

教我怎麼做！

如要僅允許記錄特定參數，請按照下列步驟操作：

1. 建立「新增」轉換規則。
2. 按一下「轉換設定」，然後選取「允許參數」。
3. 在「要允許的參數」中，新增需要的參數，例如 event_name、page_hostname、page_path、client_id 等。
4. 在「受影響的代碼」中，選取會將資料傳送至資料倉儲的代碼。針對 BigQuery，您可以使用自訂標記中的 addEventCallback 和 BigQuery APIs，或探索社群範本庫，是否有預先建構的選項來監控伺服器容器。
5. 為轉換命名並儲存 Save。如下所示：

擴增事件參數

「擴增事件」轉換可讓您修改事件參數值，或是新增要提供給代碼使用的參數。

注意： 如果參數使用修改，標記可能無法正常運作。先查看代碼使用的參數，再擴增參數。

如要修改或新增特定事件參數，請按照下列步驟進行：

1. 在工作區中開啟 「轉換」選單。
2. 建立「新增」轉換規則。
3. 按一下「轉換設定」，然後選取「擴增事件」。

4. 在「擴展參數」中：

   • 如要修改現有事件參數，請在「Name」中輸入要修改的參數，然後新增新的值。查看所有常用事件參數。

   • 如要新增事件資料物件值，請輸入您選擇的「Name」(名稱) 和「Variable」(變數)。

5. 選用：「Matching Conditions」(比對條件) 可讓您定義啟用轉換的時機。根據預設，轉換規則一律會套用。

6. 在「受影響的標記」中，選擇會回應這項轉換規則的標記類型或個別標記。根據預設，轉換會套用至所有標記。

7. 為轉換規則命名並儲存。

範例：為購物事件設定以價值為準出價

以價值為準出價有助您改善廣告活動成效，將宣傳對象設為對商家價值更高的使用者。設定以價值為準出價後，Google Ads 就會根據轉換價值設定更有價值的出價。 擴增事件轉換適合用於在伺服器端設定以價值為準出價。

教我怎麼做！

只有在 Google Ads 轉換追蹤代碼未指定轉換價值時，才適用下列操作說明。

如要設定以價值為準出價：

1. 建立「新增」轉換規則。
2. 按一下「Transformation Configuration」，然後選取「Augment event」。
3. 在「擴增參數」中新增資料列。設定變數，將項目的金錢價值載入轉換：
   1. 在「名稱」參數中，輸入需要調整的值，例如 value。取代所有 value 欄位，因為這些欄位代表事件的金錢價值。
   2. 在「Value」參數中，設定從資料庫擷取價格的變數。舉例來說，如果您在 Firestore 中儲存產品資料，請新增 Firestore 查詢變數。
4. 在「相符條件」中，設定這個轉換僅適用於特定事件。如果只想針對購買事件套用以價值為準出價，請設定：{{Event Name}} 等於 purchase。
5. 在「受影響的代碼」中，加入所有要套用這項轉換的 Google Ads 轉換追蹤代碼。
6. 輸入代碼名稱並進行「儲存」。如下所示：

從代碼中排除事件參數

「排除參數」轉換可協助您從代碼中移除特定事件參數。

注意：排除需要的參數後，標記可能無法正常運作。在轉換參數前，請先查看代碼應使用哪些參數。

如要排除特定事件參數，請按照下列步驟操作：

1. 在工作區中開啟 「轉換」選單。
2. 建立「新增」轉換規則。
3. 按一下「轉換設定」，然後選取「排除參數」。
4. 新增代碼禁止使用的事件參數。查看所有常用事件參數。
5. 選用：「Matching Conditions」(比對條件) 可讓您定義啟用轉換的時機。根據預設，轉換規則一律會套用。
6. 在「受影響的標記」中，選擇會回應這項轉換規則的標記類型或個別標記。根據預設，轉換會套用至所有標記。
7. 為轉換規則命名並儲存。

範例：根據使用者同意聲明排除特定 GA4 自訂維度

「排除參數」可讓您掌控要傳送至 Google 的第一方資料。舉例來說，當使用者拒絕 analytics_storage Cookie 時，您可能需要移除所選的自訂維度。

教我怎麼做！

如要移除自訂維度，請按照下列步驟操作：

1. 建立「新增」轉換規則。
2. 按一下「轉換設定」，然後選取「排除參數」。
3. 在「要排除的參數」中，新增一個資料列，並設定您要排除的自訂維度，例如 payment_type、payment_status。
4. 在「Matching Conditions」(相符條件) 中，設定只有在使用者拒絕使用 analytics_storage Cookie 時才應執行轉換。
   下列條件如下：
   • G100 {{gcs}}等於
   • G110 {{gcs}}等於
5. 選用：在「受影響的代碼」中，新增要套用這項轉換的所有代碼。
6. 輸入代碼名稱並進行「儲存」。如下所示：

確認套用轉換規則

您可以預覽工作區，藉此驗證轉換規則：

1. 開啟網站。

2. 在 Google 代碼管理工具伺服器容器中，選取「預覽」。

   Tag Assistant 會啟動並載入伺服器容器。

3. 如要查看針對事件觸發的所有標記和動作，請從左側的清單中選取事件名稱。

確認已執行轉換：

1. 在要驗證的事件中，開啟「代碼」分頁。

2. 選取會觸發的標記，以便查看標記屬性、傳出 HTTP 要求、觸發觸發條件和轉換。

   注意：轉換只會影響觸發的標記。如果轉換會修改或移除必要的事件參數欄位，則轉換不會觸發。

3. 「代碼詳細資料」總覽會顯示代碼執行的轉換作業和順序。預設順序如下：

   1. 允許參數
   2. 擴增參數
   3. 排除參數
   提示： 您可以為轉換指定優先順序值，藉此變更預設順序。值越高，優先順序越高。

   

4. 如要查看轉換詳細資料，請按一下轉換作業。提供給代碼的事件參數則會顯示在「事件資料」區段下方。

   

5. 按一下「Event Data」方塊，即可在所有轉換作業執行後查看事件參數的狀態。如要查看原始和已轉換的事件參數，請勾選「Show Original」(顯示原始參數)。