與 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 查詢，讓商家從 CRM 系統中找出已知目標對象或顧客區隔。

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

LiveRamp 身分解析擷取 API 可讓企業以程式輔助方式，將 PII 資料解析為個人。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 表格中沒有重複的項目 (例如，同一人出現多次，且 PII 資訊相同，即使 ID 可能不同)。如果區隔包含許多重複項目，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 聯絡，取得驗證憑證。這應包含「用戶端 ID」和「用戶端密鑰」。

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 取得的用戶端密鑰。

Managed Airflow 連線

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

設定

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

後續步驟

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