API đối tác

Yêu cầu quảng cáo cho ngày trong tương lai

Sử dụng campaignFilterDate thuộc tính của CitrusAd, bạn có thể truy vấn các chiến dịch sẽ đi vào hoạt động vào ngày được yêu cầu.

📘

Đây là tính năng tốt nhất dành cho tích hợp quảng cáo biểu ngữ, đặc biệt nếu bạn có yêu cầu pháp lý để hiển thị bất kỳ thông tin về giá nào trong biểu ngữ tại thời điểm lựa chọn vị trí phân phối của khách hàng.

Tác dụng của thuộc tính này là gì?

Khi bạn chỉ định campaignFilterDate trong yêu cầu quảng cáo của bạn tới CitrusAd, chúng tôi sẽ chỉ xem xét các chiến dịch sẽ hoạt động vào ngày bạn đã chỉ định hoặc các chiến dịch được đặt thành "Luôn bật" trong hệ thống CitrusAd.

Trong hệ thống CitrusAd, nhà quảng cáo có thể đặt chiến dịch chỉ hoạt động trong các phạm vi ngày nhất định.

Điều này thường tùy thuộc vào nhà quảng cáo nếu họ muốn lên lịch cho chiến dịch của mình trong một khung thời gian cụ thể hoặc họ cũng có thể chọn "Luôn bật" để cho phép chiến dịch luôn chi tiêu nếu có sẵn ngân sách.

Ví dụ, chiến dịch ở trên sẽ đi vào hoạt động trong khoảng thời gian từ 07/02/2023 đến 14/03/2023. Nếu một yêu cầu quảng cáo có liên quan được nhận với campaignFilterDate trong khoảng thời gian này, chiến dịch sẽ được cấp phát nếu nó được coi là quảng cáo có liên quan nhất.

Yêu cầu về tích hợp

Tổng quan cấp cao

Ngoài tích hợp tiêu chuẩn với CitrusAd, tích hợp của bạn sẽ cần được nâng cao để chỉ định một campaignFilterDate trong yêu cầu quảng cáo của bạn. Không cần thay đổi đối với báo cáo số lần hiển thị và số lượt nhấp và bạn phải đảm bảo báo cáo đơn hàng của mình chính xác như được nêu bên dưới.

Yêu cầu quảng cáo

Yêu cầu quảng cáo của bạn sẽ cần chỉ định một campaignFilterDate, ở định dạng ISO-8601, dưới đây là một ví dụ:

Chức năng campaignFilterDate sẽ là ngày mà khách hàng nhận được đơn hàng từ trang web của bạn.

POST $BASE_URL/v1/ads/generate HTTP/1.1
accept: application/json
content-type: application/json
Authorization: Basic <API_KEY>
{
    "customerId": "wertg5432a",
    "placement": "search",
    "catalogId": "628dbe95-2ec9-4e07-881d-3e9f92ab2e0b",
    "searchTerm": "chocolate",
    "campaignFilterDate": "2022-11-20T13:40:00+01:00",
    "options": {
                         "filterMode": "AndOr",
                             },
    "maxNumberOfAds": 3    
}

Báo cáo đơn hàng

Khi báo cáo các đơn hàng, bạn sẽ cần đảm bảo những điều dưới đây được thực hiện:

  • ngày đặt hàng bạn chỉ định phải là thời điểm khách hàng thanh toán và không phải là thời điểm nhận/giao đơn hàng của khách hàng.
    • Điều này là để đảm bảo thuật toán phân bổ của CitrusAd có thể áp dụng cửa sổ xem lại chính xác cho các tương tác của khách hàng của bạn để phân bổ doanh số bán hàng cho các chiến dịch đã được hiển thị cho khách hàng.
  • Vì có khả năng khách hàng sẽ gửi lại đơn hàng của họ, bạn cũng cần đảm bảo rằng bạn không gửi ID đơn hàng đến CitrusAd. Điều này sẽ đảm bảo khi gửi lại đơn hàng và cập nhật đơn hàng, thuật toán CitrusAd sẽ xem xét đơn hàng và các thuộc tính tương ứng.
    • Hiện tại, thuật toán phân bổ CitrusAd không xử lý lại đơn hàng khi đơn hàng được gửi với ID đơn hàng đã được gửi trước đó.

Vui lòng xem lại Dữ liệu đơn hàng để biết thông tin chính xác về báo cáo đơn hàng.

Báo cáo nền tảng

Vì hệ thống CitrusAd hiển thị báo cáo theo thời gian thực nên số lần nhấp và số lần hiển thị, bao gồm cả những lần phân phối trong tương lai sẽ được báo cáo khi chúng được xem hoặc nhấp vào.

Vì quảng cáo đang được cấp phát trong thời gian thực, ví tiền sẽ bị trừ tiền khi số lần hiển thị và số lần nhấp được báo cáo cho CitrusAd.

🚧

Báo cáo chi tiêu

Khi tính năng này truy vấn các chiến dịch trong tương lai, bạn có thể thấy các chiến dịch có ngày hoạt động trong tương lai với chi tiêu và dữ liệu báo cáo được tích lũy, đây là hành vi dự kiến của tính năng khi các chiến dịch được lên kế hoạch hoạt động trong một khoảng thời gian trong tương lai đang được truy vấn trước.