與 LiveRamp 整合

本頁面說明必要設定，可將 LiveRamp 的資料做為 Cortex Framework Data Foundation 行銷工作負載的資料來源。

LiveRamp 是資料協作平台，可協助企業連結、控管及啟用資料，進而提升顧客體驗並帶動業績成長。Cortex Framework 提供工具和平台，可供您分析資料、與其他資料來源合併，以及運用 AI 深入瞭解資料並調整行銷策略。

下圖說明如何透過 Cortex Framework Data Foundation 的行銷工作負載，使用 LiveRamp 資料來源：

設定檔

config.json 檔案會設定連線至資料來源所需的設定，以便從各種工作負載移轉資料。這個檔案包含下列 LiveRamp 參數：

   "marketing": {
        "deployLiveRamp": true,
        "LiveRamp": {
            "datasets": {
                "cdc": ""
            }
        }
    }

下表說明各個 LiveRamp 參數的值：

API 連線

Cortex Framework 資料基礎可透過與 LiveRamp 整合，進行身分解析。Cortex Framework 可執行 RampID 查詢，讓商家從客戶關係管理系統中找出已知目標對象或顧客區隔。

RampID 是由 LiveRamp 的 API 產生，使用的個人識別資訊 (PII) 包括電子郵件地址、電話號碼和姓名。商家可透過這個 RampID 識別及整合多個系統中的記錄，例如不同廣告活動的目標對象。整合 LiveRamp 後，商家就能更準確地找出及指定目標對象，進而放送更有效且個人化的行銷廣告活動。

LiveRamp 身分解析擷取 API 可讓商家以程式輔助方式，將個人識別資訊資料解析為個人。Cortex Framework 會透過 API 呼叫傳送經過雜湊處理的 PII 資料，使用 LiveRamp 的查詢端點。

輸入和輸出表格

部署 Cortex Framework 後，系統會在 config.json 中提供的相關資料集中，建立下列兩個 BigQuery 資料表。

rampid_lookup_input 個資料表

rampid_lookup_input 資料表是 RampID 查詢程序的輸入內容。

請根據業務需求，定期在 rampid_lookup_input 表格中填入客戶的 PII 詳細資料，例如：Cortex Framework 不提供自動執行這項作業的方法，但提供範例指令碼 ddls/samples/populate_rampid_lookup_input.sql，說明如何使用已透過 Cortex Framework 部署的 Salesforce 系統資料，填入這個資料表。如果資料來自其他系統，您可以使用這個檔案做為指南。

請確認 rampid_lookup_input 表格中沒有重複的項目 (例如，即使 ID 可能不同，同一人也不應出現多次，且具有相同的 PII 資訊)。如果區隔包含許多重複項目，Cortex Framework 查詢 DAG 就會失敗。這項限制由 LiveRamp API 強制執行。

rampid_lookup 表格

rampid_lookup 資料表是輸出資料表，內含輸入記錄中每個區隔的 RampID。根據設計，LiveRamp 不允許將 RampID 對應至個別記錄。

LiveRamp RampID 可能會在一段時間內變更，但仍對應同一位使用者。也就是說，您需要不時對已處理的資料執行新的查詢。Cortex Framework 提供範例指令碼 ddls/samples/clean_up_segment_matching.sql，說明如何在區隔層級執行這項操作。這樣一來，您就能重設整個區隔，系統會為該區隔執行查閱作業，並提供最新的 RampID。

與輸入資料表相比，rampid_lookup (輸出資料表) 的記錄數量可能略少。這是設計使然，因為 Cortex Framework 會嘗試使用 PII 詳細資料偵錯輸入記錄，確保 LiveRamp API 查詢不會失敗。

帳戶驗證

1. 與 LiveRamp 聯絡，取得驗證憑證。這應包含「Client ID」(用戶端 ID) 和「Client Secret」(用戶端密鑰)。

2. 使用 Secret Manager 建立名為 cortex-framework-liveramp 的密鑰，並使用下列值。請參閱 Secret Manager 說明文件中的操作說明。

   {
     'client_id':'CLIENT_ID',
     'client_secret':'CLIENT_SECRET',
     'grant_type':'client_credentials'
   }
   

   更改下列內容：

   • 以步驟 1 取得的用戶端 ID 取代 'CLIENT_ID'。
   • 將 'CLIENT_SECRET' 替換為您在步驟 1 中取得的用戶端密鑰。

Cloud Composer 連線

在 Cloud Composer 中建立下列連線。詳情請參閱「管理 Airflow 連線」說明文件。

設定

config.ini 檔案可控制 Cloud Composer DAG 的部分行為，以及 LiveRamp API 的使用方式。根據需求設定 LiveRamp/src/pipelines/config.ini 檔案。雖然檔案中已說明這些參數，但請注意 liveramp_api_base_url。根據預設，這個參數會指向 LiveRamp 的正式版 API 網址。視設定而定，您可能需要將這個參數指向測試版，以利進行測試。

後續步驟

• 如要進一步瞭解其他資料來源和工作負載，請參閱「資料來源和工作負載」一文。
• 如要進一步瞭解在正式環境中部署的步驟，請參閱 Cortex Framework Data Foundation 部署作業的必要條件。