LiveRamp - Onboarding個連線 liveramp-onboarding
使用LiveRamp - Onboarding連線將對象從Adobe Real-time Customer Data Platform上線到LiveRamp Connect。
使用案例 use-cases
為協助您更清楚瞭解您應如何及何時使用LiveRamp - Onboarding目的地，以下是Adobe Experience Platform客戶可藉由使用此目的地解決的範例使用案例。
身為行銷人員，我想要將對象從Adobe Experience Platform傳送至內建身分識別至LiveRamp Connect，以便我可以使用Ramp ID識別碼在行動、開啟Web、社交和CTV平台上鎖定使用者。
先決條件 prerequisites
LiveRamp - Onboarding連線使用LiveRamp的SFTP儲存空間匯出檔案。
在從Experience Platform傳送資料給LiveRamp - Onboarding之前，您需要您的LiveRamp認證。 如果您尚未取得認證，請洽詢您的LiveRamp代表以取得認證。
支援的身分 supported-identities
LiveRamp - Onboarding支援啟用PII型識別碼、已知識別碼和自訂ID等識別碼，如官方LiveRamp檔案所述。
在啟動工作流程的對應步驟中，您必須將目標對應定義為自訂屬性。
支援的對象 supported-audiences
本節說明您可以將哪些型別的對象匯出至此目的地。
匯出型別和頻率 export-type-frequency
請參閱下表以取得目的地匯出型別和頻率的資訊。
連線到目標 connect
若要連線到此目的地，請依照目的地組態教學課程中所述的步驟進行。 在設定目標工作流程中，填寫以下兩個區段中列出的欄位。
驗證目標 authenticate
若要驗證到目的地，請填入必填欄位，然後選取 連線到目的地。
使用密碼的SFTP驗證
-
連線埠：您的LiveRamp - Onboarding儲存位置所使用的連線埠。 使用與您地理位置對應的連線埠，如下所述：
- NA：使用連線埠
22 - AU：使用連線埠
2222
- NA：使用連線埠
-
使用者名稱： LiveRamp - Onboarding儲存位置的使用者名稱。
-
密碼： LiveRamp - Onboarding儲存位置的密碼。
-
PGP/GPG加密金鑰：您可以選擇附加RSA格式的公開金鑰，將加密新增至匯出的檔案。 在下圖中檢視格式正確的加密金鑰範例。
-
子金鑰識別碼：如果您提供加密金鑰，您也必須提供加密 子金鑰識別碼。 請參閱LiveRamp 加密檔案以瞭解如何取得子金鑰ID。
使用SSH金鑰驗證的SFTP
-
連線埠：您的LiveRamp - Onboarding儲存位置所使用的連線埠。 使用與您地理位置對應的連線埠，如下所述：
- EU：使用連線埠
4222
- EU：使用連線埠
-
使用者名稱： LiveRamp - Onboarding儲存位置的使用者名稱。
-
SSH金鑰：用來登入LiveRamp - Onboarding儲存位置的私人SSH金鑰。 私密金鑰必須格式化為Base64編碼的字串，且不得受密碼保護。
- 若要將您的SSH金鑰連線至LiveRamp - Onboarding伺服器，您必須透過LiveRamp的技術支援入口網站提交票證，並提供您的公開金鑰。 請參閱LiveRamp檔案中的詳細資訊。
-
PGP/GPG加密金鑰：您可以選擇附加RSA格式的公開金鑰，將加密新增至匯出的檔案。 在下圖中檢視格式正確的加密金鑰範例。
-
子金鑰識別碼：如果您提供加密金鑰，您也必須提供加密 子金鑰識別碼。 請參閱LiveRamp 加密檔案以瞭解如何取得子金鑰ID。
填寫目標詳細資訊 destination-details
若要設定目的地的詳細資訊，請填寫下方的必填和選用欄位。 UI中欄位旁的星號表示該欄位為必填欄位。
- 名稱：您日後可辨識此目的地的名稱。
- 描述：可協助您日後識別此目的地的描述。
- 地區：您LiveRamp SFTP儲存體執行個體的地理區域。
- 資料夾路徑： LiveRamp
uploads子資料夾的路徑，此子資料夾將裝載匯出的檔案。uploads首碼會自動新增至資料夾路徑。 LiveRamp建議從Adobe Real-Time CDP建立傳遞的專用子資料夾，以將檔案與其他任何現有的摘要分開，並確保所有自動化運作順暢無礙。- 例如，如果您要將檔案匯出至
uploads/my_export_folder，請在 資料夾路徑 欄位中輸入my_export_folder。
- 例如，如果您要將檔案匯出至
- 壓縮格式：選取Experience Platform應用於匯出檔案的壓縮型別。 可用的選項為 GZIP 或 無。
啟用警示 enable-alerts
您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊，請參閱使用UI訂閱目的地警示的指南。
當您完成提供目的地連線的詳細資訊後，請選取 下一步。
啟動此目標的對象 activate
讀取啟用批次設定檔匯出目的地的對象資料，以取得啟用此目的地對象的指示。
正在排程 scheduling
在排程步驟中，為每個對象建立一個匯出排程，其設定如下所示。
- 檔案匯出選項： 匯出完整檔案。 目前不支援LiveRamp目的地的增量檔案匯出。
- 頻率： 每日
- 日期：視需要選取匯出開始和結束時間。
匯出的檔案名稱目前無法由使用者設定。 所有匯出至LiveRamp - Onboarding目的地的檔案都會根據下列範本自動命名：
%ORGANIZATION_NAME%_%DESTINATION%_%DESTINATION_INSTANCE_ID%_%DATETIME%
例如，名為Luma之組織的匯出檔案名稱可能如下所示：
Luma_LiveRamp_52137231-4a99-442d-804c-39a09ddd005d_20230330_153857.csv
對應屬性和身分 map
在 對應 步驟中，您可以選取要為設定檔匯出的屬性和身分。
在 對應 步驟中，目標欄位 對應會定義匯出CSV檔案中欄標題的名稱。 您可以為 目標欄位 提供自訂名稱，將匯出檔案中的CSV欄位標題變更為您想要的任何好記名稱。
-
在 對應 步驟中，選取 新增對應。 您會在畫面上看到新的對應列。
-
在 選取來源欄位 視窗中，選擇 選取屬性 類別並選取您要對應的XDM屬性，或選擇 選取身分名稱空間 類別並選取要對應到目的地的身分。
-
在 選取目標欄位 視窗中，輸入您要將選取的來源欄位對應到的屬性名稱。 此處定義的屬性名稱將在匯出的CSV檔案中反映為欄標題。
您也可以直接在 目標欄位 中輸入屬性名稱，以輸入屬性名稱。
新增所有需要的對應之後，請選取 下一步 並完成啟動工作流程。
匯出的資料/驗證資料匯出 exported-data
您的資料會匯出至您設定的LiveRamp - Onboarding儲存位置（CSV檔案）。
匯出的檔案大小上限為1,000萬列。 如果選取的對象超過1,000萬列，Experience Platform會在每次傳送中產生多個檔案。 如果您預計會超過單一檔案限制，請聯絡您的LiveRamp代表，讓他們為您設定批次擷取。
將檔案匯出至LiveRamp - Onboarding目的地時，Platform會為每個合併原則ID產生一個CSV檔案。
例如，我們考慮以下對象：
- 對象A （合併原則1）
- 對象B （合併原則2）
- 對象C （合併原則1）
- 對象D （合併原則1）
Platform會將兩個CSV檔案匯出至LiveRamp - Onboarding：
- 一個CSV檔案，包含對象A、C和D；
- 一個CSV檔案包含對象B。
匯出的CSV檔案包含具有所選屬性的設定檔和對應的對象狀態，位於獨立的欄上，並具有屬性名稱，以及作為欄標題的audience_namespace:audience_ID對，如以下範例所示：
ATTRIBUTE_NAME, AUDIENCE_NAMESPACE_1_AUDIENCE_ID_1, AUDIENCE_NAMESPACE_2_AUDIENCE_ID_2,..., AUDIENCE_NAMESPACE_X_AUDIENCE_ID_X
匯出檔案中包含的設定檔可符合下列其中一個對象資格狀態：
Active：設定檔目前符合對象的資格。Expired：設定檔不再符合對象的資格，但過去已符合資格。""（空字串）：設定檔從未符合對象的資格。
例如，具有一個email屬性、兩個源自Experience Platform分段服務的對象，以及一個匯入外部對象的匯出CSV檔案可能如下所示：
email,ups_aa2e3d98-974b-4f8b-9507-59f65b6442df,ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f,CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e
abc117@testemailabc.com,active,,
abc111@testemailabc.com,,,active
abc102@testemailabc.com,,,active
abc116@testemailabc.com,active,,
abc107@testemailabc.com,active,expired,active
abc101@testemailabc.com,active,active,
在上述範例中，ups_aa2e3d98-974b-4f8b-9507-59f65b6442df和ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f區段說明源自細分服務的對象，而CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e說明將對象匯入至Platform做為自訂上傳。
由於Platform會針對每個合併原則ID產生一個CSV檔案，因此也會針對每個合併原則ID產生個別的資料流執行。
這表示資料流執行頁面中收到的 身分啟用 和 設定檔 量度，會針對使用相同合併原則的每個對象群組進行彙總，而非針對每個對象顯示。
由於為使用相同合併原則的對象群組產生資料流執行，對象名稱不會顯示在監視儀表板中。
將匯出的資料上傳至LiveRamp upload-to-liveramp
在資料成功匯出至LiveRamp - Onboarding儲存體後，您必須將資料上傳至LiveRamp平台。
如需有關如何將檔案從LiveRamp - Onboarding儲存空間上傳到LiveRamp對象的詳細資訊，請參閱下列檔案： 將第一個檔案上傳到對象時的考量事項。
資料使用與控管 data-usage-governance
處理您的資料時，所有Adobe Experience Platform目的地都符合資料使用原則。 如需Adobe Experience Platform如何強制資料控管的詳細資訊，請閱讀資料控管概觀。
其他資源 additional-resources
如需如何設定LiveRamp - Onboarding儲存空間的詳細資訊，請參閱正式檔案。
Changelog changelog
本節擷取此目的地聯結器的功能和重要檔案更新。
| table 0-row-3 1-row-3 2-row-3 layout-auto | ||
|---|---|---|
| 發行月份 | 更新型別 | 說明 |
| 2024 年 3 月 | 功能和檔案更新 |
|
| 2023 年 7 月 | 首次發行 | 已發佈初始目的地版本和檔案。 |