Google Cloud Storage個連線

概觀 overview

建立與Google Cloud Storage的即時輸出連線,以定期從Adobe Experience Platform將資料檔案匯出到您自己的貯體。

透過API或UI連線至您的Google Cloud Storage儲存空間 connect-api-or-ui

  • 若要使用Platform使用者介面連線到您的Google Cloud Storage儲存位置,請閱讀以下章節: 連線到目的地以及啟用對象到此目的地
  • 若要以程式設計方式連線至您的Google Cloud Storage儲存位置,請使用「流程服務API」教學課程🔗,讀取將對象啟用至檔案型目的地。

支援的對象 supported-audiences

本節說明您可以將哪些型別的對象匯出至此目的地。

對象來源
支援
說明
Segmentation Service
✓ (A)
透過Experience Platform細分服務產生的對象。
自訂上傳
✓ (A)
對象從CSV檔案匯入至Experience Platform。

匯出型別和頻率 export-type-frequency

請參閱下表以取得目的地匯出型別和頻率的資訊。

項目
類型
附註
匯出類型
以設定檔為基礎
您正在匯出區段的所有成員,以及適用的結構描述欄位,如目的地啟用工作流程的選取設定檔屬性畫面中所選。
匯出頻率
批次
批次目的地會以三、六、八、十二或二十四小時的增量將檔案匯出至下游平台。 深入瞭解批次檔案型目的地

匯出資料集 export-datasets

此目的地支援資料集匯出。 如需如何設定資料集匯出的完整資訊,請閱讀教學課程:

  • 如何使用Platform使用者介面🔗匯出資料集。
  • 如何使用流程服務API🔗以程式設計方式匯出資料集。

匯出資料的檔案格式 file-format

匯出​ 對象資料 ​時,Platform會在您提供的儲存位置中建立.csvparquet.json檔案。 如需檔案的詳細資訊,請參閱對象啟動教學課程中的匯出支援的檔案格式一節。

匯出​ 資料集 ​時,Platform會在您提供的儲存位置中建立.parquet.json檔案。 如需檔案的詳細資訊,請參閱匯出資料集教學課程中的驗證資料集匯出成功區段。

連線您的Google Cloud Storage帳戶的先決條件設定 prerequisites

若要將Platform連線到Google Cloud Storage,您必須先為您的Google Cloud Storage帳戶啟用互通性。 若要存取互通性設定,請開啟Google Cloud Platform,然後從導覽面板的​ 雲端儲存空間 ​選項中選取​ 設定

Google Cloud Platform儀表板,強調顯示雲端儲存空間與設定。

設定 ​頁面隨即顯示。 從這裡,您可以檢視有關您的Google專案ID的資訊,以及有關您的Google Cloud Storage帳戶的詳細資料。 若要存取互通性設定,請從頂端標頭選取​ 互通性

Google Cloud Platform儀表板中反白顯示的[互通性]索引標籤。

互通性 ​頁面包含驗證、存取金鑰以及與您的服務帳戶關聯的預設專案的資訊。 若要為您的服務帳戶產生新的存取金鑰ID和機密存取金鑰,請選取​ 為服務帳戶建立金鑰

在Google Cloud Platform儀表板中反白顯示的服務帳戶控制項的建立金鑰。

您可以使用新產生的存取金鑰ID和機密存取金鑰,將您的Google Cloud Storage帳戶連線至Platform。

連線到目標 connect

IMPORTANT
若要連線到目的地,您需要​ 檢視目的地 ​和​ 管理目的地 存取控制許可權。 閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。

若要連線到此目的地,請依照目的地組態教學課程中所述的步驟進行。 在目標設定工作流程中,填寫以下兩個區段中列出的欄位。

驗證目標 authenticate

若要驗證到目的地,請填入必填欄位,然後選取​ 連線到目的地

  • 存取金鑰識別碼:用於向Platform驗證您的Google Cloud Storage帳戶的61個字元英數字串。 如需如何取得此值的詳細資訊,請閱讀上述必要條件區段。

  • 秘密存取金鑰:用於向Platform驗證您的Google Cloud Storage帳戶的40個字元base64編碼字串。 如需如何取得此值的詳細資訊,請閱讀上述必要條件區段。

  • 加密金鑰:您可以選擇附加RSA格式的公開金鑰,將加密新增至匯出的檔案。 在下圖中檢視格式正確的加密金鑰範例。

    影像顯示UI中格式正確的PGP金鑰範例

如需這些值的詳細資訊,請參閱Google雲端儲存空間HMAC金鑰指南。 如需如何產生您自己的存取金鑰ID和秘密存取金鑰的步驟,請參閱Google Cloud Storage 來源概觀

填寫目標詳細資訊 destination-details

若要設定目的地的詳細資訊,請填寫下方的必填和選用欄位。 UI中欄位旁的星號表示該欄位為必填欄位。

  • 名稱:填寫此目的地的偏好名稱。

  • 描述:選擇性。 例如,您可以提及要將此目的地用於哪個行銷活動。

  • Bucket名稱:輸入要由此目的地使用的Google Cloud Storage儲存貯體的名稱。

  • 資料夾路徑:輸入目的地資料夾的路徑,此資料夾將裝載匯出的檔案。

  • 檔案型別:選取匯出檔案應使用的格式Experience Platform。 選取CSV選項時,您也可以設定檔案格式選項

  • 壓縮格式:選取Experience Platform應用於匯出檔案的壓縮型別。

  • 包含資訊清單檔案:如果您想要匯出包含資訊清單JSON檔案,其中包含有關匯出位置、匯出大小等資訊,請開啟此選項。 資訊清單的命名格式為manifest-<<destinationId>>-<<dataflowRunId>>.json。 檢視範例資訊清單檔案。 資訊清單檔案包含下列欄位:

    • flowRunId:產生匯出檔案的資料流執行
    • scheduledTime:檔案匯出的時間(UTC)。
    • exportResults.sinkPath:存放匯出檔案之存放位置中的路徑。
    • exportResults.name:匯出的檔案名稱。
    • size:匯出的檔案大小(位元組)。

啟用警示 enable-alerts

您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊,請參閱使用UI訂閱目的地警示的指南。

當您完成提供目的地連線的詳細資訊後,請選取​ 下一步

必要的Google Cloud Storage許可權 required-google-cloud-storage-permission

若要成功連線並匯出資料至您的Google Cloud Storage儲存位置,您需要儲存貯體的下列Google Cloud Storage許可權:

  • orgpolicy.policy.get
  • resourcemanager.projects.get
  • resourcemanager.projects.list
  • storage.managedFolders.create
  • storage.multipartUploads.abort
  • storage.multipartUploads.create
  • storage.multipartUploads.listParts
  • storage.objects.create
  • storage.objects.list

深入瞭解Google Cloud Storage中的存取控制與許可權

啟動此目標的對象 activate

IMPORTANT
  • 若要啟用資料,您需要​ 檢視目的地啟用目的地檢視設定檔 ​和​ 檢視區段 存取控制許可權。 閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。
  • 若要匯出​ 身分,您需要​ 檢視身分圖表 存取控制許可權
    選取工作流程中反白的身分名稱空間,以啟用目的地的對象。 {width="100" modal="regular"}

請參閱啟用對象資料至批次設定檔匯出目的地,以取得啟用對象至此目的地的指示。

正在排程

在​ 排程 ​步驟中,您可以為您的Google Cloud Storage目的地設定匯出排程,也可以設定匯出檔案的名稱

對應屬性和身分 map

在​ 對應 ​步驟中,您可以選取要為設定檔匯出的屬性和身分欄位。 您也可以選取將匯出檔案中的標題變更為任何您想要的易記名稱。 如需詳細資訊,請參閱啟動批次目的地UI教學課程中的對應步驟

驗證資料匯出成功 exported-data

若要驗證是否已成功匯出資料,請檢查您的Google Cloud Storage貯體,並確定匯出的檔案包含預期的設定檔母體。

IP位址允許清單 ip-address-allow-list

如果您需要將AdobeIP新增至允許清單,請參閱IP位址允許清單文章。

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6