테스트 및 검증
사전 출시 검증 체크리스트
기술 통합
- API :
POST /ads/v3/brand-pagesreturns 200 withcontentData. - Rendering : Content modules render correctly on your site in the correct order.
- Theme:
themefields are applied correctly;nullvalues fall back to retailer style guide defaults. - Optional fields: Renderer and tracking logic must tolerate omitted, null, or empty optional module fields, as well as omitted tracking nodes, without errors (validate using multiple live templates, not just a single demo brand page).
- Styling : Brand page matches your site's design system.
- Mobile : Brand page displays correctly on mobile devices.
- Cache-busting :
{TS}value changes on every request.
추적 유효성 검사
- Impression pixel (C2S) : Every entry in
trackingTemplates.client.impressionPixelUrlsfires and returns 200image/gif - Impression notification (S2S) : Composed server impression URL; GET or POST direct to Epsilon tracking host returns 204 No Content.
- Click tracking (C2S) : Either the composed
client.clickRedirectURL returns 302 to the correct destination, or the composedclient.clickEventreturns 204 No Content (whichever option your flow uses - not both) - Click notification (S2S) : GET or POST direct to the composed server URL returns 204 No Content
- Add-to-cart (C2S) : Composed
client.addToCartEventfired as event beacon returns 204 No Content - Add-to-cart (S2S) : Composed
server.addToCartEventcalled direct to tracking host returns 204 No Content
인프라 & 개인정보 보호
- Reverse proxy : C2S tracking requests forwarded through your domain; S2S is not sent through the proxy
- Headers :
RP-Host,X-Forwarded-For,X-Forwarded-Request-Path,Refererare present on proxied requests - 개인정보 보호: 매개변수 또는 URL에 PII가 없음
- HTTPS: 모든 요청은 보안 연결을 사용.
- 제품 페이지: 클릭 후 리디렉션 시 페이지가 올바르게 표시
권장 도구
- 브라우저 개발자 도구: 픽셀 로드 및 리디렉션을 점검하는 네트워크 탭입니다.
- Fiddler 또는 Charles Proxy — 리버스 프록시 동작 및 헤더 전달을 검사합니다.
문제 해결
| 발행 | 확인 |
|---|---|
| 픽셀을 로드하는 데 실패 | Verify DNS/SSL, confirm proxy path rewrite, check reachability to the Epsilon tracking host. |
| 리디렉션이 전달되지 않음 | Ensure {RURL} is URL-encoded, verify proxy preserves query string. |
| API는 콘텐츠를 반환하지 않음 | Verify catalogId and urlSlug match an active brand page campaign. |
| 추적이 광고 차단기에 의해 차단됨 | Confirm reverse proxy is configured - tracking should route through your domain. |
| 장바구니 추가가 추적되지 않음 | Ensure you fire the composed client or server add-to-cart URL after the cart action. |
| Page throws when loading some brand pages | Likely treating doc/example fields as always required. Log raw module JSON, add guards for optional keys and missing tracking, and confirm the template allows or disables those fields. |
| Theme colors not applying correctly | Check that null theme fields fall back to your style guide defaults, rather than being rendered as literal null values or empty strings. |
용어집
브랜드 페이지 통합을 위한 필수 약관
| 용어 | 정의 | 예시 |
|---|---|---|
| Api 키 | Epsilon 서비스에 대한 인증 자격 증명 | Basic abc123xyz... |
| 브랜드 페이지 | 귀하의 사이트에서 브랜드 랜딩 페이지 경험을 제공 | yoursite.com/brands/nike |
| C2S 추적 | Client-to-Server: Browser-based tracking. Impressions use 1x1 pixels; clicks use a 302 redirect or an event beacon; add-to-cart uses an event beacon. | <img src="impression-pixel">, navigator.sendBeacon(clickEvent) |
| S2S 추적 | 서버-서버(S2S) : 백엔드 트래킹 방식입니다. 구성된 트래킹 URL(GET 또는 POST 방식)로 직접 전송하는 방식이 사용됩니다. | 귀하의 서버 → Epsilon 서버 |
| 콘텐츠 모듈 | 개별 콘텐츠 블록(히어로, 텍스트, 제품 등) | 히어로 배너, 제품 그리드 |
| Module Tags | Optional string labels on a module (e.g., ["header"]) set in the template. Used by retailers for layout routing, analytics, or mapping to their own components. Omitted from the response when empty. | "tags": ["header"] |
| Theme | Always present on success in the API response: nested colors (background + seven text roles) and buttons (primary / secondary with background and text). All theme color fields are required (hex6). See Theme Object. | "theme": {"colors": { ... }, "buttons": { ... }} |
| 노출 | 사용자가 브랜드 페이지를 볼 때 | 페이지 로드 = 1번 노출 |
| 클릭하여 | 사용자가 브랜드 페이지 콘텐츠를 클릭하는 경우 | CTA 버튼을 클릭 |
| 전환 | 사용자가 브랜드 페이지에서 제품을 장바구니에 추가할 경우 | 장바구니에 담기 |
| 리버스 프록시 | 도메인을 통한 추적 경로로 광고 차단기를 회피 | yoursite.com/epsilon/ → Epsilon |
| URL 슬러그 | URL 경로의 브랜드 식별자 | nike in /brands/nike |
| 카탈로그 ID | 고유 제품 카탈로그 식별자 | Epsilon에서 제공 |
| 매크로 | Response placeholders ({TS}, {RURL}) in tracking.params that you replace at runtime; | {TS} → 1737485823910 |
| IAB TCF | 인터랙티브 광고국 투명성 및 동의 프레임워크 | GDPR 준수 표준 |
| PII | 개인 식별 정보(절대 보내지 마십시오!) | 이메일, 전화번호, 실명입니다 |
| 캐시 버스팅 | 캐시된 응답을 방지하기 위해 타임스탬프를 추가 | ?ts=1737485823910 |
기술 약어
| 두문자어 | 용어 전체 | 의미 |
|---|---|---|
| RMN | 리테일 미디어 네트워크 | Epsilon의 광고 플랫폼 |
| CTA | 콜 투 액션 | 클릭 가능한 버튼/링크 |
| JSON | 자바스크립트 객체 표기법 | API 요청/응답을 위한 데이터 형식 |
| HTTPS | HTTP 보안 | 암호화된 웹 프로토콜 |
| GDPR | 일반 데이터 보호 규정(GDPR) | EU 개인정보 보호법 |
| TLS | 전송 계층 보안 | 암호화 프로토콜 |
| DNS | 도메인 이름 시스템 | 인터넷 주소 시스템 |
| SSL | 보안 소켓 계층 | 암호화 프로토콜 |
| RFC | Request for Comments | Technical standards documents |