Hướng dẫn cấu hình kết nối ACCESSTRADE trong CMS

Kết nối ACCESSTRADE giúp website hiển thị sản phẩm tiếp thị liên kết, mã giảm giá và các chiến dịch bạn đã được duyệt tham gia. Bạn chỉ cần lấy API Key trong tài khoản đối tác (publisher), lưu vào CMS Dybi, rồi chọn nội dung muốn hiển thị.

Các bước dưới đây hướng dẫn cách lấy khóa, lưu kết nối, thiết lập sản phẩm và ưu đãi, sau đó kiểm tra trên website. Tên tiếng Anh được ghi kèm tên tiếng Việt để bạn dễ tìm các mục trong ACCESSTRADE.

1. Hiểu đúng thông tin cần lấy

• Tài khoản và mật khẩu ACCESSTRADE: dùng để bạn đăng nhập cổng publisher. Biểu mẫu kết nối ACCESSTRADE hiện tại của CMS không yêu cầu nhập hai thông tin này.
• API Key/Access Key: khóa bí mật để máy chủ website gọi dữ liệu của tài khoản publisher. Đây là thông tin cần nhập vào CMS.
• Publisher ID/Pub ID: định danh publisher có thể xuất hiện trong công cụ tạo link hoặc mã nhúng. Không dùng Pub ID thay API Key.
• Campaign ID: ID một chiến dịch cụ thể, dùng khi cần lọc một chiến dịch trong khối chức năng.
• Merchant ID của kho coupon, Keyword ID và Category ID: những mã của từng danh sách dữ liệu. Chúng không mặc định giống Campaign ID, Pub ID hay ID danh mục CMS.

Với nhu cầu tải dữ liệu thông thường, bạn chỉ cần API Key hợp lệ và một khối chức năng đã được đặt trên website. Các ID lọc là tùy chọn; nên để trống khi kiểm tra lần đầu, sau đó giới hạn dần theo nhu cầu.

2. Đăng nhập cổng publisher ACCESSTRADE

1. Mở pub2.accesstrade.vn. Nếu đang ở website giới thiệu accesstrade.vn, bấm Đăng nhập để vào cổng publisher.
2. Nếu chưa có phiên đăng nhập, dùng tài khoản publisher và mật khẩu của bạn theo biểu mẫu nền tảng. Hoàn tất bước xác minh bổ sung nếu được yêu cầu.
3. Kiểm tra đúng tài khoản trước khi lấy khóa. API Key của một tài khoản khác sẽ truy cập dữ liệu/quyền chiến dịch của tài khoản đó.
4. Nếu thông báo hoặc banner che menu Công cụ / Tool, đóng thông báo rồi tiếp tục.

Nếu đã đăng nhập sẵn, đi thẳng đến bước lấy API Key. Sau khi lưu API Key trong CMS, website có thể tải dữ liệu mà không cần giữ cửa sổ ACCESSTRADE luôn mở.

3. Lấy API Key từ Tool → Integration → API

1. Ở menu bên trái, chọn Công cụ hoặc Tool.
2. Chọn nhóm Integration.
3. Mở thẻ API, có mô tả Manage API access keys. Đừng nhầm với thẻ API Document chỉ mở tài liệu.
4. Trang API Key cũng có thể mở trực tiếp tại pub2.accesstrade.vn/profile/api_key sau khi đăng nhập.
5. Ở dòng khóa hiện có, bấm biểu tượng Copy để sao chép. Nút hình con mắt Show key dùng để xem đầy đủ khi cần đối chiếu; giữ khóa được che khi chụp ảnh gửi hỗ trợ.

Hình 1. Đường vào API Key trên giao diện đang dùng: Tool → Integration → API. Nguồn: ACCESSTRADE Publisher. Mở ảnh kích thước đầy đủ.

Hình 2. Sao chép khóa bằng nút Copy ở cuối dòng; ảnh giữ nguyên trạng thái che khóa. Nguồn: ACCESSTRADE Publisher. Mở ảnh kích thước đầy đủ.

Nhập khóa thật, không nhập dãy dấu sao. Hình thức che chỉ bảo vệ giá trị trên màn hình. Nếu tự bôi đen chuỗi đang bị che rồi sao chép, bạn có thể lấy nhầm nội dung rút gọn; ưu tiên nút Copy của nền tảng.

Nếu chưa có khóa, dùng + Create new API Key và làm theo hướng dẫn của ACCESSTRADE. Nếu đã có khóa đang hoạt động, bạn có thể sử dụng khóa đó. Khi thay hoặc thu hồi khóa, nhớ cập nhật những website đang dùng chung khóa.

Nếu tài khoản chưa có khóa hoặc không thấy nút tương ứng, xử lý quyền/trạng thái tài khoản với ACCESSTRADE trước. Sử dụng API Key được cấp trong tài khoản của bạn.

4. Điền và lưu API Key trong CMS Dybi

1. Đăng nhập CMS của website cần sử dụng ACCESSTRADE.
2. Kiểm tra tên website/doanh nghiệp trên thanh đầu trang để tránh lưu nhầm website.
3. Vào Cấu hình → Cấu hình kết nối.
4. Chọn nhóm Affiliate, rồi tab ACCESSTRADE.
5. Bật công tắc Bật kết nối ACCESSTRADE. Ô API Key sẽ xuất hiện.
6. Dán API Key vừa sao chép vào ô API Key.
7. Bấm Lưu kết nối ở góc phải phía dưới và chờ thông báo Đã lưu kết nối ACCESSTRADE.

Hình 3. Khi khóa đã lưu, CMS để ô API Key trống và hiện lời nhắc giữ nguyên khóa hiện có. Nguồn: CMS Dybi. Mở ảnh kích thước đầy đủ.

Chỉ dán giá trị API Key vừa sao chép. Không thêm chữ Token, Bearer, dấu nháy hoặc địa chỉ website.

Nếu CMS báo khóa không hợp lệ, sao chép lại bằng nút Copy của ACCESSTRADE. Giữ nguyên khóa trên một dòng, tránh chèn khoảng trắng hoặc xuống dòng vào giữa.

Ô trống sau khi lưu có phải mất API Key không?

Không. CMS không đọc lại khóa đầy đủ lên biểu mẫu. Khi đã lưu, dòng trợ giúp hiện Đã lưu API Key. Để trống để giữ nguyên khóa hiện có. Bạn có thể tải lại trang rồi kiểm tra dòng này. Lần lưu sau để API Key trống sẽ tiếp tục dùng khóa đã lưu.

Nếu chưa có khóa, bật kết nối mà để trống sẽ báo Vui lòng nhập API Key để kết nối ACCESSTRADE. Khi cần thay khóa, dán khóa mới và lưu. Biểu mẫu hiện không có nút xóa khóa đã lưu; xóa chữ trong ô không xóa khóa đang có. Muốn ngừng sử dụng, tắt kết nối và lưu.

Tải lại, chuyển tab và thay đổi đồng thời

Tải lại đọc cấu hình đang lưu trên máy chủ và bỏ phần đang sửa chưa lưu. Bật/tắt công tắc hoặc chuyển tab chưa thay cho nút Lưu kết nối. Nếu báo cấu hình đã thay đổi, tải lại để đọc bản mới, đối chiếu rồi nhập lại phần cần sửa; không cố ghi đè một biểu mẫu cũ ở tab khác.

Sau khi lưu, mở trang sản phẩm, mã giảm giá hoặc chiến dịch trên website để kiểm tra kết nối. Thông báo Đã lưu xác nhận đã lưu cấu hình; việc dữ liệu hiển thị trên website giúp bạn xác nhận khóa đang sử dụng được.

5. Chiến dịch được duyệt và các ID lọc lấy ở đâu?

Campaign ID và trạng thái được duyệt

1. Trong ACCESSTRADE, mở Chiến dịch/Campaigns.
2. Tìm chiến dịch muốn giới thiệu; mở chi tiết và đọc điều kiện tham gia.
3. Đăng ký tham gia nếu chưa có quyền chạy. Đợi nền tảng/đối tác duyệt khi chiến dịch yêu cầu; trạng thái đang chờ không tương đương đã được duyệt.
4. Khi cần lọc riêng chiến dịch, lấy Campaign ID ở URL chi tiết hoặc trường ID do công cụ/tài liệu API trả về. Nhập đúng dãy ID, không dùng tên thương hiệu thay thế.

Website chỉ hiển thị những chiến dịch đã được duyệt, còn hoạt động và tạo được liên kết tiếp thị. Nếu tài khoản còn ở trạng thái chờ duyệt hoặc chưa đăng ký, hãy hoàn tất quy trình tham gia trên ACCESSTRADE trước. Lưu API Key không thay thế bước đăng ký chiến dịch.

Publisher ID không thay cho API Key

Kết nối ACCESSTRADE trong CMS chỉ cần API Key, không yêu cầu nhập thêm Publisher ID. Nếu bạn thấy Pub ID trong công cụ tạo liên kết của ACCESSTRADE, giữ đúng API Key đã lấy ở bước 3 để điền vào phần kết nối.

Merchant ID, Keyword ID và Category ID nâng cao

Những trường lọc này dùng mã dữ liệu của ACCESSTRADE, không dùng ID của danh mục CMS và không dùng mã ADPIA. Nếu chưa có mã chắc chắn, để trống và kiểm tra danh sách tổng trước.

• Merchant ID: mã nhà cung cấp dùng để lọc mã giảm giá. Lấy đúng mã của ACCESSTRADE; tên sàn hoặc mã chiến dịch không thay thế mã này.
• Keyword ID: mã nhóm từ khóa dành cho mã giảm giá. Trường này nhận mã do ACCESSTRADE cung cấp, không nhận từ khóa tự gõ.
• Category ID: mã lĩnh vực chiến dịch trong ACCESSTRADE. Khi dùng nhiều mã, phân tách bằng dấu phẩy.
• Product ID: mã sản phẩm trong danh sách ACCESSTRADE. Sử dụng mã của nền tảng, không dùng mã sản phẩm tự đặt trong CMS.

Các mã nâng cao không phải tài khoản nào cũng có cùng một danh sách. Tra phần tương ứng trong Tool → Integration → API Document hoặc tài liệu API Publisher. Nếu chưa rõ mã cần nhập, nhờ bộ phận hỗ trợ ACCESSTRADE hoặc đơn vị quản trị website kiểm tra giúp. Bạn có thể để trống các bộ lọc tùy chọn trong lần thiết lập đầu tiên.

6. Chọn sản phẩm hiển thị trên website

Vào Cấu hình → Cài đặt nâng cao, bấm Xem ở dòng khối sản phẩm của đúng trang/vị trí để mở các phần chỉnh sửa. Tìm chức năng AffiliateProducts hoặc khối sản phẩm tiếp thị liên kết. Kiểm tra Hoạt động và phạm vi áp dụng Trang hoặc Template (mẫu giao diện dùng chung), rồi sửa các thông số ACCESSTRADE. Tên khối có thể khác tùy giao diện website.

Hình 4. Kết nối được lưu riêng theo website; bộ lọc và cách hiển thị được đặt ở từng khối chức năng. Nguồn: CMS Dybi. Mở ảnh kích thước đầy đủ.

• AccessTradeTitleKeywords: từ khóa tìm theo tên sản phẩm. Ví dụ nhập thú bông để xây dựng một khối cùng chủ đề. Để trống để bỏ từ khóa mặc định.
• AccessTradeSortField: mã thứ tự sắp xếp của ACCESSTRADE, dùng một trong các lựa chọn bên dưới.
• AccessTradeProductIds: lọc các Product ID theo định dạng của API nguồn; để trống khi không giới hạn vào sản phẩm cụ thể.
• AccessTradePageSize: số sản phẩm muốn lấy trong một lần tải. Nhập 0 để dùng mặc định, hoặc 1–50 để chọn số lượng mong muốn. Số sản phẩm thực tế có thể ít hơn nếu nguồn không có đủ kết quả phù hợp.

Danh sách sản phẩm ACCESSTRADE trong chức năng này sử dụng nguồn TikTok Shop. Hãy chọn từ khóa và mã sản phẩm thuộc nguồn này. Bộ lọc dành cho một sàn khác có thể không có kết quả.

Các giá trị AccessTradeSortField được hỗ trợ

• RECOMMENDED: đề xuất của nền tảng.
• BEST_SELLERS: số lượng bán từ cao xuống thấp.
• LOW_PRICE: giá từ thấp lên cao.
• HIGH_PRICE: giá từ cao xuống thấp.
• NEWLY_RELEASED: sản phẩm mới trước.
• HIGH_COMMISSION_RATE: tỷ lệ hoa hồng từ cao xuống thấp.

Trong khối chức năng hiện tại, để trống dùng thứ tự mới nhất. Khi người xem chủ động đổi bộ lọc/sắp xếp trên giao diện, lựa chọn đó có thể thay cho mặc định của khối. Với ACCESSTRADE, hãy dùng một trong các kiểu sắp xếp được liệt kê ở trên.

Các thông số được lưu ngay tại khối sản phẩm trong CMS. Bạn không cần thêm mã lập trình vào bài viết hoặc giao diện website.

Xem thêm sản phẩm và bắt đầu lại danh sách

Khi người xem bấm Xem thêm hoặc sang trang tiếp, website tự tải các sản phẩm tiếp theo. Bạn không cần nhập thêm mã phân trang.

Sau khi đổi từ khóa, sắp xếp hoặc số lượng sản phẩm, hãy tải lại từ trang đầu để xem kết quả theo cấu hình mới. Nếu website đề nghị bắt đầu lại danh sách, thực hiện thao tác đó; bạn không cần thay API Key.

7. Thiết lập mã giảm giá và kho mã

Với danh sách mã giảm giá chung, dùng AffiliateCoupons. Với khung kho mã ACCESSTRADE của website, dùng AccesstradeCouponWidget nếu giao diện website đã hỗ trợ. Hai chức năng dùng kết nối ACCESSTRADE của website, nhưng mỗi lần đặt khối có bộ lọc riêng.

• AccessTradeMerchantId: mã nhà cung cấp muốn lấy mã giảm giá. Để trống để lấy tất cả nhà cung cấp phù hợp.
• AccessTradeKeywordId: mã nhóm mã giảm giá muốn lọc. Để trống nếu chưa cần giới hạn nhóm.
• AccessTradeNextDayCoupon: True lấy nhóm sắp diễn ra; False lấy nhóm đang diễn ra.
• AccessTradePageSize: số mã giảm giá muốn lấy mỗi lần. Nhập 0 để dùng mặc định hoặc 1–50 để chọn số lượng mong muốn.

Danh sách “sắp diễn ra” và “đang diễn ra” có thể có số lượng khác nhau. Nếu đổi công tắc này mà tưởng bị mất mã, hãy đối chiếu đúng nhóm ưu đãi. Khi mã có hạn dùng/điều kiện, đọc điều kiện nguồn và kiểm tra tại nơi mua; dữ liệu tải được không bảo đảm mọi mã áp dụng được cho mọi tài khoản mua hàng.

Nếu website có nhiều khối mã giảm giá, kiểm tra bạn đang sửa đúng khối lấy dữ liệu ACCESSTRADE. Tên khối có thể được đặt riêng theo giao diện website. API Key chỉ cần lưu tại Cấu hình kết nối.

8. Thiết lập chiến dịch, cửa hàng và dịch vụ

Trong AffiliateCampaigns, cấu hình phần ACCESSTRADE như sau:

• AccessTradeCampaignId: ID chiến dịch cần lấy riêng; để trống để lấy danh sách đã duyệt.
• AccessTradeApproval: dùng successful để lấy các chiến dịch đã được duyệt. Website chỉ hiển thị các chiến dịch đủ điều kiện này, kể cả khi bạn để trống trường.
• AccessTradeCategoryIds: mã category của ACCESSTRADE, cách nhau bằng dấu phẩy. Để trống nếu muốn hiển thị tất cả lĩnh vực phù hợp.
• AccessTradePageSize: số chiến dịch muốn lấy mỗi lần. Nhập 0 để dùng mặc định hoặc 1–50 để chọn số lượng mong muốn.

Chiến dịch cần còn hoạt động và tạo được liên kết tiếp thị. Bộ lọc lĩnh vực có thể làm danh sách ngắn hơn. Nếu vẫn có nút Xem thêm hoặc trang tiếp, hãy bấm để xem các kết quả còn lại.

Không dùng chung mã lĩnh vực giữa ADPIA và ACCESSTRADE. Hai nền tảng có hệ danh mục khác nhau. Ví dụ muốn chỉ giới thiệu giáo dục, cần lấy đúng mã giáo dục ở từng nguồn và điền vào trường riêng của nguồn đó. Không sao chép nguyên dãy AdpiaCategoryGroupId hoặc AdpiaPublicCategoryCodes vào AccessTradeCategoryIds.

9. Lưu từng thông số và dùng chung với ADPIA

Thông số chữ/số có nút Lưu ngay tại dòng: bấm nút của từng dòng đã sửa. Các công tắc như Hoạt động, Paging, ShowEmpty hoặc lựa chọn nhóm mã giảm giá được lưu ngay khi thay đổi. Việc lưu kết nối ở tab ACCESSTRADE không tự lưu các thông số đang sửa tại Cài đặt nâng cao.

• Paging: bật phân trang theo nguồn cho mẫu hiển thị có hỗ trợ.
• ShowEmpty: điều khiển thông báo khi khối không có dữ liệu.
• Description: phần giới thiệu của khối sản phẩm nếu mẫu hiển thị sử dụng.
• Kind: loại nội dung của khối. Giữ giá trị đã được thiết lập nếu chỉ thay bộ lọc hoặc từ khóa.

Một khối có thể hiển thị dữ liệu ACCESSTRADE và ADPIA nếu website đã bật cả hai kết nối. Các trường bắt đầu bằng AccessTrade chỉ điều chỉnh dữ liệu ACCESSTRADE; muốn thay dữ liệu ADPIA, sửa các trường tương ứng của ADPIA.

Khi bấm Xem thêm hoặc sang trang tiếp, website tải thêm kết quả từ các nguồn còn dữ liệu. Số mục hiển thị có thể khác nhau giữa các lần tải và giữa hai nền tảng.

Website hiện không tự lọc trùng giữa hai nền tảng, nên cùng sản phẩm có thể được hiển thị từ hai nguồn. AccessTradePageSize không làm thay đổi số mục của ADPIA. Nếu chưa kết nối ACCESSTRADE, tham số này không ảnh hưởng dữ liệu ADPIA.

10. Kiểm tra sau cấu hình và xử lý lỗi

Kiểm tra theo thứ tự

1. Bấm Tải lại trong phần kết nối; kiểm tra công tắc bật và dòng “Đã lưu API Key”.
2. Mở trang công khai có khối chức năng sản phẩm, coupon hoặc chiến dịch. Đợi nguồn tải xong và xem thông báo ngay tại khối.
3. Lần đầu nên dùng bộ lọc rộng để xác nhận có dữ liệu, rồi kiểm tra bộ lọc mục tiêu theo cấu hình thực tế của website.
4. Thử Xem thêm/trang tiếp để xác nhận có thể lấy lô kế tiếp, không chỉ xem trang đầu.
5. Với chiến dịch, đối chiếu trạng thái đã duyệt và liên kết đúng tài khoản. Dùng chức năng tạo liên kết của nền tảng và mở thử để kiểm tra đúng chiến dịch.

CMS báo chưa nhập API Key

Nếu đây là lần đầu lưu và chưa có dòng “Đã lưu API Key”, cần dán khóa thật trước khi bật và lưu. Nếu đã lưu mà vẫn báo thiếu, kiểm tra đang ở đúng CMS/website, đã bấm Lưu kết nối và không nhầm tab ADPIA.

API Key để trống sau khi tải lại

Đây là hành vi bình thường khi có dòng “Đã lưu API Key. Để trống để giữ nguyên khóa hiện có.” Không dán lại dấu sao trong ảnh của nền tảng. Chỉ nhập lại khi chủ động thay khóa hoặc khi chưa từng lưu thành công.

Đã lưu nhưng nguồn báo lỗi hoặc từ chối truy cập

Kiểm tra khóa của đúng tài khoản publisher, không dính tiền tố Token/Bearer, không có xuống dòng và chưa bị thay/thu hồi trên nền tảng. Lấy lại khóa hiện có, cập nhật CMS rồi thử lại. Nếu nền tảng giới hạn/tạm lỗi, đợi theo thông báo và dùng Thử lại; không tải lại dồn dập.

Product Feeds không có sản phẩm

Kiểm tra nguồn TikTok, quyền chiến dịch cần thiết, từ khóa và Product ID. Một bộ lọc sàn khác hoặc Product ID không thuộc nguồn có thể không có kết quả. Khi so sánh với ACCESSTRADE, hãy dùng cùng từ khóa và bộ lọc.

Coupon không có mã hoặc lọc sai sàn

Đối chiếu đúng nhóm đang/sắp diễn ra, đúng UID Merchant và Keyword. Không dùng tên sàn thay UID trong thông số AccessTradeMerchantId. Nếu không biết mã, bỏ bộ lọc tùy chọn để kiểm tra lại nguồn, sau đó lấy đúng UID từ tài liệu/công cụ.

Chiến dịch thấy trên nền tảng nhưng không thấy trên website

Danh sách tổng có thể gồm chiến dịch chưa đăng ký hoặc đang chờ duyệt. Kiểm tra đã được duyệt, còn chạy, có thể tạo link và phù hợp bộ lọc lĩnh vực. Nếu vừa duyệt, dữ liệu đệm có thể chưa đổi ngay; thử lại sau và tải lại khối.

Không thấy cả khối trên trang

Kiểm tra Hoạt động, đúng Trang/Template, đúng vị trí và mẫu hiển thị hỗ trợ của khối chức năng. Nguồn kết nối và vị trí hiển thị là hai phần cấu hình riêng. Xem hướng dẫn Cài đặt nâng cao để đối chiếu từng khối.

Trang tiếp báo cần bắt đầu lại

Danh sách đang xem có thể không còn khớp với bộ lọc mới. Tải lại danh sách từ trang đầu rồi thử Xem thêm. Nếu lỗi lặp lại, gửi đường dẫn trang và thông báo cho bộ phận hỗ trợ.

11. Tạm tắt, thay khóa và sử dụng cho nhiều website

Muốn tạm ngừng ACCESSTRADE, tắt Bật kết nối ACCESSTRADE rồi bấm Lưu kết nối. Việc này không xóa API Key đã lưu; bật lại và lưu khi muốn sử dụng tiếp. Nếu có ADPIA, nguồn đó được quản lý bằng công tắc riêng.

Muốn thay API Key, lấy khóa hợp lệ của tài khoản dự định sử dụng, bật kết nối nếu cần, dán khóa mới rồi lưu. Sau đó kiểm tra lại sản phẩm, coupon và chiến dịch vì quyền truy cập có thể khác giữa hai tài khoản.

Mỗi website trong CMS lưu cấu hình riêng. Cùng chủ tài khoản không có nghĩa bật ở website thứ nhất sẽ tự bật website thứ hai. Nếu được chủ tài khoản cho phép dùng chung khóa, vẫn cần cấu hình và lưu tại từng website; sau đó đặt từ khóa, lĩnh vực và vị trí hiển thị riêng theo mục đích từng website.

Chỉ nhập API Key tại phần kết nối của CMS. Giữ khóa bí mật và che khóa trong ảnh chụp gửi hỗ trợ. Muốn làm mới dữ liệu website sau khi thay cấu hình, tham khảo hướng dẫn xóa cache; xóa cache không cấp thêm quyền chiến dịch hoặc sửa được khóa sai.

12. Kiểm tra hoàn tất kết nối ACCESSTRADE

• Đã lấy API Key từ đúng tài khoản publisher, dùng nút Copy để lấy giá trị đầy đủ.
• Đã bật và lưu ở đúng website; tải lại vẫn thấy thông báo đã lưu khóa.
• Đã đặt khối chức năng và lưu thông số ở đúng trang/vị trí; không nhầm mã Campaign/Merchant/Keyword/Category.
• Sản phẩm, coupon hoặc chiến dịch cần dùng tải được và phân trang tiếp được.
• Chiến dịch công bố đã được duyệt, còn chạy và có thể tạo link; bộ lọc lĩnh vực dùng mã riêng của ACCESSTRADE.
• Nếu dùng hai nguồn, từ khóa và bộ lọc được cấu hình riêng; AccessTradePageSize chỉ áp cho ACCESSTRADE.
• API Key và mật khẩu không xuất hiện trong nội dung công khai.

Muốn thiết lập nguồn còn lại, xem Hướng dẫn cấu hình kết nối ADPIA trong CMS Dybi. Quy trình ADPIA cần Affiliate ID của website và có cách xử lý ô mật khẩu khác với API Key của ACCESSTRADE.