本文件旨在協助伺服器端標記控管哪些事件參數會提供給代碼。
伺服器端容器包含可接受傳入 HTTP 要求的用戶端。HTTP 要求中的資訊會轉譯為事件資料物件。您的伺服器端代碼會讀取事件資料物件。
什麼是轉型?
您可以利用轉換功能來納入、排除或修改來自用戶端的輸出參數,然後在這些標記公開給標記。透過轉換,您可以保護機密資訊,並精確控制可用於進一步處理的事件參數。
您可以運用轉換來建立規則:
- 僅允許與代碼明確共用事件參數。
- 建立規則來編輯或新增事件參數,藉此擴增事件參數。
- 從代碼中排除事件參數,藉此遮蓋傳入資訊。
您可以將轉換套用至所有代碼、整個代碼類型或個別選取的組合。 此外,您可以套用一組在執行轉換之前必須符合的條件。
每次執行轉換時,都會評估變數。視您的轉換用途而定,變數可能會解析為不同的值。
允許代碼使用事件參數
允許參數轉換可讓您指定要向標記公開的特定事件參數。系統會捨棄未明確定義的事件參數。
如要允許代碼使用特定事件參數,請按照下列步驟操作:
- 在工作區中開啟 「轉換」選單。
- 建立「新增」轉換規則。
- 按一下「轉換設定」,然後選取「允許參數」。
- 新增代碼可使用的事件參數。查看所有常見事件參數。
- 選用:「Matching Conditions」(比對條件) 可讓您定義啟用轉換的時機。根據預設,轉換規則一律會套用。
- 在「受影響的標記」中,選擇會回應這項轉換規則的標記類型或個別標記。根據預設,轉換會套用至所有標記。
- 為轉換規則命名並儲存。
範例:將選取資訊記錄至 BigQuery 資料表
掌控所記錄的參數可讓您:
- 確保內部資料儲存庫不會記錄機密資訊。
- 避免過度記錄,藉此節省儲存空間和雲端費用。
- 儲存與監控和報表相關的指標。
教我怎麼做!
如要僅允許記錄特定參數,請按照下列步驟操作:
- 建立「新增」轉換規則。
- 按一下「轉換設定」,然後選取「允許參數」。
- 在「要允許的參數」中,新增需要的參數,例如
event_name
、page_hostname
、page_path
、client_id
等。 - 在「受影響的代碼」中,選取會將資料傳送至資料倉儲的代碼。針對 BigQuery,您可以使用自訂標記中的
addEventCallback
和BigQuery APIs
,或探索社群範本庫,是否有預先建構的選項來監控伺服器容器。 - 為轉換命名並儲存 Save。如下所示:
擴增事件參數
「擴增事件」轉換可讓您修改事件參數值,或是新增要提供給代碼使用的參數。
如要修改或新增特定事件參數,請按照下列步驟進行:
- 在工作區中開啟 「轉換」選單。
- 建立「新增」轉換規則。
- 按一下「轉換設定」,然後選取「擴增事件」。
在「擴展參數」中:
如要修改現有事件參數,請在「Name」中輸入要修改的參數,然後新增新的值。查看所有常用事件參數。
如要新增事件資料物件值,請輸入您選擇的「Name」(名稱) 和「Variable」(變數)。
選用:「Matching Conditions」(比對條件) 可讓您定義啟用轉換的時機。根據預設,轉換規則一律會套用。
在「受影響的標記」中,選擇會回應這項轉換規則的標記類型或個別標記。根據預設,轉換會套用至所有標記。
為轉換規則命名並儲存。
範例:為購物事件設定以價值為準出價
以價值為準出價有助您改善廣告活動成效,將宣傳對象設為對商家價值更高的使用者。設定以價值為準出價後,Google Ads 就會根據轉換價值設定更有價值的出價。 擴增事件轉換適合用於在伺服器端設定以價值為準出價。
教我怎麼做!
只有在 Google Ads 轉換追蹤代碼未指定轉換價值時,才適用下列操作說明。
如要設定以價值為準出價:
- 建立「新增」轉換規則。
- 按一下「Transformation Configuration」,然後選取「Augment event」。
- 在「擴增參數」中新增資料列。設定變數,將項目的金錢價值載入轉換:
- 在「名稱」參數中,輸入需要調整的值,例如
value
。取代所有value
欄位,因為這些欄位代表事件的金錢價值。 - 在「Value」參數中,設定從資料庫擷取價格的變數。舉例來說,如果您在 Firestore 中儲存產品資料,請新增 Firestore 查詢變數。
- 在「名稱」參數中,輸入需要調整的值,例如
- 在「相符條件」中,設定這個轉換僅適用於特定事件。如果只想針對購買事件套用以價值為準出價,請設定:
{{Event Name}}
等於purchase
。 - 在「受影響的代碼」中,加入所有要套用這項轉換的 Google Ads 轉換追蹤代碼。
- 輸入代碼名稱並進行「儲存」。如下所示:
從代碼中排除事件參數
「排除參數」轉換可協助您從代碼中移除特定事件參數。
注意:排除需要的參數後,標記可能無法正常運作。在轉換參數前,請先查看代碼應使用哪些參數。
如要排除特定事件參數,請按照下列步驟操作:
- 在工作區中開啟 「轉換」選單。
- 建立「新增」轉換規則。
- 按一下「轉換設定」,然後選取「排除參數」。
- 新增代碼禁止使用的事件參數。查看所有常用事件參數。
- 選用:「Matching Conditions」(比對條件) 可讓您定義啟用轉換的時機。根據預設,轉換規則一律會套用。
- 在「受影響的標記」中,選擇會回應這項轉換規則的標記類型或個別標記。根據預設,轉換會套用至所有標記。
- 為轉換規則命名並儲存。
範例:根據使用者同意聲明排除特定 GA4 自訂維度
「排除參數」可讓您掌控要傳送至 Google 的第一方資料。舉例來說,當使用者拒絕 analytics_storage
Cookie 時,您可能需要移除所選的自訂維度。
教我怎麼做!
如要移除自訂維度,請按照下列步驟操作:
- 建立「新增」轉換規則。
- 按一下「轉換設定」,然後選取「排除參數」。
- 在「要排除的參數」中,新增一個資料列,並設定您要排除的自訂維度,例如
payment_type
、payment_status
。 - 在「Matching Conditions」(相符條件) 中,設定只有在使用者拒絕使用
analytics_storage
Cookie 時才應執行轉換。
下列條件如下:G100
{{gcs}}
等於G110
{{gcs}}
等於
- 選用:在「受影響的代碼」中,新增要套用這項轉換的所有代碼。
- 輸入代碼名稱並進行「儲存」。如下所示:
確認套用轉換規則
您可以預覽工作區,藉此驗證轉換規則:
- 開啟網站。
在 Google 代碼管理工具伺服器容器中,選取「預覽」。
Tag Assistant 會啟動並載入伺服器容器。
如要查看針對事件觸發的所有標記和動作,請從左側的清單中選取事件名稱。
確認已執行轉換:
- 在要驗證的事件中,開啟「代碼」分頁。
選取會觸發的標記,以便查看標記屬性、傳出 HTTP 要求、觸發觸發條件和轉換。
注意:轉換只會影響觸發的標記。如果轉換會修改或移除必要的事件參數欄位,則轉換不會觸發。
「代碼詳細資料」總覽會顯示代碼執行的轉換作業和順序。預設順序如下:
- 允許參數
- 擴增參數
- 排除參數
如要查看轉換詳細資料,請按一下轉換作業。提供給代碼的事件參數則會顯示在「事件資料」區段下方。
按一下「Event Data」方塊,即可在所有轉換作業執行後查看事件參數的狀態。如要查看原始和已轉換的事件參數,請勾選「Show Original」(顯示原始參數)。