Tối ưu hóa nhắm mục tiêu quảng cáo

Tài liệu này trình bày các phương pháp tốt nhất để tạo quảng cáo sản phẩm ở các vị trí tìm kiếm, danh mục và hiển thị rộng rãi (trang chủ, thanh toán, đặc biệt, v.v.). Việc triển khai các chiến lược này làm cho quảng cáo của bạn có liên quan và được nhắm mục tiêu hơn, nâng cao mức độ tương tác và sự hài lòng của người dùng. Các cải tiến bao gồm phân trang, tìm kiếm được lọc và chức năng lọc dựa trên vị trí cho phương pháp quảng cáo được cá nhân hóa.

Để tạo quảng cáo sản phẩm bằng cách sử dụng vị trí tìm kiếm và danh mục, hãy xem các chủ đề sau:

Yêu cầu Phân trang

Phân trang là một kỹ thuật được sử dụng để quản lý các tập hợp dữ liệu lớn bằng cách chia chúng thành các trang hoặc phân đoạn riêng biệt. Trong bối cảnh tạo quảng cáo sản phẩm, tính năng phân trang đảm bảo rằng người dùng không bị choáng ngợp bởi quá nhiều quảng cáo cùng một lúc và các quảng cáo đã xem trước đó không được cấp phát một cách dư thừa.

Khi bạn tạo quảng cáo sản phẩm, phản hồi sẽ bao gồm một memoryToken. Mã thông báo này giúp theo dõi những quảng cáo nào đã được cấp phát. Bằng cách đưa mã này memoryToken vào các yêu cầu quảng cáo tiếp theo, bạn có thể đảm bảo rằng các quảng cáo đã cấp phát trước đây sẽ bị loại trừ khỏi phản hồi quảng cáo mới, nâng cao trải nghiệm người dùng bằng cách hiển thị quảng cáo mới và có liên quan.

  • Yêu cầu ban đầu: Tạo quảng cáo sản phẩm và nhận memoryToken trong phản hồi.
  • Các yêu cầu tiếp theo: Đưa memoryToken vào các yêu cầu quảng cáo tiếp theo để loại trừ quảng cáo được cấp phát trước đó khỏi phản hồi.

Để biết thêm thông tin, hãy xem Phân trang.

Yêu cầu Thông số

Nội dung yêu cầu phải là một đối tượng JSON chứa các trường sau:

đối tượngtypeMô tả
customerIdchuỗi, bắt buộcMã nhận dạng duy nhất cho khách hàng. Mã này được cung cấp bởi nhà bán lẻ của bạn.
sessionIdchuỗi, bắt buộcMã nhận dạng duy nhất cho phiên. Mã này là bắt buộc để phân bổ và được cung cấp bởi nhà bán lẻ.
placementchuỗi, bắt buộcNgữ cảnh trong đó quảng cáo được hiển thị (ví dụ: "tìm kiếm").
catalogIdchuỗi, bắt buộcMã nhận dạng duy nhất cho catalogue sản phẩm mà sản phẩm đang được lọc. Bạn có thể tải ID catalogue từ giao diện người dùng Retail Media của Epsilon hoặc từ nhà bán lẻ.
maxNumberOfAdssố nguyên, bắt buộcSố lượng quảng cáo tối đa được hiển thị.
searchTermchuỗi, bắt buộc đối với vị trí tìm kiếmThuật ngữ để tìm kiếm trong danh mục.
memoryTokenchuỗi, bắt buộcMã token để loại trừ các quảng cáo đã cấp phát trước đó.
optionsđối tượng, tùy chọnCác tùy chọn bổ sung như chế độ lọc AndOr. Nếu được chỉ định, hệ thống sẽ sử dụng cả điều kiện "AND" và "OR" để thu hẹp kết quả tìm kiếm.

Yêu cầu Ví dụ

Trong ví dụ sau, yêu cầu quảng cáo ban đầu là dành cho vị trí tìm kiếm có cụm từ "sô cô la". Yêu cầu memoryToken được bao gồm để đảm bảo rằng các quảng cáo được cấp phát trước đó cho cùng một cụm từ tìm kiếm và ngữ cảnh được loại trừ khỏi phản hồi. Đối options tượng chỉ định chế độ lọc và maxNumberOfAds đặt giới hạn cho số lượng quảng cáo được tạo trong phản hồi.

Bằng cách tận dụng khả năng phân trang và mã token bộ nhớ, bạn có thể cung cấp trải nghiệm quảng cáo năng động và hấp dẫn hơn cho người dùng của mình, tránh sự dư thừa và nâng cao mức độ liên quan.

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    
}

Ví dụ về Phản hồi

Mọi phản hồi quảng cáo sản phẩm đều tuân theo một định dạng JSON chuẩn. Quảng cáo sản phẩm được trả về trong mảng quảng cáo.

  • id: ID quảng cáo được sử dụng trong báo cáo số lần hiển thị và nhấp chuột.
  • gtin: Mã số thương phẩm toàn cầu cho sản phẩm.
  • giảm giá: Chi tiết về bất kỳ chiết khấu nào áp dụng cho quảng cáo.
    • số tiền: Số tiền chiết khấu.
    • minPrice: Giá tối thiểu để được giảm giá.
    • maxPerCustomer: Số lượng mặt hàng tối đa mà khách hàng có thể mua với mức giảm giá.
  • hết hạn: Ngày và thời gian hết hạn của quảng cáo.
  • vị trí: Vị trí của quảng cáo trong tải trọng phản hồi. Luôn đọc và chú ý đến trường vị trí để đảm bảo các vị trí thuê cố định hiển thị chính xác.
{
    "ads": [
        {
            "id": "display_QqHaKRrKlFm1Wxr9c_DXJN4HSE3NzMzNjM2",
            "gtin": "7733636",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400902957Z",
            "position": 1
        },
        {
            "id": "display_NzsHqP0_iQedlo9VnrO2vqkwi_k3NzMzNjI4",
            "gtin": "7733628",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400908257Z",
            "position": 2
        },
        {
            "id": "display_xNeShqidaMuEqiJ0zNdt-Gzygjs3NzE0MTA3",
            "gtin": "7714107",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400912929Z",
            "position": 3
        },
        {
            "id": "display_3rGiryPskhQusmsf43nghbQwnqo3NzMzNjU3",
            "gtin": "7733657",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400917769Z",
            "position": 4
        }
    ],
    "banners": [],
    "products": [],
    "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}

Khi hỗ trợ người bán trên thị trường trong những bước đầu tiên, một sellerId trường bổ sung có thể xuất hiện trong phản hồi quảng cáo. Trường này chỉ được đưa vào nếu nhóm sở hữu chiến dịch đã định cấu hình ID người bán trong giao diện người dùng Phương tiện truyền thông Bán lẻ Epsilon.

Ví dụ với ID Người bán

{
    "ads": [
        {
            "id": "display_QqHaKRrKlFm1Wxr9c_DXJN4HSE3NzMzNjM2",
            "gtin": "7733636",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400902957Z",
            "position": 1
        },
        {
            "id": "display_NzsHqP0_iQedlo9VnrO2vqkwi_k3NzMzNjI4",
            "gtin": "7733628",
            "sellerId": "2834-ascre-2wcr4",
            "discount": {
                "amount": 0,
                "minPrice": 0,
                "maxPerCustomer": 0
            },
            "expiry": "2021-05-12T04:17:50.400908257Z",
            "position": 2
        }
    ],
    "banners": [],
    "products": [],
    "memoryToken":"85ykKVv-luDHMWLZx2d6xcPq6sF7CgkJCSJDb3VudGVyIjogIjIiLAoJCQkiQWRzIjogWwoJCQkJImRpc3BsYXlfV05VV0NwQkRKMUpKNm5wdVZSVExvOU40TUxzNE1UWTBOemt5TWc9PSIsCgkJCQkiZGlzcGxheV9MME5NUHRxNmdCcVFvREJOd3J0dE9UTGJoWk0xTVRFeU9UYzRPUT09IiwKCQkJCSJkaXNwbGF5XzlCcEpmdUpaWk9VXzgyaWpFM3VCczgxd3VVczRNekkwTnpVeE5nPT0iLAoJCQkJImRpc3BsYXlfcW1VU1p4TkpMQ0lqeWQwdTFJRDk0RmxVZ0pnNE16STBOelV4Tnc9PSIsCgkJCQkiZGlzcGxheV9oeHlFZktCUnRrNWlxMThMQzE1SDJHcEN3QjgxTVRFeU9UYzVNQT09IiwKCQkJCSJkaXNwbGF5X1NkcjFEcU5aUEFtcGh0Q1FIUndoYUxFT1B0RXhNamsxT1RJNE5BPT0iLAoJCQkJImRpc3BsYXlfeVlSai1qV2Ntc2ozNzhrel9PMm0yOVlwTjhJeE5EazNPRE00TXc9PSIsCgkJCQkiZGlzcGxheV9Xbm9NZGZuLTRTVmhxcF9xQzVvLWxoT0paNm8xTkRJeE1UUTROdz09IgoJCQldLAoJCQkiVFRMIjogMTYyODk4NTYwMAoJCX0="
}

Tìm kiếm đã lọc

Khi khách hàng áp dụng bộ lọc cho tìm kiếm của họ, bạn có thể nâng cao ngữ cảnh truy vấn của họ bằng cách sử dụng productFilters. Điều này cho phép bạn nhắm mục tiêu quảng cáo chính xác hơn dựa trên danh mục hoặc thuộc tính cụ thể. Dưới đây, chúng tôi cung cấp ví dụ về cách lọc theo danh mục "Tủ ly" và hạn chế về chế độ ăn uống "Không chứa gluten". Phương pháp này có thể được điều chỉnh cho phù hợp với bất kỳ danh mục hoặc vị trí đối sánh rộng nào.

Yêu cầu Thông số

Nội dung yêu cầu phải là một đối tượng JSON chứa các trường sau:

đối tượngtypeMô tả
customerIdchuỗi, bắt buộcMã nhận dạng duy nhất cho khách hàng. Mã này được cung cấp bởi nhà bán lẻ của bạn.
sessionIdchuỗi, bắt buộcMã nhận dạng duy nhất cho phiên. Mã này là bắt buộc để phân bổ và được cung cấp bởi nhà bán lẻ.
placementchuỗi, bắt buộcNgữ cảnh trong đó quảng cáo được hiển thị (ví dụ: "tìm kiếm").
catalogIdchuỗi, bắt buộcMã nhận dạng duy nhất cho catalogue sản phẩm mà sản phẩm đang được lọc. Bạn có thể tải ID catalogue từ giao diện người dùng Retail Media của Epsilon hoặc từ nhà bán lẻ.
maxNumberOfAdssố nguyên, bắt buộcSố lượng quảng cáo tối đa được hiển thị.
searchTermchuỗi, bắt buộc đối với vị trí tìm kiếmThuật ngữ để tìm kiếm trong danh mục.
productFiltersmảng, bắt buộcMột mảng chứa các bộ lọc danh mục.
optionsđối tượng, tùy chọnCác tùy chọn bổ sung như chế độ lọc AndOr. Nếu được chỉ định, hệ thống sẽ sử dụng cả điều kiện "AND" và "OR" để thu hẹp kết quả tìm kiếm.

Yêu cầu Ví dụ

Ví dụ về yêu cầu sử dụng phương thức HTTP POST để gửi một đối tượng JSON đến điểm cuối được chỉ định. Mảng productFilters chỉ định rằng tìm kiếm phải được lọc theo danh mục "Tủ ly" và hạn chế về chế độ ăn uống "Không chứa gluten". Đối tượng tùy chọn đặt filterMode thành AndOr, cho phép kết hợp linh hoạt các bộ lọc. Trường maxNumberOfAds giới hạn số lượng quảng cáo hiển thị ở mức ba.

Bằng cách tuân theo cấu trúc này, bạn có thể tạo các chiến dịch quảng cáo được nhắm mục tiêu phù hợp hơn với tiêu chí tìm kiếm của khách hàng, từ đó nâng cao trải nghiệm tổng thể của người dùng.

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",
    "productFilters": [
     	 ["category:Cupboard"],["dietary:Gluten-free"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}

Lọc theo vị trí

Khi đồng bộ hóa bộ lọc vị trí trong danh mục của mình, bạn có thể mở rộng ngữ cảnh để bao gồm vị trí cửa hàng của khách hàng trong productFilters. Tính năng này cho phép bạn nhắm mục tiêu quảng cáo dựa trên vị trí cửa hàng cụ thể, nâng cao mức độ liên quan của quảng cáo được hiển thị cho khách hàng.

Yêu cầu Thông số

Nội dung yêu cầu phải là một đối tượng JSON chứa các trường sau:

đối tượngtypeMô tả
customerIdchuỗi, bắt buộcMã nhận dạng duy nhất cho khách hàng. Mã này được cung cấp bởi nhà bán lẻ của bạn.
sessionIdchuỗi, bắt buộcMã nhận dạng duy nhất cho phiên. Mã này là bắt buộc để phân bổ và được cung cấp bởi nhà bán lẻ.
placementchuỗi, bắt buộcNgữ cảnh trong đó quảng cáo được hiển thị (ví dụ: "tìm kiếm").
catalogIdchuỗi, bắt buộcMã nhận dạng duy nhất cho catalogue sản phẩm mà sản phẩm đang được lọc. Bạn có thể tải ID catalogue từ giao diện người dùng Retail Media của Epsilon hoặc từ nhà bán lẻ.
maxNumberOfAdssố nguyên, bắt buộcSố lượng quảng cáo tối đa được hiển thị.
searchTermchuỗi, bắt buộc đối với vị trí tìm kiếmThuật ngữ để tìm kiếm trong danh mục.
productFiltersmảng, bắt buộcMột mảng chứa các bộ lọc danh mục.
optionsđối tượng, tùy chọnCác tùy chọn bổ sung như chế độ lọc AndOr. Nếu được chỉ định, hệ thống sẽ sử dụng cả điều kiện "AND" và "OR" để thu hẹp kết quả tìm kiếm.

Yêu cầu Ví dụ

Ví dụ về yêu cầu sử dụng phương thức HTTP POST để gửi một đối tượng JSON đến điểm cuối được chỉ định.

  • productFilters mảng chỉ định rằng tìm kiếm phải được lọc theo:
    • Danh mục: "Tủ ly"
    • Hạn chế về chế độ ăn uống: "Không chứa gluten"
    • Vị trí: "Westenbury"
  • Đối tượng tùy chọn đặt filterMode thành AndOr, cho phép kết hợp linh hoạt các bộ lọc.
  • maxNumberOfAds giới hạn số lượng quảng cáo hiển thị ở mức ba.

Bằng cách tuân theo cấu trúc này, bạn có thể tạo các chiến dịch quảng cáo được nhắm mục tiêu phù hợp hơn với tiêu chí tìm kiếm của khách hàng, từ đó nâng cao trải nghiệm tổng thể của người dùng.

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",
    "productFilters": [
     	 ["category:Cupboard"],["dietary:Gluten-free"],["location:Westenbury"]
    ],
    "options": {
   							 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3
}