設定Amazon S3以取得對象來源
瞭解如何在Adobe Real-Time CDP Collaboration UI中設定並連線您的Amazon S3儲存空間,以取得對象資料以進行啟用和重疊分析。
如需逐步設定指示,請參閱**設定對象來源的AWS許可權**指南。
概觀 overview
使用此工作流程直接從Amazon S3取得及管理第一方對象。 完成設定後,Collaboration會自動從S3貯體取得受眾,並供深入分析和啟用之用。
透過S3取得的對象會遵循與透過Adobe Experience Platform取得的對象相同的治理和資料處理規則。
先決條件 prerequisites
在設定S3資料連線之前,請確定下列事項:
-
您可以存取包含符合 Amazon S3對象來源規格(v1.1) 之對象檔案的有效貯體。
-
您已在AWS中建立IAM角色,授予Adobe使用 假設的角色 方法(非存取/密碼金鑰)存取貯體的許可權。 如需詳細指示,請參閱設定對象來源的AWS許可權。 IAM角色必須包含下列許可權:
ListBucketGetBucketLocationGetObject
-
您已準備好下列值:
- IAM角色Amazon資源名稱(ARN)
- S3 bucket名稱
- 資料夾路徑 (包含對象檔案的目錄前置詞)
設定您的Amazon S3連線 configure-aws-s3-connection
從 設定 工作區中的 我的對象 索引標籤中,選取新增圖示(
如果這是您的第一個對象,您也可以選取 新增 選項。
「新增對象」工作流程隨即顯示。 選取新增資料連線,然後選取下一步。
選取Amazon S3作為資料連線 select-aws-s3
選取 Amazon S3 作為資料連線,接著選取下一步。
檢閱對象檔案需求 review-audience-requirements
會出現一個對話方塊,說明您的對象檔案必須如何建構。 使用指向 對象來源規格 的連結來瞭解如何格式化和建構來自Amazon S3的對象資料,以便Collaboration正確讀取。
您的對象檔案必須符合「對象來源規格」。 比對索引鍵會根據所需的格式自動對應。
主要考量事項包括:
- 檔案必須是CSV格式,使用逗號作為分隔符號,並使用直立線符號(
|)表示多個值。 - 如果上傳多個檔案,請確定所有檔案都包含相同的欄。
- 每個對象記錄都必須包含
AUDIENCE_ID和至少一個比對索引鍵,例如HASHED_EMAIL_SHA_256、HASHED_PHONE_SHA_256、HASHED_IPV4_SHA_256、CRM_ID、LOYALTY_ID或ADFIXUS_ID。 - 在Collaboration中設定sourcing期間,資料會根據您的選擇每1-6天重新整理一次。
驗證您的S3連線 authenticate-s3-connection
接下來,提供您的Amazon S3認證,以將您的S3貯體連線至Collaboration。
請依照 設定對象來源的AWS許可權 中概述的步驟,將Adobe存取權授予
Amazon S3儲存空間。 完成後,將您的值輸入到以下UI欄位中:
- IAM 角色
- S3 Bucket名稱
- 資料夾路徑
確認同意確認 confirm-consent
在繼續之前,您必須先確認同意選擇退出已移除。 核取確認方塊,然後按一下 確定 確認。
驗證驗證結果 validate-authentication
連線之後,系統會驗證您的憑證並顯示下列其中一則訊息:
提供連線詳細資料 provide-connection-details
為您的S3資料連線輸入描述性名稱和選擇性說明。 將您的值輸入到下列UI欄位中:
- 資料連線名稱 (必要)
- 資料連線描述 (選擇性)
檢閱自動對應的身分欄位 auto-mapped-fields
對應畫面是唯讀的。 您無法新增、刪除或套用轉換。 Collaboration會根據對象來源規格,自動將對象檔案中的來源身分欄位對應到目標欄位。
以視覺化方式確認對應的欄位,並選取 下一步 以繼續。
排程重新整理頻率和日期範圍 schedule-refresh
排程檢視出現。 使用下拉式功能表選取一到六天之間的重新整理頻率,然後設定作用中的日期範圍。 使用日曆圖示指定開始和結束日期。
檢閱並完成連線 review-and-complete
最後,在摘要畫面中檢閱您的組態設定。 此檢視包含下列區段的摘要:
- 資料連線:顯示您設定的IAM角色、S3 Bucket名稱和資料夾路徑。
- 詳細資料:顯示資料連線的名稱和選擇性說明,以便稍後識別。
- 對應:列出已上傳對象檔案(例如
HASHED_EMAIL)中的來源欄位如何對應到Collaboration中使用的目標欄位(例如,雜湊電子郵件)。 - 排程:摘要連線重新整理對象資料的頻率,以及來源的有效日期範圍。
如需編輯區段,請選取鉛筆圖示。 選取 完成 以確認所有區段。
系統會顯示對話方塊確認,指出已成功建立資料連線,且正在尋找對象。
檢閱來源對象 review-sourced-audiences
完成設定後,Collaboration會開始從S3貯體取得受眾。 透過Amazon S3貯體取得的對象會顯示在「我的對象」標籤中,且具有與來自Experience Platform之對象相同的功能和資訊。
如果對象來源正在進行中,畫面頂端會顯示橫幅。 個別對象只會在來源完成之後顯示。
取得S3對象的來源後,表格或卡片檢視就會提供您的可用對象清單。
在網格檢視或表格檢視中,選取列專案或 檢視對象 以檢視特定對象的概觀。 它會顯示對象的狀態、來源和資料連線名稱,以及下列專案的詳細面板:
身分:顯示資料可供使用時的身分計數和劃分總數。
類別:列出用於組織或篩選對象的任何標籤。
連線存取:指出對象是私人、公開或與特定共同作業人員共用。
中繼資料可見性:定義共同作業人員可看到的對象資訊(例如身分計數、重疊百分比和索引)。
在共同作業專案中使用對象之前,使用此檢視來確認對象組態和可見度設定。
請參閱檢視對象儀表板檔案以瞭解更多資訊。
檢視您的S3資料連線 view-s3-connection
您新增的Amazon S3連線立即可在 我的資料連線 索引標籤中使用。 對象來源顯示為Amazon S3。
您的S3資料連線包含與其他對象資料連線相同的功能和詳細資料,但您無法直接從此檢視新增或編輯對象。
後續步驟 next-steps
您現在已成功設定並連線您的Amazon S3儲存體作為Collaboration中的資料來源。 透過完成此工作流程,您啟用第一方對象資料的安全來源,以進行啟用和重疊分析。
來源完成之後,您的對象會出現在 我的對象 工作區中,準備共同作業和啟動。 如需詳細管理選項,請參閱來源及管理對象檔案。