Cải thiện trải nghiệm khách hàng khi duyệt nhiều trang cùng lúc. Khi tạo quảng cáo sản phẩm, bạn sẽ nhận được memoryToken và token này có thể gửi trong các yêu cầu theo sau để loại trừ các quảng cáo đã được cấp phát.
Chỉ quảng cáo sản phẩm!
Tính năng này hiện chỉ được hỗ trợ cho các quảng cáo sản phẩm của CitrusAd.
Làm thế nào để phân trang trên trang web của bạn?
Khi tạo quảng cáo sản phẩm, trong mục phản hồi, bạn sẽ nhận được memoryToken.
{
"ads": [
{
"id": "display_3rGiryPskhQusmsf43nghbQwnqo3NzMzNjU3",
"gtin": "7733657",
"discount": {
"amount": 0,
"minPrice": 0,
"maxPerCustomer": 0
},
"expiry": "2021-05-12T04:17:50.400917769Z",
"position": 1
}
],
"banners": [],
"products": [],
"memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}
Khi khách hàng điều hướng đến trang tiếp theo, bạn cần gửi mã token này trong yêu cầu quảng cáo tiếp theo của mình.
POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
"customerId": "wertg5432a",
"sessionId": "ec9-4e07-881d-3e9",
"placement": "search",
"catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
"searchTerm": "chocolate",
"memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0=",
"options": {
"filterMode": "AndOr"
},
"maxNumberOfAds": 3
}
Khi sử dụng mã token này, CitrusAd sẽ loại trừ mọi quảng cáo đã được cấp phát trước đó cho khách hàng nếu sessionId giống với yêu cầu của mã token đó.
Tích hợp tiêu chuẩn!
Tính năng này hiện chỉ được hỗ trợ cho các quảng cáo sản phẩm của CitrusAd.
Cách thức hoạt động như thế nào?
Khi CitrusAd nhận được memoryToken trong yêu cầu quảng cáo, bất kỳ quảng cáo nào đã cấp phát trước đó cho sessionId sẽ bị loại trừ khỏi phản hồi quảng cáo. Điều này khách hàng của bạn sẽ được cấp phát nhiều loại quảng cáo hơn khi họ duyệt nhiều trang.
Khi mã token này không tồn tại theo yêu cầu, việc tạo quảng cáo sẽ được thực hiện theo quy trình hiện tại mà không áp dụng loại trừ nào. Mã token sẽ luôn được cung cấp sau khi tạo quảng cáo để nhà bán lẻ lựa chọn sử dụng.
Mã token bộ nhớ chứa thông tin được mã hóa cho phép CitrusAd xác định các quảng cáo đã được cấp phát trước đó (dù là trong một yêu cầu đơn lẻ hoặc trong một khoảng thời gian có nhiều yêu cầu được xâu chuỗi).
Trong trường hợp có mã token không liên quan được gửi đến CitrusAd (chẳng hạn như có ngữ cảnh khác), quảng cáo sẽ được trả về như thể không có mã token nào được cung cấp trong yêu cầu quảng cáo đó.
️ Bạn có yêu cầu nhiều quảng cáo hơn số lượng được phân phát đến trang web của mình không?
Nếu bạn là nhà bán lẻ và bạn yêu cầu thêm nhiều quảng cáo từ CitrusAd hơn mức phân phối thực tế cho khách hàng của mình thì bạn có thể sẽ không nhận được nhiều quảng cáo trên các trang tiếp theo. Nếu bạn yêu cầu 15 quảng cáo và chỉ cấp phát 4 quảng cáo cho khách hàng của mình thì khi nhận được
memoryToken, CitrusAd sẽ loại trừ tất cả 15-20 quảng cáo đã cấp phát trước đó cho bạn trong phản hồi quảng cáo tiếp theo.
Quy trình yêu cầu mẫu
Câu hỏi thường gặp
Tôi có thể sử dụng mã token này trên nhiều tìm kiếm của khách hàng để loại trừ các sản phẩm trên hành trình khách hàng lớn hơn không?
Không, nếu CitrusAd nhận được yêu cầu quảng cáo không khớp với yêu cầu quảng cáo của mã token, yêu cầu đó sẽ bị bỏ qua và quảng cáo được tạo theo hình thức không có mã token nào được cung cấp.
Nếu tôi gửi một memoryToken không đúng định dạng thì sao?
CitrusAd sẽ bỏ qua mã token đó và xử lý yêu cầu như thể đó là một yêu cầu bất thường.
Tôi có thể phân trang cho bao nhiêu trang?
Mặc định là 5, đây là mức cân bằng tốt nhất giữa hiệu suất và độ bão hòa mà CitrusAd đã thấy trên nhiều khách hàng.
Kể từ phiên bản 39.0 của CitrusAd, tính năng này có thể được định cấu hình bởi người quản lý tài khoản kỹ thuật của bạn.
Điều gì xảy ra khi bạn không có quảng cáo để cấp phát, chẳng hạn như cho trang 5-10 trên cấu hình mặc định?
MemoryToken được cấu hình ở phía CitrusAd để lưu trữ quảng cáo từ số trang trong cấu hình. Ví dụ: nếu cấu hình là mặc định cho 5 trang, CitrusAd sẽ bắt đầu cấp phát lại quảng cáo từ trang 7.
Yêu cầu phân trang 6 (trang 6): memoryToken chứa thông tin về quảng cáo của 5 trang trước đó, do đó sẽ không có quảng cáo nào từ 5 trang trước được cấp phát.
Yêu cầu phân trang 7 (trang 7): các quảng cáo từ trang 1 đủ điều kiện để được cấp phát.
Điều gì xảy ra nếu tôi không còn quảng cáo trước trang 5 trên cấu hình mặc định?
Ví dụ: nếu ở trang 3, bạn không còn quảng cáo, chúng tôi sẽ bắt đầu cấp phát quảng cáo ở trang 7, vì chúng tôi lưu trữ tổng số trang trong cấu hình dưới dạng quảng cáo đã cấp phát trước đó và quảng cáo này sẽ không được cấp phát lại.