啟用對象以批次設定檔匯出目的地
概觀 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 note NOTE 此 區段評估後 以下所述的選項僅適用於部分Beta版客戶。 使用 區段評估後 讓啟動工作在每日Platform批次分段工作完成後立即執行的選項。 此選項可確保當啟動工作執行時,最新的設定檔會匯出至您的目的地。
使用 已排程 讓啟動工作以固定時間執行的選項。 此選項可確保每天的相同時間匯出Experience Platform設定檔資料。 不過,您匯出的設定檔可能不是最新的,這取決於批次分段工作是否在啟動工作開始之前完成。 -
使用 日期 選擇器來選擇應執行匯出的日期或間隔。 對於每日匯出,最佳實務是設定您的開始和結束日期,以符合下游平台中行銷活動的持續時間。
note important IMPORTANT 選取匯出間隔時,間隔的最後一天不包含在匯出中。 例如,如果您選取1月4日至11日的間隔,則最後的檔案匯出將於1月10日進行。 -
選取 建立 以儲存排程。
匯出增量檔案
選取 匯出增量檔案 觸發匯出,其中第一個檔案是所選對象所有設定檔資格的完整快照,後續檔案是自上次匯出以來的增量設定檔資格。
-
使用 頻率 選擇器以選取匯出頻率:
- 每日:排程增量檔案每天於您指定的時間匯出一次。
- 每小時:排程每3、6、8或12小時匯出一次增量檔案。
-
使用 時間 選擇器來選擇一天中的時間,在 UTC 格式,應何時進行匯出。
-
使用 日期 選擇器來選擇應進行匯出的間隔。 最佳實務建議將您的開始和結束日期設定為您在下游平台中的行銷活動持續時間。
note important IMPORTANT 間隔的最後一天不包含在匯出中。 例如,如果您選取1月4日至11日的間隔,則最後的檔案匯出將於1月10日進行。 -
選取 建立 以儲存排程。
設定檔案名稱
對於大多數目的地,預設檔案名稱會包含目的地名稱、對象ID以及日期和時間指示器。 例如,您可以編輯匯出的檔案名稱,以區分不同的促銷活動,或將資料匯出時間附加至檔案。 請注意,某些目的地開發人員可能會選擇為其目的地顯示不同的預設檔案名稱附加選項。
若要開啟模型視窗並編輯檔案名稱,請選取鉛筆圖示。 檔案名稱上限為255個字元。
在檔案名稱編輯器中,您可以選取不同的元件以新增至檔案名稱。
無法從檔案名稱中移除目的地名稱和對象ID。 除了這些選項以外,您還可以新增下列選項:
MMDDYYYY_HHMMSS
格式或產生檔案時的UNIX 10位數時間戳記。 如果您希望檔案在每次增量匯出時產生動態檔案名稱,請選擇其中一個選項。選取 套用變更 以確認您的選取。
設定完所有對象後,選取「 」 下一個 以繼續。
映射 mapping
在此步驟中,您必須選取要新增至匯出至目標目的地之檔案的設定檔屬性。 若要選取要匯出的設定檔屬性和身分:
-
在 對應 頁面,選取 新增對應.
-
選取右側的箭頭 來源欄位 登入點。
-
在 選取來源欄位 頁面上,選取要包含在匯出檔案中以抵達目的地的設定檔屬性和身分,然後選擇 選取.
note tip TIP 您可以使用搜尋欄位來縮小選取範圍,如下圖所示。 -
您選取要匯出的欄位現在會出現在對應檢視中。 如果需要,您可以編輯匯出檔案中標題的名稱。 若要這麼做,請選取目標欄位上的圖示。
-
在 選取目標欄位 頁面,在匯出的檔案中輸入所需的標題名稱,然後選擇 選取.
-
您選取要匯出的欄位現在會出現在對應檢視中,並在匯出的檔案中顯示編輯的標頭。
-
[Beta]{class="badge informative"}
note note NOTE 此功能為測試版,僅供特定客戶使用。 若要要求存取此功能,請聯絡您的Adobe代表。 -
(選擇性)您可以選取匯出的欄位作為 強制索引鍵 或 重複資料刪除索引鍵.
-
若要新增更多欄位以供匯出,請重複上述步驟。
強制屬性 mandatory-attributes
強制屬性是使用者啟用的核取方塊,可確保所有設定檔記錄都包含選取的屬性。 例如:所有匯出的設定檔都包含電子郵件地址。
您可以將屬性標示為必要,以確保 Platform 僅匯出包含特定屬性的設定檔。 因此,可作為其他篩選形式使用。 將屬性標示為強制是 非 必填。
若未選取強制屬性,會匯出所有合格的設定檔,無論其屬性為何。
建議其中一個屬性為 唯一識別碼 從您的結構描述。 如需強制屬性的詳細資訊,請參閱 電子郵件行銷目的地 檔案。
去重複化索引鍵 deduplication-keys
重複資料刪除索引鍵是使用者定義的主索引鍵,可決定使用者要透過哪個身分來為其設定檔進行重複資料刪除重複資料刪除。
重複資料刪除索引鍵可排除一個匯出檔案中有多個相同設定檔記錄的可能性。
您有三種方式可以在中使用重複資料刪除索引鍵 Platform:
- 使用單一身分名稱空間做為 重複資料刪除索引鍵
- 使用來自的單一設定檔屬性 XDM 設定檔as a 重複資料刪除索引鍵
- 使用來自的兩種設定檔屬性的組合 XDM 設定檔作為複合索引鍵
重複資料刪除範例 deduplication-example
此範例說明重複資料刪除的運作方式,視選取的重複資料刪除索引鍵而定。
讓我們考慮以下兩個設定檔。
設定檔A
{
"identityMap": {
"Email": [
{
"id": "johndoe_1@example.com"
},
{
"id": "johndoe_2@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_1@example.com"
},
{
"id": "johndoe_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中的資料控管.[測試版]{class="badge informative"}透過計算欄位匯出陣列 export-arrays-calculated-fields
部分測試版客戶可將陣列物件從Experience Platform匯出至雲端儲存目的地。 深入瞭解 匯出陣列和計算欄位 並聯絡您的Adobe代表以取得功能的存取權。
已知限制 known-limitations
新的 對應 頁面有下列已知限制:
無法透過對應工作流程選取對象成員資格屬性
由於已知限制,您目前無法使用 選取欄位 新增視窗 segmentMembership.status
至您的檔案匯出。 您而是需要手動貼上值 xdm: segmentMembership.status
放入結構欄位中,如下所示。
檔案匯出內容可能會以下列方式有所差異,具體取決於是否 segmentMembership.status
已選取:
- 如果
segmentMembership.status
欄位已選取,匯出的檔案包括 作用中 初始完整快照中的成員,以及新 作用中 和 已過期 後續增量匯出中的成員。 - 如果
segmentMembership.status
未選取欄位,匯出的檔案僅包含 作用中 初始完整快照和後續增量匯出中的成員。
深入瞭解 檔案型目的地的設定檔匯出行為.
目前無法選取身分名稱空間進行匯出
目前不支援選取要匯出的身分名稱空間(如下圖所示)。 選取要匯出的任何身分名稱空間都會導致 檢閱 步驟。
作為臨時解決方法,如果您在Beta版期間需要將身分識別名稱空間新增到匯出的檔案,您可以:
- 針對您要在匯出中包含身分名稱空間的資料流,使用舊版雲端儲存空間目的地
- 將身分作為屬性上傳到Experience Platform,然後將其匯出到您的雲端儲存空間目標。
選取設定檔屬性 select-attributes
針對以設定檔為基礎的目的地,您必須選取要傳送至目標目的地的設定檔屬性。
-
在 選取屬性 頁面,選取 新增欄位.
-
選取右側的箭頭 結構描述欄位 登入點。
-
在 選取欄位 頁面上,選取您要傳送至目的地的XDM屬性或身分名稱空間,然後選擇 選取.
-
若要新增更多對應,請重複步驟1到3。
person.name.firstName
, person.name.lastName
, personalEmail.address
, segmentMembership.status
.
segmentMembership.status
至您的檔案匯出。 您必須手動貼上值 xdm: segmentMembership.status
放入結構欄位中,如下所示。檔案匯出會依下列方式而異 segmentMembership.status
已選取:
- 如果
segmentMembership.status
欄位已選取,匯出的檔案包括 作用中 初始完整快照和中的成員 作用中 和 已過期 後續增量匯出中的成員。 - 如果
segmentMembership.status
未選取欄位,匯出的檔案僅包含 作用中 初始完整快照和後續增量匯出中的成員。
選取擴充屬性 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
.