API đối tác
Danh sách API

Danh sách tham chiếu cho quảng cáo biểu ngữ (tĩnh)

Phần dưới đây nêu rõ các thuộc tính có thể có trong yêu cầu tiêu chuẩn như nêu trong phần Yêu cầu quảng cáo biểu ngữ đối với yêu cầu của bạn và phản hồi nếu bạn nhận được quảng cáo.

📘

Quảng cáo biểu ngữ được yêu cầu trên điểm cuối /generate giống như quảng cáo sản phẩm. Chỉ cần một yêu cầu là có thể truy xuất cả hai loại quảng cáo.

Mục được yêu cầu

ChuỗiMô tảBắt buộc/không bắt buộc
bannerSlotsMảng các vùng biểu ngữ mà bạn muốn nhận quảng cáo biểu ngữ. Bằng cách chỉ định maxNumberOfAds cho các vùng biểu ngữ, bạn có thể truy xuất tối thiểu hai biểu ngữ cho vùng đó. Tính năng này áp dụng cho các vị trí quảng cáo xoay vòng.Bắt buộc
bannerSlotIdsMột mảng vùng biểu ngữ mà bạn muốn nhận quảng cáo biểu ngữBắt buộc, được thay thế bằng bannerSlots
catalogIdMã nhận dạng danh mục cho trang web của bạn.Bắt buộc
contentStandardIdMã nhận dạng tiêu chuẩn nội dung cho trang web của bạn.Bắt buộc
customerIdMã nhận dạng duy nhất cho khách hàng được phân phát quảng cáo.Tùy chọn
filterModeCách xác định cấu trúc yêu cầu của bạn (không bắt buộc). Xem phần Lọc tạo quảng cáo để biết thêm thông tin.Không bắt buộc, ưu tiên
maxNumberOfAdsSố lượng quảng cáo sản phẩm tối đa bạn muốn trả lại là 15.Bắt buộc, cho phép quảng cáo sản phẩm được phân phát trong cùng một yêu cầu. Nếu không muốn có quảng cáo sản phẩm, hãy đặt thành 0
optionsCách xác định cấu trúc yêu cầu của bạn (không bắt buộc). Xem phần Lọc tạo quảng cáo để biết thêm thông tin.Không bắt buộc, ưu tiên
placementVị trí duy nhất mà bạn đang yêu cầu quảng cáo.Bắt buộc
productFiltersBất kỳ bộ lọc sản phẩm nào có liên quan đến yêu cầu của bạn. Như danh mục, vị trí hoặc kích cỡ.Bắt buộc
sessionIdMã nhận dạng duy nhất cho phiên của khách hàng. Dùng để phân bổ trong các tùy chọn tích hợp tiêu chuẩn. Đọc kỳ phần Các tùy chọn quy trình tích hợp để biết thêm thông tin.Bắt buộc trong quy trình tích hợp tiêu chuẩn
dtmCookieIdCookie được tạo và lưu trữ bởi trang web, được sử dụng để theo dõi hành vi của người dùng trên cùng một tên miền.Tùy chọn

Mặt hàng bị trả lại

ChuỗiMô tảVí dụ về giá trị
altTextVăn bản thay thế cho hình ảnh trung tâm nếu hình ảnh này không hiển thị (hiếm khi xảy ra).Advertisement for <BRAND>. Art of the Burger. Create your delicious masterpiece. Shop Now.
contentStandardIdMã nhận dạng tiêu chuẩn nội dung cho trang web của bạn.`4ffb80ba-b9a9-4567-8069-79b2eca93473
expiryThời hạn của quảng cáo. Đây là thời điểm gần nhất mà một lượt nhấp được báo cáo cho CitrusAd2021-06-01T23:48:16.573967987Z
idID duy nhất của quảng cáo.
Đây là mã duy nhất cho mỗi yêu cầu được gửi đến CitrusAd và sẽ không lưu được vào bộ nhớ đệm.		banner_j2vfi9pN2BiQZk4X9sC55PgNu5k3ODIzOTlfMDAwODc2ODQwMDEwNzM=
imageUrlLiên kết hình ảnh của biểu ngữ.[<https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3>](https://cdn.[server].io/s/9b93e7f9-d747-4c8b-bcba-2357b280a3b3`)
gtinsMột mảng gồm tối đa 20 mã sản phẩm được chọn từ các sản phẩm được quảng cáo trong chiến dịch. [ "7714107", "7163379", "7733636", "7733657", "7733628" ],
linkUrlUrl được chuyển tiếp từ biểu ngữ khi khách hàng nhấp vào biểu ngữ.<https://www.retailer.com/groceries/en-GB/search?query=double-fudge>
slotIdId của vị trí cụ thể cho biểu ngữ bạn đã yêu cầu.Category_Top
tagsTrường này trả về thẻ bên thứ ba bất kỳ được nhà quảng cáo nhập vào trong chiến dịch.{ "dv": "<script src=\"<https://cdn.doubleverify.com/dvtp_src.js?ctx=111111&cmp=11111111&sid=111111&plc=111111&adsrv=111&btreg=&btadsrv=&crt=&tagtype=&dvtagver=6.1.src\>" type=\"text/javascript\"></script>" }
textĐược sử dụng trong quy trình tích hợp theo yêu cầu riêng như một trường văn bản bổ sung.
positionVị trí của quảng cáo trong phản hồi CitrusAd. Bạn nên chú ý đến vị trí này nếu sử dụng chiến dịch thuê cố định.1
sellerIdId không trùng lặp của người bán. Sẽ chỉ được tạo nếu sellerID được cài đặt trong nhóm. sellerID thường được sử dụng khi hỗ trợ người bán trên thị trường trong những bước đầu tiên.73nns-32sxr-32ss Tùy chỉnh mỗi lần tích hợp