목차
Criteo 리셀러 프로그램 API V2 - 전체 참조 가이드
개념
다음 개념은 Criteo 리셀러 프로그램 API에서 사용됩니다.
- 예산 - 예산은 하나 이상의 캠페인에서 판매자의 지출을 제한합니다. 초기 금액과 지출 금액이 있습니다. 시작일과 종료일도 있습니다. 판매자 캠페인을 통해 판매된 광고 클릭은 협상 요율에 따라 관련 예산에 대해 청구됩니다. 예산은 동일한 판매자에게 속하는 한 여러 판매자 캠페인에서 소비될 수 있습니다.
- 캠페인 - 캠페인은 판매자의 제품을 홍보하기 위한 조치 과정입니다.
- 광고주 - 광고주는 판매자를 대신하여 광고하는 법인입니다. 일반적으로 광고주는 CRP 솔루션을 사용하여 판매자 광고 예산으로 수익을 창출하는 마켓플레이스입니다. 별칭: 마켓플레이스
- 판매자 - 귀하의 마켓플레이스에서 제품을 판매하는 판매자입니다. 판매자는 Criteo 플랫폼을 통해 인터넷에서 제품을 더 많이 노출함으로써 캠페인을 통해 이익을 얻습니다. 그러나 판매자는 Criteo와 재정적으로 교류하지 않습니다.
- 판매자 캠페인 - 판매자 캠페인은 특정 캠페인에서 사용하기 위해 판매자가 동의한 비즈니스 규칙을 요약한 리소스입니다. 예를 들어 판매자가 일부 캠페인에 적용하려는 최대 입찰가가 포함됩니다. 플랫폼(웹 대 모바일)마다 일반적으로 캠페인이 다릅니다.
이 API에 노출된 리소스는 다음과 같습니다.
- 광고주(광고주)
- 판매자(판매자)
- 판매자 캠페인(판매자 캠페인)
- 예산(예산)
또한 v1 캠페인 리소스(/marketing/v1/campaigns)도 API에서 참조됩니다.
이러한 리소스에는 각각 전역적으로 고유한 식별자가 있습니다. 단, sellerId 및 campaignId가 고유 식별자 역할을 하는 판매자 캠페인은 예외입니다.
판매자 리소스는 광고주와 연결되며 해당 컨텍스트에서 고유한 이름도 갖습니다.
설계
v2 스키마의 디자인은 가장 중요한 리소스에 대한 다음 관계 다이어그램을 기반으로 합니다.
모든 판매자 캠페인은 단일 판매자와 단일 캠페인으로 구성된 복합 기본 키를 사용합니다. 여러 예산 리소스에 연결할 수 있습니다. 예산은 동일한 판매자에게 속하는 한 여러 판매자 캠페인에서 소비될 수 있습니다. 그러나 비즈니스 규칙에서는 최대 하나의 현재 일일예산과 하나의 현재 비일일예산이 있다고 규정합니다. 비일일예산 없이 일일예산을 구성할 수 있지만 일일예산만으로는 판매자 캠페인을 활성화하고 광고 게재를 시작하기에 충분하지 않습니다. 비일일(일명 '총') 예산이 필요합니다.
API 끝점
- 이 설계 문서는 https://api.criteo.com/marketing/v2/crp 서비스 루트 아래에 있는 서비스에 대해 설명합니다.
- API에 대한 스웨거 설명은 https://api.criteo.com/marketing/swagger 에서 확인할 수 있습니다.
이 서비스 루트는 리셀러 프로그램 도메인에만 사용됩니다. 과거에 리셀러 프로그램은 판매자 URI 경로 세그먼트 아래의 https://api.criteo.com/marketing/v1/ 서비스 루트의 일부였습니다.
이 섹션의 나머지 부분은 URI 주소로 구성됩니다. 네 가지 주요 하위 섹션이 있습니다.
- 광고주
- 판매자(판매자)
- 판매자 캠페인(판매자 캠페인)
- 예산(예산)
각 하위 섹션은 지원되는 끝점 표로 시작합니다.