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

本文將概略介紹 Google Analytics (分析) 多管道漏斗 Reporting API。如需 API 的詳細參考資料,請參閱參考指南

引言

透過多管道漏斗 Reporting API,您可以要求已驗證使用者的多管道漏斗資料。 資料來源為轉換路徑資料,其中顯示轉換前多個工作階段與各種流量來源的互動。這可讓您分析多個行銷通路如何長期影響轉換。如要進一步瞭解有哪些資料可用,請參閱 關於多管道漏斗 關於多管道漏斗資料

透過多管道漏斗 Reporting API,您可以:

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

概念總覽

「多管道漏斗報表 API」的基本概念如下:

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

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

如要要求使用者的報表資料,應用程式必須識別使用者,並指定要擷取資料的資料檢視 (設定檔)。當使用者取得 授權憑證並在每個 API 要求中傳送憑證時,就可以識別使用者。資料檢視 (設定檔) 會以資料檢視 (設定檔) ID 識別。資料檢視 (設定檔) 和其他實體都屬於 Google Analytics (分析) 設定階層的一部分。應用程式可以使用 Management API 掃遍這個階層,並取得資料檢視 (設定檔) ID。

查詢維度和指標

您會查詢 API 來取得 Google Analytics (分析) 報表資料,該資料由維度和指標組成。「指標」是使用者活動的個別測量值,例如轉換次數和價值。維度會按照一些常見的條件來細分指標,可以是代表轉換路徑中個別互動事件的原始值,也可以是整個轉換路徑中一系列互動事件的序列。

請參閱 維度和指標參考指南,探索透過 API 公開的所有維度和指標。此外,請參閱《 多管道漏斗 Reporting API 參考指南》,瞭解如何在 API 查詢中指定維度和指標。

轉換路徑資料和歸因概念

「多管道漏斗」報表是依據轉換路徑產生,也就是達成每次轉換和交易的一連串互動 (例如來自管道的點擊/參照連結網址)。轉換路徑是透過 Google Analytics (分析) Cookie 收集,而 Cookie 會記錄由相同的瀏覽器和電腦進行的互動。「多管道漏斗」資料會結合 Google Analytics (分析) 轉換資料與 Cookie 中擷取到的互動順序。

「多管道漏斗」報表查詢會以 100 萬個轉換路徑的樣本為依據傳回資料。如果日期範圍包含 100 萬或更少的轉換總數,報表就會未取樣。否則,系統會使用 100 萬的樣本組合來產生結果。這與核心報表功能 (以工作階段為基礎進行取樣) 不同。如要進一步瞭解資料和相關概念,請參閱「 關於多管道漏斗資料」一文。此外,您也可以參閱 分析管道貢獻一文,瞭解輔助轉換等核心概念。

使用報表

API 傳回的資料可以視為含有標頭和列清單的資料表。每個 API 回應都包含一個標頭,用來說明每個資料欄的名稱和資料類型。回應也包含資料列清單,其中每列都是一份儲存格清單,其中所含資料的順序與標頭相同。如要進一步瞭解 API 回應,請參閱《 多管道漏斗 Reporting API 參考指南》。

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

配額政策

「多管道漏斗」資料查詢可處理數百萬筆作業。為了防止系統收到超過系統可處理的作業,並確保系統資源能以公平的方式發布,就必須使用配額系統。詳情請參閱 限制與配額指南。

後續步驟

現在您已瞭解 API 的運作方式,以下提供多項資源協助您快速上手: