什麼是「多管道漏斗報表 API」- 總覽

本文提供 Google Analytics (分析) 多管道漏斗報表 API 的概要總覽。如需 API 的詳細參考資料，請參閱參考指南。

簡介

您可利用 Multi-ChannelFunnel Reporting API 要求已驗證使用者的多管道漏斗資料。資料衍生自轉換路徑資料，其中顯示使用者在轉換前在多個工作階段中與各種流量來源的互動。進而分析多個行銷管道在一段時間內對轉換的影響。如要進一步瞭解有哪些資料可用，請參閱「 關於多管道漏斗」和「 關於多管道漏斗資料」一文。

使用「多管道漏斗報表 API」時，您可以：

  • 使用「多管道漏斗」資料建立自訂報表。舉例來說，您可以使用 最佳轉換路徑資料，針對轉換路徑中的互動位置等屬性製作報表。
  • 整合「多管道漏斗」資料與業務資料。 舉例來說，您可以將線上轉換資料與離線銷售資料和媒體費用資料建立關聯，進而更全面地掌握行銷投資報酬率。
  • 在新環境中顯示多管道漏斗。舉例來說，您可以建立資料視覺化和其他呈現方式，呈現不同行銷管道在提高轉換方面的價值。

概念總覽

多管道漏斗報表 API 的基本概念如下：

  • 報表與使用者及資料檢視 (設定檔) 的關係。
  • 報表的結構和建立查詢的方式。
  • 轉換路徑資料和歸因概念。
  • 使用 API 回應。

報表、使用者和資料檢視 (設定檔)

如要為使用者要求報表資料，應用程式必須識別使用者，並指定要擷取資料的檢視畫面 (設定檔)。使用者可以透過取得 授權憑證來識別，並針對每個 API 要求傳送這些憑證。資料檢視 (設定檔) 是以資料檢視 (設定檔) ID 識別。 資料檢視 (設定檔和其他實體) 屬於 Google Analytics (分析) 設定階層的一部分。您的應用程式可以使用 Management API 掃遍這個階層，並取得資料檢視 (設定檔) ID。

查詢維度和指標

您會查詢 API 以取得 Google Analytics (分析) 報表資料 (當中包含維度和指標)。指標是使用者活動的個別測量結果，例如轉換計數和價值。維度可依據部分常見條件細分指標，可以是代表轉換路徑中個別互動事件的原始值，或是代表整個轉換路徑的一系列互動事件的序列。

您可以參閱 維度和指標參考指南，探索透過 API 公開的所有維度和指標。此外，請參閱 Multi-ChannelFunnel Reporting API 參考指南，瞭解如何在 API 查詢中指定維度和指標。

轉換路徑資料和歸因概念

「多管道漏斗」報表是根據轉換路徑製作而成，這類路徑是指達成每次轉換和交易的一系列互動 (例如來自管道的點擊/參照連結網址)。轉換路徑是透過 Google Analytics (分析) Cookie 收集，這類 Cookie 會記錄相同瀏覽器和機器的互動。「多管道漏斗」資料會結合 Google Analytics (分析) 轉換資料與 Cookie 所記錄的互動順序。

「多管道漏斗」報表查詢會根據 100 萬個轉換路徑的樣本傳回資料。如果日期範圍包含的轉換總數不超過 100 萬次，報表就不會經過取樣。否則，系統會使用 100 萬個樣本的樣本來產生結果。這與以工作階段為基礎的核心報表功能不同。如要進一步瞭解資料和相關概念，請參閱「 關於多管道漏斗資料」一文。我們也建議您參閱 分析管道貢獻一文，其中定義「輔助轉換」等核心概念。

使用報表

API 傳回的資料可視為含有標頭和列清單的資料表。每個 API 回應都包含一個標頭，用於說明每個資料欄的名稱和資料類型。回應也會包含資料列清單，其中每列都是一個儲存格清單，而且資料的順序與標題順序相同。如要進一步瞭解 API 回應，請參閱 Multi-ChannelFunnel Reporting API 參考指南。

每個儲存格值都包含字串類型的原始值，或是轉換路徑值。這個轉換路徑值是物件陣列，代表該路徑的所有節點。我們可以利用欄標題中的類型資訊，將每個儲存格值剖析為適當的類型。 詳情請參閱這篇文章。

配額政策

「多管道漏斗」資料查詢可處理數百萬項作業。為避免系統接收的作業數量超過系統可處理的作業量，並確保系統資源能均勻分佈，必須使用配額系統。詳情請參閱 限制與配額指南。

後續步驟

現在您已瞭解 API 的運作方式，我們提供了許多資源，可協助您開始使用：