啟用對象以批次設定檔匯出目的地

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

概觀 overview

本文說明在Adobe Experience Platform中啟用對象以批次設定檔檔案型目的地(例如雲端儲存空間與電子郵件行銷目的地)所需的工作流程。

先決條件 prerequisites

若要啟用目的地的對象,您必須已成功連線到目的地。 如果您尚未這麼做,請前往目的地目錄,瀏覽支援的目的地,並設定您要使用的目的地。

支援的匯出檔案格式 supported-file-formats-export

匯出對象時,支援下列檔案格式:

  • CSV
  • JSON
  • Parquet

請注意,匯出CSV檔案可讓您在要如何建構匯出的檔案方面擁有更大的彈性。 深入瞭解CSV檔案的檔案格式設定

建立以檔案為基礎的目的地的連線時,選取您想要的檔案格式以進行匯出。

選取您的目的地 select-destination

  1. 在左側導覽中選取「目的地」,選取「目錄」標籤,然後在您要啟用對象的目的地對應卡片上選取「啟用對象」。

    (選用)依名稱搜尋您的目的地,而非瀏覽完整目錄。

    目的地目錄中反白顯示的目的地導覽、目錄標籤和啟用對象控制項,而搜尋方塊反白顯示的選填方式可依名稱尋找您的目的地。 {modal="regular"}

  2. 選取您想要用來啟動對象的目的地連線旁的核取方塊,然後選取「下一步」。

    (選擇性)使用搜尋方塊依名稱尋找目的地連線,或選取篩選圖示以顯示篩選面板,並根據您偏好的條件縮小結果。

    搜尋方塊、篩選器面板切換、目的地連線核取方塊,以及選取目的地步驟中反白顯示的「下一步」按鈕。 {modal="regular"}

  3. 移至下一個區段以選取您的對象

選取您的對象 select-audiences

  1. 選取您要啟用至目的地之對象旁的核取方塊,然後選取​下一步

    (可選)使用搜尋方塊依名稱尋找對象,或選取篩選圖示依評估型別(邊緣、串流或批次)、名稱空間來源或標籤縮小結果。

    note tip
    TIP
    您可以依在對象瀏覽畫面中使用的相同標籤來篩選。 您新增至該處對象的任何標籤都會延續至此畫面。

    搜尋方塊、篩選器面板切換、對象核取方塊,以及「選取對象」步驟中反白顯示的「下一步」按鈕。 {modal="regular"}

您可以根據對象的來源,從多種對象型別中進行選取:

  • 細分服務:細分服務在Experience Platform中產生的對象。 如需詳細資訊,請參閱分段檔案
  • 自訂上傳:對象是在Experience Platform外部產生,並以CSV檔案形式上傳至Experience Platform。 若要深入瞭解外部對象,請參閱有關匯入對象的檔案。 選取源自​ 自訂上傳 ​的對象會自動啟用選取擴充屬性步驟。
  • 其他型別的對象,源自其他Adobe解決方案,例如Audience Manager。
IMPORTANT
將自訂上傳對象啟用至批次檔案型目的地時,您可以在資料流中啟用10個這類對象的限制。
TIP
若要從現有的啟用流程移除對象,請使用​ 啟用資料 ​頁面。 閱讀有關如何從啟用流程移除多個對象的章節,以取得詳細資料。

排程對象匯出 scheduling

Adobe Experience Platform會將電子郵件行銷和雲端儲存空間的資料匯出為不同的檔案型別。 在​ 排程 ​頁面中,您可以設定排程和要匯出之每個對象的檔案名稱。

使用​ 新對象 ​和​ 啟用的對象 ​選項,在此頁面的兩個檢視之間切換:

  • 新對象:只顯示您在目前啟用流程中新增至目的地的對象。
  • 啟用的對象:顯示您在先前的啟用流程中啟用至目的地的對象。

Experience Platform會自動設定每個檔案匯出的預設排程。 您可以視需要修改預設排程,方法是選取每個排程旁的鉛筆圖示,並定義自訂排程。

針對每個對象,選擇兩種匯出型別之一: 匯出完整檔案匯出增量檔案

在排程步驟中反白顯示 鉛筆圖示。 {modal="regular"}

若要同時編輯多個排程,請使用畫面左側的核取方塊來選取對象,然後選取​編輯排程。 然後,您設定的排程將套用至所選對象的所有匯出檔案。

標題核取方塊和編輯排程控制項在排程步驟中反白顯示。 {modal="regular"}

TIP
您可以從​ 啟用資料 ​頁面,編輯現有啟用流程的對象啟用排程。 如需詳細資訊,請參閱有關大量編輯啟動排程的檔案。
IMPORTANT
Adobe Experience Platform會自動分割匯出檔案,每個檔案為500萬筆記錄(列)。 每一列代表一個設定檔。
分割檔案名稱會附加一個數字,表示檔案是較大匯出的一部分,例如: filename.csvfilename_2.csvfilename_3.csv

匯出完整檔案 export-full-files

選取​匯出完整檔案,以觸發匯出包含所選對象所有設定檔資格的完整快照的檔案。

匯出已選取的完整檔案。 {modal="regular"}

  1. 使用​ 頻率 ​選擇器來選取匯出頻率:

    • 一次:排程一次隨選完整檔案匯出。
    • 每日:排程每天一次在您指定的時間匯出完整檔案。
    • 每週:選取開始日期,後續的匯出將發生在一週的該日,直到選取的結束日期為止。
    • 每月:選取開始日期,後續的匯出會在該月的該日期發生,直到選取的結束日期為止。 對於少於 30 或 31 天的月份,匯出將在該月的最後一天進行。
    note
    NOTE
    目前只有下列以檔案為基礎的雲端儲存空間目的地才支援每週和每月排程選項,而且只有在啟用人員對象潛在對象時才支援。
    每週和每月排程選項不適用於其他目的地型別。
  2. 使用​ 時間 ​切換功能來選取匯出應該在對象評估後立即執行,還是在指定的時間依排程執行。 選取​ 已排程 ​選項時,您可以使用選取器來選取一天中應該進行匯出時的時間(格式為UTC)。

    使用​ 區段評估之後 ​選項,讓啟動工作在每日Experience Platform批次分段工作完成後立即執行。 此選項可確保當啟動工作執行時,最新的設定檔會匯出至您的目的地。 這可能會導致根據您的動作,一天匯出對象多次。

    note important
    IMPORTANT
    若您對原已設定為在區段評估後啟用的客群,執行彈性客群評估,則一旦彈性客群評估工作完成,無論先前的每日啟用工作為何,這些客群都會立即啟用。 這可能會導致根據您的動作,一天匯出對象多次。

    在編輯排程對話方塊中反白顯示區段評估選項之後。 {modal="regular"}

    使用​ 已排程 ​選項,讓啟動工作以固定時間執行。 此選項可確保每天的相同時間匯出Experience Platform設定檔資料。 不過,您匯出的設定檔可能不是最新的,這取決於批次分段工作是否在啟動工作開始之前完成。

    在編輯排程對話方塊中反白顯示的排程選項和開始時間選擇器。 {modal="regular"}

    對映過去24小時內建立並透過批次分段評估的受眾時,請將每日匯出排程設定為最早從次日開始。 這可確保每日批次評估工作會先執行,而且您正在匯出完整的對象資料。

    設定匯出排程時,請在完成啟動流程後設定開始時間至少​1小時。 對象啟用最多可能需要1小時的時間,才能在整個系統中傳播。 如果您排程在啟用後1小時內執行匯出,排程的匯出可能會錯過。

  3. 使用​ 日期 ​選擇器來選擇匯出應該發生的日期或間隔。 對於每日匯出,最佳實務是設定您的開始和結束日期,以符合下游平台中行銷活動的持續時間。

    note important
    IMPORTANT
    選取匯出間隔時,間隔的最後一天不包含在匯出中。 例如,如果您選取1月4日至11日的間隔,則最後的檔案匯出將於1月10日進行。
  4. 選取​ 建立 ​以儲存排程。

瞭解排定的匯出行為 export-behavior

已排程的匯出專案包括對象快照集資料,以及在快照集建立和匯出之間發生的任何增量設定檔或身分變更。 這與隨選匯出不同,後者只使用快照集資料。

下表著重說明排程匯出與隨選匯出的差異,尤其是資料新鮮度和預期用途方面:

排程的匯出
立即匯出檔案
資料來源
快照+增量變更
僅快照
輪廓屬性
匯出時目前的值
快照時間的值

如果設定檔在對象評估後更新,則排程的匯出將包括更新的屬性值,即使對象成員資格是在評估時確定的。

範例: 「retailID為null的設定檔」對象可能會匯出填入retailID的設定檔,如果該欄位在​ 評估後 ​但在​ 排程匯出前 ​更新。

推薦

  • 設定重複資料刪除索引鍵以防止重複記錄
  • 使用隨選匯出來取得精確的快照集資料
  • 讓批次內嵌與評估排程保持一致,以將差異降至最低

如需隨選匯出,請參閱有關隨選匯出檔案的檔案。

匯出增量檔案 export-incremental-files

選取​ 匯出增量檔案 ​以觸發匯出,其中第一個檔案是所選對象所有設定檔資格的完整快照,而後續檔案則是自上次匯出以來的增量設定檔資格。

IMPORTANT
第一個匯出的增量檔案包含符合對象資格的所有設定檔,可作為回填。

匯出增量檔案切換已選取。 {modal="regular"}

  1. 使用​ 頻率 ​選擇器來選取匯出頻率:

    • 每日:排程增量檔案匯出一次,每天一次,在您指定的時間。
    • 每小時:排程每3、6、8或12小時匯出一次增量檔案。
  2. 使用​ Time ​選擇器來選擇要進行匯出的時間(格式為UTC)。

  3. 使用​ 日期 ​選擇器來選擇匯出發生的間隔。 最佳實務建議將您的開始和結束日期設定為您在下游平台中的行銷活動持續時間。

    note important
    IMPORTANT
    間隔的最後一天不包含在匯出中。 例如,如果您選取1月4日至11日的間隔,則最後的檔案匯出將於1月10日進行。
  4. 選取​ 建立 ​以儲存排程。

設定檔案名稱 configure-file-names

對於大多數目的地,預設檔案名稱會包含目的地名稱、對象ID以及日期和時間指示器。 例如,您可以編輯匯出的檔案名稱,以區分不同的促銷活動,或將資料匯出時間附加至檔案。 請注意,某些目的地開發人員可能會選擇為其目的地顯示不同的預設檔案名稱附加選項。

若要開啟模型視窗並編輯檔案名稱,請選取鉛筆圖示。 檔案名稱上限為255個字元。

NOTE
下圖顯示如何編輯Amazon S3目的地的檔案名稱,但所有批次目的地的處理程式都相同(例如SFTP、Azure Blob Storage或Google Cloud Storage)。

影像醒目顯示用來設定檔案名稱的鉛筆圖示。 {modal="regular"}

在檔案名稱編輯器中,您可以選取不同的元件以新增至檔案名稱。

影像顯示所有可用的檔案名稱選項。 {modal="regular"}

無法從檔案名稱中移除目的地名稱和對象ID。 除了這些選項以外,您還可以新增下列選項:

檔案名稱選項
說明
對象名稱
匯出的對象名稱。
日期和時間
選擇新增MMDDYYYY_HHMMSS格式或產生檔案時的UNIX 10位數時間戳記。 如果您希望檔案在每次增量匯出時產生動態檔案名稱,請選擇其中一個選項。
自訂文字
您要新增至檔案名稱的任何自訂文字。
目的地識別碼
用來匯出對象的目的地資料流的ID。
目的地名稱
用來匯出對象的目的地資料流名稱。
組織名稱
Experience Platform中的組織名稱。
沙箱名稱
您用來匯出對象的沙箱的ID。

若要同時編輯多個檔案名稱,請使用畫面左側的核取方塊來選取對象,然後選取​編輯檔案名稱。 然後,您設定的檔案名稱選項將套用至所選對象的所有匯出檔案。

標題核取方塊和編輯在排程步驟中反白的檔案名稱控制項。 {modal="regular"}

選取​ 套用變更 ​以確認您的選擇。

IMPORTANT
如果您未選取​ 日期與時間 ​元件,檔案名稱將會是靜態的,而且新的匯出檔案將會以每次匯出覆寫您儲存位置中的上一個檔案。 從儲存位置執行週期性匯入工作至電子郵件行銷平台時,這是建議的選項。

完成所有對象的設定後,請選取[下一步] 以繼續。

對應 mapping

IMPORTANT
下面說明的​ 對應 ​步驟適用於所有雲端儲存空間目的地。 如果您正在啟用受眾至Adobe Campaign、Oracle Responsys、Oracle Eloqua或Salesforce Marketing Cloud,請改為參閱選取設定檔屬性(舊版)

在此步驟中,您必須選取要新增至匯出至目標目的地之檔案的設定檔屬性。 若要選取要匯出的設定檔屬性和身分:

  1. 在​ 對應 ​頁面中,選取​新增對應,然後選取​ Source欄位 ​專案右側的箭頭。

    新增對應工作流程中反白顯示的新對應控制項和來源欄位箭頭。 {modal="regular"}

  2. 在​ 選取來源欄位 ​頁面中,使用​ 選取屬性 ​或​ 選取身分名稱空間 ​切換功能,在兩個類別的來源欄位之間切換,然後選取要包含在匯出檔案中到目的地的設定檔屬性或身分。 完成時選擇​儲存

    note tip
    TIP
    使用搜尋方塊來篩選來源欄位,如下圖所示。 搜尋會比對部分且不區分大小寫的文字,適用於設定檔屬性以及標準Adobe和自訂身分識別名稱空間。

    使用​ 僅顯示含有資料的欄位 ​切換按鈕,僅顯示填入值的結構描述欄位。 依預設,只會顯示填入的結構欄位。

    在選取來源欄位頁面中反白顯示選取屬性和身分名稱空間切換。 {modal="regular"}

    使用​ 顯示欄位名稱 ​切換來顯示欄位易記名稱,而非結構描述欄位名稱。

    選取來源欄位頁面,顯示顯示顯示名稱的切換。 {modal="regular"}

  3. 您選取要匯出的欄位現在會出現在對應檢視中。 如果需要,您可以編輯匯出檔案中標題的名稱。 若要這麼做,請選取目標欄位上的圖示。

    note
    NOTE
    匯出檔案中的欄位名稱不支援點(.)。 如果欄位名稱包含點(例如person.name.firstName),匯出的欄名稱中每個點都會以底線(_)取代。 例如,person.name.firstName將在匯出的檔案中變成person_name_firstName

    對應檢視中反白顯示的目標欄點陣圖示。 {modal="regular"}

  4. 在​ 選取目標欄位 ​頁面中,輸入匯出檔案中標題的所需名稱,然後選擇​儲存

    在[選取目標欄位]頁面中反白的 屬性名稱欄位。 {modal="regular"}

  5. 您選取要匯出的欄位現在會出現在對應檢視中,並在匯出的檔案中顯示編輯的標頭。

    反白顯示對應檢視中更新標題名稱的目標欄位。 {modal="regular"}

  6. (選擇性) UI中對應欄位的順序反映了匯出CSV檔案中欄的順序(從上到下),而上列是CSV檔案中最左側的欄。 您可以拖放對應列,以任何想要的方式重新排序對應欄位,如下所示。

    錄製顯示透過拖放重新排序的對映欄位。 {modal="regular"}

  7. (選擇性)您可以選取匯出的欄位為必要索引鍵重複資料刪除索引鍵

    對應身分時,Experience Platform會自動將其標示為強制索引鍵和重複資料刪除索引鍵。 您無法為識別對應清除這些選取專案。

    在對應檢視中反白顯示的必要索引鍵與重複資料刪除索引鍵資料行。 {modal="regular"}

  8. 若要新增更多欄位以供匯出,請重複上述步驟。

如需必要屬性、重複資料刪除索引鍵、計算欄位和對應步驟的已知限制的詳細資訊,請參閱批次目的地對應參考

選取擴充屬性 select-enrichment-attributes

IMPORTANT
只有當您在對象選取步驟期間選取​ 自訂上傳 ​對象時,才會顯示此步驟。

擴充屬性對應至Experience Platform中擷取的自訂上傳對象,做為​自訂上傳。 在此步驟中,您可以為每個選取的外部對象選取要匯出至目的地的屬性。

TIP
如果您想要在不匯出任何屬性的情況下對目的地啟用外部對象,請啟用​ 排除擴充屬性 ​切換按鈕。 此選項會從外部對象匯出設定檔,但其對應的屬性不會傳送至您的目的地。
顯示排除擴充屬性切換的UI影像。 {modal="regular"}

顯示擴充屬性選取步驟的UI影像。 {modal="regular"}

請依照下列步驟,為每個外部對象選取擴充屬性:

  1. 在​ 擴充屬性 ​欄中,選取 編輯按鈕 (編輯)按鈕。
  2. 選取​新增擴充屬性。 隨即顯示新的空白結構描述欄位。
    新增擴充屬性強制回應視窗中醒目提示的擴充屬性控制項。 {modal="regular"}
  3. 選取空白欄位右側的按鈕,以開啟欄位選取畫面。
  4. 選取您要為對象匯出的屬性。
    顯示擴充屬性清單的UI影像。 {modal="regular"}
  5. 新增所有要匯出的屬性之後,請選取​儲存並關閉
  6. 對每個外部對象重複這些步驟。

選取​ 下一步 ​以移至檢閱步驟。

[Beta]{class="badge informative"}從擴充屬性匯出陣列和物件 export-arrays-enrichment-attributes

AVAILABILITY
從擴充屬性匯出陣列和物件的功能處於測試階段,可供特定客戶使用。 如欲請求存取權,請和您的 Adobe 代表聯絡。

當使用JSON或Parquet輸出以及已啟用匯出陣列、對應和物件​​切換將對象匯出至雲端儲存空間目的地時,您可以將複雜的資料結構(包括整個陣列或從物件陣列選取的欄位)匯出為擴充屬性。

「選取擴充屬性」對話方塊顯示「匯出」陣列和複雜物件啟用的橫幅,以及雙欄Source和Target對應介面。 {modal="regular"}

擴充屬性步驟會顯示兩欄對應介面:

  • Source欄位:完整結構描述路徑,當選取的欄位在陣列內時,其中可能包含計算的transformArray運算式。 您可以透過來源欄位右側的函式圖示(與一般屬性所顯示的結構描述圖示相反)來識別計算運算式。
  • 目標欄位:在匯出的檔案中做為欄位名稱使用的別名。 編輯此檔案以在匯出的檔案中使用不同的名稱。 目標欄位只能包含字母、數字和底線。 不允許使用點、破折號和其他特殊字元。

只有在滿足以下所有條件時,才能使用此功能:

匯出整個陣列 export-entire-array

從來源欄位選取畫面中選取陣列屬性的名稱。 來源欄位會填入陣列路徑,而目標欄位則會自動填入陣列名稱。 匯出的輸出會保留陣列中的所有物件及其所有屬性。

在擴充屬性對話方塊中錄製如何依名稱選取陣列屬性,以匯出整個陣列。 {modal="regular"}

從物件陣列匯出單一欄位 export-single-array-field

當您選取巢狀內嵌於物件陣列中的屬性時,Source欄位​會自動填入transformArray計算運算式,使用to_object從陣列中的每個物件擷取該屬性。

例如,選取someArray[*].amount會將下列專案填入來源欄位:

transformArray(someArray, x -> to_object("amount", x.amount))

目標欄位會自動填入分葉節點名稱(amount)。 如果您想要變更目標欄位的名稱,可以變更名稱。

錄製顯示如何選取陣列內的巢狀欄位,以使用transformArray計算運算式自動填入來源欄位。 {modal="regular"}

從物件陣列匯出多個欄位 export-multiple-array-fields

若要從相同的物件陣列匯出多個屬性,請遵循以下兩個步驟程式:

  1. 使用來源欄位選擇器,從陣列中選取一個屬性。 對話方塊會自動填入該欄位的計算運算式。
  2. 在​ Source欄位 ​中手動編輯產生的transformArray運算式,以在to_object函式中新增其他屬性。

例如,若要從someArray匯出amountdate,請選取someArray[*].amount,然後編輯運算式至:

transformArray(someArray, x -> to_object("amount", x.amount, "date", x.date))

匯出的陣列中的每個物件只包含您指定的欄位。 此外,您可以視需要變更匯出檔案中的頂層陣列名稱。

錄製顯示如何從陣列中選取一個欄位,然後手動編輯transformArray運算式以包含多個欄位。 {modal="regular"}

NOTE
UI目前支援從陣列中一次選取一個欄位。 若要從單一對應中的相同陣列匯出多個欄位,請選取第一個欄位,然後手動編輯來源運算式,如上所示。

檢閱 review

NOTE
如果有任何資料使用標籤套用至資料集內的特定欄位(而非整個資料集),則會在下列條件下在啟用時強制執行這些欄位層級標籤:
  • 這些欄位會用於對象定義中。
  • 這些欄位會設定為目標目的地的投影屬性。
例如,如果欄位person.name.firstName的某些資料使用標籤與目的地的行銷動作衝突,您會在檢閱步驟中看到資料使用原則違規。 如需詳細資訊,請參閱 Adobe Experience Platform🔗中的資料控管。

在​ 檢閱 ​頁面上,您可以看到選取專案的摘要。 選取​ 取消 ​以中斷流程,上一步​以修改您的設定,或選取​ 完成 ​以確認您的選擇並開始傳送資料到目的地。

檢閱步驟中顯示的選擇摘要。 {modal="regular"}

如果您的組織已購買 Adobe Healthcare ShieldAdobe Privacy & Security Shield,請選取「檢視適用的同意原則」,查看已套用哪些同意原則以及由於這些原則啟動中已包含多少個輪廓。 如需詳細資訊,請參閱同意原則評估

資料使用原則檢查 data-usage-policy-checks

在​ 檢閱 ​步驟中,Experience Platform也會檢查是否有任何資料使用原則違規。 以下是違反原則的範例。 在解決違規之前,您無法完成對象啟用工作流程。 如需有關如何解決原則違規的資訊,請參閱資料治理檔案一節中的關於資料使用原則違規

啟動工作流程中顯示的資料原則違規範例。 {modal="regular"}

篩選對象 filter-audiences

使用​ 新對象 ​和​ 已啟動對象 ​切換按鈕,在此啟動流程中新增的對象與您已在先前流程中啟動至目的地的對象之間切換。

若要選擇要在表格中顯示哪些欄,請選取自訂表格圖示。 在​ 自訂資料表 ​對話方塊中,選取或清除要顯示的資料行,然後選取​套用

熒幕錄製顯示新對象與啟用對象切換,以及自訂表格對話方塊,用來選取要在檢閱表格中顯示的欄。 {modal="regular"}

如果您對您的選擇感到滿意,並且未偵測到任何原則違規,請選取[完成] 以確認您的選擇,並開始將資料傳送到目的地。

驗證受眾啟用 verify

將對象匯出至雲端儲存空間目的地時,Adobe Experience Platform會在您提供的儲存位置中建立.csv.json.parquet檔案。 預期會根據您在工作流程中設定的排程,在您的儲存位置中建立新檔案。 預設檔案格式如下所示,但您可以編輯檔案名稱的元件
<destinationName>_segment<segmentID>_<timestamp-yyyymmddhhmmss>.csv

例如,如果您選取每日匯出頻率,您連續三天收到的檔案可能會如下所示:

Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200408061804.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200409052200.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200410061130.csv

這些檔案是否存在於您的儲存位置即表示啟用成功。 若要瞭解匯出的檔案結構方式,您可以下載範例.csv檔案。 此範例檔案包含設定檔屬性person.firstnameperson.lastnameperson.genderperson.birthyearpersonalEmail.address

recommendation-more-help
experience-platform-help-destinations