使用轉換功能控管代碼可用的事件參數

這份文件適用於需要控管要向代碼公開哪些事件參數的伺服器端代碼使用者。

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

轉換會在用戶端建立事件資料物件後執行。

什麼是轉換？

轉換可讓您在事件參數公開給代碼之前，加入、排除或修改從用戶端輸出的事件參數。透過轉換，您可以保護機密資訊，並精確控管哪些事件參數可供進一步處理。

您可以使用轉換建立規則，以便執行下列操作：

  • 只允許與代碼共用明確定義的事件參數。
  • 建立編輯或新增事件參數的規則，以擴增事件參數。
  • 排除代碼中的事件參數，遮蓋收到的資訊。

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

系統會在每次轉換作業執行時評估變數。視轉換作業的運作方式而定，變數可能會解析為不同的值。

允許代碼使用事件參數

您可以使用「允許參數」轉換，指定要公開至代碼的特定事件參數。系統會捨棄未明確定義的事件參數。

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

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

範例：將特定資訊記錄到 BigQuery 資料表

您可以控制記錄的參數，以便執行下列操作：

  • 請確認機密資訊不會記錄在內部資料儲存庫中。
  • 避免記錄過多，節省儲存空間和雲端費用。
  • 儲存相關指標，以利監控和回報。

請教我如何操作！

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

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

擴充事件參數

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

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

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

  4. 在「需要增修的參數」中：

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

    • 如要新增事件資料物件值，請輸入所需的名稱和變數。

  5. 選用：比對條件可讓您定義啟用轉換作業的規則。根據預設，系統一律會套用轉換規則。

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

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

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

以價值為準出價可協助您改善廣告活動成效，將廣告支出最佳化，以便鎖定對業務價值較高的使用者。設定以價值為準出價後，Google Ads 就會根據您的轉換價值設定出價，為您爭取更有價值的轉換。擴充事件轉換作業可用於設定以價值為準出價的伺服器端。

請教我如何操作！

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

如要設定以價值為準出價，請按照下列步驟操作：

  1. 建立「新」轉換規則。
  2. 按一下「轉換設定」，然後選取「擴充事件」。
  3. 在「需要增修的參數」中，新增一列。設定變數，將商品的貨幣價值載入轉換作業：
    1. 在「參數名稱」中，輸入要調整的值名稱，例如 value。請替換所有 value 欄位，因為這些欄位代表事件的金錢價值。
    2. 在參數「Value」中，設定可從資料庫擷取價格的變數。舉例來說，如果您將產品資料儲存在 Firestore 中，請新增 Firestore 查閱變數。
  4. 在「相符條件」中，設定此轉換作業只應套用至特定事件。如要只針對購物事件套用以價值為準出價，請設定：{{Event Name}} 等於 purchase。
  5. 在「受影響的代碼」中，新增所有應套用這項轉換的 Google Ads 轉換追蹤代碼。
  6. 為代碼命名並儲存。內容應類似以下： 顯示擴充參數轉換作業的螢幕截圖

從代碼中排除事件參數

排除參數轉換作業可用於從代碼中移除特定事件參數。

注意：如果排除標記所需的參數，標記可能無法正常運作。轉換參數前，請先檢查代碼所依賴的參數。

如要排除特定事件參數的代碼：

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

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

您可以透過「排除參數」控管要傳送給 Google 的第一方資料。舉例來說，如果使用者拒絕 analytics_storage Cookie，您可能需要移除特定的自訂維度。

請教我如何操作！

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

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

確認轉換規則已套用

您可以預覽工作區，確認轉換規則是否正確：

  1. 開啟網站。

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

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

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

驗證轉換作業是否已執行：

  1. 如要驗證，請開啟「標記」分頁。

  2. 選取已觸發的代碼，即可查看代碼屬性、傳出 HTTP 要求、觸發事件和轉換。

    注意：轉換只會影響觸發的代碼。如果轉換會修改或移除必要的事件參數欄位，就可能導致代碼無法觸發。

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

    1. 允許參數
    2. 增強參數
    3. 排除參數

    Tag Assistant 畫面：顯示 GA4 代碼簡介

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

    Tag Assistant 顯示轉換作業的詳細資料。

  5. 點選「Event Data」方塊後，您可以查看所有轉換作業執行後的事件參數狀態。如要同時查看原始和轉換後的事件參數，請勾選「顯示原始」。

    修改後的事件參數總覽