VI | EN
Message us on Messenger
Developer resources

Update an Upgraded Smart+ Campaign — TikTok Business API

Update an Upgraded Smart+ Campaign · call it through Quantri360 with one API key for your own accounts / assets that you connected and authorized — 360 handles request signing and refreshing the authorization you granted.

Update an Upgraded Smart+ Campaign

POST/smart_plus/campaign/update/Via 360: POST https://partner.quantri360.com/v1/tiktok_business/smart_plus/campaign/update/
Write endpoint — changes data on TikTok Business. The key must be created with "Allow write API calls" ticked, otherwise you get 403 write_not_allowed. Every call is logged.
Description

> Note

> add your content

Use this endpoint to update an Upgraded Smart+ Campaign.

This endpoint supports incremental updates.

Request

Endpoint

POST https://partner.quantri360.com/v1/tiktok_business/smart_plus/campaign/update/

Authentication & shop

NameInTypeSampleDescription
AuthorizationheaderheaderBearer q360_live_ab12cd34_…Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand.
platform_shop_idquerystring7000000000000000001Tài sản TikTok Business đã kết nối — "Mã tài sản" ở trang Nền tảng hoặc GET /v1/platforms (tài khoản quảng cáo cho Marketing API, tài khoản TikTok cho Organic / Messaging). Có thể bỏ khi chỉ kết nối một tài sản.

Request parameters

NameInTypeRequiredSampleDescription
campaign_idbodystringYesCampaign ID. To obtain campaign IDs, use /smart_plus/campaign/get/.
campaign_namebodystringNoCampaign name. Length limit: 512 characters. Emoji is not supported. Each word in Chinese or Japanese counts as two characters, while each letter in English counts as one character.
is_promotional_campaignbodybooleanNoValid in the following scenario: - objective_type is APP_PROMOTION and app_promotion_type is APP_INSTALL. Whether to use promotion campaign settings. Enable this feature to activate specialized campaign setup flows and optimization for new releases, event-driven campaigns, or time-bound offers. Supported values: true, false.
budget_auto_adjust_strategybodystringNoValid only when the following conditions are all met: - budget_optimize_on is true. - budget_mode is BUDGET_MODE_DYNAMIC_DAILY_BUDGET. - app_promotion_type is not MINIS. The campaign budget strategy for automatic daily campaign budget. Enum values: - AUTO_BUDGET_INCREASE: To enable Goal-based budget increase. Allow your budget to automatically increase when your ads are performing well and target CPA, Day 0 target ROAS, and budget requirements are met. - When budget_auto_adjust_strategy is AUTO_BUDGET_INCREASE, the specified budget will be the initial daily budget. Your daily budget will be allowed to automatically increase by 20%, up to 10 times per day, when your budget utilization reaches 90% or more. Your daily budget will reset to your original daily budget each day. - UNSET: To disable Goal-based budget increase. Note: Enabling Goal-based budget increase is currently an allowlist-only feature. If you would like to access it, please contact your TikTok representative.
budgetbodyfloatNoFixed campaign budget or initial campaign budget. - When budget_auto_adjust_strategy is UNSET, this field represents your fixed campaign budget. - When budget_auto_adjust_strategy is AUTO_BUDGET_INCREASE, this field represents your initial campaign budget. To retrieve the current campaign budget, check the returned current_budget. To learn about the minimum budget and how to set budget modes, see Budget. To directly see the daily budget value range for a currency, see Currency-Daily budget value range.
po_numberbodystringNoPO (purchase order) number. PO numbers are useful for invoice tracking and reconciliation. Learn more about PO numbers on monthly invoices.

Request examples

curl -s -X POST "https://partner.quantri360.com/v1/tiktok_business/smart_plus/campaign/update/" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaign_id":""}'
Python
import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.post(
    "https://partner.quantri360.com/v1/tiktok_business/smart_plus/campaign/update/",
    params={},
    json={
        "campaign_id": ""
    },
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())
Node.js
const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/tiktok_business/smart_plus/campaign/update/');
for (const [k, v] of Object.entries({})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'POST',
  headers: { Authorization: `Bearer ${KEY}`, 'Content-Type': 'application/json' },
  body: JSON.stringify({"campaign_id":""}),
});
console.log(r.status, await r.json());
PHP
<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/tiktok_business/smart_plus/campaign/update/' . '?' . http_build_query([]);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key, 'Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"campaign_id":""}');
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Response fields (as returned by TikTok Business)

NameTypeSampleDescription
codenumberResponse code. For the complete list of response codes and descriptions, see Appendix - Return Codes.
messagestringResponse message. For details, see Appendix - Return Codes.
request_idstringThe log ID of a request, which uniquely identifies the request.
dataobjectReturned data.
advertiser_idstringAdvertiser ID.
campaign_idstringCampaign ID.
create_timestringThe time when the campaign was created, in the format of `YYYY-MM-DD HH:MM:SS` (UTC time)
modify_timestringThe time when the campaign was last modified, in the format of `YYYY-MM-DD HH:MM:SS` (UTC time)
objective_typestringAdvertising objective. Currently, we support `APP_PROMOTION`, `WEB_CONVERSIONS`, and `LEAD_GENERATION`. For detailed explanation of enum values, see Enumeration-Advertising Objective.
app_promotion_typestringApp promotion type. Enum value: - `APP_INSTALL`: App install. Get new users to install your app. - `APP_RETARGETING`: App retargeting. Re-engage existing app users to take action in your app. - `MINIS`: TikTok Mini or Series. Promote your Series, mini series, or mini game by optimizing for organic and ads traffic.
sales_destinationstringSales destination, the destination where you want to drive your sales. Enum values: - `WEBSITE`: Website. Drive sales on your website. - `APP`: App. Drive sales on your app (product catalog required). - `WEB_AND_APP`: Website and app. Drive sales on both your website and your app.
campaign_typestringCampaign Type. Currently, we support `REGULAR_CAMPAIGN` and `IOS14_CAMPAIGN`.
app_idstringThe App ID of the app to promote. To get a list of App IDs, use /app/list/.
gaming_ad_compliance_agreementstringWhether to agree to the Compliance Assurance Policy for Gaming Advertisers on TikTok. The policy is as follows: Yo confirms and attest that any gaming application, product or service (game) you desire to advertise on TikTok, including any associated URL(s), (a) complies with all applicable laws and regulations of the jurisdictions where the game can be accessed or played, and upon request, can provide supporting documentation as evidence of why the game is not considered illegal gambling or lottery; and (b) has not been and is not part of any investigation or lawsuit regarding the game's legality or regulatory compliance. Enum values: - `ON`: To agree to the policy. - `OFF`: To leave the policy not accepted.
is_advanced_dedicated_campaignbooleanWhether the campaign is an Advanced Dedicated Campaign. Advanced Dedicated Campaigns leverage advanced delivery models that benefit from real-time signals. Supported values: `true`, `false`.
disable_skan_campaignbooleanWhether to disable SKAN (SKAdNetwork) attribution, Apple's conversion attribution solution for iOS campaigns. Enum values: - `true`: To disable SKAN attribution. The campaign will not be bound by Dedicated Campaign quota limits and you will be able to retrieve Self Attribution Network (SAN) metrics for the campaign. However, you cannot retrieve SKAN reporting metrics for the campaign. Learn more about SAN integration. - `false`: To enable SKAN attribution. The campaign will be bound by Dedicated Campaign quota limits and you will be able to retrieve SKAN metrics for the campaign.
bid_align_typestringThe attribution type for the Dedicated Campaign. The type determines which attribution network the target CPA (conversion_bid_price) or ROAS (roas_bid) at the ad group level is based on. Enum values: - `SAN`: SAN. - `SKAN`: SKAN.
campaign_app_profile_page_statestringIndicates the status of the App Profile Page. Enum values: `ON`, `OFF`.
is_search_campaignbooleanWhether the campaign is a Search Ads Campaign. With Search Ads Campaigns, you set up your campaign to target ads in TikTok search results. Search Ads Campaigns reach those in your audience actively looking for products or information related to your brand. You'll use relevant keywords and search terms to help guide audiences to your ads. Supported values: `true`, `false`.
catalog_enabledbooleanWhether to use your catalog to automatically advertise relevant products or services to people based on their unique interests, intent and actions. Supported values: `true`, `false`.
catalog_typestringThe type of catalog. Enum values: - `ECOMMERCE`: e-commerce. - `TRAVEL_ENTERTAINMENT`: travel and entertainment. - `MINI_SERIES`: mini series. - `GENERIC`: generic. - `ONLINE_TO_OFFLINE`: online-to-offline.
campaign_namestringCampaign name.
special_industriesstring[]Ad categories. Enum values: - `HOUSING`: Ads for real estate listings, homeowners insurance, mortgage loans or other related opportunities. - `EMPLOYMENT`: Ads for job offers, internships, professional certification programs or other related opportunities. - `CREDIT`: Ads for credit card offers, auto loans, long-term financing or other related opportunities.
budget_optimize_onbooleanWhether CBO is enabled. Supported values: `true` (enabled), `false` (disabled).
budget_modestringBudget mode. - When `budget_optimize_on` is `true` or not specified, the enum values are: - `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`: Dynamic daily campaign budget. It is the average daily budget over a week. Daily costs will not exceed 125% of the average daily budget. Weekly costs will not exceed the average daily budget * 7. - `BUDGET_MODE_TOTAL`: Lifetime campaign budget. - When `budget_optimize_on` is `false`, the enum values are: - `BUDGET_MODE_INFINITE`: No limit for all ad groups under this campaign. - `BUDGET_MODE_DAY`: Daily budget limit for all ad groups under this campaign. - `BUDGET_MODE_TOTAL`: Total budget limit for all ad groups under this campaign.
budget_auto_adjust_strategystringReturned only when the following conditions are all met: - `budget_optimize_on` is `true` or not specified. - `budget_mode` is `BUDGET_MODE_DYNAMIC_DAILY_BUDGET`. - `app_promotion_type` is not `MINIS`. The campaign budget strategy for automatic daily campaign budget. Enum values: - `AUTO_BUDGET_INCREASE`: To enable Goal-based budget increase. Allow your budget to automatically increase when your ads are performing well and target CPA, Day 0 target ROAS, and budget requirements are met. - When `budget_auto_adjust_strategy` is `AUTO_BUDGET_INCREASE`, the specified `budget` will be the initial daily budget. Your daily budget will be allowed to automatically increase by 20%, up to 10 times per day, when your budget utilization reaches 90% or more. Your daily budget will reset to your original daily budget each day. - `UNSET`: To disable Goal-based budget increase.
budgetfloat- When `budget_optimize_on` is `true` or not specified, this field represents fixed campaign budget or initial campaign budget. - When `budget_auto_adjust_strategy` is `UNSET`, this field represents your fixed campaign budget. - When `budget_auto_adjust_strategy` is `AUTO_BUDGET_INCREASE`, this field represents your initial campaign budget. To retrieve the current campaign budget, check the returned `current_budget`. - When `budget_optimize_on` is `false`, this field represents the limit for all ad groups under this campaign. - When `budget_mode` is `BUDGET_MODE_DAY`, this field represents the daily limit for all ad groups under this campaign. - When `budget_mode` is `BUDGET_MODE_TOTAL`, this field represents the total limit for all ad groups under this campaign.
current_budgetfloatReturned only when `budget_auto_adjust_strategy` is `AUTO_BUDGET_INCREASE`. Current campaign budget for a campaign with Goal-based budget increase enabled.
operation_statusstringOperation status. Enum values: - `ENABLE` : The campaign is enabled (in 'ON' status). - `DISABLE`: The campaign is disabled (in 'OFF' status).
secondary_statusstringCampaign secondary status. For enum values, see Enumeration- Campaign Status - Secondary Status.
smart_plus_adgroup_modestringThe ad group mode for the campaign. Enum values: - `SINGLE`: You can only create one single ad group within the campaign. - `MULTIPLE`: You can only create multiple ad groups within the campaign.
postback_window_modestringThe mode that determines which SKAN 4.0 postback you want to secure. Enum values: - `POSTBACK_WINDOW_MODE1`: This option secures the first postback, which corresponds to the 0-2 day attribution window. The data can take up to 4 days to return, and the campaign will wait for 4 days to release the campaign quota. - `POSTBACK_WINDOW_MODE2`: This mode secures the first two postbacks, which correspond to the 3-7 day attribution window. The data can take up to 13 days to return, and the campaign will wait for 13 days to release the campaign quota. - `POSTBACK_WINDOW_MODE3`: This mode secures all three postbacks, which correspond to the 8-35 day attribution window. The data can take up to 41 days to return, and the campaign will wait for 41 days to release the campaign quota. Note: If you have set up Mobile Measurement Partner (MMP) Tracking with Adjust, Airbridge, Appsflyer, Branch, Kochava, or Singular for your App and your MMP SDK version is updated to a SKAN 4.0 supported SDK, you can transition your App to SKAN 4.0 on Events Manager. To learn about how to set up MMP tracking for your App, see How to Set Up App Attribution in TikTok Ads Manager. To learn more about how to transition your App to SKAN 4.0, see About SKAN 4.0 and TikTok and How to transition to SKAN 4.0.
po_numberstringPO (purchase order) number. PO numbers are useful for invoice tracking and reconciliation. Learn more about PO numbers on monthly invoices.
is_promotional_campaignbooleanWhether to use promotion campaign settings. Enable this feature to activate specialized campaign setup flows and optimization for new releases, event-driven campaigns, theatrical releases, streaming service promotions, events, or time-bound offers. Supported values: `true`, `false`.
rta_idstringRealtime API (RTA) ID, the RTA strategy identifier.
rta_bid_enabledbooleanWhether to use RTA bid. Supported values: - `true`: enabled. - `false`: not enabled.
rta_product_selection_enabledbooleanWhether to use RTA to automatically select products. Enum values: - `true`: enabled. - `false`: not enabled.

Response sample

{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "advertiser_id": "{{advertiser_id}}",
        "app_id": "{{app_id}}",
        "app_promotion_type": "APP_INSTALL",
        "budget": {{budget}},
        "budget_mode": "BUDGET_MODE_DYNAMIC_DAILY_BUDGET",
        "budget_optimize_on": true,
        "campaign_app_profile_page_state": "ON",
        "campaign_id": "{{campaign_id}}",
        "campaign_name": "{{campaign_name}}",
        "campaign_type": "IOS14_CAMPAIGN",
        "create_time": "{{create_time}}",
        "disable_skan_campaign": false,
        "is_advanced_dedicated_campaign": true,
        "modify_time": "{{modify_time}}",
        "objective_type": "APP_PROMOTION",
        "operation_status": "ENABLE",
        "secondary_status": "CAMPAIGN_STATUS_ENABLE",
        "smart_plus_adgroup_mode": "MULTIPLE"
    }
}

Get started

  1. Sign up for Partner
  2. Enable a data type of the Ads (Marketing API) group on the platform page
  3. Create an API key (tick the TikTok Business channel)
  4. Call it as in the examples above