파트너 API
API 참조

옵션 3: 대상 고객만 동기화

🚧

개발 예정!

다음은 향후 제공될 기능에 대한 사전 안내입니다. 전체적인 구조는 개발이 완료되는 과정에서 세부 사양이 변경될 수 있습니다.

개요

고객 식별자를 공유할 수 없는 조직의 경우 세그먼트 피드를 동기화하고 광고 요청에서 세그먼트 ID를 전달하는 방식으로 대상 고객 기반 광고 타겟팅을 실행할 수 있습니다. 이러한 프라이버시 우선 접근 방식을 통해 고객 수준 데이터 노출 없이 맞춤형 및 일반 대상 고객 타겟팅을 모두 수행할 수 있습니다. 대상 활성화를 지원하기 위해 광고 요청에는 세그먼트 식별자가 반드시 포함되어야 합니다.

통합 요구 사항

  • 세그먼트 피드에는 지정된 광고주 팀에서 사용 가능한 대상 고객 세그먼트가 지정되어야 합니다.
  • 광고 요청에는 각 고객에 대한 관련 세그먼트 ID가 반드시 포함되어야 합니다.

작동 방식

CDP 또는 오디언스 플랫폼은 파일 업로드 또는 API를 통해 Epsilon에 세그먼트 피드를 제공합니다. 광고 요청에 포함된 세그먼트 ID는 대상 고객을 캠페인에 매칭하는 데 사용됩니다. 고객과 세그먼트 간의 매핑은 소매업체의 백엔드 시스템 내에서 내부적으로 관리됩니다.

통합 사례

광고 요청 예시: 세그먼트 ID를 포함한 광고 요청:

POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "segmentIds":[
        "general-segment-4","general-segment-3"
    ],
    "sessionId": "ec9-4e07-881d-3e9",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "options": {
        "filterMode": "AndOr"
    },
    "maxNumberOfAds": 3
}

피드 파일 동기화 통합 (권장)

세그먼트 동기화 시 파일은 하나만 필요합니다.

세그먼트 파일

세그먼트 파일은 UI에 표시되는 세그먼트 ID, 이름 및 설명을 제공하는 데 사용됩니다. 또한 세그먼트를 볼 수 있는 특정 team_ids를 지정할 수 있어 특정 광고주를 위한 세그먼트를 큐레이팅할 수 있습니다.

segment_id이름설명team_ids
general-segment-1고액 소비 고객주간 평균 구매액이 상위 15%에 해당하는 고객
general-segment-2가치 지향 고객가치 지향 상품 구매 비중이 높은 고객
general-segment-3반복 쇼핑 고객평균적으로 매주 쇼핑하는 고객
custom-segment-1사용자 정의: 최근 BrandCo 구매 빈도가 높은 고객지난 30일 내 BrandCo를 구매한 고객["a5166fc4-f874-4741-a721-c05ffd9941a5","92f4b91f-0089-4102-b13b-6015da8e0174"]

여기에서 세그먼트 참조 가이드를 확인하십시오.

API 동기화 통합

API를 통해 고객 및 세그먼트 동기화 시, 한두 가지 작업을 완료해야 합니다.

  1. 세그먼트 생성
  2. 선택 사항: 관리자 세그먼트 액세스

API를 통한 세그먼트 생성

광고 요청 전에 고객-세그먼트 간 관계가 이미 관리되고 있으므로, 세그먼트만 전송하면 됩니다.

UI에 표시될 세그먼트 ID, 이름, 설명 및 귀하의 소매업체 팀 정보를 제공해야 합니다.

📘

세그먼트 API는 파트너 API에서 사용하는 Bearer 인증을 사용합니다. Bearer 토큰을 생성한 후 사용해야 합니다. 자세히 알아보기: 인증 요청.

POST $BASE_URL/v1/segments HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer <API_KEY>
{
  "segment":{
        "segmentId": "general-segment-4",
        "sourceId": "DEFAULT_SOURCE_ID",
        "name": "Value Shoppers",
        "description": "Shoppers that have a higher basket % of value driven products.",
        "retailerTeamId": "13c84def-41cb-4f99-a3fc-6788264f79fe"
  }
}

여기에서 세그먼트 생성 엔드포인트에 대한 참조를 확인하십시오.

선택 사항: 세그먼트 액세스 관리

관리 액세스 기능을 사용하여 선택한 광고주가 세그먼트를 확인할 수 있도록 액세스 권한을 부여할 수 있으며 이를 통해 특정 광고주에 대한 세그먼트를 큐레이션할 수 있습니다.

POST $BASE_URL/v1/segments/{id}:manage-access HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Bearer <API_KEY>
{
  "accessTeamIds":[
        "90d5f138-2090-412b-a397-1f59ea6a31b3","1439f6f2-8c43-4ec5-b511-fc153f7d8119"
        ]
}

여기에서 특정 세그먼트 엔드포인트에 대한 액세스 관리 참조를 확인하십시오.