啟用對象以批次設定檔匯出目的地
概觀 overview
本文說明在Adobe Experience Platform中啟用受眾以批次設定檔為基礎的目的地(例如雲端儲存空間與電子郵件行銷目的地)所需的工作流程。
先決條件 prerequisites
若要啟用目的地的對象,您必須已成功連線到目的地。 如果您尚未這麼做,請前往目的地目錄,瀏覽支援的目的地,並設定您要使用的目的地。
支援的匯出檔案格式 supported-file-formats-export
匯出對象時,支援下列檔案格式:
- CSV
- JSON
- Parquet
請注意,匯出CSV檔案可讓您在要如何建構匯出的檔案方面擁有更大的彈性。 深入瞭解CSV檔案的檔案格式設定。
在建立以檔案為基礎的目的地的連線時,選取您想要的檔案格式以進行匯出。
選取您的目的地 select-destination
-
移至 連線>目的地,然後選取 目錄 標籤。
-
在您要啟用對象之目的地的對應卡片上,選取 啟用對象,如下圖所示。
-
選取您想要用來啟用對象的目的地連線,然後選取[下一步] 。
-
移至下一個區段以選取您的對象。
選取您的對象 select-audiences
若要選取您要啟用至目的地的對象,請使用對象名稱左邊的核取方塊,然後選取 下一步。
您可以根據對象的來源,從多種對象型別中進行選取:
排程客群匯出 scheduling
Adobe Experience Platform會將電子郵件行銷和雲端儲存空間的資料匯出為不同的檔案型別。 在 排程 頁面中,您可以設定排程和要匯出之每個對象的檔案名稱。
Experience Platform會自動設定每個檔案匯出的預設排程。 您可以視需要修改預設排程,方法是選取每個排程旁的鉛筆圖示,並定義自訂排程。
若要同時編輯多個排程,請使用畫面左側的核取方塊來選取對象,然後選取 編輯排程。 然後,您設定的排程將套用至所選對象的所有匯出檔案。
filename.csv
、filename_2.csv
、filename_3.csv
。匯出完整檔案 export-full-files
選取 匯出完整檔案,以觸發匯出包含所選對象所有設定檔資格的完整快照的檔案。
-
使用 頻率 選擇器來選取匯出頻率:
- 一次:排程一次隨選完整檔案匯出。
- 每日:排程每天一次在您指定的時間匯出完整檔案。
-
使用 時間 切換功能來選取匯出應該在對象評估後立即執行,還是在指定的時間依排程執行。 選取 已排程 選項時,您可以使用選取器來選取一天中應該進行匯出時的時間(格式為UTC)。
使用 區段評估之後 選項,讓啟動工作在每日平台批次分段工作完成後立即執行。 此選項可確保當啟動工作執行時,最新的設定檔會匯出至您的目的地。 這可能會導致根據您的動作,一天匯出對象多次。
note important IMPORTANT 如果您對已設定在區段評估後啟用的對象執行彈性對象評估,則無論任何先前的每日啟用工作,彈性對象評估工作一完成,對象就會啟用。 這可能會導致根據您的動作,一天匯出對象多次。
使用 已排程 選項,讓啟動工作以固定時間執行。 此選項可確保每天的相同時間匯出Experience Platform設定檔資料。 不過,您匯出的設定檔可能不是最新的,這取決於批次分段工作是否在啟動工作開始之前完成。 -
使用 日期 選擇器來選擇匯出應該發生的日期或間隔。 對於每日匯出,最佳實務是設定您的開始和結束日期,以符合下游平台中行銷活動的持續時間。
note important IMPORTANT 選取匯出間隔時,間隔的最後一天不包含在匯出中。 例如,如果您選取1月4日至11日的間隔,則最後的檔案匯出將於1月10日進行。 -
選取 建立 以儲存排程。
匯出增量檔案
選取 匯出增量檔案 以觸發匯出,其中第一個檔案是所選對象所有設定檔資格的完整快照,而後續檔案則是自上次匯出以來的增量設定檔資格。
-
使用 頻率 選擇器來選取匯出頻率:
- 每日:排程增量檔案匯出一次,每天一次,在您指定的時間。
- 每小時:排程每3、6、8或12小時匯出一次增量檔案。
-
使用 Time 選擇器來選擇要進行匯出的時間(格式為UTC)。
-
使用 日期 選擇器來選擇匯出發生的間隔。 最佳實務建議將您的開始和結束日期設定為您在下游平台中的行銷活動持續時間。
note important IMPORTANT 間隔的最後一天不包含在匯出中。 例如,如果您選取1月4日至11日的間隔,則最後的檔案匯出將於1月10日進行。 -
選取 建立 以儲存排程。
設定檔案名稱 configure-file-names
對於大多數目的地,預設檔案名稱會包含目的地名稱、對象ID以及日期和時間指示器。 例如,您可以編輯匯出的檔案名稱,以區分不同的促銷活動,或將資料匯出時間附加至檔案。 請注意,某些目的地開發人員可能會選擇為其目的地顯示不同的預設檔案名稱附加選項。
若要開啟模型視窗並編輯檔案名稱,請選取鉛筆圖示。 檔案名稱上限為255個字元。
在檔案名稱編輯器中,您可以選取不同的元件以新增至檔案名稱。
無法從檔案名稱中移除目的地名稱和對象ID。 除了這些選項以外,您還可以新增下列選項:
MMDDYYYY_HHMMSS
格式或產生檔案時的UNIX 10位數時間戳記。 如果您希望檔案在每次增量匯出時產生動態檔案名稱,請選擇其中一個選項。若要同時編輯多個檔案名稱,請使用畫面左側的核取方塊來選取對象,然後選取 編輯檔案名稱。 然後,您設定的檔案名稱選項將套用至所選對象的所有匯出檔案。
選取 套用變更 以確認您的選擇。
完成所有對象的設定後,請選取[下一步] 以繼續。
對應 mapping
在此步驟中,您必須選取要新增至匯出至目標目的地之檔案的設定檔屬性。 若要選取要匯出的設定檔屬性和身分:
-
在 對應 頁面中,選取 新增對應。
-
選取 Source欄位 專案右側的箭頭。
-
在 選取來源欄位 頁面中,選取要包含在匯出至目的地的檔案中的設定檔屬性和身分,然後選擇 選取。
note tip TIP 您可以使用搜尋欄位來縮小選取範圍,如下圖所示。 使用 僅顯示含有資料的欄位 切換按鈕,僅顯示填入值的結構描述欄位。 依預設,只會顯示填入的結構欄位。
-
您選取要匯出的欄位現在會出現在對應檢視中。 如果需要,您可以編輯匯出檔案中標題的名稱。 若要這麼做,請選取目標欄位上的圖示。
-
在 選取目標欄位 頁面中,輸入匯出檔案中標題的所需名稱,然後選擇 選取。
-
您選取要匯出的欄位現在會出現在對應檢視中,並在匯出的檔案中顯示編輯的標頭。
-
(選擇性) UI中對應欄位的順序反映了匯出CSV檔案中欄的順序(從上到下),而上列是CSV檔案中最左側的欄。 您可以拖放對應列,以任何想要的方式重新排序對應欄位,如下所示。
note note NOTE 此功能為測試版,僅供特定客戶使用。 若要請求此功能的存取權,請聯絡您的 Adobe 代表。 -
(選擇性)您可以選取匯出的欄位為必要索引鍵或重複資料刪除索引鍵。
-
若要新增更多欄位以供匯出,請重複上述步驟。
強制屬性 mandatory-attributes
強制屬性是使用者啟用的核取方塊,可確保所有設定檔記錄都包含選取的屬性。 例如:所有匯出的設定檔都包含電子郵件地址。
您可以將屬性標籤為必要,以確保Platform僅匯出包含特定屬性的設定檔。 因此,可作為其他篩選形式使用。 將屬性標籤為必要是 不需要。
若未選取強制屬性,會匯出所有合格的設定檔,無論其屬性為何。
去重複化索引鍵 deduplication-keys
重複資料刪除索引鍵是使用者定義的主索引鍵,可決定使用者要透過哪個身分來為其設定檔進行重複資料刪除重複資料刪除。
重複資料刪除索引鍵可排除一個匯出檔案中有多個相同設定檔記錄的可能性。
有三種方式可以在Platform中使用重複資料刪除索引鍵:
- 使用單一身分名稱空間做為重複資料刪除索引鍵
- 使用XDM設定檔中的單一設定檔屬性做為重複資料刪除索引鍵
- 使用XDM設定檔中的兩個設定檔屬性組合作為複合索引鍵
重複資料刪除範例 deduplication-example
此範例說明重複資料刪除的運作方式,視選取的重複資料刪除索引鍵而定。
讓我們考慮以下兩個設定檔。
設定檔A
{
"identityMap": {
"Email": [
{
"id": "johndoe_1@example.com"
},
{
"id": "doejohn_1@example.com"
}
]
},
"segmentMembership": {
"ups": {
"fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
"status": "realized",
"lastQualificationTime": "2021-03-10 10:03:08"
}
}
},
"person": {
"name": {
"lastName": "Doe",
"firstName": "John"
}
},
"personalEmail": {
"address": "johndoe@example.com"
}
}
設定檔B
{
"identityMap": {
"Email": [
{
"id": "johndoe_2@example.com"
},
{
"id": "doejohn_2@example.com"
}
]
},
"segmentMembership": {
"ups": {
"fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
"status": "realized",
"lastQualificationTime": "2021-04-10 11:33:28"
}
}
},
"person": {
"name": {
"lastName": "D",
"firstName": "John"
}
},
"personalEmail": {
"address": "johndoe@example.com"
}
}
重複資料刪除使用案例1:無重複資料刪除 deduplication-use-case-1
若不使用重複資料刪除,匯出檔案會包含以下專案。
重複資料刪除使用案例2:根據身分名稱空間重複資料刪除 deduplication-use-case-2
假設以Email名稱空間刪除重複資料,匯出檔案會包含以下專案。 設定檔B是符合對象資格的最新設定檔,因此是唯一匯出的設定檔。
重複資料刪除使用案例3:根據單一設定檔屬性重複資料刪除 deduplication-use-case-3
假設重複資料刪除是以personal Email
屬性執行,匯出檔案會包含下列專案。 設定檔B是符合對象資格的最新設定檔,因此是唯一匯出的設定檔。
重複資料刪除使用案例4:根據兩個設定檔屬性重複資料刪除 deduplication-use-case-4
假設複合索引鍵personalEmail + lastName
執行重複資料刪除,匯出檔案會包含下列專案。
Adobe建議選取身分名稱空間(例如CRM ID或電子郵件地址)作為重複資料刪除索引鍵,以確保所有設定檔記錄都可唯一識別。
- 這些欄位會用於對象定義中。
- 這些欄位會設定為目標目的地的投影屬性。
person.name.firstName
的某些資料使用標籤與目的地的行銷動作衝突,您會在檢閱步驟中看到資料使用原則違規。 如需詳細資訊,請參閱Adobe Experience Platform中的資料控管。[Beta]{class="badge informative"}透過計算欄位匯出陣列 export-arrays-calculated-fields
部分測試版客戶可將陣列物件從Experience Platform匯出至雲端儲存目的地。 閱讀有關匯出陣列和計算欄位的詳細資訊,並連絡您的Adobe代表以取得功能的存取權。
已知限制 known-limitations
新 對應 頁面有下列已知限制:
無法透過對應工作流程選取對象成員資格屬性
由於已知的限制,您目前無法使用 選取欄位 視窗將segmentMembership.seg_namespace.seg_id.status
新增至您的檔案匯出。 相反地,您需要手動將值xdm: segmentMembership.seg_namespace.seg_id.status
貼到結構描述欄位中,如下所示。
segmentMembership.seg_namespace.seg_id.status
segmentMembership.seg_namespace.seg_id.lastQualificationTime
視是否選取segmentMembership.seg_namespace.seg_id.status
而定,檔案匯出會依下列方式而有所不同:
- 如果選取
segmentMembership.seg_namespace.seg_id.status
欄位,匯出的檔案會在初始完整快照中包含 Active 成員,並在後續的增量匯出中包含 Active 和 Expired 成員。 - 如果未選取
segmentMembership.seg_namespace.seg_id.status
欄位,則匯出的檔案在初始完整快照和後續的增量匯出中僅包含 Active 成員。
深入瞭解檔案型目的地🔗的設定檔匯出行為。
目前無法選取身分名稱空間進行匯出
目前不支援選取要匯出的身分名稱空間(如下圖所示)。 選取任何要匯出的身分名稱空間將會導致 檢閱 步驟中的錯誤。
作為臨時解決方法,如果您在Beta版期間需要將身分識別名稱空間新增到匯出的檔案,您可以:
- 針對您要在匯出中包含身分名稱空間的資料流,使用舊版雲端儲存空間目的地
- 將身分作為屬性上傳到Experience Platform,然後將其匯出到您的雲端儲存空間目標。
選取設定檔屬性 select-attributes
針對以設定檔為基礎的目的地,您必須選取要傳送至目標目的地的設定檔屬性。
-
在 選取屬性 頁面中,選取 新增欄位。
-
選取 結構描述欄位 專案右側的箭頭。
-
在 選取欄位 頁面中,選取您要傳送至目的地的XDM屬性或身分識別名稱空間,然後選擇 選取。
-
若要新增更多對應,請重複步驟1到3。
person.name.firstName
、person.name.lastName
、personalEmail.address
、segmentMembership.seg_namespace.seg_id.status
。
segmentMembership.seg_namespace.seg_id.status
新增至您的檔案匯出。 相反地,您必須手動將值xdm: segmentMembership.seg_namespace.seg_id.status
貼到結構描述欄位中,如下所示。視是否選取segmentMembership.seg_namespace.seg_id.status
而定,檔案匯出會依下列方式而有所不同:
- 如果選取
segmentMembership.seg_namespace.seg_id.status
欄位,匯出的檔案會在初始完整快照中包含 Active 成員,並在後續的增量匯出中包含 Active 和 Expired 成員。 - 如果未選取
segmentMembership.seg_namespace.seg_id.status
欄位,則匯出的檔案在初始完整快照和後續的增量匯出中僅包含 Active 成員。
選取擴充屬性 select-enrichment-attributes
擴充屬性對應至在Experience Platform中擷取的自訂上傳對象,做為 自訂上傳。 在此步驟中,您可以為每個選取的外部對象選取要匯出至目的地的屬性。
請依照下列步驟,為每個外部對象選取擴充屬性:
- 在 擴充屬性 欄中,選取 (編輯)按鈕。
- 選取 新增擴充屬性。 隨即顯示新的空白結構描述欄位。
- 選取空白欄位右側的按鈕,以開啟欄位選取畫面。
- 選取您要為對象匯出的屬性。
- 新增所有要匯出的屬性之後,請選取 儲存並關閉。
- 對每個外部對象重複這些步驟。
如果您想要在不匯出任何屬性的情況下對目的地啟用外部對象,請啟用 排除擴充屬性 切換按鈕。 此選項會從外部對象匯出設定檔,但其對應的屬性不會傳送至您的目的地。
選取 下一步 以移至檢閱步驟。
檢閱 review
在 檢閱 頁面上,您可以看到選取專案的摘要。 選取 取消 以中斷流程,上一步 以修改您的設定,或選取 完成 以確認您的選擇並開始傳送資料到目的地。
同意原則評估 consent-policy-evaluation
如果您的組織購買了 Adobe Healthcare Shield 或 Adobe Privacy & Security Shield,請選取 檢視適用的同意原則,以查看套用了哪些同意原則以及由於這些原則啟動中包含了多少個輪廓。如需詳細資訊,請參閱同意原則評估。
資料使用原則檢查 data-usage-policy-checks
在 檢閱 步驟中,Experience Platform也會檢查是否有任何資料使用原則違規。 以下是違反原則的範例。 在解決違規之前,您無法完成對象啟用工作流程。 如需有關如何解決原則違規的資訊,請參閱資料治理檔案一節中的關於資料使用原則違規。
篩選對象 filter-audiences
此外,在此步驟中,您可以使用頁面上的可用篩選器,只顯示其排程或對應已隨著此工作流程而更新的對象。 您也可以切換要檢視的表格欄。
如果您對您的選擇感到滿意,並且未偵測到任何原則違規,請選取[完成] 以確認您的選擇,並開始將資料傳送到目的地。
驗證受眾啟用 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.firstname
、person.lastname
、person.gender
、person.birthyear
和personalEmail.address
。