Tài liệu này cung cấp hướng dẫn toàn diện về cách tạo quảng cáo sản phẩm dựa trên tiêu chí tìm kiếm được chỉ định. Mỗi yêu cầu API đều phải nêu ngữ cảnh chi tiết, ví dụ:

• placement
• catalogId
• customerId
• sessionId
• searchTerm
• Số lượng quảng cáo tối đa được hiển thị

Điều kiện tiên quyết

Bạn phải hoàn tất các bước sau trước khi bắt đầu yêu cầu quảng cáo sản phẩm cho vị trí tìm kiếm.

Thêm Danh mục Sản phẩm

Thêm sản phẩm của bạn vào catalogue và đồng bộ hóa các sản phẩm này với nền tảng Epsilon Retail Media.

Tạo Chiến dịch và Định cấu hình Cụm từ Tìm kiếm

Tạo chiến dịch và định cấu hình cụm từ tìm kiếm. Để biết thêm chi tiết, hãy tham khảo Bước 4b: Định cấu hình cụm từ tìm kiếm..

Xác định các cụm từ tìm kiếm mà bạn muốn nhắm mục tiêu (bao gồm và loại trừ) cho quảng cáo sản phẩm của mình. Bạn có thể chỉ định đối sánh chính xác, đối sánh cụm từ và cụm từ tìm kiếm phủ định cho quảng cáo của mình.

• Đối sánh chính xác:
  • Nhắm mục tiêu các cụm từ tìm kiếm đối sánh chính xác với từ khóa của bạn.
  • Ví dụ: Nếu từ khóa của bạn là "giày chạy bộ màu xanh", quảng cáo của bạn sẽ chỉ xuất hiện cho những người dùng nhập "giày chạy bộ màu xanh" theo đúng thứ tự đó mà không có thêm bất kỳ từ nào khác.
• Đối sánh cụm từ:
  • Nhắm mục tiêu các cụm từ tìm kiếm đối sánh chính xác với từ khóa của bạn.
  • Quảng cáo của bạn có thể xuất hiện cho những tìm kiếm bao gồm các từ bổ sung trước hoặc sau cụm từ đó.
  • Ví dụ: Nếu từ khóa của bạn là "giày chạy bộ màu xanh", quảng cáo của bạn sẽ chỉ xuất hiện cho những người dùng nhập "giày chạy bộ màu xanh" theo đúng thứ tự đó mà không có thêm bất kỳ từ nào khác.
  • Để biết thêm thông tin, hãy xem cụm từ tìm kiếm đối sánh cụm từ.
• Cụm từ tìm kiếm phủ định:
  • Loại trừ các từ hoặc cụm từ cụ thể khỏi chiến dịch của bạn.
  • Ngăn quảng cáo của bạn xuất hiện trong các tìm kiếm không liên quan.
  • Ví dụ: Thêm "đã qua sử dụng" làm thuật ngữ phủ định cho quảng cáo ô tô mới để không hiển thị quảng cáo đó cho những người đang tìm ô tô đã qua sử dụng.

Tìm nạp Khóa API và URL Cơ sở

1. Bạn phải có mã khóa API hợp lệ. Để tìm nạp khóa API, hãy làm như sau:

   1. Đăng nhập vào tài khoản nhóm Phương tiện Bán lẻ của Epsilon của bạn.

   2. Điều hướng đến phía trên bên phải của trang và nhấp vào menu thả xuống.

   3. Chọn Cài đặt tích hợp, từ menu thả xuống.

      

   4. Nhấp vào tab Mã khóa API. Mã khóa API bí mật của bạn ban đầu bị ẩn. Để xem mã khóa, nhấp vào nút Hiển thị. Khi mã khóa hiển thị, hãy sao chép mã khóa API bí mật của bạn. Sử dụng mã khóa này để thực hiện lệnh gọi API.

2. Bạn phải có URL cơ sở cho điểm cuối API. Ví dụ: https://staging-test.citrusad.com/v1/ads/generate HTTP/1.1. Kiểm tra với Người quản lý Tài khoản Kỹ thuật của bạn để biết URL cơ sở.

Tạo quảng cáo

Thực hiện các bước sau để tạo quảng cáo sản phẩm.

Yêu cầu HTTP

Điểm cuối: /v1/ads/generate

Phương pháp: POST

Tiêu đề:

• chấp nhận: application/json
• nội dung-loại: application/json
• Ủy quyền: Cơ bản <API_KEY>

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:

Yêu cầu Ví dụ

Yêu cầu này được sử dụng để tạo tối đa 3 quảng cáo có liên quan đến cụm từ tìm kiếm chocolate. Những quảng cáo này sẽ được đặt trong kết quả tìm kiếm cho một khách hàng cụ thể (customerId: "wertg5432a") và phiên (sessionId: "ec9-4e07-881d-3e9"). Quảng cáo sẽ được tạo từ danh mục được xác định bởi catalogId: "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b", với các tùy chọn lọc bổ sung được chỉ định (filterMode: "AndOr").

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",
    "dtmCookieId": "AAAF8xLBTA968AB6TOthAAAAAAE",
    "placement": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "options": {
   						 "filterMode": "AndOr"
 							 },
    "maxNumberOfAds": 3    
}

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

📘

Khi bạn nhận được phản hồi về quảng cáo sản phẩm, phản hồi thường sẽ bao gồm mã sản phẩm, chẳng hạn như GTIN trong ví dụ này. Nhà bán lẻ cần sử dụng mã sản phẩm được cung cấp trong phản hồi quảng cáo để tra cứu siêu dữ liệu cần thiết nhằm hiển thị sản phẩm.

Trong ví dụ này, "gtin": "024100191345" là mã sản phẩm. Các nhà bán lẻ sẽ sử dụng GTIN này để xác định và hiển thị sản phẩm được tài trợ cụ thể.

{
    "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": [],
}

Các bước tiếp theo

• Tạo quảng cáo sản phẩm sử dụng vị trí danh mục
• Tối ưu hóa nhắm mục tiêu quảng cáo