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의 광고 생성 엔드포인트는 OAuth2.0과도 호환됩니다. 자세한 내용은 OAuth 2.0 인증 을 참조하십시오.
기본 URL
Epsilon Retail Media는 스테이징 및 프로덕션 환경에 대해 서로 다른 기본 URL을 사용합니다.
스테이징 환경의 기본 URL을 받으려면 Epsilon Retail Media에 문의하십시오. 통합이 진행되면 프로덕션 환경의 기본 URL이 제공됩니다.