POST Tạo Chiến Dịch Affiliate Partner
Tạo Chiến Dịch Affiliate Partner Asset Scope bắt buộc: partner.tap_campaign.write API này cung cấp khả năng tạo chiến dịch cho các seller được nhắm mục tiêu/seller công khai, bao gồm thời gian chiến dịch, thời gian đăng ký chiến dịch và yêu cầu hoa hồng. Lưu ý: Chiến dịch sẽ không được hiển thị cho seller sau khi tạo Version 202405
POST/affiliate_partner/202405/campaigns
Request
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Kiểu được phép: application/json |
| x-tts-access-token Required | string | Giá trị partner access_token lấy từ Get Access Token, khi user_type = 3. Làm theo hướng dẫn này để lấy partner access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được dùng trên tất cả các yêu cầu API. Nhà phát triển có thể dùng giá trị này để chuyển đổi sang giờ địa phương. |
| category_asset_cipher Required | string | Định danh partner được dùng trong các yêu cầu API. Lấy giá trị này bằng cách sử dụng [Get Authorized Category Assets API] (https://partner.tiktokshop.com/docv2/page/666012dd609d4402cc3be995). |
Body
| Properties | Type | Description |
|---|---|---|
| name Required | string | Tên chiến dịch. Tên chiến dịch phải nhỏ hơn 50 ký tự. |
| description Required | string | Mô tả chiến dịch. Mô tả chiến dịch phải nhỏ hơn 1000 ký tự. |
| campaign_start_time Required | int | Thời gian bắt đầu theo lịch ở định dạng Unix epoch time cho chiến dịch. Lưu ý rằng trường này chỉ có thể được cập nhật khi trạng thái chiến dịch được đặt là READY hoặc UPCOMING. |
| campaign_end_time Required | int | Thời gian kết thúc theo lịch ở định dạng Unix epoch time cho chiến dịch. Lưu ý rằng thời gian kết thúc phải nhỏ hơn 360 ngày kể từ ngày bắt đầu. Trường này không còn chỉnh sửa được khi trạng thái chiến dịch được đặt là CLOSED. |
| registration_start_time Required | int | Thời gian bắt đầu theo lịch ở định dạng Unix epoch cho việc đăng ký sản phẩm của seller. Lưu ý rằng trường này chỉ có thể được cập nhật khi trạng thái chiến dịch được đặt là READY hoặc UPCOMING. |
| registration_end_time Required | int | Thời gian kết thúc theo lịch ở định dạng Unix epoch time cho việc đăng ký sản phẩm của seller. Trường này không còn chỉnh sửa được khi trạng thái chiến dịch được đặt là CLOSED. |
| commission_rate Required | int | Tổng tỷ lệ hoa hồng tính theo đơn vị phần trăm (0.01%) do affiliate partner đề xuất để hiển thị cho seller. Tỷ lệ hoa hồng phải lớn hơn 100 và nhỏ hơn 8000. |
| contact_info Required | object | Thông tin liên hệ của partner. |
| target_shop_codes | []string | Danh sách các shop code của seller TikTok Shop được phép đăng ký chiến dịch. Shop code của seller có sẵn trong TikTok Shop Seller Central bằng cách nhấp vào biểu tượng Seller Profile ở góc trên bên phải của giao diện người dùng. Danh sách phải có độ dài nhỏ hơn 100 mục. |
| target_seller_types | []string | Danh sách các loại seller đủ điều kiện được phép đăng ký chiến dịch. Sử dụng trường này để nhắm mục tiêu rộng theo loại seller thay vì các seller cụ thể trong trường target_shop_codes. Đây là kiểu liệt kê với các giá trị có thể có:- LOCAL- CROSS_BORDER |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong phản hồi API. |
| message | string | Thông báo thành công hoặc thất bại được trả về trong phản hồi API. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Nhật ký yêu cầu |
| data | object | Thông tin trả về cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 16032001 | nvalid parameter Creator and Seller, please ensure Region mismatch. | | 16032002 | Invalid campaign period | | 16032003 | Invalid registration period | | 16032004 | Invalid campaign seller scope | | 16032013 | Payment account not yet activated |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext