文件Experience PlatformReal-Time CDP Collaboration

[有限可用性]{class="badge informative"}

設定Google Cloud Storage以取得對象來源

最後更新： 2026年4月14日

請依照本指南中的步驟，將您的Google Cloud Storage (GCS)貯體連線至Adobe Real-Time CDP Collaboration，並開始透過UI取得第一方對象資料。

將GCS貯體連線到Collaboration以直接擷取第一方受眾資料，無需工程支援。 在連線後，Collaboration會根據週期性排程從您的貯體中取得對象，並讓這些對象可在您的共同作業專案中用於啟用和重疊分析。 您必須先將對象來源化，才能加以啟用，或在與共同作業人員的重疊分析中使用對象。

本指南涵蓋端對端設定工作流程：準備先決條件、驗證您的GCS貯體、檢閱自動對應的身分欄位、排程資料重新整理，以及確認來源已成功完成。

來源為Google Cloud Storage的對象會遵循與來源為Adobe Experience Platform的對象相同的治理和資料處理規則。

其他可用的來源方法包括Experience Platform、Amazon S3、Snowflake和CSV檔案上傳。

先決條件 prerequisites

請先完成本節中的所有專案，再開始設定工作流程。 不完整的先決條件是最常見的原因，包括設定失敗或對象在來源後未出現。 在遵循本指南之前，您必須已完成帳戶上線和設定。

本節中的某些步驟需要由Google Cloud管理員執行動作。 如果您不是組織的Google Cloud管理員，請在開始之前識別適當的人員。

GCS存取和許可權 gcs-access-permissions

NOTE
涵蓋此整合所需的特定Google Cloud個IAM角色、服務帳戶設定和貯體層級許可權的專屬指南正在等候發佈。 在該指南可用之前，請與您的Google Cloud管理員合作，確認Adobe具有針對您的貯體進行驗證並讀取受眾檔案所需的許可權。

繼續之前，請向您的Google Cloud管理員確認下列事項：

  • Adobe已獲得對您的GCS貯體進行驗證和讀取受眾檔案所需的許可權。
  • Google Cloud Storage對象來源可在您的地區使用。 供應情況因地區而異（北美地區、歐洲、中東和非洲地區、澳新地區）。 如果您所在地區尚未提供GCS來源，請聯絡您的Adobe客戶代表以確認時間表。

準備您的對象資料 prepare-audience-data

您的對象檔案必須符合​對象來源規格(v1.2)，來源才會開始。 檢閱完整結構描述定義和欄位層級範例的規格。 主要需求包括：

  • 檔案格式： CSV，使用逗號作為欄位分隔符號，使用直立線符號(|)作為單一欄位中多個值的分隔符號。
  • 必要欄位：​每個記錄都必須包含AUDIENCE_ID欄和至少一個支援的相符索引鍵欄。
  • 支援的相符金鑰： HASHED_EMAIL_SHA_256，HASHED_PHONE_SHA_256，HASHED_IPV4_SHA_256，CRM_ID，LOYALTY_ID，ADFIXUS_ID。
  • 雜湊需求：​所有相符索引鍵值在上傳前都必須經過修剪、小寫和SHA256雜湊。 Collaboration不會在內嵌前將資料雜湊或標準化。
  • 資料行一致性：​如果您的儲存貯體包含多個對象檔案，則所有檔案必須使用相同的資料行結構。

對象檔案中存在的所有相符金鑰也必須為您的Collaboration帳戶啟用。 若要新增或啟用比對金鑰，請參閱設定比對金鑰。

開始前所需的值 required-values

在啟動設定精靈之前，請先準備好下列值。

值
說明
貯體
包含您的對象檔案的Google Cloud Storage儲存貯體的名稱。
路徑
儲存對象檔案之貯體中的路徑前置詞（例如，sourcing/testdata/path1/）。

設定您的Google Cloud Storage連線 configure-gcs-connection

設定工作流程是​ 設定 ​工作區內的多步驟精靈。 依序完成每個步驟。 在建立連線之前，您可以使用最終稽核畫面上的鉛筆圖示返回任何步驟。

新增資料連線 add-data-connection

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

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

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

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

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

選取Google Cloud Storage作為資料來源 select-gcs

資料來源選取畫面會列出所有可用的連線型別。 選取​Google雲端儲存空間，然後選取​下一步。

此新增對象工作流程會顯示資料來源選取畫面，其中已選取Google雲端儲存空間，並反白顯示「下一步」。

先決條件對話方塊會出現，概述必要的設定步驟（例如GCS貯體設定和IAM角色指派），並注意資料必須符合​對象來源規格。 選取​ 開始上線 ​以確認合規性，然後再繼續。

「準備您的GCS儲存貯體供上線」強制回應清單的先決條件，包括建立GCS儲存貯體、設定Adobe的IAM存取權，以及遵守「對象來源規格」，並提供「取消」和「開始上線」選項。

輸入您的Google Cloud Storage連線詳細資料 authenticate-gcs-connection

提供允許Collaboration存取您的Google Cloud Storage儲存貯體所需的詳細資料。 輸入必要資訊後，選取​下一步。

欄位
說明
貯體
您的Google Cloud Storage儲存貯體的名稱。 檢視開始🔗前所需的值。
路徑
儲存對象檔案之貯體中的路徑前置詞。

此新增對象工作流程會顯示Google Cloud Storage驗證表單（含貯體名稱和資料夾路徑欄位），以及下一步按鈕。

您必須確認已從對象資料中移除同意退出選項，Collaboration才能處理。 如果您不確定您的資料是否符合此要求，請先檢閱治理原則與執行動作指南，再繼續進行。 選取確認核取方塊，然後選取​ 確定 ​以繼續。

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

輸入此資料連線的名稱和說明（選擇性）。 您提供的名稱會顯示在​ 我的資料連線 ​標籤中，如果您管理多個資料連線，此名稱有助於區分此來源。

  • 資料連線名稱 （必要）
  • 資料連線描述 （選擇性）。

選取​ 「下一步」 ​以繼續。

在「提供詳細資料」步驟中新增對象工作流程，其中顯示資料連線名稱和資料連線說明的欄位已填入範例值，右上角顯示「下一步」。

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

對應​畫面是唯讀的。 Collaboration會根據「對象來源規格」中定義的欄名稱，自動將來源身分欄位從對象檔案對應至目標欄位。 您無法在此階段新增、移除或套用轉換至對應的欄位。

TIP
選取​ 預覽來源資料 ​以表格格式檢閱對象資料的範例，然後選取​ 關閉 ​以返回對應畫面。

此「GCS資料預覽」對話方塊顯示對象資料的範例表格，其中包含AUDIENCEID和HASHEDEMAILSHA256等欄，以及右下角的「關閉」按鈕。 {modal="regular"}

確認顯示的對應反映對象檔案中的欄位。 如果不符合，請先停止並修正您的檔案，使其符合Audience Sourcing規格，然後再繼續。 選取​ 「下一步」 ​以繼續。

在「對應欄位」步驟中新增對象工作流程，顯示自動對應的來源欄位（AUDIENCEID和HASHEDEMAILSHA256）以鎖定身分欄位，並顯示「預覽來源資料」選項和右上角的「下一步」按鈕。

排程資料重新整理 schedule-data-refresh

在​ 排程 ​檢視中，設定Collaboration從您的GCS貯體中擷取更新對象資料的頻率，並定義來源的有效日期範圍。

使用​ 頻率 ​下拉式清單來選取Collaboration從GCS貯體中擷取更新對象資料的頻率。 可用的間隔範圍從​ 每日 ​到​每6天。

在輸入欄位中輸入日期範圍，或選取行事曆圖示以設定作用中來源期間的​ 開始日期 ​和​結束日期。 到達結束日期時，來源會停止，且先前來源的對象會過期，而無法用於共同作業專案。

IMPORTANT
將重新整理頻率設定為符合或不超過您的基礎GCS對象資料的更新速率。 支援的最低重新整理間隔是每六天一次。 重新整理的頻率高於資料變更的頻率，會消耗Collaboration積分，而不會產生更新的結果。 若要監視您的信用使用情況，請參閱追蹤您的信用消耗活動。

在「排程」步驟中新增對象工作流程，此步驟顯示「頻率」下拉式清單已設定為週期性間隔，且行事曆日期範圍選擇器有反白顯示的開始和結束日期。 「下一步」會顯示在右上角。

選取​ 「下一步」 ​以繼續。

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

在建立連線之前，請先檢閱組態摘要。 摘要畫面會顯示下列區段：

  • 資料連線：您設定的GCS儲存貯體認證和資料夾路徑。
  • 詳細資料：此資料連線的名稱和選擇性描述。
  • 對應：自動對應的來源和目標識別欄位。
  • 排程：重新整理頻率和作用中的日期範圍。

在「檢閱」步驟中新增對象工作流程，其中會顯示資料連線、詳細資料、對應及排程區段與設定值的摘要，以及右上角顯示的「完成」按鈕。

選取鉛筆圖示（ 鉛筆圖示。） ，即可返回該步驟並進行變更。 當所有區段都正確時，請選取​完成。

確認對話方塊隨即顯示，指出Collaboration已建立資料連線，且對象來源正在進行中。

檢閱來源對象 review-sourced-audiences

在您完成設定精靈後，Collaboration會開始以非同步方式從GCS貯體取得受眾。 瀏覽至​設定 > 我的對象​以監視進度。 來源不會立即完成；所需時間取決於資料大小和設定的重新整理頻率。

監控對象來源進度 monitor-sourcing-progress

當Collaboration擷取您的對象資料時，我的對象​工作區頂端的橫幅會指出來源補充正在進行中。 個別對象只有在每個對象的sourcing完成後才會出現在清單中。

​ 「我的對象」標籤上的設定工作區會顯示「對象來源正在進行」橫幅，指出對象是從Google雲端儲存空間資料連線取得，且對象清單顯示如下。

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

檢視來源對象詳細資料 view-audience-details

來源補充完成後，您的Google Cloud Storage對象會與其他連線來源的對象一起出現在​ 我的對象 ​標籤中。 選取列專案或​ 檢視對象 ​以開啟特定對象的詳細資料檢視。

設定工作區中的「我的對象」索引標籤會顯示對象表格，包含來源為Google雲端儲存空間的對象，且有可選取的核取方塊和可用的列動作。

詳細資料檢視會顯示對象的狀態、來源和資料連線名稱，以及下列面板：

  • 身分：資料可供使用時，對象的身分計數和劃分總數。
  • 類別：任何套用於組織或篩選對象的標籤。
  • 連線存取：對象是私人、公開或與特定共同作業人員共用。
  • 中繼資料可見性：共同作業人員可看見哪些對象資訊，例如身分計數、重疊百分比和索引。

個別對象詳細資料檢視顯示「狀態：作用中」、頂端有來源系統，且有資料連線名稱，下方有四個面板：顯示身分計數和劃分的身分、顯示套用標籤的類別、顯示對象型別和可見性的連線存取，以及顯示身分計數、重疊百分比和對象索引設定的中繼資料可見性。

在共同作業專案中使用對象之前，請先檢閱這些設定。 若要更新類別、連線存取權或中繼資料可見度，請參閱檢視和管理個別對象。

編輯對象設定 edit-audience-settings

您可以直接從​ 我的對象 ​清單檢視編輯對象中繼資料，而不需開啟詳細資料檢視。 選取對象的核取方塊以顯示動作工具列，然後選取動作： 編輯中繼資料可見度、編輯連線存取權、編輯名稱和描述、編輯類別​或​刪除。

「我的對象」清單檢視會顯示兩個對象 — 一個來源於Adobe Experience Platform，一個來源於Google Cloud Storage — 其中有一列是使用核取方塊選取的，顯示底部工具列，其中包含編輯中繼資料可見性、編輯連線存取權、編輯名稱和說明、編輯類別以及刪除的選項。

檢視您的GCS資料連線 view-gcs-connection

若要檢閱或管理連線本身，包括其比對索引鍵和排程，請瀏覽至​設定 > 我的資料連線。 您的新GCS連線立即在那裡可用。 對象來源顯示為​Google雲端儲存空間。

已知限制 known-limitations

設定和使用Google Cloud Storage對象來源時，請注意下列限制：

  • 符合索引鍵條件約束：​一旦為資料連線啟用符合索引鍵，就無法移除它。 您可以將相符金鑰新增至現有的連線，但無法停用或刪除它們。 若要變更作用中的比對金鑰，您必須刪除資料連線並建立新的連線。
  • 每個來源有一個使用中的資料連線：​一次只支援一個使用中的Google Cloud Storage資料連線。 如果您需要從不同的儲存貯體取得對象，請刪除現有的連線，並建立指向新儲存貯體的新連線。
  • 子資料夾支援：​對象檔案必須直接位於指定的資料夾路徑中。 Collaboration不會在該路徑內周遊子資料夾。

疑難排解 troubleshooting

您可以使用此段落來解決建立初始連線後發生的問題。 對於驗證期間發生的錯誤，請檢閱您的憑證和貯體許可權，或聯絡您的管理員。

對象未出現或來源搜尋所花的時間比預期長

  • 來源時間會隨著資料量和設定的重新整理頻率而調整。 大型資料集的處理時間預期會延長。
  • 如果對象未在24小時內出現，請確認您的對象檔案位於您在設定期間指定的資料夾路徑中，並符合Audience Sourcing規格。
  • 檢查​ 我的資料連線 ​索引標籤，找出連線上的錯誤指標。
  • 如果完成這些步驟後問題仍然存在，請聯絡Adobe客戶支援並提供資料連線名稱和貯體詳細資料。

資料連線在初始成功後顯示失敗狀態

  • 確認自您建立連線以來，GCS貯體許可權和認證沒有變更。 任何移除Adobe貯體存取權的變更都會導致後續來源執行失敗。
  • 確認對象檔案仍存在於設定的資料夾路徑中，並符合Audience Sourcing規格。
  • 如果在確認許可權和檔案可用性後問題仍然存在，請刪除連線並建立新連線，或聯絡Adobe客戶支援。

排程重新整理期間發生對象檔案格式錯誤

  • 確認儲存貯體中的更新檔案符合對象來源規格中的欄位結構和欄位要求。
  • 請確定設定資料夾路徑中的所有檔案都使用相同的欄結構。 相同路徑中的混合格式檔案可能會導致部分sourcing失敗。

後續步驟 next-steps

您已將Google Cloud Storage設定為Collaboration中的資料來源。 來源完成之後，您的對象可在​ 我的對象 ​工作區中使用，並準備用於共同作業專案。

從此處，您可以：

如需其他對象來源方法，請參閱：

recommendation-more-help
real-time-cdp-collaboration-help-guide