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

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

概觀 overview

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

先決條件 prerequisites

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

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

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

  • CSV
  • JSON
  • Parquet

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

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

選取您的目的地 select-destination

  1. 移至​ 連線>目的地,然後選取​ 目錄 ​標籤。

    影像醒目提示如何前往目的地目錄標籤。

  2. 在您要啟用對象之目的地的對應卡片上,選取​ 啟用對象,如下圖所示。

    啟用目錄頁面中反白顯示的對象控制項。

  3. 選取您想要用來啟用對象的目的地連線,然後選取[下一步]

    醒目提示核取方塊以選取一或多個要啟用對象的目標位置。

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

選取您的對象 select-audiences

若要選取您要啟用至目的地的對象,請使用對象名稱左邊的核取方塊,然後選取​ 下一步

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

  • 細分服務:細分服務在Experience Platform內產生的對象。 如需詳細資訊,請參閱分段檔案
  • 自訂上傳:在Experience Platform外部產生的對象,並以CSV檔案形式上傳至Platform。 若要深入瞭解外部對象,請參閱有關匯入對象的檔案。
  • 其他型別的對象,源自其他Adobe解決方案,例如Audience Manager。

選取一或多個要啟動的對象時顯示的核取方塊。

TIP
選取源自​ 自訂上傳 ​的對象會自動啟用選取擴充屬性步驟。
TIP
您可以從​ 啟用資料 ​頁面移除現有啟用流程中的對象。 如需詳細資訊,請參閱專屬檔案

排程對象匯出 scheduling

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

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

編輯排程步驟中反白顯示的排程控制項。

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

匯出完整檔案 export-full-files

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

匯出已選取的完整檔案。

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

    • 一次:排程一次隨選完整檔案匯出。
    • 每日:排程每天一次在您指定的時間匯出完整檔案。
  2. 使用​ 時間 ​切換功能來選取匯出應該在對象評估後立即執行,還是在指定的時間依排程執行。 選取​ 已排程 ​選項時,您可以使用選取器來選取一天中應該進行匯出時的時間(格式為UTC)。

    note note
    NOTE
    底下所述的​ 區段評估後 ​選項僅供選取Beta客戶使用。

    使用​ 區段評估之後 ​選項,讓啟動工作在每日平台批次分段工作完成後立即執行。 此選項可確保當啟動工作執行時,最新的設定檔會匯出至您的目的地。

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

    影像在批次目的地的啟動流程中醒目提示「已排程」選項,並顯示時間選擇器。

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

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

匯出增量檔案

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

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

匯出增量檔案切換已選取。

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

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

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

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

設定檔案名稱

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

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

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

影像醒目顯示用來設定檔案名稱的鉛筆圖示。

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

影像顯示所有可用的檔案名稱選項。

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

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

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

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

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

對應 mapping

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

  1. 在​ 對應 ​頁面中,選取​ 新增對應

    新增對應工作流程中反白顯示的新欄位控制項。

  2. 選取​ Source欄位 ​專案右側的箭頭。

    選取對應工作流程中醒目提示的原始檔欄位控制項。

  3. 在​ 選取來源欄位 ​頁面中,選取要包含在匯出至目的地的檔案中的設定檔屬性和身分,然後選擇​ 選取

    note tip
    TIP
    您可以使用搜尋欄位來縮小選取範圍,如下圖所示。

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

    顯示可匯出至目的地之設定檔屬性的模型視窗。

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

    顯示可匯出至目的地之設定檔屬性的模型視窗。

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

    顯示標題輸入易記名稱的模型視窗。

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

    顯示可匯出至目的地之設定檔屬性的模型視窗。

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

    note note
    NOTE
    此功能為測試版,僅供特定客戶使用。 若要要求存取此功能,請聯絡您的Adobe代表。

    錄製顯示透過拖放重新排序的對映欄位。

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

    顯示可匯出至目的地之設定檔屬性的模型視窗。

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

強制屬性 mandatory-attributes

強制屬性是使用者啟用的核取方塊,可確保所有設定檔記錄都包含選取的屬性。 例如:所有匯出的設定檔都包含電子郵件地址​。

您可以將屬性標籤為必要,以確保Platform僅匯出包含特定屬性的設定檔。 因此,可作為其他篩選形式使用。 將屬性標籤為必要是​ 不需要

若未選取強制屬性,會匯出所有合格的設定檔,無論其屬性為何。

建議其中一個屬性是結構描述中的唯一識別碼。 如需強制屬性的詳細資訊,請參閱電子郵件行銷目的地檔案中的身分一節。

去重複化索引鍵 deduplication-keys

重複資料刪除索引鍵是使用者定義的主索引鍵,可決定使用者要透過哪個身分來為其設定檔進行重複資料刪除重複資料刪除​。

重複資料刪除索引鍵可排除一個匯出檔案中有多個相同設定檔記錄的可能性。

有三種方式可以在Platform中使用重複資料刪除索引鍵:

  • 使用單一身分名稱空間做為重複資料刪除索引鍵
  • 使用XDM設定檔中的單一設定檔屬性做為重複資料刪除索引鍵
  • 使用XDM設定檔中的兩個設定檔屬性組合作為複合索引鍵
IMPORTANT
您可以將單一身分名稱空間匯出至目的地,該名稱空間會自動設定為重複資料刪除索引鍵。 不支援傳送多個名稱空間至目的地。
您無法使用身分識別名稱空間和設定檔屬性的組合作為重複資料刪除索引鍵。

重複資料刪除範例 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

若不使用重複資料刪除,匯出檔案會包含以下專案。

個人電子郵件
名字
姓氏
johndoe@example.com
John
完成
johndoe@example.com
John
D

重複資料刪除使用案例2:根據身分名稱空間重複資料刪除 deduplication-use-case-2

假設以Email名稱空間刪除重複資料,匯出檔案會包含以下專案。 設定檔B是符合對象資格的最新設定檔,因此是唯一匯出的設定檔。

電子郵件*
個人電子郵件
名字
姓氏
johndoe_1@example.com
johndoe@example.com
John
D
johndoe_2@example.com
johndoe@example.com
John
D

重複資料刪除使用案例3:根據單一設定檔屬性重複資料刪除 deduplication-use-case-3

假設重複資料刪除是以personal Email屬性執行,匯出檔案會包含下列專案。 設定檔B是符合對象資格的最新設定檔,因此是唯一匯出的設定檔。

個人電子郵件*
名字
姓氏
johndoe@example.com
John
D

重複資料刪除使用案例4:根據兩個設定檔屬性重複資料刪除 deduplication-use-case-4

假設複合索引鍵personalEmail + lastName執行重複資料刪除,匯出檔案會包含下列專案。

個人電子郵件*
姓氏*
名字
johndoe@example.com
D
John
johndoe@example.com
完成
John

Adobe建議選取身分名稱空間(例如CRM ID或電子郵件地址)作為重複資料刪除索引鍵,以確保所有設定檔記錄都可唯一識別。

NOTE
如果有任何資料使用標籤套用至資料集內的特定欄位(而非整個資料集),則會在下列條件下在啟用時強制執行這些欄位層級標籤:
  • 這些欄位會用於對象定義中。
  • 這些欄位會設定為目標目的地的投影屬性。
例如,如果欄位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貼到結構描述欄位中,如下所示。

熒幕錄製,顯示啟動工作流程對應步驟中的對象成員資格因應措施。

NOTE
對於雲端儲存空間目的地,下列屬性會預設新增至對應:
  • 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

IMPORTANT
目錄中的所有雲端儲存空間目的地都可以檢視已改善的對應步驟,以取代本節中說明的​ 選取屬性 ​步驟。
此​ 選取屬性 ​步驟仍會針對Adobe Campaign、Oracle Responsys、Oracle Eloqua和SalesforceMarketing Cloud電子郵件行銷目的地顯示。

針對以設定檔為基礎的目的地,您必須選取要傳送至目標目的地的設定檔屬性。

  1. 在​ 選取屬性 ​頁面中,選取​ 新增欄位

    影像醒目提示[新增欄位]按鈕。

  2. 選取​ 結構描述欄位 ​專案右側的箭頭。

    影像醒目提示如何選取來源欄位。

  3. 在​ 選取欄位 ​頁面中,選取您要傳送至目的地的XDM屬性或身分識別名稱空間,然後選擇​ 選取

    顯示各種可用欄位做為來源欄位的影像。

  4. 若要新增更多對應,請重複步驟1到3。

NOTE
Adobe Experience Platform會使用結構描述中四個建議且常用的屬性來預先填入您的選取範圍: person.name.firstNameperson.name.lastNamepersonalEmail.addresssegmentMembership.seg_namespace.seg_id.status

此影像顯示對象啟動工作流程對應步驟中預先填入的建議屬性。

IMPORTANT
由於已知的限制,您目前無法使用​ 選取欄位 ​視窗將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

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

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

顯示擴充屬性選取步驟的UI影像。

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

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

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

顯示排除擴充屬性切換的UI影像。

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

檢閱 review

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

檢閱步驟中顯示的選擇摘要。

同意原則評估 consent-policy-evaluation

如果您的組織購買了 Adobe Healthcare ShieldAdobe 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.firstnameperson.lastnameperson.genderperson.birthyearpersonalEmail.address

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6