LiveRamp 통합

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

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 Data Foundation은 LiveRamp와 통합하여 ID 확인을 지원합니다.Cortex Frameworks는 RampID 조회를 실행할 수 있으므로 비즈니스는 CRM 시스템에서 알려진 잠재고객 또는 고객 세그먼트를 식별할 수 있습니다.

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

LiveRamp Identity Resolution Retrieval API를 사용하면 비즈니스가 개인 식별 정보 데이터를 개인으로 프로그래매틱 방식으로 확인할 수 있습니다. Cortex Framework는 API 호출을 통해 해싱된 PII 데이터를 전송하여 LiveRamp의 Lookup Endpoint를 사용합니다.

입력 및 출력 테이블

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

테이블 rampid_lookup_input개

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

열 데이터 유형 설명 예시 기본 키
id 문자열 이 레코드의 고유 ID입니다. '123' 예
segment_name 문자열 잠재고객/CRM/고객 세그먼트의 이름입니다. '가치가 높음' 아니요
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 테이블은 비즈니스 요구사항에 따라 주기적으로 고객의 PII 세부정보로 채워야 합니다. Cortex Framework는 이를 자동화하는 방법을 제공하지 않지만 이미 Cortex Framework로 배포된 Salesforce 시스템의 데이터를 사용하여 이 테이블을 채우는 방법을 보여주는 샘플 스크립트 ddls/samples/populate_rampid_lookup_input.sql를 제공합니다. 데이터가 다른 시스템에서 가져온 경우 이 파일을 가이드로 사용할 수 있습니다.

rampid_lookup_input 테이블에 중복 항목이 없어야 합니다(예: ID가 다를 수 있지만 동일한 개인이 동일한 PII 정보로 여러 번 표시됨). 세그먼트에 중복 항목이 많으면 Cortex Framework Lookup 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 (출력 테이블)에는 입력 테이블에 비해 약간 적은 수의 레코드가 포함될 수 있습니다. 이는 LiveRamp API 조회가 실패하지 않도록 하기 위해 Cortex Framework에서 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단계에서 가져온 클라이언트 보안 비밀번호로 바꿉니다.

Cloud Composer 연결

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

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

구성

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

다음 단계