Epsilon Retail Media는 어떻게 작동하나요?
API는 REST 방식으로 구성되어 있습니다. API에는 예측 가능한 리소스 중심의 URL이 존재하며 HTTP 응답 코드를 사용하여 API 오류를 나타냅니다. API는 HTTP 인증 및 HTTP 동사를 포함한 기본 HTTP 기능을 사용하며 이 기능은 일반적인 HTTP 클라이언트를 통해 인식됩니다.
API에 대한 인증은 API 키를 사용하여 관리됩니다. API 키는 백엔드와 API 간 통신 시 사용됩니다.
통합 API는 광고 생성에 사용되는 제품, 카탈로그, 고객 및 주문 데이터 업로드를 지원합니다. 통합 API를 사용하여 광고를 요청하고 해당 광고와의 상호 작용을 보고할 수 있습니다.
통합 엔드포인트
Epsilon Retail Media는 다양한 엔드포인트를 사용하여 데이터를 동기화하고 광고를 생성합니다. 아래는 간단한 요약 설명입니다.
| 엔드포인트 | 사용 | 설명 |
|---|---|---|
catalogs | API를 통한 카탈로그 동기화 | API를 통해 카탈로그를 작성하는 데 사용됩니다. 단일 카탈로그 네임스페이스의 경우 이는 기술 계정 관리자가 사용자를 위해 조직할 수 있는 대상입니다. |
catalog-products | API를 통한 제품 동기화 | 카탈로그 내에서 제품 데이터를 작성하고 업데이트하는 데 사용됩니다. |
customers | API를 통한 고객 데이터 동기화 | 카탈로그 내에서 고객 데이터를 작성하고 업데이트하는 데 사용됩니다. |
orders | API를 통한 주문 데이터 동기화 | 주문 데이터를 전송하는 데 사용됩니다. |
/resource/ | 노출 수 및 클릭 수 보고 API를 통한 주문 데이터 동기화 | 프론트엔드를 통해 보고하는 경우 주문은 물론 클릭 수 및 노출 수를 보고하는 데 사용됩니다. |
/ads/generate | 광고 생성 | 제품 광고 및 배너 광고를 생성하는 데 사용됩니다. |
/ads/bannerx | 광고 생성 | 배너 x 광고를 생성하는 데 사용됩니다. |
카탈로그, 제품, 고객 및 주문 동기화에는 별도의 엔드포인트를 사용할 필요가 없습니다. Epsilon Retail Media는 파일을 통한 데이터 동기화를 지원하며 이는 귀하의 요구 사항에 적합할 수 있습니다.
콘텐츠 유형 및 페이로드
데이터 페이로드는 JSON 형식입니다. 이러한 엔드포인트의 Content-Type은 다음과 같이 요청에서 헤더로 전달되어야 하는 application/json입니다.
-H "Content-Type: application/json" \요청 인증
기본 인증
모든 통합 자원은 다음과 같이 API 키와 함께 헤더로 전달되어야 하는 기본 인증을 사용합니다.
-H "Authorization: Basic 4ww25f70-b52s-40de-8f29-07b139b5cdc8" \사용자의 API 키는 소매업체 팀의 통합 설정 섹션에서 액세스할 수 있습니다. 비밀 API 키만 있으면 됩니다.
OAuth 2.0 인증
Epsilon Retail Media's ad generation endpoint is additionally compatible with OAuth2.0. Review OAuth 2.0 Authentication for more information.
기본 URL
Epsilon Retail Media는 스테이징 및 프로덕션 환경에 대해 서로 다른 기본 URL을 사용합니다.
스테이징 환경의 기본 URL을 받으려면 Epsilon Retail Media에 문의하십시오. 통합이 진행되면 프로덕션 환경의 기본 URL이 제공됩니다.