Meta Ads 串接
在 adstage 中，可以收集 Meta Ads（Facebook、Instagram）上投放中的廣告活動的費用資料，也可以串接把 adstage 收集到的轉換事件回傳給 Meta 的轉換 API（CAPI）。Meta Ads 串接由 管道串接、費用串接、轉換 API 三個分頁構成。
1. 串接概述
在 adstage 儀表板 串接 > 廣告管道串接 > Meta Ads 中設定以下項目。
| 分頁 | 作用 |
|---|---|
管道串接 | 登錄解密 Android Install Referrer 所需的 Facebook App ID 與解密金鑰。 |
費用串接 | 透過 OAuth 連接 Meta 廣告帳戶，收集廣告活動的費用資料。 |
轉換 API | 將 adstage 收集到的事件透過 Meta Conversions API（CAPI）從伺服器端傳送。 |
2. 進行費用串接
在 費用串接 分頁中連接 Meta 廣告帳戶後，即可在 adstage 儀表板中確認 Meta Ads 上投放中的廣告活動的費用資料。
使用 Meta 帳戶串接
採用 Meta Business 登入（OAuth）方式進行安全認證。
-
在
費用串接分頁中啟用費用資料收集開關。 -
點擊
新增串接帳戶按鈕。Facebook 企業登入視窗會以新視窗開啟。 -
以 Meta 帳戶登入，並核准 adstage 存取廣告資料的權限。
串接前的準備
要進行費用串接，需要 Meta 企業管理平台（Business Manager）的存取權限，以及該廣告帳戶的管理員權限。
選擇廣告帳戶
認證完成後，會顯示該 Meta 帳戶可存取的廣告帳戶清單。
-
選擇一個以上要串接的廣告帳戶。清單會顯示帳戶名稱、廣告帳戶 ID（Ad Account ID）、企業管理平台（Business Manager）資訊，請據此確認是否為正確的帳戶。
-
可依帳戶名稱或 ID 搜尋清單，也可以用
全選一次全部選取。 -
確認已選帳戶數量後確定串接，該廣告帳戶即與 adstage 完成串接。
請注意
已新增過的廣告帳戶會被排除在串接之外。若所選帳戶全部都已新增，則不會進行串接。
管理串接帳戶
已串接的廣告帳戶可在 費用串接 分頁的帳戶清單中透過以下資訊確認。
| 項目 | 說明 |
|---|---|
廣告帳戶 | Meta 廣告帳戶名稱與廣告帳戶 ID（Ad Account ID） |
狀態 | 費用串接狀態（準備中、成功、失敗） |
最後資料更新 | 最近一次資料收集的時間 |
Facebook 帳戶 | 串接時所用的 Meta 帳戶電子郵件或名稱 |
管理 | 解除帳戶串接（刪除） |
要解除串接，請在帳戶清單中點擊該帳戶的刪除按鈕，然後在確認訊息中選擇 刪除。
請注意
刪除帳戶後，該帳戶的資料收集將會中斷。已收集的歷史資料仍保留在 adstage 中，但不會再收集新資料。
收集的資料
費用資料以下列方式收集。
| 項目 | 說明 |
|---|---|
| 收集週期 | 每 4 小時自動收集 |
| 資料層級 | 廣告活動、廣告群組（Ad Set）、廣告（Ad）層級的明細資料 |
| 收集指標 | 費用等各廣告活動的成效資料 |
3. 進行轉換 API（CAPI）串接
在 轉換 API 分頁中串接 Meta Conversions API（CAPI）後，即使不在應用程式中安裝 Facebook SDK，也能把 adstage 收集到的事件從伺服器端傳送給 Meta。即使在 iOS ATT 環境下，也可透過伺服器端傳送提升歸因準確度。
輸入 Pixel ID
在 Meta 事件管理工具（Events Manager） 中確認 Pixel ID 後輸入。
- 查看路徑：事件管理工具 → 資料來源 → 選擇 Pixel → 設定 → Pixel ID
輸入存取權杖
在事件管理工具中產生轉換 API 專用的存取權杖後輸入。
- 產生路徑：事件管理工具 → 資料來源 → 選擇 Pixel → 設定 → Conversions API → 產生存取權杖
存取權杖會加密儲存
儲存的存取權杖會加密並安全保管，儲存後不會再次顯示。如需變更，請重新輸入新的權杖。
測試事件代碼（選用）
若想在不影響正式報表的前提下驗證事件，可設定測試事件代碼。切換為正式模式時，請清空代碼並重新儲存。
- 查看路徑：事件管理工具 → 測試事件（Test Events）分頁 → 確認測試代碼
連線測試與事件轉發設定
儲存 Pixel ID 與存取權杖後，即可使用以下功能。
| 項目 | 說明 |
|---|---|
連線測試 | 傳送測試事件，確認 CAPI 設定是否正常運作。 |
事件轉發設定 | 可依收集到的各個事件開啟或關閉傳送至 Meta，並對應每個 adstage 事件要以哪個 Meta 事件傳送。 |
事件轉發設定中只會顯示實際已收集到的事件。若尚無已收集的事件，則會在應用程式有資料進入之後出現在清單中。
CAPI 的運作方式
- 使用者電子郵件與電話號碼在傳送給 Meta 之前會經過 SHA256 雜湊處理。
- 自動套用以 event_id 為基準的重複排除，避免與瀏覽器 Pixel 重複計算。
- 透過伺服器端事件傳送繞過 iOS ATT 限制，藉此提升歸因準確度。
4. 進行管道串接
管道串接 分頁用於登錄解密 Android Facebook Install Referrer 所需的資訊。
確認 Facebook App ID
在 Meta for Developers 註冊應用程式後，確認 App ID 並輸入。
- 查看路徑：Dashboard → 選擇應用程式 → 設定（Settings） → 基本（Basic） → App ID
輸入解密金鑰
輸入 Meta 核發的 32 位元組解密金鑰（HEX 64 字元）。
- 查看路徑：Dashboard → 選擇應用程式 → 設定（Settings） → 進階（Advanced） → Install Referrer Decryption Key
解密金鑰會加密儲存
儲存的解密金鑰會加密並安全保管，儲存後不會再次顯示。如需變更，請重新輸入新的金鑰。
5. 注意事項
請留意以下事項。
- Meta Ads 與 adstage 之間可能出現數值差異。這是統計時間點、時區、篩選基準的差異所致。
- 若撤銷 Meta 帳戶的權限或權杖過期，資料收集可能會中斷。
- 在廣告管道中修改廣告活動名稱後，反映到 adstage 可能需要一些時間。
- 要啟用轉換 API，Pixel ID 與存取權杖兩者都必須已儲存。