선별된 패키지 알아보기

curators.curatedPackages 리소스를 사용하면 미디어 계획 담당자를 대신하여 선별한 게시자 인벤토리 패키지를 프로그래매틱 방식으로 만들고 관리할 수 있습니다.

선별된 패키지를 사용하면 기기 유형, 지역, 데이터 세그먼트와 같은 특정 타겟팅 기준을 충족하는 인벤토리를 그룹화하고 구매자가 선별된 패키지로 타겟팅된 노출을 획득할 때 청구되는 선별자 수수료를 할당할 수 있습니다.

주요 개념 이해

통합을 시작하기 전에 선별된 패키지의 작동 방식을 정의하는 필드와 설정을 검토하세요.

선별된 패키지에 액세스할 수 있는 사용자 관리

선별된 패키지는 CuratedPackage.accessSettings 필드를 사용하여 액세스 권한을 명시적으로 부여한 미디어 계획자만 액세스할 수 있습니다. 선별된 패키지가 생성될 때 accessSettings 필드를 채워야 합니다.

mediaPlanners.list 메서드를 사용하여 CuratedPackage.accessSettings.allowlistedMediaPlanners 필드에 지정할 수 있는 미디어 플래너 목록을 볼 수 있습니다.

선별 패키지가 타겟팅하는 인벤토리 구성

CuratedPackage.targeting 필드를 사용하여 선별된 패키지가 타겟팅하는 인벤토리를 지정할 수 있습니다. targeting 필드는 기기 유형, 광고 소재 형식, 지리적 위치와 같은 타겟팅 기준을 지원하는 PackageTargeting 객체로 채워집니다.

CuratedPackage.targeting.includedDataSegments 필드를 사용하여 맞춤 타겟팅을 지정할 수도 있습니다. includedDataSegments 필드를 사용하면 나 또는 다른 큐레이션 파트너가 관리하는 데이터 세그먼트를 타겟팅할 수 있습니다.

타겟팅 로직 이해하기

반복 필드의 값은 논리 OR를 사용하여 처리됩니다. 즉, 지정된 값 중 하나에 적용되는 노출이 일치합니다. 각 필드는 논리적 AND를 사용하여 처리됩니다. 즉, 선별된 패키지가 해당 입찰 요청에 표시되려면 지정된 모든 필드가 지정된 노출과 일치해야 합니다.

다음 예시에서는 기기 유형과 데이터 세그먼트의 조합을 타겟팅하도록 CuratedPackage.targeting 필드가 채워진 선별 패키지를 만듭니다.

{
  "includedDeviceTypes": [
    "DEVICE_TYPE_PHONE",
    "DEVICE_TYPE_PERSONAL_COMPUTER"
  ],
  "includedDataSegments": [
    "curators/123456/dataSegments/8765",
    "curators/123456/dataSegments/8172"
  ]
}

다음 표는 예시의 선별된 패키지가 노출을 타겟팅하는지 여부를 보여줍니다. 각 행은 개별 노출입니다.

기기 유형 데이터 세그먼트 ID 큐레이션된 패키지가 타겟팅되는지 여부
DEVICE_TYPE_PERSONAL_COMPUTER 8765, 8172 예
DEVICE_TYPE_PHONE 8172, 4321 예
DEVICE_TYPE_PHONE 9182 아니요
DEVICE_TYPE_CONNECTED_TV 4321, 9182 아니요

큐레이션된 패키지의 가치 알리기

선별된 패키지를 만들 때 CuratedPackage.fee 유니온 필드를 사용하여 선별 수수료를 설정해야 하며 CuratedPackage 객체에서 지원하는 수수료 유형(예: feeCpm 필드) 중 하나만 채울 수 있습니다. 특정 노출의 총 선별 수수료는 선별된 패키지 수수료와 노출에 적용되는 타겟팅된 데이터 세그먼트의 수수료를 합한 금액입니다.

CuratedPackage.floorPriceCpm 필드를 설정하여 선별된 패키지가 타겟팅하는 노출의 가치를 알릴 수도 있습니다. 이는 실시간 입찰에서 입찰자에게 지정된 가격 하한선에 영향을 줄 수 있습니다. 입찰자에게 전송되는 가격 하한선은 floorPriceCpm 필드에 지정한 가격 하한선과 게시자 가격 하한선 및 총 선별 수수료의 합계를 비교했을 때 더 높은 값입니다.

다음 표에는 맞춤 패키지의 입찰 요청에 전송된 유효 최저가가 계산되는 방식의 예가 나와 있습니다.

게시자 가격 하한선 (CPM) 총 선별 수수료 (CPM) 선별된 패키지 가격 하한선 (CPM) 유효 최저가 (CPM)
$7 $2 $10 $10
$4 $1 $4 $5

선별된 패키지의 게재 관리

선별된 패키지는 다음 상태 중 하나일 수 있습니다.

  • ACTIVE: 선별된 패키지가 활성 상태입니다. 구독한 미디어 계획자는 타겟팅된 인벤토리의 선별된 패키지 ID가 포함된 실시간 입찰 입찰 요청을 받을 수 있습니다.
  • INACTIVE: 큐레이션된 패키지가 비활성 상태입니다. 선별된 패키지의 ID는 구독한 미디어 플래너의 경우에도 실시간 입찰 입찰 요청에 표시되지 않습니다.

다음 단계

curatedPackages 리소스로 실행할 수 있는 워크플로에 대해 자세히 알아보려면 다음 콘텐츠를 검토하세요.