Chuyển tới nội dung chính

Hướng dẫn API Quảng cáo trên nền tảng Shopee

Shopee Ads là gì

Shopee Ads cho phép bạn tạo quảng cáo trong nền tảng Shopee để tăng mức độ hiển thị cho sản phẩm và shop của bạn.

Tìm hiểu về Shopee Ads: https://ads.shopee.sg/learn/faq/96/195

Quy tắc sử dụng Ads Open API

Khi sử dụng API quảng cáo, bạn cần tuân thủ các quy tắc sau đây để Shopee có thể tạo ra một thị trường công bằng và an toàn cho tất cả người bán:

  1. Khi xử lý dữ liệu quảng cáo, bạn cần tuân thủ chính sách bảo vệ dữ liệu của nền tảng.
  2. API quảng cáo giới hạn cho các ISV hợp tác chính thức của Shopee và được sử dụng cùng với người bán trên nền tảng. Có thể dùng cho hoạt động quảng cáo của shop và các dự án hợp tác đại lý chính thức. API quảng cáo không được dùng cho mục đích khác.
  3. Dữ liệu shop không được sử dụng cho bất kỳ mục đích nào ngoài hoạt động của shop và các dự án hợp tác chính thức với Shopee.
  4. Để truy xuất dữ liệu shop người bán qua API ISV, bạn cần có sự đồng ý của người bán nền tảng thông qua quy trình ủy quyền.

Lưu ý: Nếu bạn không tuân thủ các quy chuẩn và quy tắc của chúng tôi, bạn sẽ nhận được email cảnh báo từ Shopee; nếu không sửa đổi kịp thời, bạn có thể đối mặt với các hình thức xử phạt.

Hướng dẫn Ads Open API

1. Lấy Số dư Quảng cáo và Cài đặt Shop​

  • v2.ads.get_total_balance: Dùng API này để lấy tổng số dư tín dụng quảng cáo thời gian thực của người bán, bao gồm cả tín dụng trả phí và miễn phí. Người bán có thể theo dõi tình trạng số dư qua API này để đảm bảo số dư đủ cho hoạt động quảng cáo bình thường.
  • v2.ads.get_shop_toggle_info: Dùng API này để lấy cài đặt quảng cáo của shop, chẳng hạn như có bật tính năng nạp tiền tự động và tối ưu giá quảng cáo hay không.

Top_Up Toggle: Bật/tắt nạp tiền tự động

Campaign_Surge: Bật/tắt tối ưu giá quảng cáo trong giai đoạn chiến dịch

  • Campaign_Surge: Bật/tắt tối ưu giá quảng cáo

2. Lấy dữ liệu tổng quan hiệu suất thời gian thực của quảng cáo sản phẩm (phạm vi shop)​

  • v2.ads.get_all_cpc_ads_hourly_performance: Dùng API này để lấy dữ liệu hiệu suất theo giờ của quảng cáo CPC cấp store cho một ngày. Người bán có thể truy cập thông tin như Chuyển đổi hàng ngày, Tỷ lệ chuyển đổi, số mặt hàng đã bán, GMV, Ad GMV/Chi tiêu quảng cáo, v.v.
  • v2.ads.get_all_cpc_ads_daily_performance: Dùng API này để lấy hiệu suất nhiều ngày của quảng cáo CPC cấp store (đơn vị thời gian là ngày). Người bán có thể lấy thông tin như chuyển đổi hàng ngày, tỷ lệ chuyển đổi, số mặt hàng đã bán, GMV, Ad GMV/Chi tiêu quảng cáo, v.v. trong nhiều ngày.

3. Lấy Từ khóa đề xuất và Dữ liệu sản phẩm​

  • v2.ads.get_recommended_keyword_list: Dùng API này để lấy danh sách từ khóa được đề xuất theo từng mặt hàng, cùng với các từ khóa tìm kiếm tùy chọn. Người bán cũng có thể xem điểm chất lượng từ khóa, khối lượng tìm kiếm và giá thầu đề xuất.
  • v2.ads.get_recommended_item_list: Dùng API này để lấy danh sách SKU được đề xuất (cấp shop) với các nhãn cụ thể như Hot Search, Best Seller hoặc Best ROI.

4. Lấy Dữ liệu cấp Chiến dịch​

  • v2.ads.get_product_level_campaign_id_list: Dùng API này để lấy danh sách các chiến dịch quảng cáo liên kết với một sản phẩm cụ thể.
  • v2.ads.get_product_level_campaign_setting_info: Dùng API này để lấy cài đặt chi tiết của một chiến dịch quảng cáo cụ thể.
  • v2.ads.get_product_campaign_daily_performance và v2.ads.get_product_campaign_hourly_performance: Dùng các API này để lấy dữ liệu hiệu suất hàng ngày/hàng giờ của các chiến dịch quảng cáo cấp sản phẩm.

5. Tổng quan về Quảng cáo GMV Max​

Quảng cáo GMV Max là giải pháp quảng cáo toàn phễu của Shopee, tận dụng đặt giá thầu tự động và phân bổ traffic thông minh để tối đa hóa hiệu suất GMV của người bán.

Hiện tại, Shopee hỗ trợ hai loại Quảng cáo GMV Max:

  • Quảng cáo GMV Max theo Mặt hàng (cấp mặt hàng)
  • Quảng cáo GMV Max theo Shop (cấp shop / Sản phẩm được chọn tự động)

Cả hai loại quảng cáo đều được vận hành bởi tự động hóa hệ thống và tối ưu hóa xung quanh mục tiêu ROAS (Lợi nhuận trên chi tiêu quảng cáo).

So sánh:

ChiềuItem GMV MaxShop GMV Max
Cấp quảng cáoMặt hàngShop
Lựa chọn sản phẩmDo nhà phát triển chỉ địnhHệ thống tự động chọn
API tạocreate_manual_product_adscreate_gms_product_campaign
Kiểm soát ROASĐược hỗ trợĐược hỗ trợ / Tự động
Giới hạn chiến dịchNhiều chiến dịchMột chiến dịch mỗi shop
Quy tắc độc quyền sản phẩmMột sản phẩm không thể tham gia cả Quảng cáo GMV Max theo Mặt hàng lẫn theo ShopMột sản phẩm không thể tham gia cả Quảng cáo GMV Max theo Mặt hàng lẫn theo Shop

6. Quảng cáo GMV Max theo Mặt hàng (Quảng cáo toàn trang cấp mặt hàng)​

Quảng cáo GMV Max theo Mặt hàng là quảng cáo toàn trang cấp mặt hàng được thiết kế để quảng bá các sản phẩm được chỉ định trên toàn bộ kho traffic của Shopee.

Đặc điểm chính:

  • Được tạo ở cấp mặt hàng
  • Sử dụng Đặt giá thầu tự động
  • Được tối ưu hóa xung quanh mục tiêu ROAS
  • Phù hợp với người bán muốn mở rộng GMV cho từng sản phẩm riêng lẻ

Để tạo Quảng cáo GMV Max theo Mặt hàng qua Open API, dùng:

  • v2.ads.create_manual_product_ads

  • Tham số chính:

  • bidding_method = auto → Quảng cáo GMV Max theo Mặt hàng

Trước khi tạo Quảng cáo GMV Max theo Mặt hàng, nhà phát triển có thể lấy ROAS được đề xuất qua:

v2.ads.get_product_recommended_roi_target

Nhà phát triển cũng có thể lấy phạm vi ngân sách đề xuất qua:

v2.ads.get_create_product_ad_budget_suggestion

Luồng điển hình:

  1. Gọi v2.ads.get_product_recommended_roi_target để lấy ROAS được đề xuất

  2. Gọi v2.ads.get_create_product_ad_budget_suggestion để lấy đề xuất ngân sách

  3. Gọi v2.ads.create_manual_product_ads (bidding_method = auto)

Lưu ý:

Đề xuất ROAS và ngân sách là tham chiếu được hệ thống tạo ra. Hiệu suất thực tế phụ thuộc vào phân phối thực tế và quá trình học máy của hệ thống.

7. Quảng cáo GMV Max theo Shop​

Quảng cáo GMV Max theo Shop là quảng cáo toàn trang cấp shop. Hệ thống tự động chọn sản phẩm trong shop và tối ưu phân phối dựa trên cài đặt ngân sách và ROAS để tối đa hóa GMV tổng thể của shop.

Đặc điểm chính:

  • Được tạo ở cấp shop
  • Hệ thống tự động chọn sản phẩm và phân bổ ngân sách linh hoạt
  • Hỗ trợ Đặt giá thầu tự động và ROAS tùy chỉnh
  • Phù hợp với người bán muốn giảm chi phí quản lý và tăng trưởng GMV shop theo quy mô

Chế độ đặt giá thầu:

  1. Đặt giá thầu tự động: Hệ thống tự động khám phá cơ hội traffic trong phạm vi ROAS chấp nhận được để mở rộng hiển thị và GMV.
  2. ROAS tùy chỉnh: Hệ thống tối ưu phân phối dựa trên mục tiêu ROAS do nhà quảng cáo xác định để cân bằng GMV và hiệu quả.

Để tạo Quảng cáo GMV Max theo Shop qua Open API, dùng:

  • v2.ads.create_gms_product_campaign

  • Trường chính: roas_target

  • Không cung cấp hoặc = 0 → Đặt giá thầu tự động (Shop GMV Max)

  • 0 → ROAS tùy chỉnh (Shop GMV Max)

Trước khi tạo, nhà phát triển có thể xác thực điều kiện đủ bằng cách dùng:

  • v2.ads.check_create_gms_product_campaign_eligibility

API Quản lý & Hiệu suất:

  • Cấu hình & Quản lý chiến dịch

  • v2.ads.edit_gms_product_campaign: Cập nhật cấu hình chiến dịch Shop GMV Max (ví dụ: chế độ đặt giá thầu, cài đặt ROAS).

  • Quản lý sản phẩm

  • v2.ads.edit_gms_item_product_campaign: Quản lý cấu hình cấp sản phẩm trong chiến dịch Shop GMV Max.

  • v2.ads.list_gms_user_deleted_item: Lấy thông tin về các sản phẩm đã bị người bán xóa.

  • Hiệu suất & Báo cáo

  • v2.ads.get_gms_campaign_performance: Lấy các chỉ số hiệu suất tổng thể của chiến dịch Shop GMV Max.

  • v2.ads.get_gms_item_performance: Lấy các chỉ số hiệu suất cấp mặt hàng trong chiến dịch Shop GMV Max.

Luồng tích hợp điển hình

  1. Gọi v2.ads.check_create_gms_product_campaign_eligibility
  • Xác thực xem shop có đủ điều kiện tạo chiến dịch Shop GMV Max không.
  1. Gọi v2.ads.create_gms_product_campaign
  • Tạo chiến dịch Shop GMV Max.
  1. (Tùy chọn) Gọi v2.ads.edit_gms_product_campaign
  • Cập nhật hoặc điều chỉnh cấu hình chiến dịch sau khi tạo.
  1. Gọi v2.ads.get_gms_campaign_performance và v2.ads.get_gms_item_performance
  • Theo dõi hiệu suất cấp chiến dịch và cấp mặt hàng liên tục.

Lưu ý:

  • Sản phẩm được tự động chọn theo mặc định và cập nhật hàng ngày. Nếu người bán tự điều chỉnh danh sách sản phẩm, danh sách do người bán cấu hình sẽ được ưu tiên.
  • Hiệu suất cải thiện trong giai đoạn học máy. Tránh thay đổi cấu hình thường xuyên trong giai đoạn này.

8. Quảng cáo sản phẩm thủ công​

Quảng cáo sản phẩm thủ công là quảng cáo cấp mặt hàng yêu cầu nhà phát triển cấu hình rõ ràng sản phẩm, từ khóa và chiến lược đặt giá thầu. Hiện tại, tính năng này chỉ dành cho một số người bán trong danh sách whitelist.

Đặc điểm chính:

  • Được tạo ở cấp mặt hàng
  • Sử dụng Đặt giá thầu thủ công
  • Hỗ trợ nhắm mục tiêu theo từ khóa và mặt hàng
  • Phù hợp với người bán cần kiểm soát chi tiết

Để tạo Quảng cáo sản phẩm thủ công, dùng:

  • v2.ads.create_manual_product_ads

  • Tham số chính:

  • bidding_method = manual → Quảng cáo sản phẩm thủ công

Đối với Quảng cáo sản phẩm thủ công (bidding_method = manual), nhà phát triển có thể dùng

v2.ads.get_recommended_item_list và v2.ads.get_recommended_keyword_list

để lấy các mặt hàng và từ khóa được đề xuất, sau đó cấu hình ngân sách, vị trí quảng cáo

và các cài đặt chiến dịch khác để bắt đầu phân phối quảng cáo.

9. (Sắp ngừng hoạt động) Quảng cáo sản phẩm tự động​

v2.ads.create_auto_product_ads (chỉ dành cho shop trong whitelist)

Nếu gặp sự cố, bạn nên kiểm tra Developer Guide và tìm kiếm FAQ.

Nếu gặp sự cố, vui lòng đăng nhập vào Open Platform Console để Gửi ticket.