設定Amazon S3以取得對象來源

瞭解如何在Adobe Real-Time CDP Collaboration UI中設定並連線您的Amazon S3儲存空間,以取得對象資料以進行啟用和重疊分析。

IMPORTANT
在遵循本指南之前,您必須先完成在AWS帳戶中授權Adobe IAM角色的步驟。
如需逐步設定指示,請參閱​**設定對象來源的AWS許可權**​指南。

概觀 overview

使用此工作流程直接從Amazon S3取得及管理第一方對象。 完成設定後,Collaboration會自動從S3貯體取得受眾,並供深入分析和啟用之用。

透過S3取得的對象會遵循與透過Adobe Experience Platform取得的對象相同的治理和資料處理規則。

先決條件 prerequisites

在設定S3資料連線之前,請確定下列事項:

  • 您可以存取包含符合​ Amazon S3對象來源規格(v1.1) ​之對象檔案的有效​貯體

  • 您已在AWS中建立​IAM角色,授予Adobe使用​ 假設的角色 ​方法(非存取/密碼金鑰)存取貯體的許可權。 如需詳細指示,請參閱​設定對象來源的AWS許可權。 IAM角色必須包含下列許可權:

    • ListBucket
    • GetBucketLocation
    • GetObject
  • 您已準備好下列值:

    • IAM角色Amazon資源名稱(ARN)
    • S3 bucket名稱
    • 資料夾路徑 (包含對象檔案的目錄前置詞)
NOTE
對象檔案必須位於授權S3儲存貯體的​ 根資料夾路徑 ​中。 不支援子資料夾結構。

設定您的Amazon S3連線 configure-aws-s3-connection

從​ 設定 ​工作區中的​ 我的對象 ​索引標籤中,選取新增圖示( 新增圖示。 ),然後選取​對象

如果這是您的第一個對象,您也可以選取​ 新增 ​選項。

設定工作區中的「我的對象」索引標籤,其中顯示「新增」圖示和「新增對象」選項。

「新增對象」工作流程隨即顯示。 選取​新增資料連線,然後選取​下一步

反白顯示[新增資料連線]選項的[新增對象]工作區。 {modal="regular"}

選取Amazon S3作為資料連線 select-aws-s3

選取​ Amazon S3 ​作為資料連線,接著選取​下一步

具有Amazon S3的資料連線選取畫面可作為選取選項使用。

檢閱對象檔案需求 review-audience-requirements

會出現一個對話方塊,說明您的對象檔案必須如何建構。 使用指向​ 對象來源規格 ​的連結來瞭解如何格式化和建構來自Amazon S3的對象資料,以便Collaboration正確讀取。

IMPORTANT
您必須已授權Adobe為Amazon S3使用者,Adobe才能從Amazon S3儲存空間中擷取資料以進行處理。

您的對象檔案必須符合「對象來源規格」。 比對索引鍵會根據所需的格式自動對應。

主要考量事項包括:

  • 檔案必須是CSV格式,使用逗號作為分隔符號,並使用直立線符號(|)表示多個值。
  • 如果上傳多個檔案,請確定所有檔案都包含相同的欄。
  • 每個對象記錄都必須包含AUDIENCE_ID和至少一個比對索引鍵,例如HASHED_EMAIL_SHA_256HASHED_PHONE_SHA_256HASHED_IPV4_SHA_256CRM_IDLOYALTY_IDADFIXUS_ID
  • 在Collaboration中設定sourcing期間,資料會根據您的選擇每1-6天重新整理一次。

準備資料以進行Sourcing對話方塊,其中包含Audience Sourcing規格的連結。

驗證您的S3連線 authenticate-s3-connection

接下來,提供您的Amazon S3認證,以將您的S3貯體連線至Collaboration。

請依照​ 設定對象來源的AWS許可權 ​中概述的步驟,將Adobe存取權授予
Amazon S3儲存空間。 完成後,將您的值輸入到以下UI欄位中:

  • IAM 角色
  • S3 Bucket名稱
  • 資料夾路徑

具有IAM角色、S3 Bucket名稱和資料夾路徑欄位的Amazon S3連線表單。

在繼續之前,您必須先確認同意選擇退出已移除。 核取確認方塊,然後按一下​ 確定 ​確認。

同意選擇退出確認對話方塊,需要確認才能繼續。

驗證驗證結果 validate-authentication

連線之後,系統會驗證您的憑證並顯示下列其中一則訊息:

狀態
訊息
說明
成功
驗證成功
您與Amazon S3的連線已成功建立。
已失敗
驗證失敗
請檢查您的認證,然後再試一次。
拒絕存取
拒絕存取
您的認證沒有存取此Amazon S3儲存貯體的必要許可權。 請驗證存取設定,或連絡您的管理員。
無效的檔案格式
無效的檔案格式
對象資料不符合預期結構。 請確定您的檔案符合「對象來源規格」。
找不到對象檔案
找不到對象檔案
請確認您的對象檔案存在於指定的資料夾路徑中,以及該路徑可供存取。
內部錯誤
發生內部錯誤
請重試。 如果問題仍然存在,請聯絡客戶支援。

提供連線詳細資料 provide-connection-details

為您的S3資料連線輸入描述性名稱和選擇性說明。 將您的值輸入到下列UI欄位中:

  • 資料連線名稱 (必要)
  • 資料連線描述 (選擇性)

資料連線詳細資料表單,其中包含連線名稱和說明的欄位。

檢閱自動對應的身分欄位 auto-mapped-fields

對應​畫面是唯讀的。 您無法新增、刪除或套用轉換。 Collaboration會根據對象來源規格,自動將對象檔案中的來源身分欄位對應到目標欄位。

以視覺化方式確認對應的欄位,並選取​ 下一步 ​以繼續。

顯示自動對應來源與目標識別欄位的欄位對應畫面。

排程重新整理頻率和日期範圍 schedule-refresh

排程​檢視出現。 使用下拉式功能表選取一到六天之間的重新整理頻率,然後設定作用中的日期範圍。 使用日曆圖示指定開始和結束日期。

IMPORTANT
為了有效管理您的Collaboration積分,請將重新整理頻率設定為符合或超過基礎S3資料的更新頻率。 支援的最低重新整理間隔是每六天一次。

排程設定畫麵包含重新整理頻率選項和日期範圍設定。

檢閱並完成連線 review-and-complete

最後,在摘要畫面中檢閱您的組態設定。 此檢視包含下列區段的摘要:

  • 資料連線:顯示您設定的IAM角色、S3 Bucket名稱和資料夾路徑。
  • 詳細資料:顯示資料連線的名稱和選擇性說明,以便稍後識別。
  • 對應:列出已上傳對象檔案(例如HASHED_EMAIL)中的來源欄位如何對應到Collaboration中使用的目標欄位(例如,雜湊電子郵件)。
  • 排程:摘要連線重新整理對象資料的頻率,以及來源的有效日期範圍。

如需編輯區段,請選取鉛筆圖示。 選取​ 完成 ​以確認所有區段。

檢閱摘要畫面會顯示資料連線、詳細資料、對應及排程區段。

系統會顯示對話方塊確認,指出已成功建立資料連線,且正在尋找對象。

檢閱來源對象 review-sourced-audiences

完成設定後,Collaboration會開始從S3貯體取得受眾。 透過Amazon S3貯體取得的對象會顯示在「我的對象」標籤中,且具有與來自Experience Platform之對象相同的功能和資訊。

如果對象來源正在進行中,畫面頂端會顯示橫幅。 個別對象只會在來源完成之後顯示。

「對象」標籤顯示Amazon S3個對象正在進行來源取得。

取得S3對象的來源後,表格或卡片檢視就會提供您的可用對象清單。

TIP
對象來源時間會因S3資料大小和您設定的重新整理頻率而有所不同。 較大的資料集或不太頻繁的重新整理排程可能需要更長的時間才會出現在​ 我的對象 ​工作區中。

「對象」標籤顯示來源對象的表格清單。

在網格檢視或表格檢視中,選取列專案或​ 檢視對象 ​以檢視特定對象的概觀。 它會顯示對象的狀態、來源和資料連線名稱,以及下列專案的詳細面板:

身分:顯示資料可供使用時的身分計數和劃分總數。
類別:列出用於組織或篩選對象的任何標籤。
連線存取:指出對象是私人、公開或與特定共同作業人員共用。
中繼資料可見性:定義共同作業人員可看到的對象資訊(例如身分計數、重疊百分比和索引)。

在共同作業專案中使用對象之前,使用此檢視來確認對象組態和可見度設定。

請參閱檢視對象儀表板檔案以瞭解更多資訊。

檢視您的S3資料連線 view-s3-connection

您新增的Amazon S3連線立即可在​ 我的資料連線 ​索引標籤中使用。 對象來源顯示為Amazon S3。

您的S3資料連線包含與其他對象資料連線相同的功能和詳細資料,但您無法直接從此檢視新增或編輯對象。

NOTE
Amazon S3個資料連線無法編輯。 建立連線後,就無法修改設定,例如重新整理頻率。 若要更新組態,您必須刪除現有的連線並建立新的連線。

我的資料連線標籤顯示Amazon S3資料連線,其中包含sourcing狀態資訊。

後續步驟 next-steps

您現在已成功設定並連線您的Amazon S3儲存體作為Collaboration中的資料來源。 透過完成此工作流程,您啟用第一方對象資料的安全來源,以進行啟用和重疊分析。

來源完成之後,您的對象會出現在​ 我的對象 ​工作區中,準備共同作業和啟動。 如需詳細管理選項,請參閱來源及管理對象檔案

recommendation-more-help
ba510b24-e0c6-47a6-8a56-d8f75bb36627