파트너 API
API 참조

위치 타게팅

위치 타기팅을 사용하면 광고주나 소매업체가 캠페인에서 특정 위치(예: 매장 또는 지역)를 타기팅할 수 있습니다. 이 기능은 광범위한 게재 위치에서 오디언스를 특정 위치로 좁히기 위해 사용할 수 있습니다.

👍

이 개선 사항은 확장 디스플레이 게재 위치에서 권장됩니다

이는 탐색 기반에 더 가깝기 때문에 가장 좋은 방법은 카테고리 또는 확장 디스플레이 게재 위치에 이를 통합하는 것입니다. 검색 게재 위치에서는 캠페인이 이미 의도 타기팅이 되어 있어 광고주가 선택 가능한 오디언스가 줄어들 수 있으므로 이 방법을 사용하지 않는 것이 좋습니다.

고급 단계 개요

CitrusAd의 위치 타기팅 기능을 통해 광고주는 캠페인 마법사에서 위치를 선택할 수 있습니다. 검색, 카테고리 및 확장 디스플레이 게재 위치에 대해 게재 위치 수준별로 활성화할 수 있습니다. 인터페이스 예시는 다음과 같습니다.

이 기능은 카테고리 타기팅 기능과 유사하게 작동하여 광고주가 선택한 제품에서 동기화된 위치를 선택할 수 있습니다. 위치가 선택되면 리뷰 및 캠페인 관리자 화면에서 해당 위치를 확인할 수 있습니다.

통합 개요

이 통합의 일부로 다음을 수행해야 합니다.

  1. 제품 광고에서 위치 수준 필터 동기화
  2. filterMapping API를 통해 UI 친화적 위치 이름 또는 지도 위치를 함께 동기화(통합 조건부)
      1. 이름 대신 위치 ID로 통합했거나 위치를 함께 매핑하려는 경우에만 적용됩니다(예: 매장을 동기화하고 해당 지역에 매핑하려는 경우).
  3. 광고 요청 시 위치 필터를 사용할 수 있도록 개선

제품 광고에서 위치 수준 필터 동기화

UI에 위치를 표시하려면 각 제품 광고에서 관련 데이터(가용성)를 동기화해야 합니다. 통합에 따라 귀하는 광고 충족률을 높이기 위해 이미 이 정보를 동기화하고 있을 수 있습니다.

API로 동기화

API를 통해 제품 광고를 동기화하는 경우 각 제품 광고를 filters 개체 내 관련 위치로 업데이트해야 합니다. API를 통한 제품 광고 동기화 페이지의 위치 정보 동기화 섹션에 자세한 예가 나와 있습니다.

파일로 동기화

파일을 통해 카탈로그 및 제품을 동기화하는 경우 제품별 재고를 보유한 관련 위치를 지정하는 열을 파일에 추가하기만 하면 됩니다. 이는 다음으로 이름이 지정된 다른 열이 됩니다. location.

📘

위치 필터 형식

위치 필터 형식은 location:<value>를 사용하는 것이 좋습니다. 이 형식은 보고 API에 올바르게 표시되며 광고 요청에서 광고 실행 시 사용해야하는 것과 동일한 형식입니다.

파일을 통해 동기화하는 경우 클라이언트 통합 엔지니어가 이를 올바르게 매핑할 수 있습니다.

filterMapping API로 위치 이름 동기화

필터 매핑 API를 사용하면 위치 ID를 사용자가 읽을 수 있는 값에 매핑할 수 있습니다. 이는 UI가 사용자에게 값을 표시할 때 위치 ID를 동기화하는 경우 필요합니다. 단일 수준 필터(예: 상태)를 동기화하는 경우 UI에 각 선택 항목이 아래와 같이 표시됩니다.

매장을 지역 또는 유사한 집계에 매핑하는 경우 각 선택 항목에 해당되는 위치 필터 수가 표시됩니다.


📘

제품 광고 카탈로그에서 사용자가 읽을 수 있는 지역을 위치로 CitrusAd에 동기화하는 경우에는 이 단계가 필요하지 않습니다.

광고 요청 개선

통합에 따라 귀하는 광고 충족률을 높이기 위해 이미 이 정보를 동기화하고 있을 수 있습니다 . productFilters 개체에서 사용자의 위치를 지정하기 위한 요청을 개선하는 것이 필요합니다.

요청 형식은 아래 표시된 광고 요청과 일치해야 합니다:

🚧

선택한 게재 위치에만 위치 타게팅을 추가하고 싶으신가요?

모든 게재 위치에서 이 개선 사항을 구현하고 싶을 수도 있습니다. 이렇게 하면 선택한 게재 위치에서 타기팅을 활성화하더라도 모든 게재 위치에서 구현이 표준화됩니다.

알려진 기능 제한 사항

개발을 시작하기 전에 이 기능에 대한 아래 제한 사항을 알아두는 것이 좋습니다.

  • 이 기능은 제품에 동기화된 필터를 활용합니다. 제품 광고-위치 가용성을 동기화하여 지원되는 SLA 서비스 수준 계약을 유지하는 것이 좋습니다.
  • 이 기능은 카테고리 교차 판매 또는 레거시 제품 교차 판매 게재 위치와 호환되지 않습니다.
  • 캠페인에서 선택한 위치별 내부 UI 보고 기능이 없습니다.
    • 이 정보는 보고 API를 사용하는 소매 업체를 위한 사실 수준 보고 데이터 세트에 표시됩니다. 외부 시스템에서 필요한 경우 소매 업체가 위치 수준 보고를 통해 보고를 롤업할 수 있습니다.
  • 고정 테넌시 예약을 통해 캠페인에서 위치를 선택할 수 있으나 캠페인별로 예약할 수는 없습니다.
    • 카테고리, 검색어 또는 게재 위치 수준(확장 스플레이 게재 위치의 경우)에서 예약이 이루어집니다.