Meta Audience Network

Facebook 登入與 Audience Network 分析報告 API V2 整合

「Facebook 登入」是允許存取 Audience Network 分析報告 API 資料的新方法。此方法將取代營利管理工具介面中複製貼上系統用戶權杖的舊方法，可提供更安全的方法來授予資料存取權限，因為營利管理工具權杖存在暴露於企業之外的風險。

本文件著重於為直接分析報告 API 整合合作夥伴、行動成效衡量合作夥伴、中介服務合作夥伴，以及代表發佈商存取分析報告 API 資料的其他 Facebook 合作夥伴提供指引。

我正在使用第三方服務來取得分析報告 API 資料

如果您是使用現有的合作夥伴（行動衡量或中介服務合作夥伴），則無需進行額外的編碼工作。確認您的合作夥伴已整合「Facebook 登入」流程。您必須點擊「使用 FB 登入」選項，然後選擇您想要授與存取權限的資產，並包含將產生的權杖。

如果您選擇「所有」資產，只要建立權杖的用戶能夠存取企業管理平台中的資產，權杖就會提供存取權限給「商家」底下的所有資產。

權限

如果您需要直接使用分析報告 API，必須先建立 Facebook 應用程式並取得必要的權限。您的應用程式需要 read_audience_network_insights 權限才能存取 Audience Network 分析報告 API 資料。為了讓您的應用程式取得該權限，商家需要設置 Audience Network。

  • 在商業帳號欄位中選擇新建的商家

您的應用程式現已在 Audience Network 上線，可以使用 read_audience_network_insights 權限。如果您看不到 read_audience_network_insights，請確認該應用程式連結至能夠存取您的營利管理工具商業帳號的商家。

如果您先前透過「Facebook 登入」獲得了 read_insights permission，此權限仍然有效，但建議您改為使用 read_audience_network_insights 權限。

存取分析報告 API 的方式將因整合的類型而異。請按照適合您狀況的指示操作：

不包含用戶介面的直接 API 整合

如果您有不包含任何前端／用戶介面的自訂（直接）分析報告 API 整合，並且僅用來查詢您的商家資料，則可以使用下列指示存取分析報告 API。

透過圖形 API 測試工具建立用戶權杖

  1. 如果您已在應用程式中使用「行銷 API」，請跳過此步驟。否則，請按照取得 read_audience_network_insights 權限的指示操作
  2. 前往圖形 API 測試工具
  3. 選擇您的應用程式
  4. 選擇 read_audience_network_insights 權限（位於「權限 > 事件群組頁面」底下）並點擊「產生存取權杖」。
    1. 您現在可以暫時使用此權杖（而非來自營利管理工具的權杖）存取 Audience Network 分析報告 API 資料
    2. 免責聲明：此權杖將在 2 小時後過期，您需要使用以下指示將其轉變成長期存取權杖。

將此權杖轉變成長效存取權杖

  1. 前往存取權杖偵錯工具
  2. 輸入權杖並按下「偵錯」
  3. 一直捲動至包含所有權杖資訊的資料表底部，點擊「延長存取權杖」按鈕
  4. 複製產生的權杖

您現在可以使用此權杖存取 Audience Network 分析報告 API 資料。

包含用戶介面的直接 API 整合

若發佈商和合作夥伴擁有自己的用戶介面且可在介面中放置「Facebook 登入」按鈕，下列指南將很有幫助。對於願意存取所屬資料的發佈商以及希望使用權限存取其他發佈商營利資料的合作夥伴，本指南將很有助益。

您可以同時查看下列指南的端對端示範影片，包括上述的權限步驟：

發生錯誤
播放此影片時發生問題。
瞭解詳情
  • 在開發人員入口網站上，選擇之前步驟中所新建的商業應用程式
  • 在此應用程式中新增「Facebook 登入」產品
  • 選擇「網頁」選項並按照整合步驟操作
  • 輸入將顯示「Facebook 登入」體驗的網站網址。確認其支援 HTTPS 通訊協定
  • 整合步驟結束時，您將取得範例程式碼，可用於在網站上整合「Facebook 登入」。您可以複製該程式碼，不過請使用新存取的 read_audience_network_insights 權限，而不是建議的 public_profile,email 權限。使用更新的權限後，您的按鈕程式碼應如下所示： 
<fb:login-button 
  scope="read_audience_network_insights"
  onlogin="checkLoginState();">
</fb:login-button>
  • 請務必在產品設定頁面的「Facebook 登入」中為應用程式啟用 JavaScript SDK
  • 現在，用戶可以在您的頁面執行「Facebook 登入」流程來產生存取權杖
  • 系統將傳回存取權杖，並作為傳遞至之前步驟的 statusChangeCallback JavaScript 方法之引數的一部分。
  • 預設情況下，此權杖將在大約 2 小時後過期
  • 開發人員可要求將此權杖延長為長期存取權杖而無需與其他用戶互動。
    • 向 Facebook 的伺服器發出分析報告 API 要求時，系統會每天重新整理一次長期權杖。如果未發出任何要求，權杖將會在大約 60 天後到期，用戶必須產生新的權杖。
  • 請記住，透過此權杖提供的資料在很大程度上取決於誰通過此「Facebook 登入」流程以及他們同意共享哪些資料。因此，如果商家員工通過此流程，所產生的存取權杖將具有與該員工相同的權限。

疑難排解

錯誤訊息代表意涵處置／解決方式

讀取的粉絲專頁、企業商家、應用程式、網域或事件來源群組洞察報告不屬於查詢的用戶或應用程式所擁有

若是 Facebook 登入權杖，這表示應用程式發佈的權杖沒有足夠的權限（read_audience_network_insights），或用戶本身沒有查看特定屬性的權限。可能發生此狀況的原因為：* 產生權杖的用戶尚未獲得存取企業管理平台的權限。* 建立權杖的用戶尚未獲得存取所有已查詢屬性的權限。

商業帳號管理員必須向想要產生權杖或已經產生權杖的用戶提供存取所有屬性的權限。

遺失或空白資料

此狀況通常表示全部或部分資料是使用我們的隱私彙總進行篩選，也可能是根據 MoMa 資料進行驗證。

檢查是否包含 omitted_results 陣列，其表示資料正在進行彙總，請嘗試更高的要求。如需詳細資訊，請閱讀彙總部分。

權杖看不見 read_audience_network_insights

用於產生權杖所建立的應用程式並未建立為「商家」類型，且該應用程式已連結至 Audience Network 營利管理工具。

請確認建立中的應用程式可產生「商家」類型的權杖。嘗試建立新的應用程式，並務必依照「權限」部分下的指示進行操作。前往 developers.facebook.com/apps，選擇您看不到 read_audience_network_insights 的應用程式，接著選擇「Audience Network」，然後點擊「設定」按鈕。

Error validating access token: Session has expired on ...

權杖已過期

請確認已將權杖轉換為長期權杖。依照「將此權杖轉換為長期存取權杖」部分下的指示進行操作。向 Facebook 的伺服器發出分析報告 API 要求時，系統每天會重新整理長期存取權杖一次。如果未發出任何要求，權杖將會在大約 60 天後到期，用戶必須產生新的權杖。

顯示兩個名稱相同的應用程式

檢查其中一個應用程式是否具有 read_audience_network_insights 權限

使用具有正確 read_audience_network_insights 權限的應用程式

（#200）存取分析報告 API v2.0 的方式已變更。您現在必須為應用程式實作 Facebook 登入才能存取此 API。

您沒有使用認證以新方式存取 API。

請確認從頭開始建立新的應用程式（僅用於建立權杖），並將其建立為「商家」類型。