API ของคู่ค้า
ข้อมูลอ้างอิง API

Validation & Troubleshooting

การทดสอบและการตรวจสอบ

รายการตรวจสอบการตรวจสอบความถูกต้องก่อนการเปิดตัว

การผสานรวมทางเทคนิค

  • API :POST /ads/v3/brand-pages returns 200 with contentData.
  • Rendering : Content modules render correctly on your site in the correct order.
  • Theme: theme fields are applied correctly; null values 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.impressionPixelUrls fires and returns 200 image/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.clickRedirect URL returns 302 to the correct destination, or the composed client.clickEvent returns 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.addToCartEvent fired as event beacon returns 204 No Content
  • Add-to-cart (S2S) : Composed server.addToCartEvent called 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, Referer are present on proxied requests
  • ความเป็นส่วนตัว: ไม่มี PII ปรากฏในพารามิเตอร์หรือ URL ใดๆ
  • 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 pagesLikely 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 correctlyCheck that null theme fields fall back to your style guide defaults, rather than being rendered as literal null values or empty strings.

คําศัพท์

ข้อกําหนดที่จําเป็นสําหรับการรวมแบรนด์เพจ

คำค้นหาคำนิยามตัวอย่าง
คีย์ APIข้อมูลรับรองความถูกต้องของคุณสำหรับบริการ EpsilonBasic abc123xyz...
หน้าแบรนด์ประสบการณ์แลนดิ้งเพจที่มีแบรนด์บนเว็บไซต์ของคุณyoursite.com/brands/nike
การติดตาม C2SClient-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เซิร์ฟเวอร์ไปยังเซิร์ฟเวอร์: การติดตามฝั่งแบ็กเอนด์ (GET หรือ POST ไปยัง URL ติดตามที่ประกอบขึ้น)เซิร์ฟเวอร์ของคุณ → เซิร์ฟเวอร์ Epsilon
โมดูลเนื้อหาบล็อกเนื้อหาแต่ละรายการ (ฮีโร่ ข้อความ ผลิตภัณฑ์ ฯลฯ)แบนเนอร์ฮีโร่ ตารางผลิตภัณฑ์
Module TagsOptional 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"]
ThemeAlways 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ตัวระบุแบรนด์ในเส้นทาง URLnike ใน /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คำกระตุ้นการตัดสินใจปุ่ม/ลิงก์ที่คลิกได้
JSONJavaScript Object Notation (JSON) หรือ การบ่งชี้วัตถุแบบ JavaScriptรูปแบบข้อมูลสําหรับคําขอ/การตอบกลับ API
HTTPSHTTP ปลอดภัยโปรโตคอลเว็บที่เข้ารหัส
GDPRกฎระเบียบการคุ้มครองข้อมูลทั่วไปกฎหมายความเป็นส่วนตัวของสหภาพยุโรป
TLSการรักษาความปลอดภัยชั้นการขนส่งโปรโตคอลการเข้ารหัส
DNSระบบชื่อโดเมนระบบที่อยู่อินเทอร์เน็ต
SSLชั้นซ็อกเก็ตปลอดภัยโปรโตคอลการเข้ารหัส
RFCRequest for CommentsTechnical standards documents

ที่อัปเดต ประมาณ 1 เดือนที่แล้ว

ที่อัปเดต ประมาณ 1 เดือนที่แล้ว