此 API 為測試版。若要取得使用權限,請連絡您的 Meta 業務代表。
使用轉換 API 分享伺服器事件的廣告商,可以在事件管理工具中查看事件配對品質。不過,這僅適用於個案,如果技術供應商合作夥伴、代理商合作夥伴或廣告商為其商家管理千百個 Meta 像素,很難擴充規模。整合品質 API 可使用程式碼大規模合併整合品質衡量指標,以協助解決此問題。
事件配對品質(EMQ)為滿分 10 分的分數,用以指示從您的伺服器所傳送的顧客資訊,在用於配對事件實例與 Facebook 帳號時的有效程度。優異的品質事件配對可改善廣告歸因和成效。請注意,此衡量指標仍在調整中。
事件配對品質是根據轉換 API 整合工具從您的伺服器收到的顧客資料參數、收到的資料品質,以及與 Meta 帳號配對的事件實例百分比所計算而得。
事件配對品質用於評估您是否透過轉換 API 傳送正確的顧客資訊,以配對您的事件與 Meta 帳號,以及您是否已正確設定顧客資訊參數。顧客資訊參數可協助配對您的事件與 Meta 帳號,以便您將轉換歸因於廣告,並將其投遞給最有可能轉換的用戶。
事件配對品質為即時計算。請前往此處深入瞭解 EMQ 最佳作法的相關資訊。
EMQ 目前僅適用於網站事件。若是其他事件類型,例如離線和實體店面事件、應用程式事件、轉換潛在顧客,或是處於初期或測試版階段的任何整合,請聯絡您的 Meta 代表,以取得提升配對品質的相關指導。
合作夥伴和代理商可以使用整合品質 API 來提供高品質的主控板和洞察報告,同時協助廣告商強化和最佳化整合。合作夥伴也可以使用此整合來監控其轉換 API 整合工具的穩定性。廣告商可以使用此端點來彙總整合品質資料,以納入其監控中。
您必須先要求授權,才能代表客戶傳送事件。您有以下幾種驗證選項:
對需要存取商家客戶資產的技術供應商和商業應用程式開發人員而言,商家專用 Facebook 登入是其偏好的驗證和授權解決方案。Facebook 商家登入可讓您指定存取權杖類型、資產類型和應用程式需要的權限,並將之儲存為一組(配置)。接著,您可將此組配置提供給商家客戶,好讓他們完成流程,並授權您的應用程式存取其商家資產。
使用此選項時,Meta Business 擴充功能(MBE)會傳回代表客戶傳送事件所需的所有必要資訊。MBE 會提供端點,以擷取在客戶企業管理平台中建立的系統用戶存取權杖。此程序包含傳送伺服器事件的權限,並且會自動安全地完成。MBE 目前為測試版,若要取得使用權限,請連絡您的 Meta 業務代表。
端點需要用戶存取權杖做為輸入參數。如果您是新的 MBE 用戶,在完成 MBE 設定後,請呼叫此端點來擷取系統用戶存取權杖。現有用戶在呼叫新的 API 端點之前,需要先要求重新驗證。
使用此選項時,客戶可以透過企業管理平台設定或透過 API,將其 Meta 像素分享給合作夥伴。然後,合作夥伴可以將合作夥伴系統用戶指派給客戶像素,並產生存取權杖來傳送伺服器事件。
您可以使用下列 API 端點、參數和欄位,監控每個事件的事件配對品質分數,以及所傳送的配對索引鍵:
https://graph.facebook.com/v21.0
/<pixel_id>/integration_quality
參數 | 說明 |
---|---|
agent_name 字串 | 選用項目。 例如,如果您的 partner_agent 值為
如果您是廣告商,通常不必擔心 如果您未提供 |
欄位 | 說明 |
---|---|
event_name 字串 | |
event_match_quality AdsPixelCAPIEMQ | 事件配對品質會指示從您的伺服器所傳送的顧客資訊,在用於配對事件實例與 Facebook 帳號時的有效程度。 |
圖形 API 測試工具
GET/v21.0
/<PIXEL_ID>/integration_quality?fields=event_match_quality,event_name&agent_name=<AGENT_NAME>&access_token=<ACCESS_TOKEN>
cURL
curl -X GET -G \ -d 'fields="event_match_quality,event_name"' \ -d 'agent_name="<AGENT_NAME>"' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<LATEST_VERSION>/<PIXEL_ID>/integration_quality
API 回應
{ "data": [ { "event_match_quality": { "composite_score": 5.1, "match_key_feedback": [ { "identifier": "email", "coverage": { "percentage": 100 } }, { "identifier": "user_agent", "coverage": { "percentage": 100 } }, { "identifier": "external_id", "coverage": { "percentage": 100 } } ] }, "event_name": "pLTVPurchase" }, { "event_match_quality": { "composite_score": 7.2, "match_key_feedback": [ { "identifier": "email", "coverage": { "percentage": 100 } }, { "identifier": "user_agent", "coverage": { "percentage": 100 } }, { "identifier": "phone", "coverage": { "percentage": 69.1 } }, { "identifier": "fbp", "coverage": { "percentage": 96.7 } }, { "identifier": "external_id", "coverage": { "percentage": 100 } }, { "identifier": "fbc", "coverage": { "percentage": 3.2 } } ] }, "event_name": "CompleteRegistration" } ] }
The access token is used when partners send signal events or access the Setup Quality API on behalf of advertisers. The client system user access token onboarding method is not compatible with the EMQ API at the moment.
The partner_agent
value in your API GET request should be a normalized lowercase format. This field is now optional.
Meta 企業商家使用說明的轉換 API 設定品質指引: