Phần dưới đây mô tả các thuộc tính có thể có trong một yêu cầu tiêu chuẩn như đã nêu trong mục Yêu cầu quảng cáo để bản gửi yêu cầu, 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
/generategiố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ỗi | Mô tả | Bắt buộc/không bắt buộc |
|---|---|---|
bannerSlots | Mả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 |
bannerSlotIds | Mộ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 |
catalogId | Mã nhận dạng danh mục cho trang web của bạn. | Bắt buộc |
contentStandardId | Mã nhận dạng tiêu chuẩn nội dung cho trang web của bạn. | Bắt buộc |
customerId | Mã 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 |
filterMode | Cá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 |
maxNumberOfAds | Số 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 |
options | Cá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 |
placement | Vị trí duy nhất mà bạn đang yêu cầu quảng cáo. | Bắt buộc |
productFilters | Bấ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 |
sessionId | Mã 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 |
Mặt hàng bị trả lại
| Chuỗi | Mô tả | Ví dụ về giá trị |
|---|---|---|
altText | Vă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. |
contentStandardId | Mã nhận dạng tiêu chuẩn nội dung cho trang web của bạn. | `4ffb80ba-b9a9-4567-8069-79b2eca93473 |
expiry | Thờ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 CitrusAd | 2021-06-01T23:48:16.573967987Z |
id | ID 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= |
imageUrl | Liê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`) |
gtins | Mộ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" ], |
linkUrl | Url đượ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> |
slotId | Id của vị trí cụ thể cho biểu ngữ bạn đã yêu cầu. | Category_Top |
tags | Trườ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. | |
position | Vị 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 |
sellerId | Id 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 |