Tích hợp Affiliate
Bối cảnh
TikTok Shop vui mừng ra mắt một danh mục API mới tập trung vào affiliate marketing trên TikTok Shop.
Các API này sẽ cung cấp cho Seller, Creator Affiliate và TikTok Shop Partner những cách thức hiệu quả hơn để tạo, quản lý, kết nối (matchmake), theo dõi, kiếm tiền và cộng tác trên các TikTok Shop Affiliate Collaboration và Partner Campaign.
✏️ Thông tin đăng nhập thử nghiệm (Test Credentials)
Partner Center:
- Sử dụng các Development Shop như hướng dẫn trong tài liệu này.
Affiliate Center/Seller Center:
- Sử dụng các tài khoản liên kết với Development Shop của bạn.
Test Creator:
- 86 12341968831, 003615 ( Ymd_ttp_8831, 7205096607046632494 )
- 86 12343432801, 007424 ( testdziwjtmwbq, 7400230764149244970 )
Affiliate API mặc định không được kích hoạt, và partner/ISV phải đăng ký quyền truy cập, việc này yêu cầu sự phê duyệt từ Account Manager hoặc Partner Manager của bạn để kích hoạt API nhằm xây dựng ứng dụng.
Thiết lập tài khoản partner
- Tham khảo Register as a service partner để đăng ký. Đảm bảo bạn chọn các giá trị sau trong quá trình đăng ký.
Business Guide: For app developers (ISVs) Category: App developer > Customer Engagement > Affiliate
Tham khảo Register as a service partner
để đăng ký. Đảm bảo bạn chọn các giá trị sau trong quá trình đăng ký. - Business Guide: For app developers (ISVs)
- Category: App developer > Customer Engagement > Affiliate
- Truy cập App & Service và tạo các app sau:
Affiliate (public): Để ra mắt một app chính thức trên TikTok Shop App Store. Affiliate (custom): Cho mục đích thử nghiệm. Connector (custom): Để có được quyền truy cập cần thiết tới các API không thuộc affiliate. Truy cập App & Service
và tạo các app sau: - Affiliate (public): Để ra mắt một app chính thức trên TikTok Shop App Store.
- Affiliate (custom): Cho mục đích thử nghiệm.
- Connector (custom): Để có được quyền truy cập cần thiết tới các API không thuộc affiliate.
- Khởi tạo quy trình rà soát tuân thủ (compliance review) cho app Affiliate (public) bằng cách tham khảo Publish and list a Public App.
- Cung cấp app key của bạn (một key dài 14 ký tự, không phải App ID hay Partner ID) cho partner manager của bạn để chúng tôi có thể liệt kê bạn cho việc cấp quyền creator (creator authorization). Việc cấp quyền creator là cần thiết để truy cập các Creator API.
- Bắt đầu phát triển tích hợp khi quyền truy cập API được cấp.
Thiết lập development shop
Thiết lập Seller Center cho development shop
Thông tin thuế
Cung cấp thông tin giả (dummy) để đáp ứng yêu cầu này.
Điều hướng đến Seller Center và sẽ có một banner tương tự như sau:
Nhấp vào Verify Now trên banner này và bạn sẽ thấy một biểu mẫu thuế như hình bên dưới. Bạn có thể dùng các giá trị giống như trong ví dụ này.
Khi bạn nhấp Submit, bạn sẽ được nhắc với một hộp xác nhận, nơi bạn được yêu cầu ký tên. Nó trông có vẻ đáng ngại, nhưng đây là tài khoản thử nghiệm và chúng ta chỉ cần đáp ứng một số yêu cầu.
📌 Lưu ý: Bạn có thể phải thiết lập kho xuất hàng (origin warehouse) và kho nhận trả hàng (return warehouse) cũng như thiết lập các shipping template. Vui lòng tham khảo các bài viết hỗ trợ sau về cách cấu hình kho và shipping template:
Sau khi bạn đã gửi thông tin thuế, việc thiết lập development shop của bạn hoàn tất và sẵn sàng chấp nhận đăng bán sản phẩm.
Ví dụ đăng bán sản phẩm
Lấy một ví dụ, giả sử chúng ta có một sản phẩm mà chúng ta muốn creator giới thiệu. Họ sẽ cần một affiliate link để chia sẻ với người theo dõi nhằm mua sản phẩm này. Điều này giúp tinh gọn quy trình mua hàng và theo dõi doanh số theo từng creator hoặc phân khúc sản phẩm. Dưới đây là một số ảnh chụp màn hình ví dụ về cách bạn có thể đăng bán sản phẩm qua Seller Center. Bạn cũng có thể tạo chúng bằng API.
📌 Lưu ý: Khuyến nghị chọn No Brand nếu tạo qua Seller Center.
Product 1
Product 2
Sau khi sản phẩm được tạo, bạn sẽ thấy chúng ở trạng thái Live sau khi được phê duyệt.
Chúc mừng! Sản phẩm giờ đã sẵn sàng để thêm vào một open collaboration! Hãy vào Affiliate Center bằng cách nhấp vào Affiliate ở bên trái. Cuộn xuống và nhấp vào Go to TikTok Shop Affiliate homepage. Việc này sẽ mở Affiliate Center trong một tab mới. Bạn cũng có thể dùng link này và nó sẽ tự động đăng nhập.
Onboarding seller
Việc cấp quyền Seller Center là bắt buộc để lấy thông tin về tất cả sản phẩm mà một seller đang bán. Seller có thể thiết lập các open collaboration để bất kỳ creator nào cũng có thể tham gia, hoặc thiết lập các targeted collaboration với những partner cụ thể. Để kích hoạt tất cả những điều này qua API, một seller phải kết nối tài khoản TikTok Seller Center của họ để bạn có thể quản lý affiliate, sản phẩm và đơn hàng của họ.
Để hiểu tất cả các bước liên quan đến việc cấp quyền cho ứng dụng của bạn, vui lòng xem Seller Authorization Guide trong Partner Center. Sau khi được cấp quyền, bạn nên:
- Xác minh kết nối bằng cách gọi Get Authorized Shops API và so sánh phản hồi với các giá trị trong Seller Center.
- Gọi Search Products API để lấy danh sách sản phẩm và các Product ID tương ứng cần thiết cho các lần gọi API sau này.
Onboarding creator
Trước khi bạn có thể gửi các targeted collaboration hoặc mời họ tham gia campaign, bạn cần để creator kết nối tài khoản TikTok của họ với ứng dụng của bạn.
- Yêu cầu họ đăng nhập vào TikTok bằng creator authorization link của bạn. Nó sẽ có dạng:
shop.tiktok.com/alliance/creator/auth?app_key=<app_key>&state=<state>
❗ Quan trọng: Tham số state là bắt buộc cho các creator authorization link.
- Việc này sẽ nhắc creator đăng nhập bằng tài khoản TikTok của họ.
- Sau khi họ đăng nhập thành công, họ sẽ thấy một màn hình giống như sau:
- Khi họ nhấp vào nút Authorize, TikTok Shop sẽ chuyển bạn đến redirect link được chỉ định trong cài đặt app. Ví dụ, nếu redirect link là
http://localhost:8000, thì redirect URL sẽ trông như:http://localhost:8000?code=<redacted>&state=<state>&app_key=<app_key>. - Dùng code từ redirect URL để gọi endpoint GET Access Token, endpoint này sẽ cấp cho bạn quyền gọi các Affiliate Creator endpoint.
📌 Lưu ý: Quy trình này giống như khi lấy access token cho tài khoản Seller Center của bạn, nhưng có hai access token riêng biệt, một cho tài khoản seller và một cho tài khoản creator.
- Endpoint GET Creator Profile sẽ cung cấp cho bạn
creator_user_idcần thiết để gọi thành công các API tạo một targeted collaboration.
Vui lòng tham khảo creator authorization guide trong TikTok Shop Partner Center để biết thông tin chi tiết về cách kết nối các tài khoản này.
Ánh xạ scope của API
💡 Mẹo: Bạn có thể trực tiếp tìm kiếm tên API trong modal Manage API bằng cách nhấp vào dropdown bên cạnh Scope Name và chọn một trong các mục nằm dưới cột API Names.
| Scope ID | Scope Name | API Names |
|---|---|---|
| 434372 | Affiliate Information | * Check Anchor Content |
- Check Anchor Prerequisites
- Get Creator Profile
- Get Live Room Info
- Get Shop Products | | 733764 | Read Seller Affiliate Collaborations | * Search Seller Affiliate Orders
- Seller Search Affiliate Open Collaboration Product | | 890884 | Manage Seller Affiliate Collaboration | * Create Open Collaboration
- Create Target Collaboration
- Edit Open Collaboration Settings
- Generate Affiliate Product Promotion Link
- Remove Creator Affiliate from Collaboration | | 1021508 | Read Creator Affiliate Collaborations | * Creator Search Open Collaboration Product
- Search Creator Affiliate Orders
- Search Creator Target Collaborations | | 733508 | Read Affiliate Partner Campaigns | * Get Affiliate Partner Campaign Detail
- Get Affiliate Partner Campaign List
- Get Affiliate Partner Campaign Product List | | 733444 | Manage Affiliate Partner Campaigns | * Create Affiliate Partner Campaign
- Edit Affiliate Partner Campaign
- Publish Affiliate Partner Campaign | | 733572 | Manage Affiliate Partner Campaign Products | * Review Affiliate Partner Campaign Product |
Trường hợp sử dụng
Tạo affiliate product promotion link
Đối với các sản phẩm đang live, bạn có thể tạo product promotion link bằng cách gọi Generate Affiliate Product Promotion Link API. Bạn chỉ có thể tạo một promotion link mỗi lần gọi API vì product ID là một phần của tham số path.
CURLWord Wrap
curl --location --globoff --request POST 'https://open-api.tiktokglobalshop.com/affiliate_seller/202405/products/1729570313535393936/promotion_link/generate?app_key=6d0ut2ttps2io&shop_cipher=TTP_YaVduQAAAACwxSc13yKds1NldAZaPw34&sign=c2a149d480ae59b6eaf0ceebe1173d7fbb831a4227406a9008c0565535b42ebe×tamp=1723135734' \
--header 'content-type: application/json' \
--header 'x-tts-access-token: <token>' \
--data ''
{
"code": 0,
"data": {
"product_promotion_link": "https://www.tiktok.com/t/ZTNgEQFGa/"
},
"message": "Success",
"request_id": "20240808165018109CFA6CCA917E04CBAD"
}
❗ Quan trọng: Bạn chỉ có thể thêm một sản phẩm vào một open collaboration.
Để tạo một open collaboration, hãy làm theo các bước sau:
- Thêm sản phẩm vào open collaboration bằng cách dùng product ID và commission rate (ví dụ 1234) thông qua việc gọi Create Open Collaboration API.
Nếu thành công, phản hồi sẽ bao gồm effective time, ID (open collaboration ID 87620110221), và product ID thuộc collaboration đó. Nếu bạn muốn chỉnh sửa commission rate hoặc toggle approve creator, chỉ cần gọi lại API với các cài đặt mới. ID không thay đổi. Thêm sản phẩm vào open collaboration bằng cách dùng product ID và commission rate (ví dụ 1234) thông qua việc gọi Create Open Collaboration API
. - Nếu thành công, phản hồi sẽ bao gồm effective time, ID (open collaboration ID 87620110221), và product ID thuộc collaboration đó.
- Nếu bạn muốn chỉnh sửa commission rate hoặc toggle approve creator, chỉ cần gọi lại API với các cài đặt mới. ID không thay đổi.
📌 Lưu ý: Không thể thêm free sample vào open collaboration qua API, và phải thực hiện trong Seller Center.
- Bạn có thể xác minh việc tạo thành công bằng cách gọi Seller Search Affiliate Open Collaboration API:
CURLWord Wrap
curl --location --globoff 'https://open-api.tiktokglobalshop.com/affiliate_seller/202405/open_collaborations/products/search?app_key=6d0ut2ttps2io&shop_cipher=TTP_YaVduQAAAACwxSc13yKds1NldAZaPw34&sign=30ce092ba485c189a6c30f856ce771c55c4acddda11c957ecababd5c07435a2d×tamp=1723136505&page_size=10' \
--header 'content-type: application/json' \
--header 'x-tts-access-token: <token>' \
--data '{
"category": {
"id": "601755"
},
"title_keywords": [
"Open Collaboration Pink"
],
"sales_price_range": {
"amount_ge": "3.99",
"amount_lt": "4.99"
},
"commission_rate_range": {
"rate_ge": 1233,
"rate_lt": 1235
}
}'
{
"code": 0,
"data": {
"next_page_token": "",
"products": [
{
"category_chains": [
{
"id": "601755",
"is_leaf": false,
"local_name": "Computers & Office Equipment",
"parent_id": "0"
},
{
"id": "831112",
"is_leaf": false,
"local_name": "Office Stationery & Supplies",
"parent_id": "601755"
},
{
"id": "855560",
"is_leaf": true,
"local_name": "Cards",
"parent_id": "831112"
}
],
"commission": {
"amount": "0.4319",
"currency": "USD",
"rate": 1234
},
"detail_link": "https://shop.tiktok.com/view/product/1729570313535393936?region=US&local=en",
"has_inventory": true,
"id": "1729570313535393936",
"main_image_url": "https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c9052b2b9d5248c1a552d5fe15a892d5~tplv-omjb5zjo8w-origin-webp.webp?from=1695864008",
"original_price": {
"currency": "USD",
"maximum_amount": "4.19",
"minimum_amount": "4.19"
},
"sale_region": "US",
"sales_price": {
"currency": "USD",
"maximum_amount": "3.5",
"minimum_amount": "3.5"
},
"shop": {
"name": "SANDBOX7398293016815273770"
},
"title": "Open Collaboration Coffee Pink Color Meme Card Smiling Lady",
"units_sold": 5
}
],
"total_count": 1
},
"message": "Success",
"request_id": "20240808170145A205E014C8878404D59C"
}
📌 Lưu ý: Bạn có thể cần điều chỉnh các tham số để lọc kết quả thu hẹp lại, đặc biệt nếu nó quá chung chung. Trong ví dụ trên, title keywords là "Open Collaboration Pink", sales price range nằm trong khoảng 3.99 đến 4.99, và commission rate nằm trong khoảng 1233 đến 1235.
- Bạn cũng có thể xác minh điều này trong Affiliate Center:
Hành động của creator
Các creator đã hoàn thành các bước onboarding mô tả ở trên có thể dùng ứng dụng của bạn để tìm các open collaboration. Để kích hoạt tính năng này, bạn phải tích hợp với Creator Search Open Collaboration Product API (cURL bên dưới). API nhận vào tìm kiếm theo product title, giá sản phẩm, category của sản phẩm và commission của collaboration, rồi trả về danh sách các open collaboration do seller đó đăng tải mà creator được tự do tham gia. Một số trong đó có quy trình sàng lọc (screening) mà seller phải phê duyệt creator sau khi rà soát.
CURLWord Wrap
curl --location --globoff 'https://open-api.tiktokglobalshop.com/affiliate_seller/202405/open_collaborations/products/search?app_key=6d0ut2ttps2io&shop_cipher=TTP_bCWokAAAAAA6xm9rY_B9wYFY2QltXcs9&sign={{sign}}×tamp={{timestamp}}&page_size=10' \
--header 'content-type: application/json' \
--header 'x-tts-access-token: <redacted>' \
--data '{
"category": {
"id": "601755"
},
"title_keywords": [
"Open Collaboration Pink"
],
"sales_price_range": {
"amount_ge": "3.99",
"amount_lt": "4.99"
},
"commission_rate_range": {
"rate_ge": 1233,
"rate_lt": 1235
}
}'
{
"code": 0,
"data": {
"next_page_token": "",
"products": [
{
"category_chains": [
{
"id": "601755",
"is_leaf": false,
"local_name": "Computers & Office Equipment",
"parent_id": "0"
},
{
"id": "831112",
"is_leaf": false,
"local_name": "Office Stationery & Supplies",
"parent_id": "601755"
},
{
"id": "855560",
"is_leaf": true,
"local_name": "Cards",
"parent_id": "831112"
}
],
"commission": {
"amount": "0.4319",
"currency": "USD",
"rate": 1234
},
"detail_link": "https://shop.tiktok.com/view/product/1729570313535393936?region=US&local=en",
"has_inventory": true,
"id": "1729570313535393936",
"main_image_url": "https://p16-oec-ttp.tiktokcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/c9052b2b9d5248c1a552d5fe15a892d5~tplv-omjb5zjo8w-origin-webp.webp?from=1695864008",
"original_price": {
"currency": "USD",
"maximum_amount": "4.19",
"minimum_amount": "4.19"
},
"sale_region": "US",
"sales_price": {
"currency": "USD",
"maximum_amount": "3.5",
"minimum_amount": "3.5"
},
"shop": {
"name": "SANDBOX7398293016815273770"
},
"title": "Open Collaboration Coffee Pink Color Meme Card Smiling Lady",
"units_sold": 5
}
],
"total_count": 1
},
"message": "Success",
"request_id": "202408081849481CCE26F7477A910041E1"
}
Nếu một creator nhấp vào detail_link trên điện thoại của họ dưới bất kỳ sản phẩm nào, nó sẽ mở app TikTok và hiển thị trang hiển thị sản phẩm (PDP) với thông tin chi tiết collaboration bên dưới. Trong ví dụ bên dưới, đó là dòng chữ "Earn 0.52 on each product sold" ngay phía trên nút Buy Now.
Nhấp vào đây sẽ mở rộng menu với các tùy chọn như yêu cầu free sample hoặc shoppable video (nếu có), và một call to action chính để họ thêm sản phẩm vào showcase. Ví dụ, một creator về thời trang có thể tìm kiếm các open collaboration với những seller đang sản xuất áo thun chất lượng cao bằng API này. Creator có thể nhập commission rate mà họ muốn kiếm được và kiểu áo thun bằng cách truyền vào phần tìm kiếm theo product title.
 |  |  |
Gỡ một creator khỏi một collaboration
Nếu vì bất kỳ lý do gì bạn muốn gỡ một creator khỏi một open collaboration, bạn có thể gọi Remove Creator Affiliate from Collaboration API.
📌 Lưu ý: Trong phiên bản API hiện tại, việc này sẽ gỡ creator nhưng không ngăn họ tham gia lại bằng affiliate link.
CURLWord Wrap
curl --location --globoff 'https://open-api.tiktokglobalshop.com/affiliate_seller/202405/open_collaborations/129916503437/remove_creator?app_key=6d0ut2ttps2io&shop_cipher=TTP_bCWokAAAAAA6xm9rY_B9wYFY2QltXcs9&sign=b61b7a13d73cf242f95d9f8ff8f0d46689af5ceba70749f5a267dac54c370869×tamp=1723143673' \
--header 'content-type: application/json' \
--header 'x-tts-access-token: <redacted' \
--data '{
"creator_user_id": "7400230764149244970",
"product_id": "1729568997216587962"
}'
{
"code": 0,
"data": {},
"message": "Success",
"request_id": "20240808190113870E01A8EAB8AF006987"
}
Tạo một targeted collaboration
Để mời thành công các creator vào một targeted collaboration, bạn sẽ cần một danh sách creator user ID, và có thể mời tối đa 50 creator mỗi lần gọi API. Điều này nghĩa là bạn cần có các creator đã được cấp quyền theo Creator Authorization link tại đây và có một access token riêng để thay đổi tài khoản TikTok của creator.
Để tạo một targeted collaboration, hãy làm theo các bước sau:
- Gọi Get Creator Profile API với creator access token để lấy creator user ID nếu bạn chưa lưu chúng trong database của mình:
CURLWord Wrap
curl --location --globoff 'https://open-api.tiktokglobalshop.com/affiliate_creator/202405/profiles?app_key=6d0ut2ttps2io&sign=4ba5a9531b4c2196cdefde923c270259363398d3fcd05074c0c9302e07f77576×tamp=1723144188' \
--header 'content-type: application/json' \
--header 'x-tts-access-token: <creator_token>' \
--data ''
{
"code": 0,
"data": {
"avatar": {
"url": "https://p16-sign-va.tiktokcdn.com/musically-maliva-obj/1594805258216454~c5_100x100.webp?lk3s=a5d48078&nonce=51354&refresh_token=4cda6b090dcbd9854fe8aa7ec2297662&x-expires=1723312800&x-signature=y9Z7uqPuxLEtzus5m7PBg5CeqH4%3D&shp=a5d48078&shcp=2c5759a5"
},
"creator_user_id": "7400230764149244970",
"permissions": [
"LIVE_STREAM_PERMISSION",
"ADD_AFFILIATE_PERMISSION"
],
"register_region": "US",
"selection_region": "US",
"seller_type": "UNKNOWN",
"user_type": "TIKTOK_SHOP_CREATOR",
"username": "testdziwjtmwbq"
},
"message": "Success",
"request_id": "202408081837124EF0047357C9480005DB"
}
CURLWord Wrap
curl --location --globoff 'https://open-api.tiktokglobalshop.com/affiliate_seller/202405/target_collaborations?app_key=6d0ut2ttps2io&shop_cipher=TTP_bCWokAAAAAA6xm9rY_B9wYFY2QltXcs9&sign=5ddb3f519b3da61f2f959df81fc42b77441df06626f070ae423e3112a932111a×tamp=1723144047' \
--header 'content-type: application/json' \
--header 'x-tts-access-token: <redacted>' \
--data-raw '{
"name": "API Target Collaboration",
"message": "Created via Postman",
"end_time": "1723194000",
"products": [
{
"id": "1729569362021748922",
"target_commission_rate": 2001
}
],
"creator_user_ids": [
"7400230764149244970"
],
"seller_contact_info": {
"email": "test@tiktokshop.com"
},
"free_sample_rule": {
"has_free_sample": true,
"is_sample_approval_exempt": false
}
}'
{
"code": 0,
"data": {
"target_collaboration": {
"id": "7400846837790361387"
},
"target_collaboration_conflicts": []
},
"message": "Success",
"request_id": "202408081907271D8F70256ABB65008443"
}
- Khuyến nghị
end_timenên cách ít nhất vài ngày kể từ bây giờ. - Đôi khi API có thể trả về
target_collaboration_conflictstrong phản hồi. Điều này nghĩa là targeted collaboration chưa được tạo. - Nếu thành công, sẽ có một object
target_collaboration, kèm theo target collaboration ID.
Các lỗi thường gặp bao gồm:
invalid_params: Vui lòng kiểm tra end_time.
test account and non test account can not cross invite: Nếu bạn đang mời nhiều creator, và một hoặc nhiều người trong số họ không khớp với môi trường shop, vui lòng gỡ họ khỏi danh sách creator.
Nếu thành công, sẽ có một object target_collaboration
, kèm theo target collaboration ID. - Các lỗi thường gặp bao gồm:
invalid_params: Vui lòng kiểm tra end_time.
test account and non test account can not cross invite: Nếu bạn đang mời nhiều creator, và một hoặc nhiều người trong số họ không khớp với môi trường shop, vui lòng gỡ họ khỏi danh sách creator.
Các lỗi thường gặp bao gồm: - invalid_params: Vui lòng kiểm tra end_time.
- test account and non test account can not cross invite: Nếu bạn đang mời nhiều creator, và một hoặc nhiều người trong số họ không khớp với môi trường shop, vui lòng gỡ họ khỏi danh sách creator.
Hành động của creator
Creator có thể tìm các lời mời collaboration bằng cách vào Profile > TikTok Studio > TikTok Shop for Creator (dưới mục Monetization) > Cuộn xuống đến TikTok Shop Toolkit > Collab invites.
- Khi một creator chọn collaboration mà họ quan tâm, nó sẽ hiển thị tất cả sản phẩm thuộc lời mời này, và họ có thể chọn thêm những sản phẩm mà họ muốn quảng bá vào showcase của mình.
- Họ có thể chọn Add All hoặc nhấp vào từng sản phẩm riêng lẻ để thêm.
 |  |  |  |
Search Creator Target Collaborations API cho phép ứng dụng tìm kiếm tất cả các targeted collaboration mà một creator có với một cửa hàng cụ thể. Cửa hàng này cần một shop ID, có thể lấy được bằng cách gọi Get Authorized Shops API như mô tả trong các bước onboarding seller ở trên.
CURLWord Wrap
curl --location --globoff 'https://open-api.tiktokglobalshop.com/affiliate_creator/202405/target_collaborations/search?app_key=6d0ut2ttps2io&sign={{sign}}×tamp={{timestamp}}&page_size=20' \
--header 'content-type: application/json' \
--header 'x-tts-access-token: TTP_VfWnMAAAAADpPV2NiWO2_60_59-jq0QxV6beCG1eHCnsQGa3Znh6huRfzsNsfAjCx3sexUeCzQ35Fi8SZfHTTwVnm-dQD_vk_Jh0YTSdfpp2tmWllFw_4g' \
--data '{
"shop_id": "7495792013947799738"
}'
{
"code": 0,
"data": {
"next_page_token": "",
"target_collaborations": [
{
"id": "7400846837790361387",
"name": "API Target Collaboration",
"products": [
{
"commission": {
"amount": "1.0005",
"currency": "USD",
"rate": 2001
},
"id": "1729569362021748922",
"main_image_url": "tos-useast5-i-omjb5zjo8w-tx/b22252c5634c4cf58ab44fd630945cc0",
"title": "I Got A Bridge To Sell You Model Concrete Test Prod"
}
],
"status": "LIVE"
}
],
"total_count": 1
},
"message": "Success",
"request_id": "202408081923125F67CB063F3DF300AF19"
}
Tương tác với showcase
Creator dùng app TikTok
Khi một creator nhấp vào product promotion link trên thiết bị di động của họ, nó sẽ mở app TikTok và hiển thị PDP, màn hình này sẽ nhắc creator thêm sản phẩm vào showcase. Lời nhắc này cũng cho phép creator đặt một free sample nếu nó được bật trong open collaboration, hoặc nhắc họ tạo một shoppable video nếu đó là một targeted collaboration.
Partner/seller dùng API
Để gọi bất kỳ API nào được liệt kê dưới mục Affiliate Creator trong API Reference, bạn sẽ cần có creator của mình cấp quyền cho ứng dụng. Hãy làm theo luồng Creator Authorization tại link này. Các bước sau giả định bạn đã có token để thực hiện thay đổi trên tài khoản TikTok của họ. Cho mục đích thử nghiệm, bạn có thể dùng thông tin đăng nhập TikTok Creator Account ở trên nếu hiện tại bạn chưa có.
Để thêm một sản phẩm vào showcase của creator, sản phẩm đó phải đã tồn tại như một phần của một collaboration. Bạn có thể nhận được lỗi yêu cầu liên hệ TikTok nếu một product collaboration link không tồn tại. Xem ở trên về cách tạo một targeted collaboration.
Để thêm một sản phẩm vào showcase của creator, bạn có thể gọi Add Showcase Products API. Khuyến nghị bạn thêm affiliate link có thể được tạo theo trường hợp sử dụng ở trên.
Sau khi sản phẩm được thêm vào showcase của họ, họ có thể yêu cầu free sample nếu được bật.
Creator dùng API
Ứng dụng tích hợp với các TikTok API có thể hiển thị các sản phẩm hiện được liệt kê trong tài khoản của một creator cụ thể bằng cách gọi Get Showcase Products.
Free sample cho creator
Bật free sample
Free sample chỉ có thể được bật trong Affiliate Center. Nhấp vào Not Created để mở một modal cho phép bạn chỉ định các quy tắc cho free sample. Trường bắt buộc duy nhất là quantity, bạn có thể điều chỉnh phần còn lại theo ý muốn. Sau khi free sample được bật, bạn cần tạo một product promotion link có thể chia sẻ với creator.
Vui lòng tham khảo các phần ở trên: Tạo affiliate product promotion link, Tạo một open collaboration, và Tạo một targeted collaboration về cách tạo link để creator có thể yêu cầu sample.
📌 Lưu ý: Nếu một sản phẩm không được thêm vào open collaboration, chỉ có link được tạo ra.
Chia sẻ link này với một creator để họ có thể thêm vào showcase như hình bên dưới.
Yêu cầu free sample
 |  |  |  |  |
Thực hiện (fulfill) free sample
Khi một creator thêm một sản phẩm vào showcase của họ, họ cũng có tùy chọn yêu cầu một free sample nếu có. Các yêu cầu sample này được hiển thị trong Affiliate Center dưới trang Sample Requests. Seller có thể phê duyệt hoặc từ chối các yêu cầu này nếu auto-approved được đặt thành false.
Sau khi được phê duyệt, một đơn sample được tạo ra và sẽ được phản ánh trong Seller Center. Hãy thực hiện (fulfill) đơn này như bất kỳ đơn hàng nào khác.
📌 Lưu ý: Không có khoảng thời gian giữ (on hold period) cho các đơn free sample. Khi một tracking number được cung cấp trong Seller Center (qua TikTok Shipping hoặc Seller Shipping), trạng thái sẽ chuyển từ Ready To Ship (Awaiting Shipment trong Seller Center) sang Shipped (Awaiting Collection trong Seller Center).
Một creator có thể xem các đơn sample của họ bằng cách vào Profile > Your Orders > Samples > Orders.
Đơn hàng affiliate
Luồng mua hàng trên app TikTok
Đơn hàng Seller Center
Khi một sản phẩm được mua thông qua quy trình affiliate (qua link hoặc shoppable video), chúng sẽ xuất hiện trong phần Affiliate Orders.
Các đơn này cũng được tạo trong Seller Center và được liên kết trong vùng được tô sáng. Nhấp vào order ID sẽ mở đơn hàng trong Seller Center trong một cửa sổ mới. Các đơn này sẽ có khoảng thời gian giữ (hold period) mặc định là một giờ.
Các đơn này cũng có thể được tìm thấy bằng cách gọi Search Seller Affiliate Orders API.
Đơn hàng creator
Để tra cứu các đơn hàng được tạo ra bởi creator, bạn có thể gọi Search Creator Affiliate Orders API. Partner có thể lấy về danh sách các đơn hàng affiliate từ creator, và partner có thể dùng order ID để đo lường các chuyển đổi (conversion) được tạo ra từ creator.