LiveRamp와의 통합

이 페이지에서는 Cortex Framework Data Foundation의 마케팅 워크로드 데이터 소스로 LiveRamp의 데이터를 가져오는 데 필요한 구성을 설명합니다.

LiveRamp는 기업이 데이터를 연결, 제어, 활성화하여 고객 경험을 개선하고 비즈니스 실적을 향상할 수 있도록 지원하는 데이터 공동작업 플랫폼입니다. Cortex Framework는 데이터를 분석하고, 다른 데이터 소스와 결합하고, AI를 사용하여 심층적인 유용한 정보를 얻고 마케팅 전략을 최적화할 수 있는 도구와 플랫폼을 제공합니다.

다음 다이어그램은 Cortex Framework Data Foundation의 마케팅 워크로드를 통해 LiveRamp 데이터 소스를 사용할 수 있는 방법을 설명합니다.

LiveRamp 데이터 소스

그림 1. LiveRamp 데이터 소스입니다.

구성 파일

config.json 파일은 다양한 워크로드에서 데이터를 전송하기 위해 데이터 소스에 연결하는 데 필요한 설정을 구성합니다. 이 파일에는 LiveRamp의 다음 매개변수가 포함되어 있습니다.

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

다음 표에서는 각 LiveRamp 매개변수의 값을 설명합니다.

매개변수 의미 기본값 설명
marketing.LiveRamp LiveRamp 배포 true LiveRamp 데이터 소스의 배포를 실행합니다.
marketing.LiveRamp.datasets.cdc LiveRamp용 CDC 데이터 세트 LiveRamp용 CDC 데이터 세트입니다.

API 연결

Cortex Framework 데이터 기반은 LiveRamp와 통합하여 신원 확인을 지원합니다.Cortex Framework는 RampID 조회를 실행할 수 있으며, 이를 통해 기업은 CRM 시스템에서 알려진 잠재고객 또는 고객 세그먼트를 식별할 수 있습니다.

RampID는 이메일, 전화번호, 이름과 같은 개인 식별 정보 (PII)를 사용하여 LiveRamp의 API에서 생성된 식별자입니다. 이 RampID를 사용하면 비즈니스에서 다양한 캠페인의 잠재고객과 같은 여러 시스템에서 레코드를 식별하고 통합할 수 있습니다. LiveRamp와 통합하면 비즈니스에서 잠재고객을 식별하고 타겟팅하는 능력을 개선하여 더 효과적이고 맞춤화된 마케팅 캠페인을 진행할 수 있습니다.

LiveRamp Identity Resolution Retrieval API를 사용하면 비즈니스가 개인에 대한 PII 데이터를 프로그래매틱 방식으로 해결할 수 있습니다. Cortex Framework는 API 호출을 통해 해시된 PII 데이터를 전송하여 LiveRamp의 조회 엔드포인트를 사용합니다.

입력 및 출력 테이블

Cortex Framework를 배포하면 시스템에서 config.json에 제공된 관련 데이터 세트에 다음 두 BigQuery 테이블을 만듭니다.

테이블 rampid_lookup_input개

rampid_lookup_input 테이블은 RampID 조회 프로세스의 입력입니다.

열 데이터 유형 설명 예시 기본 키
id 문자열 이 레코드의 고유 ID입니다. '123' 예
segment_name 문자열 잠재고객/CRM/고객 세그먼트의 이름입니다. 'High Value' 아니요
source_system_name 문자열 레코드가 제공된 소스 시스템입니다. 'Salesforce' 아니요
name 문자열 고객 이름 'John Doe' 아니요
이메일 문자열 고객 이메일 'example@example.com' 아니요
phone_number 문자열 고객 전화번호 '1234567890' 아니요
postal_code 문자열 고객 우편번호 '12345' 아니요
is_processed BOOL 레코드가 이미 처리되었는지 여부를 나타냅니다.

새 레코드의 경우 FALSE로 채웁니다.

시스템은 처리되면 이를 TRUE로 업데이트합니다. 		FALSE 아니요
load_timestamp TIMESTAMP 레코드가 시스템에 삽입된 시점의 타임스탬프입니다. 이는 순전히 감사 목적으로만 사용됩니다. '2020-01-01 00:00:00 UTC' 아니요
processed_timestamp TIMESTAMP 시스템이 이 레코드에 대해 API 조회를 실행한 타임스탬프입니다. 이 값은 항상 시스템에 의해 채워집니다. '2020-01-01 00:00:00 UTC' 아니요

rampid_lookup_input 표는 비즈니스 요구사항에 따라 고객의 개인 식별 정보 세부정보(예: Cortex Framework는 이를 수행하는 자동화된 방법을 제공하지 않지만, Cortex Framework로 이미 배포된 Salesforce 시스템의 데이터를 사용하여 이 테이블을 채우는 방법을 보여주는 샘플 스크립트 ddls/samples/populate_rampid_lookup_input.sql를 제공합니다. 데이터가 다른 시스템에서 제공되는 경우 이 파일을 가이드로 사용할 수 있습니다.

rampid_lookup_input 표에 중복 항목이 없는지 확인합니다(예: ID이 다를 수 있지만 동일한 개인의 동일한 PII 정보가 여러 번 표시됨). 세그먼트에 중복 항목이 많이 포함되어 있으면 Cortex Framework 조회 DAG가 실패합니다. 이는 LiveRamp API에 의해 적용됩니다.

rampid_lookup 테이블

rampid_lookup 테이블은 입력 레코드의 각 세그먼트에 대한 RampID가 포함된 출력 테이블입니다. LiveRamp는 설계상 RampID를 개별 레코드에 매핑할 수 없습니다.

열 데이터 유형 설명
segment_name 문자열 입력 테이블의 세그먼트 이름입니다.
ramp_id 문자열 LiveRamp RampID
레코드 스탬프 TIMESTAMP 이 RampID 조회가 실행된 타임스탬프입니다.

LiveRamp RampID는 동일한 개인에 대해 시간이 지남에 따라 변경될 수 있습니다. 즉, 이미 처리된 데이터를 경우에 따라 새로 조회해야 합니다. Cortex Framework는 세그먼트 수준에서 이를 실행하는 방법을 보여주는 샘플 스크립트 ddls/samples/clean_up_segment_matching.sql를 제공합니다. 이렇게 하면 전체 세그먼트를 재설정할 수 있으며 시스템에서 해당 세그먼트를 조회하여 최신 RampID를 제공합니다.

rampid_lookup (출력 테이블)에는 입력 테이블에 비해 레코드 수가 약간 적을 수 있습니다. 이는 Cortex Framework가 LiveRamp API 조회가 실패하지 않도록 PII 세부정보를 사용하여 입력 레코드를 디버그하려고 하기 때문에 의도된 동작입니다.

계정 인증

  1. LiveRamp에 문의하여 인증 사용자 인증 정보를 받습니다. 여기에는 클라이언트 ID와 클라이언트 보안 비밀번호가 포함되어야 합니다.

  2. Secret Manager를 사용하여 이름이 cortex-framework-liveramp인 보안 비밀을 만들고 다음을 값으로 사용합니다. Secret-Manager 문서의 안내를 참고하세요.

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

    다음을 바꿉니다.

    • 'CLIENT_ID'를 1단계에서 가져온 클라이언트 ID로 바꿉니다.
    • 'CLIENT_SECRET'을 1단계에서 가져온 클라이언트 보안 비밀번호로 바꿉니다.

관리형 Airflow 연결

관리형 Airflow에서 다음 연결을 만듭니다. 자세한 내용은 Airflow 연결 관리 문서를 참고하세요.

연결 이름 목적
liveramp_cdc_bq LiveRamp API > CDC 데이터 세트 전송

구성

config.ini 파일은 관리형 Airflow DAG의 일부 동작과 LiveRamp API가 사용되는 방식을 제어합니다. 필요에 따라 LiveRamp/src/pipelines/config.ini 파일을 구성합니다. 이러한 매개변수는 파일에 이미 설명되어 있지만 liveramp_api_base_url에 유의하세요. 이 매개변수는 기본적으로 LiveRamp의 프로덕션 API URL을 가리키며, 테스트 목적으로 설정에 따라 스테이징 버전을 가리켜야 할 수도 있습니다.

다음 단계