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，以便我可以使用CTV識別碼在行動、開啟Web、社交和Ramp ID平台上鎖定使用者。
先決條件 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
若要驗證到目的地，請填寫必填欄位並選取Connect to destination。
使用密碼的SFTP驗證
-
Port：用於您LiveRamp - Onboarding儲存位置的連線埠。 使用與您地理位置對應的連線埠，如下所述：
- NA：使用連線埠
22 - AU：使用連線埠
2222
- NA：使用連線埠
-
Username： LiveRamp - Onboarding儲存位置的使用者名稱。
-
Password：您LiveRamp - Onboarding儲存位置的密碼。
-
PGP/GPG encryption key：您可以選擇附加您的RSA格式公開金鑰，以新增加密至匯出的檔案。 在下圖中檢視格式正確的加密金鑰範例。
-
Subkey ID:If您提供加密金鑰，您也必須提供加密Subkey ID。 請參閱LiveRamp 加密檔案以瞭解如何取得子金鑰ID。
使用SSH金鑰驗證的SFTP
-
Port：用於您LiveRamp - Onboarding儲存位置的連線埠。 使用與您地理位置對應的連線埠，如下所述：
- EU：使用連線埠
4222
- EU：使用連線埠
-
Username： LiveRamp - Onboarding儲存位置的使用者名稱。
-
SSH Key：用來登入SSH儲存位置的私人LiveRamp - Onboarding金鑰。 私密金鑰必須格式化為Base64編碼的字串，且不得受密碼保護。
- 若要將您的SSH金鑰連線至LiveRamp - Onboarding伺服器，您必須透過LiveRamp的技術支援入口網站提交票證，並提供您的公開金鑰。 請參閱LiveRamp檔案中的詳細資訊。
-
PGP/GPG encryption key：您可以選擇附加您的RSA格式公開金鑰，以新增加密至匯出的檔案。 在下圖中檢視格式正確的加密金鑰範例。
-
Subkey ID:If您提供加密金鑰，您也必須提供加密Subkey ID。 請參閱LiveRamp 加密檔案以瞭解如何取得子金鑰ID。
填寫目標詳細資訊 destination-details
若要設定目的地的詳細資訊，請填寫下方的必填和選用欄位。 UI中欄位旁的星號表示該欄位為必填欄位。
- Name：您日後可辨識此目的地的名稱。
- Description：可協助您日後識別此目的地的說明。
- Region：您LiveRamp SFTP儲存空間執行個體的地理區域。
- Folder path：將裝載匯出檔案的LiveRamp
uploads子資料夾的路徑。uploads首碼會自動新增至資料夾路徑。 LiveRamp建議從Adobe Real-Time CDP建立傳遞的專用子資料夾，以將檔案與其他任何現有的摘要分開，並確保所有自動化運作順暢無礙。- 例如，如果您要將檔案匯出至
uploads/my_export_folder，請在my_export_folder欄位中輸入Folder path。
- 例如，如果您要將檔案匯出至
- Compression format：選取Experience Platform應用於匯出檔案的壓縮型別。 可用的選項為 GZIP 或None。
啟用警示 enable-alerts
您可以啟用警報以接收有關傳送到您目的地的資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊，請參閱使用UI訂閱目的地警示的指南。
當您完成提供目的地連線的詳細資訊時，請選取Next。
啟動此目標的對象 activate
讀取啟用批次設定檔匯出目的地的對象資料，以取得啟用此目的地對象的指示。
排程 scheduling
在Scheduling步驟中，使用下列設定為每個對象建立匯出排程。
- File export options： Export full files。 目前不支援目的地的增量檔案匯出LiveRamp。
- Frequency：Daily
- Date：視需要選取匯出開始和結束時間。
匯出的檔案名稱目前無法由使用者設定。 所有匯出至LiveRamp - Onboarding目的地的檔案都會根據下列範本自動命名：
%ORGANIZATION_NAME%_%DESTINATION%_%DESTINATION_INSTANCE_ID%_%DATETIME%
例如，名為Luma之組織的匯出檔案名稱可能如下所示：
Luma_LiveRamp_52137231-4a99-442d-804c-39a09ddd005d_20230330_153857.csv
對應屬性和身分 map
在 Mapping 步驟中，您可以選取要為設定檔匯出哪些屬性和身分。
在 Mapping 步驟中，Target field對應會定義匯出的CSV檔案中欄標題的名稱。 您可以為 Target field 提供自訂名稱，將匯出檔案中的CSV欄標題變更為任何您想要的易記名稱。
-
在 Mapping 步驟中，選取Add new mapping。 您會在畫面上看到新的對應列。
-
在 Select source field 視窗中，選擇 Select attributes 類別並選取您要對應的XDM屬性，或選擇 Select identity namespace 類別並選取要對應到目的地的身分。
-
在 Select target field 視窗中，輸入您要將選取的來源欄位對應到的屬性名稱。 此處定義的屬性名稱將在匯出的CSV檔案中反映為欄標題。
您也可以直接在 Target field 中輸入屬性名稱。
新增所有需要的對應之後，請選取 Next 並完成啟動工作流程。
匯出的資料/驗證資料匯出 exported-data
您的資料會匯出至您設定的LiveRamp - Onboarding儲存位置（CSV檔案）。
匯出的檔案大小上限為1,000萬列。 如果選取的對象超過1,000萬列，Experience Platform會每次傳送產生多個檔案。 如果您預計會超過單一檔案限制，請聯絡您的LiveRamp代表，讓他們為您設定批次擷取。
將檔案匯出至LiveRamp - Onboarding目的地時，Experience Platform會為每個合併原則ID產生一個CSV檔案。
例如，我們考慮以下對象：
- 對象A （合併原則1）
- 對象B （合併原則2）
- 對象C （合併原則1）
- 對象D （合併原則1）
Experience 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說明匯入Experience Platform作為自訂上傳的對象。
由於Experience Platform會為每個合併原則ID產生一個CSV檔案，因此也會為每個合併原則ID產生個別的資料流執行。
這表示 Identities activated 資料流執行 Profiles received 頁面中的和量度，會針對使用相同合併原則的每個對象群組進行彙總，而非針對每個對象顯示。
由於為使用相同合併原則的對象群組產生資料流執行，對象名稱不會顯示在監視儀表板中。
將匯出的資料上傳至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 月 | 首次發行 | 已發佈初始目的地版本和檔案。 |