本文將逐步說明如何使用 Measurement Protocol，將 SKAdNetwork 回傳傳送至 Google Analytics。
步驟 1：根據 iOS 版本註冊適用的 SKAdNetwork 回傳
詳情請參閱 Apple 說明文件。使用 Google Analytics for Firebase SDK 的客戶可以略過這個步驟，因為 SDK 會自動為應用程式註冊 SKAdNetwork 回傳。
步驟 2：確認已開始接收並解碼 SKAdNetwork 回傳
詳情請參閱 Apple 說明文件。如果尚未設定 SKAdNetwork 端點，請務必按照 Apple 說明文件完成設定。
注意：您目前無法將 Google Analytics 4 設為端點。
如果您已透過 Google 核准的應用程式歸因合作夥伴或內部解決方案設定端點，請直接跳至步驟 3，並根據當中的逐步指示完成設定，以使用 Measurement Protocol 將回傳結果傳送至 Google Analytics。
步驟 3：使用 Measurement Protocol 將回傳結果傳送至 Google Analytics
為了完成此步驟，我們將使用以下結構定義 (程式碼研究室範例)，透過 Measurement Protocol 將自訂 campaign_details 事件傳送至 Google Analytics。
導入 Google Analytics 4 SKAdNetwork Measurement Protocol
請求層級參數
| 參數 |
詳細說明 |
| firebase_app_id: {gmp_app_id} |
|
| api_secret: {api_secret} |
|
| timestamp_micros: {timestamp of received SKAN postback} |
|
| app_instance_id: {...} |
此為「必填」參數。用來產生由隨機號碼組成的專屬字串。將這些資料用於轉換模擬後，系統會捨棄此 ID 字串，並以實際的應用程式執行個體 ID 取代。
|
Google Analytics 事件
| 事件 |
詳細說明 |
| campaign_details |
自訂事件。 |
現有的 Google Analytics 參數
| 參數 |
詳細說明 |
| source: {source} |
這些是在手動標記時會使用的參數。Google Analytics 4 報表採用與 Google Analytics 4 預設管道分組一致的結構。建議您在分類每個參數時，一律遵循這些預設管道分組。只要不是 Google 回傳，就請一律傳送這些參數。
例如：
Facebook 回傳：
- source: facebook
- medium: cpc|cpm (單次點擊出價|千次曝光出價)
- content: ad_version_name
- campaign: Facebook Spring 22 Campaign (Facebook 2022 年春季廣告活動)
- campaign id: 如 SKAN 回傳中所示
針對 Google 回傳，我們會根據資源與 Google Ads 的整合情況來解碼廣告活動。因此，對於 Google 回傳，上述參數皆為「自選」參數。請確認您已將 Google Analytics 4 資源連結至 Google Ads 廣告帳戶。
注意：請務必將所有 SKAdNetwork 回傳 (不僅限於非 Google 回傳) 傳送至 Google Analytics 4。 |
| medium: {medium} |
| term: {term} 自選 |
| content: {content} 自選 |
| campaign_id: {campaign_id} |
SKAdNetwork 回傳所包含的值。 |
| campaign: {campaign} 自選參數；如未提供，系統會顯示「(未設定)」 |
如果是 Google Ads 廣告活動，我們會根據 Google Analytics 和 Google Ads 連結，解碼 ID 並提供廣告活動名稱，同時更新來源和媒介參數。如未連結帳戶，我們會使用指定的來源和媒介參數，而不會解碼 Google 廣告活動 ID。
針對非 Google Ads 廣告活動，您可以自行解碼，並提供廣告活動名稱。如果您不知道這項資訊，可以複製 SKAdNetwork campaign_id。
注意：如未提供，系統會顯示「(未設定)」。
|
| source_platform: “apple_skan” |
重要事項：您必須完整指定此字串，並遵循大小寫和「_」符號的用法。 |
| app_id: {app_id} |
SKAdNetwork 回傳所包含的值。此為您的應用程式軟體包 ID。
|
| transaction_id: {transaction_id} |
SKAdNetwork 回傳所包含的值。 |
必要的新參數
注意：您可以在 Google Analytics 4 使用者介面中設定這些新參數，但這並非強制規定。如要查看根據這些參數製作的特定自訂維度報表，就必須在 Google Analytics 4 中註冊這些參數。
| 參數 |
詳細說明 |
| version: {version} |
SKAdNetwork 回傳所包含的值 |
| conversion_value: {conversion_value} |
SKAdNetwork 回傳所包含的值 |
| fidelity_type: {fidelity_type} |
SKAdNetwork 回傳所包含的值。 |
| attribution_signature: {attribution_signature} |
SKAdNetwork 回傳所包含的值。
注意：這是一項安全防護功能。SKAdNetwork 回傳會經過加密簽署。
|
| redownload: {redownload} |
SKAdNetwork 回傳所包含的值。 |
| source_app_id: {source_app_id} |
SKAdNetwork 回傳所包含的值。
注意：此應用程式 ID 對應至使用者在當中按下廣告，因而促成安裝的應用程式。
|
| did_win: {did_win} |
SKAdNetwork 回傳所包含的值。
注意：廣告客戶只會收到在競價中勝出的回傳。廣告技術則會收到在競價中勝出的回傳，以及排名第二/輔助的回傳。
|
|
ad_network_id: {ad_network_id}
其中 {ad_network_id} 代表回傳所包含的值。
|
SKAdNetwork 回傳所包含的值。
此參數顯示廣告是在哪個廣告聯播網中放送。這項資訊對於「來源」流量維度也相當有用。
|
步驟 4：確認已開始接收 Marketing Platform 命中資料
系統不會直接在 Google Analytics 中顯示 campaign_details 事件，而是會將 SKAdNetwork 回傳轉換成事件，並整合至 first_open 重要事件和事件報表中。您可以新增維度來源平台 (來源平台為 SKAN) 以進行區隔。
如要確認系統確實傳送命中資料，建議您改用另一個事件名稱 (campaign_details_skan_test) 建立 campaign_details 事件的複本，藉此記錄測試事件。接著，您可以確認測試事件是否顯示在 Google Analytics 4 的「即時」報表中。如果您已註冊測試事件和參數，這些事件和參數會同時出現在即時和臨時報表中。
注意事項：
- 如果想在報表中顯示所有 SKAdNetwork 回傳，除了以
campaign.details 事件的形式傳送每個回傳以外，您還必須按照上述方式註冊事件和參數複本。如果選擇這麼做，您仍需使用 campaign.details 事件傳送 SKAdNetwork 回傳，否則 Google Analytics 無法辨識這些資料，也無法執行轉換模擬來改善 iOS first_open 報表。
- SKAdNetwork 回傳必須在收到後的 4 天內傳送，才可供 Google Analytics 用於轉換模擬及製作報表。
進一步瞭解一般驗證步驟。