Tecrübetecrube.com
Référence des outils — Publicité

TikTok Ads tools

Campaign, ad group and ad management, video/image upload, audiences and performance reports.

Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont le texte anglais d'origine vu par l'assistant.

Outils de lecture9 outils

list_tiktok_advertisers

Lecture1 crédits

TikTok ad accounts (advertisers) reachable with the connected TikTok Ads token: id, name, currency, timezone, status. Read only; returns connected=false when no account is linked.

Cet outil ne prend aucun paramètre.

list_tiktok_campaigns

Lecture1 crédits

TikTok campaigns of the connected ad account: campaign_id, name, objective_type, budget, budget_mode, operation_status. Use campaign_id values for the other tiktok tools.

ParamètreTypeDescription
campaign_idsFacultatifarray<string>—
statusFacultatifstringprimary status filter, e.g. STATUS_DELIVERY_OK, STATUS_DISABLE

list_tiktok_ad_groups

Lecture1 crédits

TikTok ad groups with budget, bid, optimisation goal, targeting (locations, ages, gender, languages, interests, audiences), placements, schedule and dayparting.

ParamètreTypeDescription
campaign_idsFacultatifarray<string>—
adgroup_idsFacultatifarray<string>—

list_tiktok_ads

Lecture1 crédits

TikTok ads: ad_id, name, ad group, status, format, text, video_id, landing page, call to action.

ParamètreTypeDescription
campaign_idsFacultatifarray<string>—
adgroup_idsFacultatifarray<string>—
ad_idsFacultatifarray<string>—

tiktok_performance_report

Lecture2 crédits

TikTok performance by campaign, ad group or ad for a date range: spend, impressions, clicks, CTR, CPM, CPC, conversions, cost per conversion, conversion rate, ROAS where available; optional daily breakdown and totals. Real data only; connected=false when no account.

ParamètreTypeDescription
levelFacultatifcampaign | ad_group | ad—
daysFacultatifinteger (1–365)—
start_dateFacultatifstring—
end_dateFacultatifstring—
dailyFacultatifbooleanone row per day (stat_time_day)
campaign_idsFacultatifarray<string>—
adgroup_idsFacultatifarray<string>—
ad_idsFacultatifarray<string>—

list_tiktok_audiences

Lecture1 crédits

Custom and lookalike audiences of the TikTok ad account: audience_id, name, type, size (cover_num), validity. Use audience_ids in update_tiktok_ad_group to assign them.

Cet outil ne prend aucun paramètre.

list_tiktok_videos

Lecture1 crédits

Videos in the TikTok ad account's asset library: video_id, file name, duration, size, preview and cover URLs. Use video_id in create_tiktok_ad or create_tiktok_whatsapp_campaign; add new videos from a public URL with upload_tiktok_video.

ParamètreTypeDescription
video_idsFacultatifarray<string>—

get_tiktok_video_cover

Lecture1 crédits

Suggested cover frames for a TikTok library video (file/video/suggestcover): id, preview url (valid one hour), size. Upload the chosen url with upload_tiktok_image to use it as the ad cover (image_ids). Read only.

ParamètreTypeDescription
video_idObligatoirestring—
countFacultatifinteger (1–10)—

search_tiktok_targeting

Lecture1 crédits

Turn targeting names into TikTok ids: interest (tool/interest_category → interest_category_ids), behavior (tool/action_category → actions[].action_category_ids), interest_keyword (tool/interest_keyword/recommend → interest_keyword_ids), location (tool/targeting/search → location_ids / zipcode_ids, cities and provinces), region (tool/region → targetable countries for the objective). Read only.

ParamètreTypeDescription
typeObligatoireinterest | behavior | interest_keyword | location | region—
queryObligatoirestringname to look up, e.g. fashion, moda, Istanbul, Turkey
languageFacultatifstringnames language for interest/behavior/interest_keyword, e.g. tr, en (default: conversation language)
objective_typeFacultatifstringfor location/region: campaign objective, default TRAFFIC; LEAD_GENERATION for WhatsApp ads
promotion_typeFacultatifstringfor location/region; default WEBSITE, or LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE with LEAD_GENERATION
placementsFacultatifarray<string>default PLACEMENT_TIKTOK
region_codesFacultatifarray<string>location: filter by country code, e.g. TR
geo_typesFacultatifarray<string>location: COUNTRY | PROVINCE | CITY | DISTRICT | DMA | ZIP_CODE
limitFacultatifinteger (1–100)—

Outils d'écriture13 outils

upload_tiktok_video

Écriture2 crédits

Upload a video to the TikTok ad account's asset library from a public URL (file/video/ad/upload, UPLOAD_BY_URL). Preview and approval first; the new video_id is returned in the action result.

ParamètreTypeDescription
video_urlObligatoirestringpublic http(s) URL of an mp4/mov/mpeg/avi file (ideally under 10 MB for URL uploads)
file_nameFacultatifstring1-100 chars, unique in the account; default: URL file name + timestamp
auto_fixFacultatifbooleanlet TikTok detect and fix low resolution / wrong aspect ratio

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

upload_tiktok_image

Écriture2 crédits

Upload an image (image ad or video cover) to the TikTok asset library from a public URL (file/image/ad/upload, UPLOAD_BY_URL). Preview and approval first; the image_id is returned in the action result.

ParamètreTypeDescription
image_urlObligatoirestringpublic http(s) URL of a JPG/PNG (max 1440x2560 total pixels)
file_nameFacultatifstring1-100 chars, unique in the account; default: URL file name + timestamp

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_tiktok_campaign

Écriture2 crédits

Create a TikTok campaign end to end (campaign + ad group, optionally the ad) as a paused draft. Writes a ledger draft and opens an approval item with a preview; sent to TikTok only after approval and only with a connected account.

ParamètreTypeDescription
nameObligatoirestring—
objective_typeObligatoireTRAFFIC | WEB_CONVERSIONS | REACH | VIDEO_VIEWS | LEAD_GENERATION | APP_PROMOTION | PRODUCT_SALES—
daily_budgetFacultatifnumberaccount currency
budget_modeFacultatifBUDGET_MODE_DAY | BUDGET_MODE_TOTAL | BUDGET_MODE_INFINITE—
goalFacultatifstring—
pixel_idFacultatifstring—
audienceFacultatifobjectcountries (ISO list), age_min, age_max, genders ([1]=male, [2]=female), tiktok_location_ids, tiktok_interest_ids
ad_groupFacultatifobjectoptional ad group overrides; defaults: automatic placement, from now, smooth pacing
adFacultatifobjectoptional ad; needs a library video_id

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_tiktok_ad_group

Écriture2 crédits

Create a TikTok ad group under a campaign with budget, bid, targeting, placements, schedule and dayparting. Preview and approval first; created paused unless operation_status=ENABLE.

ParamètreTypeDescription
campaign_idObligatoirestringTikTok campaign_id
nameObligatoirestring—
budgetObligatoirenumberdaily budget, account currency
budget_modeFacultatifBUDGET_MODE_DAY | BUDGET_MODE_TOTAL—
placement_typeFacultatifPLACEMENT_TYPE_AUTOMATIC | PLACEMENT_TYPE_NORMAL—
placementsFacultatifarray<string>PLACEMENT_TIKTOK | PLACEMENT_PANGLE | PLACEMENT_GLOBAL_APP_BUNDLE
promotion_typeFacultatifstringWEBSITE | APP_ANDROID | APP_IOS | LEAD_GENERATION
operation_statusFacultatifENABLE | DISABLE—
optimization_goalFacultatifstringCLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT
billing_eventFacultatifstringCPC | CPM | OCPM | CPV
bid_typeFacultatifstringBID_TYPE_NO_BID | BID_TYPE_CUSTOM
bid_priceFacultatifnumber—
conversion_bid_priceFacultatifnumber—
pacingFacultatifPACING_MODE_SMOOTH | PACING_MODE_FAST—
location_idsFacultatifarray<string>TikTok location ids (Turkey 298795, US 6252001, UK 2635167, DE 2921044)
age_groupsFacultatifarray<string>AGE_13_17 | AGE_18_24 | AGE_25_34 | AGE_35_44 | AGE_45_54 | AGE_55_100
genderFacultatifGENDER_UNLIMITED | GENDER_MALE | GENDER_FEMALE—
languagesFacultatifarray<string>language codes, e.g. tr, en
interest_category_idsFacultatifarray<string>—
operating_systemsFacultatifarray<string>ANDROID | IOS
audience_idsFacultatifarray<string>—
excluded_audience_idsFacultatifarray<string>—
schedule_start_timeFacultatifstringYYYY-MM-DD HH:MM:SS (UTC)
schedule_end_timeFacultatifstringYYYY-MM-DD HH:MM:SS (UTC); sets SCHEDULE_START_END
daypartingFacultatifstring336 chars of 0/1: 7 days x 48 half-hours starting Monday 00:00
pixel_idFacultatifstring—
optimization_eventFacultatifstringe.g. COMPLETE_PAYMENT, ON_WEB_CART, FORM
comment_disabledFacultatifboolean—
share_disabledFacultatifboolean—
search_result_enabledFacultatifboolean—
interest_keyword_idsFacultatifarray<string>from search_tiktok_targeting(type=interest_keyword)
actionsFacultatifarray<object>behaviour targeting: [{action_scene: VIDEO_RELATED|CREATOR_RELATED|HASHTAG_RELATED, action_period: 0|7|15, video_user_actions: [...], action_category_ids: [ids from search_tiktok_targeting(type=behavior)]}]

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_tiktok_ad

Écriture2 crédits

Create a TikTok ad in an ad group from a library video (or Spark post). Preview and approval first.

ParamètreTypeDescription
adgroup_idObligatoirestring—
ad_nameFacultatifstring—
ad_textObligatoirestring1-100 chars
video_idFacultatifstringfrom list_tiktok_videos
image_idsFacultatifarray<string>cover image ids / image ad
ad_formatFacultatifSINGLE_VIDEO | SINGLE_IMAGE | CAROUSEL—
landing_page_urlFacultatifstring—
call_to_actionFacultatifstringLEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | DOWNLOAD …
identity_idFacultatifstring—
identity_typeFacultatifstringCUSTOMIZED_USER | TT_USER | BC_AUTH_TT
display_nameFacultatifstring—
tiktok_item_idFacultatifstringSpark Ads post id
deeplinkFacultatifstring—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_tiktok_campaign_budget

Écriture2 crédits

Change the budget of one or more TikTok campaigns. Goes through preview and approval; the ledger is updated only when TikTok accepts.

ParamètreTypeDescription
campaign_idsObligatoirearray<string>TikTok campaign ids (or one Tecrube campaign id)
amountObligatoirenumberaccount currency

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_tiktok_campaign_status

Écriture2 crédits

Pause (DISABLE) or enable (ENABLE) TikTok campaigns. Preview and approval first.

ParamètreTypeDescription
campaign_idsObligatoirearray<string>—
operation_statusObligatoireENABLE | DISABLE—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_tiktok_ad_group

Écriture2 crédits

Update one or many TikTok ad groups at once: budget, bid (bid_type/bid_price), targeting (locations, ages, gender, languages, interests, audiences), schedule and dayparting, comment/share settings. Placements and budget mode cannot change after creation (TikTok rule). Preview and approval first.

ParamètreTypeDescription
adgroup_idsObligatoirearray<string>—
adgroup_nameFacultatifstring—
budgetFacultatifnumber—
optimization_goalFacultatifstringCLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT
billing_eventFacultatifstringCPC | CPM | OCPM | CPV
bid_typeFacultatifstringBID_TYPE_NO_BID | BID_TYPE_CUSTOM
bid_priceFacultatifnumber—
conversion_bid_priceFacultatifnumber—
pacingFacultatifPACING_MODE_SMOOTH | PACING_MODE_FAST—
location_idsFacultatifarray<string>TikTok location ids (Turkey 298795, US 6252001, UK 2635167, DE 2921044)
age_groupsFacultatifarray<string>AGE_13_17 | AGE_18_24 | AGE_25_34 | AGE_35_44 | AGE_45_54 | AGE_55_100
genderFacultatifGENDER_UNLIMITED | GENDER_MALE | GENDER_FEMALE—
languagesFacultatifarray<string>language codes, e.g. tr, en
interest_category_idsFacultatifarray<string>—
operating_systemsFacultatifarray<string>ANDROID | IOS
audience_idsFacultatifarray<string>—
excluded_audience_idsFacultatifarray<string>—
schedule_start_timeFacultatifstringYYYY-MM-DD HH:MM:SS (UTC)
schedule_end_timeFacultatifstringYYYY-MM-DD HH:MM:SS (UTC); sets SCHEDULE_START_END
daypartingFacultatifstring336 chars of 0/1: 7 days x 48 half-hours starting Monday 00:00
pixel_idFacultatifstring—
optimization_eventFacultatifstringe.g. COMPLETE_PAYMENT, ON_WEB_CART, FORM
comment_disabledFacultatifboolean—
share_disabledFacultatifboolean—
search_result_enabledFacultatifboolean—
interest_keyword_idsFacultatifarray<string>from search_tiktok_targeting(type=interest_keyword)
actionsFacultatifarray<object>behaviour targeting: [{action_scene: VIDEO_RELATED|CREATOR_RELATED|HASHTAG_RELATED, action_period: 0|7|15, video_user_actions: [...], action_category_ids: [ids from search_tiktok_targeting(type=behavior)]}]
changesFacultatifobjectany adgroup/update fields as a map

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_tiktok_ad_group_status

Écriture2 crédits

Pause or enable TikTok ad groups (e.g. the ones whose CPA is above target). Preview and approval first.

ParamètreTypeDescription
adgroup_idsObligatoirearray<string>—
operation_statusObligatoireENABLE | DISABLE—
reasonFacultatifstring—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_tiktok_ad_status

Écriture2 crédits

Pause or enable TikTok ads (e.g. a fatigued creative). Preview and approval first.

ParamètreTypeDescription
ad_idsObligatoirearray<string>—
operation_statusObligatoireENABLE | DISABLE—
reasonFacultatifstring—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_tiktok_custom_audience

Écriture2 crédits

Create a rule-based TikTok custom audience from pixel, app or engagement events (e.g. added to cart in the last 30 days but did not purchase). Preview and approval first; the audience needs hours to populate.

ParamètreTypeDescription
nameObligatoirestring—
audience_typeFacultatifPIXEL | APP | ENGAGEMENT | ENGAGEMENT_ORGANIC_VIDEO | BUSINESS_ACCOUNT | LEAD_GENERATION | TIKTOK_SHOP—
retention_daysFacultatifinteger (1–365)—
eventFacultatifstringpixel/app event to include, e.g. AddToCart, CompletePayment, ViewContent
exclude_eventFacultatifstringevent to exclude, e.g. CompletePayment for cart abandoners
pixel_idFacultatifstring—
event_source_idsFacultatifarray<string>pixel ids / app ids / ad group ids depending on audience_type

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_tiktok_lookalike_audience

Écriture2 crédits

Create a TikTok lookalike audience from a custom audience (TikTok sizes: NARROW ≈ closest, BALANCED, BROAD). Preview and approval first.

ParamètreTypeDescription
nameObligatoirestring—
source_audience_idObligatoirestring—
audience_sizeFacultatifNARROW | BALANCED | BROAD—
include_sourceFacultatifboolean—
location_idsFacultatifarray<string>—
placementsFacultatifarray<string>—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_tiktok_whatsapp_campaign

Écriture2 crédits

Create a TikTok ad that opens a WhatsApp chat (click-to-WhatsApp): LEAD_GENERATION campaign, ad group with optimisation location Instant Messaging App (WhatsApp) on TikTok placement, and a video ad whose cover is taken from the video automatically. chat_link builds the wa.me link from the phone number; website URLs are refused. Everything is created paused; preview and approval first.

ParamètreTypeDescription
nameObligatoirestring—
phone_numberObligatoirestringWhatsApp business number with country code, e.g. +90 532 000 00 00 (national format starting with 0 is rejected)
daily_budgetObligatoirenumberad group daily budget, account currency (TikTok minimum ≈ USD 20 equivalent)
video_idObligatoirestringlibrary video (list_tiktok_videos / upload_tiktok_video)
ad_textObligatoirestring1-100 chars
connection_methodFacultatifchat_link | nativechat_link: wa.me link built from the number (CLICK only, no extra setup); native: number connected to TikTok's message management tool (CLICK or allowlisted CONVERSATION)
prefilled_messageFacultatifstringchat_link only: text pre-filled in WhatsApp; must name the offer or service in the ad, generic greetings are rejected
optimization_goalFacultatifCLICK | CONVERSATION—
phone_region_codeFacultatifstringnative only, when the calling code is shared (e.g. US for +1)
message_event_set_idFacultatifstringnative + CONVERSATION only, when the number matches no event set
image_idsFacultatifarray<string>cover image id; omitted = the video's own cover is fetched and uploaded automatically
call_to_actionFacultatifstringdefault SEND_MESSAGE (CALL_NOW not allowed)
ad_nameFacultatifstring—
identity_idFacultatifstring—
identity_typeFacultatifstringCUSTOMIZED_USER | TT_USER | BC_AUTH_TT
display_nameFacultatifstring—
goalFacultatifstring—
audienceFacultatifobjectcountries (ISO list), age_min (18+), age_max, genders ([1]=male, [2]=female), tiktok_location_ids, tiktok_interest_ids
ad_groupFacultatifobjectoptional ad group targeting/schedule overrides; placements, promotion type and search results are fixed for messaging ads
landing_page_urlFacultatifstringNOT accepted: a messaging ad group has no website destination; give phone_number instead

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.