Hướng dẫn tích hợp API AMS Shopee
1. Giới thiệu về Shopee AMS
Shopee Affiliate Marketing Solutions (AMS) là nền tảng quản lý marketing và đối tác tích hợp, giúp các thương hiệu và người bán mở rộng phạm vi tiếp cận và tăng doanh số thông qua mạng lưới affiliate rộng lớn của Shopee. Đồng thời, người bán chỉ cần thanh toán cho các đơn hàng thành công do affiliate mang lại.
Bằng cách tận dụng AMS, người bán có thể hợp tác với các affiliate — từ những người sáng tạo nội dung trên Shopee Live và Shopee Video, đến các KOL và đối tác mạng xã hội — cho phép họ quảng bá sản phẩm trên nhiều kênh có tác động cao với kết quả có thể đo lường được.
Giới thiệu thêm: Shopee Affiliate Marketing Solution (AMS) 2025
AMS cung cấp hai mô hình hợp tác chính:
● Chiến dịch mở (Open Campaigns): Người bán có thể mở sản phẩm của shop để affiliate công khai quảng bá, cho phép người sáng tạo tự do chọn và quảng bá các mặt hàng.
● Chiến dịch có chủ đích (Targeted Campaigns): Người bán có thể mời các affiliate cụ thể để hợp tác tùy chỉnh với cài đặt hoa hồng riêng.
AMS cũng cung cấp bảng dữ liệu toàn diện bao gồm traffic, chuyển đổi và hiệu suất bán hàng, giúp người bán theo dõi hiệu quả, xác định affiliate hiệu suất cao và tối ưu ROI.
Open API này cho phép các nhà phát triển bên ngoài tự động hóa hoạt động AMS — bao gồm thiết lập chiến dịch, quản lý chiến dịch, theo dõi hiệu suất và xem xét hóa đơn — nâng cao hiệu quả và linh hoạt tích hợp cho người bán.
2. Tổng quan về các nhóm API
API AMS được chia thành bốn nhóm chính:
-
Quản lý Chiến dịch mở – Quản lý Chiến dịch mở cấp shop và sản phẩm.
-
Quản lý Chiến dịch có chủ đích – Quản lý Chiến dịch có chủ đích dành cho affiliate cụ thể và sản phẩm.
-
Bảng dữ liệu hiệu suất – Lấy các chỉ số và báo cáo hiệu suất.
-
Báo cáo xác thực & chuyển đổi – Kiểm tra hóa đơn xác thực AMS và chi tiết đơn hàng liên quan.
3. API Quản lý Chiến dịch mở
Chiến dịch mở cho phép người bán linh hoạt quảng bá các sản phẩm được chọn thông qua việc thu hút mạng lưới affiliate rộng lớn. Các API sau quản lý việc tạo Chiến dịch mở, thêm sản phẩm, thiết lập hoa hồng và các quy tắc tự động thêm.
3.1 Lấy sản phẩm đã thêm / chưa thêm vào Chiến dịch mở
● v2.ams.get_open_campaign_added_product: Lấy tất cả sản phẩm hiện có trong Chiến dịch mở và sẵn sàng được bất kỳ affiliate nào chọn để quảng bá bất cứ lúc nào.
● v2.ams.get_open_campaign_not_added_product: Lấy các sản phẩm đủ điều kiện chưa được thêm vào Chiến dịch mở.
3.2 Thêm sản phẩm vào Chiến dịch mở
Với tỷ lệ hoa hồng và thời gian khuyến mãi hợp lệ, sản phẩm có thể được thêm vào Chiến dịch mở để affiliate quảng bá ngay lập tức. Sử dụng các API được cung cấp, bạn có thể chọn thêm các sản phẩm cụ thể theo ID sản phẩm hoặc trực tiếp đưa tất cả sản phẩm trong shop vào Chiến dịch mở.
Ngoài ra, bạn có thể bật tính năng Tự động thêm để hệ thống tự động thêm các sản phẩm mới được ra mắt vào Chiến dịch mở khi chúng được đưa vào shop.
● v2.ams.batch_add_products_to_open_campaign: Thêm các sản phẩm được chọn vào Chiến dịch mở theo ID sản phẩm.
● v2.ams.add_all_products_to_open_campaign: Thêm tất cả sản phẩm shop đủ điều kiện vào Chiến dịch mở.
● v2.ams.get_auto_add_new_product_toggle_status: Kiểm tra xem tính năng tự động thêm sản phẩm mới có được bật không và tỷ lệ hoa hồng mặc định hiện tại.
● v2.ams.update_auto_add_new_product_setting: Cập nhật bật/tắt tự động thêm và tỷ lệ hoa hồng mặc định của nó.
● v2.ams.get_open_campaign_batch_task_result: Lấy kết quả tác vụ theo lô cho Chiến dịch mở.
3.3 Chỉnh sửa cài đặt sản phẩm trong Chiến dịch mở
Chỉnh sửa tỷ lệ hoa hồng: Tỷ lệ hoa hồng có thể được điều chỉnh cho các sản phẩm đang trong chiến dịch. Tuy nhiên lưu ý rằng nếu có affiliate đang quảng bá sản phẩm, tỷ lệ hoa hồng ban đầu vẫn sẽ tiếp tục có hiệu lực trong 7 ngày đầy đủ. Trong khi đó, tỷ lệ hoa hồng tăng sẽ có hiệu lực ngay lập tức.
Chỉnh sửa thời gian khuyến mãi: Để tối đa hóa mức độ hiển thị và duy trì tăng trưởng đơn hàng, bạn nên đặt thời gian khuyến mãi dài hơn để affiliate có thể liên tục quảng bá sản phẩm của bạn.
Lưu ý rằng thời gian khuyến mãi không thể rút ngắn khi chiến dịch đang hoạt động, để đảm bảo trải nghiệm công bằng và nhất quán cho tất cả affiliate.
● v2.ams.batch_edit_products_open_campaign_setting: Cập nhật hàng loạt cài đặt chiến dịch của nhiều sản phẩm.
● v2.ams.edit_all_products_open_campaign_setting: Cập nhật cài đặt cho tất cả sản phẩm trong chiến dịch.
● v2.ams.get_open_campaign_batch_task_result: Lấy kết quả tác vụ theo lô cho Chiến dịch mở.
3.4 Xóa sản phẩm khỏi Chiến dịch mở
Bạn có thể xóa sản phẩm khỏi Chiến dịch mở bằng các API được cung cấp — hoặc bằng cách chỉ định ID sản phẩm để xóa các mặt hàng được chọn, hoặc bằng cách xóa tất cả sản phẩm cùng lúc.
Lưu ý rằng các sản phẩm bị xóa khỏi Chiến dịch mở sẽ vẫn đủ điều kiện nhận hoa hồng trong 7 ngày đầy đủ tiếp theo để đảm bảo phân bổ công bằng cho các chiến dịch affiliate đang diễn ra.
● v2.ams.batch_remove_products_open_campaign_setting: Xóa nhiều sản phẩm cùng lúc.
● v2.ams.remove_all_products_open_campaign_setting: Xóa tất cả sản phẩm trong Chiến dịch mở.
● v2.ams.get_open_campaign_batch_task_result: Lấy kết quả tác vụ theo lô cho Chiến dịch mở.
3.5 Lấy đề xuất sản phẩm cho Chiến dịch mở
● v2.ams.get_optimization_suggestion_product: API cung cấp 3 loại đề xuất tối ưu hóa sản phẩm để giúp người bán cải thiện hiệu suất chiến dịch và thu hút affiliate:
○ Thêm sản phẩm tiềm năng cao — Đề xuất các sản phẩm bán chạy, xu hướng hoặc có tiềm năng đặt hàng cao trong các danh mục có nguồn cung AMS thấp so với nhu cầu thị trường.
○ Tối ưu tỷ lệ hoa hồng — Đề xuất điều chỉnh tỷ lệ hoa hồng cho các sản phẩm có điểm cạnh tranh dưới phân vị thứ 60 trong danh mục của chúng để thu hút thêm affiliate.
○ Kéo dài thời gian khuyến mãi — Đề xuất kéo dài thời gian chiến dịch cho các sản phẩm trong chiến dịch còn dưới 30 ngày, cho phép affiliate tiếp tục thúc đẩy chuyển đổi.
3.6 Lấy tỷ lệ hoa hồng đề xuất cho sản phẩm
● v2.ams.batch_get_products_suggested_rate: Việc tuân theo tỷ lệ hoa hồng đề xuất của từng sản phẩm sẽ nâng cao đáng kể tính cạnh tranh của sản phẩm và tăng khả năng hiển thị với affiliate.
● v2.ams.get_shop_suggested_rate: Khi thiết lập Chiến dịch mở cho toàn bộ sản phẩm shop, bạn có thể tham khảo API này để lấy tỷ lệ hoa hồng đề xuất thống nhất có thể áp dụng cho toàn bộ sản phẩm shop.
4. API Quản lý Chiến dịch có chủ đích
Chiến dịch có chủ đích cho phép người bán hợp tác với các affiliate cụ thể cho các chiến dịch quảng bá tùy chỉnh, hướng đến hiệu suất. Các API tương ứng cho phép nhà phát triển tạo, chỉnh sửa và theo dõi các Chiến dịch có chủ đích này, bao gồm chọn sản phẩm, chọn affiliate và cài đặt chiến dịch.
4.1 Tạo Chiến dịch có chủ đích mới
Lấy danh sách sản phẩm:
● v2.ams.get_targeted_campaign_addable_product_list: Lấy các sản phẩm shop có thể thêm vào Chiến dịch có chủ đích.
Lấy danh sách affiliate:
● v2.ams.get_recommended_affiliate_list: Lấy các affiliate được đề xuất hàng đầu cho Chiến dịch có chủ đích.
● v2.ams.get_managed_affiliate_list: Lấy các affiliate đã lưu vào danh sách affiliate được quản lý của shop (tính năng có sẵn trong AMS tại Seller Center).
Tạo Chiến dịch có chủ đích mới:
● v2.ams.create_new_targeted_campaign: Tạo Chiến dịch có chủ đích mới với các lựa chọn sản phẩm & affiliate và tỷ lệ hoa hồng được đặt ở cấp sản phẩm. Bạn cũng có thể sử dụng các đề xuất sản phẩm trước đó và tuân theo tỷ lệ hoa hồng đề xuất để thiết lập.
4.2 Xem & Chỉnh sửa Chiến dịch có chủ đích
● v2.ams.get_targeted_campaign_list: Lấy tất cả Chiến dịch có chủ đích do người bán tạo.
● v2.ams.get_targeted_campaign_settings: Lấy chi tiết Chiến dịch có chủ đích hiện tại, bao gồm sản phẩm & tỷ lệ hoa hồng liên kết và các affiliate.
● v2.ams.update_basic_info_of_targeted_campaign: Cập nhật thông tin cơ bản của chiến dịch như tên, thời gian khuyến mãi, tin nhắn và ngân sách.
● v2.ams.edit_product_list_of_targeted_campaign: Chỉnh sửa danh sách sản phẩm của Chiến dịch có chủ đích hiện có.
● v2.ams.edit_affiliate_list_of_targeted_campaign: Chỉnh sửa danh sách affiliate của Chiến dịch có chủ đích hiện có.
● v2.ams.terminate_targeted_campaign: Kết thúc Chiến dịch có chủ đích đang hoạt động.
5. API Hiệu suất & Phân tích
AMS cung cấp một bộ bảng phân tích được thiết kế để giúp người bán xem xét, phân tích và hiểu hiệu suất marketing affiliate của mình một cách dễ dàng, cho phép tối ưu hóa dựa trên dữ liệu và cải tiến liên tục.
5.1 Phân tích chính
● v2.ams.get_performance_data_update_time: Tất cả dữ liệu được cập nhật hàng ngày, phản ánh các đơn hàng được tạo đến ngày hôm trước. Bạn có thể dùng API này để lấy timestamp cập nhật dữ liệu hiệu suất AMS mới nhất, đảm bảo hệ thống hiển thị thông tin hiệu suất cập nhật nhất.
● v2.ams.get_shop_performance: Kiểm tra một vài chỉ số quan trọng nhất liên quan đến hiệu suất shop của bạn trong AMS.
5.2 Phân tích sản phẩm
● v2.ams.get_product_performance: Lấy dữ liệu hiệu suất của một sản phẩm shop cụ thể.
5.3 Phân tích affiliate
● v2.ams.get_affiliate_performance: Lấy dữ liệu hiệu suất của một affiliate cụ thể mang lại cho shop.
5.4 Phân tích nội dung
● v2.ams.get_content_performance: Lấy hiệu suất nội dung Shopee Video và Shopee Live của shop.
5.5 Phân tích chiến dịch
● v2.ams.get_campaign_key_metrics_performance: Lấy các chỉ số chính cho Chiến dịch mở và Chiến dịch có chủ đích.
● v2.ams.get_open_campaign_performance: Lấy dữ liệu hiệu suất cho tất cả sản phẩm trong Chiến dịch mở.
● v2.ams.get_targeted_campaign_performance: Lấy danh sách Chiến dịch có chủ đích kèm dữ liệu hiệu suất.
6. API Báo cáo Chuyển đổi & Xác thực
Được dùng để lấy và xác minh hóa đơn và báo cáo chuyển đổi AMS, giúp người bán hiểu hiệu suất cấp đơn hàng và xem xét chi tiết hoa hồng và các khoản khấu trừ phí cho từng giao dịch được tạo qua AMS.
6.1 Báo cáo chuyển đổi
● v2.ams.get_conversion_report: Lấy báo cáo chuyển đổi với chi tiết cấp đơn hàng.
6.2 Hóa đơn xác thực
● v2.ams.get_validation_list: Lấy danh sách hóa đơn xác thực AMS của người bán.
● v2.ams.get_validation_report: Lấy thông tin chi tiết của một hóa đơn xác thực cụ thể.
7. Lưu ý tích hợp cho nhà phát triển
● Chỉ các ứng dụng Quản lý Affiliate Marketing Solution mới đủ điều kiện truy cập AMS OpenAPI. Vui lòng tạo loại ứng dụng tương ứng trong Console trước khi tích hợp.
● Tất cả API AMS đều yêu cầu ủy quyền và xác thực shop hợp lệ. Để biết thêm chi tiết, vui lòng tham khảo: Ủy quyền và Xác thực.
● Sử dụng phân trang khi được hỗ trợ để xử lý bộ dữ liệu lớn.
● Dữ liệu hiệu suất và báo cáo chuyển đổi có giới hạn phạm vi dữ liệu và số bản ghi.
● Đối với các tác vụ bất đồng bộ (ví dụ: cập nhật theo lô), hãy dùng API kết quả tác vụ theo lô để kiểm tra trạng thái.
8. Các bước tiếp theo
● Tham khảo tài liệu Shopee Open Platform để biết chi tiết về xác thực, ủy quyền và xử lý lỗi.
● Để khám phá các tính năng AMS và đảm bảo căn chỉnh kiểm tra phù hợp, hãy truy cập AMS trong Seller Centre. Lưu ý rằng bạn phải đồng ý với Điều khoản & Điều kiện AMS trên trang web AMS trước khi thực hiện bất kỳ thao tác API liên quan đến AMS nào.
● Sử dụng AMS Open API để tự động hóa quản lý chiến dịch, phân tích hiệu suất và tích hợp dữ liệu AMS với các hệ thống hoặc công cụ bên ngoài của bạn để hoạt động hiệu quả hơn.