View a markdown version of this page

Google Analytics 整合 - Amazon Quick
開始之前設定 Google Cloud在 Amazon Quick 中設定連接器可用動作管理和疑難排解

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Google Analytics 整合

使用 Google Analytics 動作連接器，您可以透過自然語言直接在 Amazon Quick 中存取 Google Analytics。您可以執行報告、擷取受眾資料、監控關鍵事件，以及存取即時指標，而無需離開 Amazon Quick。

Amazon Quick 支援 Google Analytics 的多種身分驗證方法。選擇最適合您組織安全需求的方法。

  • 預設 OAuth 應用程式 – 使用 AWS受管 OAuth 應用程式。不需要額外的登入資料。您使用 Google 帳戶直接進行身分驗證。

  • 自訂 OAuth 應用程式 – 使用在 Google Cloud Console 中建立的客戶受管 OAuth 用戶端。此選項可讓您的組織完全控制 OAuth 組態。

如需 Amazon Quick 支援的身分驗證方法的詳細資訊，請參閱 身分驗證方法。

開始之前

在設定整合之前，請確定您有下列項目。

  • 可存取您要使用的 Google Analytics 屬性和資料的 Google 帳戶。

  • 對於自訂 OAuth 應用程式：存取 Google 網站上的 Google 雲端主控台，並具有建立 OAuth 用戶端的許可。

  • 如需 Amazon Quick 訂閱需求，請參閱 在主控台中設定整合。

設定 Google Cloud

如果您使用的是預設 OAuth 應用程式身分驗證，請略過本節並前往 在 Amazon Quick 中設定連接器。

對於自訂 OAuth 應用程式身分驗證，請先在 Google Cloud Console 中完成下列步驟，再設定 Amazon Quick。當您在步驟 3 中啟用 API 時，請搜尋並啟用 Google Analytics Data API。

在 Google Cloud Console 中建立 OAuth 用戶端

在 Google Cloud Console 中建立 OAuth 用戶端，以取得 Amazon Quick 所需的用戶端憑證。如需詳細資訊，請參閱 Google 網站上的使用 OAuth 2.0 存取 Google APIs。

  1. 在 Google 網站上登入 Google Cloud Console。

  2. 建立新的專案或選取現有的專案。

  3. 在左側導覽窗格中，選擇 APIs和服務，然後選擇程式庫。搜尋整合所需的 API，然後選擇啟用。

  4. 選擇 OAuth 同意畫面，然後選擇開始使用。

  5. 設定同意畫面：

    • 輸入應用程式名稱，然後選取使用者支援電子郵件。

    • 針對對象，選擇內部 （僅限您的組織） 或外部 （任何 Google 使用者）。

    • 新增開發人員聯絡詳細資訊，然後選擇建立。

  6. 選擇建立 OAuth 用戶端。

  7. 設定用戶端：

    • 針對應用程式類型，選擇 Web 應用程式。

    • 輸入用戶端的名稱。

    • 在授權重新導向 URIs下，新增 Amazon Quick 回呼 URL： https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

  8. 選擇建立。

  9. 記錄下列值。您在設定 Amazon Quick 時需要它們。

    • 用戶端 ID

    • Client secret (用戶端密碼)

建議範圍

當您連線到 Google Analytics 時，會請求以下範圍。

Google Analytics 建議的範圍
Scope (範圍) Description
https://www.googleapis.com/auth/analytics.readonly 讀取 Analytics 資料和組態。
https://www.googleapis.com/auth/analytics.edit 編輯 Analytics 組態和資料。
openid 驗證使用者的身分。
email 讀取使用者的電子郵件地址。
注意

openid 和 email範圍會自動包含在使用者身分驗證的 OAuth 同意流程中。Service-to-Service OAuth 不需要它們。

在 Amazon Quick 中設定連接器

從可用索引標籤連線

如果您想要使用預設 OAuth 應用程式身分驗證，您可以直接從可用索引標籤連線，而不需要其他組態。

  1. 在 Amazon Quick 主控台中，選擇連接器。

  2. 在可用索引標籤上，尋找 Google Analytics 並選擇連線。

  3. 完成 Google 登入流程並授予請求的許可。

若要改為使用自訂 OAuth 應用程式設定連接器，請使用為您的團隊建立索引標籤，如下所述。

從為您的團隊建立索引標籤建立

完成任何必要的 Google Cloud 組態後，請在 Amazon Quick 中建立連接器。

  1. 在 Amazon Quick 主控台中，選擇連接器。

  2. 選擇為您的團隊建立索引標籤。

  3. 尋找並選擇 Google Analytics。

    注意

    如果 Google Analytics 連接器已存在，則會顯示一個對話方塊，其中包含您現有的連接器。若要使用現有的連接器，請選擇它。若要建立新的，請選擇否，建立新的。

  4. 輸入連接器的名稱。或者，選擇 + 新增描述以新增描述。

  5. 針對連線類型，選擇公有網路。

  6. 針對 OAuth 組態，選擇下列其中一種身分驗證方法，並設定必要欄位。

    1. 對於預設 OAuth 應用程式：

      不需要額外的登入資料。選擇 Next (下一步) 繼續。

    2. 對於自訂 OAuth 應用程式，請設定下列欄位：

      • 基本 URL （選用） – Google Analytics API 基本 URL。範例：https://analyticsdata.googleapis.com

      • 用戶端 ID – 來自 Google Cloud OAuth 用戶端的用戶端 ID。

      • 用戶端秘密 – 來自 Google Cloud OAuth 用戶端的用戶端秘密。

      • 權杖 URL – 權杖端點。範例：https://oauth2.googleapis.com/token

      • 授權 URL – 授權端點。範例：https://accounts.google.com/o/oauth2/v2/auth

      • 重新導向 URL – 預先填入 Amazon Quick 回呼 URL。

  7. 選擇下一步。

  8. 如果您選擇預設 OAuth 應用程式或自訂 OAuth 應用程式，則會開啟 Google 授權視窗。檢閱請求的許可，然後選擇允許。

  9. 在檢閱頁面上，檢閱連接器的可用動作。選擇下一步。

  10. 在發佈頁面上，選擇誰可以存取連接器。您可以為組織中的每個人啟用存取權，或搜尋特定的團隊或群組。

  11. 選擇發布。

可用動作

設定連接器之後，可以使用下列動作。

Google Analytics 可用的動作
Category Action Description
報告 建立報告 執行屬性的報告。
報告 批次建立報告 在單一請求中執行多個報告。
報告 建立即時報告 執行屬性的即時報告。
報告 建立漏斗報告 執行屬性的漏斗報告。
對象 列出對象 列出屬性的對象。
對象 建立對象清單 建立要匯出的對象清單。
對象 列出對象清單 列出屬性的對象清單。
對象 取得對象清單 從對象清單中擷取資料。
對象 建立對象匯出 建立對象匯出。
對象 取得對象匯出 從對象匯出擷取資料。
帳戶 列出帳戶摘要 列出使用者可存取的帳戶摘要。
帳戶 列出帳戶 列出使用者可存取的所有帳戶。
帳戶 取得帳戶 擷取特定帳戶的詳細資訊。
Properties 取得屬性 擷取特定屬性的詳細資訊。
Properties 搜尋屬性 使用篩選搜尋屬性。
Properties 取得屬性配額 擷取屬性的配額用量。
事件 列出金鑰事件 列出屬性的關鍵事件 （轉換）。
中繼資料 取得中繼資料 擷取可用的維度和指標以進行報告。
中繼資料 取得相容性 檢查報告的維度和指標相容性。
註釋 列出註釋 列出屬性的報告資料註釋。
注意

您可以使用的動作取決於已驗證使用者可存取的 Analytics 屬性和帳戶。

管理和疑難排解

若要編輯、共用或刪除連接器，請參閱 管理現有的整合。

常見的 Google 身分驗證問題

  • 登入失敗 （預設 OAuth 應用程式或自訂 OAuth 應用程式） – 確認您的 Google 帳戶處於作用中狀態，而且您可以直接登入 Google 網站。對於自訂 OAuth 應用程式，請確認 Google Cloud OAuth 用戶端中的重新導向 URI 符合 Amazon Quick 回呼 URL。

  • 管理員封鎖的應用程式 – 如果您的 Google Workspace 管理員限制第三方應用程式存取，您可能會在嘗試登入時看到錯誤。請聯絡您的 Google Workspace 管理員以允許 Amazon Quick 應用程式。

  • 無效用戶端登入資料 （自訂 OAuth 應用程式） – 驗證用戶端 ID 和用戶端秘密是否符合 Google Cloud OAuth 用戶端中的值。

  • 身分驗證快顯視窗失敗 – 驗證您的瀏覽器是否允許來自 Amazon Quick 主控台網域的快顯視窗。請嘗試使用不同的瀏覽器或清除瀏覽器快取。

  • 已撤銷許可 – 如果您先前已撤銷 Google 帳戶許可設定的 Amazon Quick 存取權，則需要透過編輯連接器並重新登入來重新驗證。

  • Google API 速率限制 – Google 可能會在高用量期間限制請求。如果動作失敗，請在幾分鐘後重試。

Google Analytics 特定問題

  • 未啟用 Google Analytics Data API – 確認 Google Cloud 專案中的 API & Services， Library 下已啟用 Google Analytics Data APIs。

  • 未顯示任何屬性 – 驗證已驗證的 Google 帳戶可存取您要查詢的 Google Analytics 屬性。