Aller au contenu
Tecrübetecrube.com
Outils de l'assistant · Création et campagnes

Outils TikTok Ads

Gestion des campagnes, groupes de publicités et publicités, import vidéo/image, audiences et rapports de performances.

Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont la traduction du texte vu par l'assistant, les noms d'outils et de paramètres restent inchangés.

Outils de lecture27 outils

list_tiktok_advertisers

Lecture1 crédits

Comptes publicitaires TikTok (advertisers) accessibles avec le jeton TikTok Ads connecté : id, nom, devise, fuseau horaire, statut. Lecture seule ; renvoie connected=false si aucun compte n'est lié.

Cet outil ne prend aucun paramètre.

list_tiktok_campaigns

Lecture1 crédits

Campagnes TikTok du compte publicitaire connecté : campaign_id, nom, objective_type, budget, budget_mode, operation_status (activée / désactivée) et secondary_status (état de diffusion TikTok). Utilisez les valeurs campaign_id dans les autres outils tiktok.

ParamètreTypeDescription
campaign_idsFacultatifarray<string>—
statusFacultatifSTATUS_DELIVERY_OK | STATUS_NOT_DELIVERY | STATUS_DISABLE | STATUS_DELETE | STATUS_NOT_DELETE | STATUS_ALLfiltre de statut principal, p. ex. STATUS_DELIVERY_OK, STATUS_DISABLE
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_ad_groups

Lecture1 crédits

Groupes d'annonces TikTok avec budget, enchère, objectif d'optimisation, ciblage (zones, âges, genre, langues, centres d'intérêt, audiences), placements, calendrier et plages horaires.

ParamètreTypeDescription
campaign_idsFacultatifarray<string>—
adgroup_idsFacultatifarray<string>—
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_ads

Lecture1 crédits

Annonces TikTok : ad_id, nom, groupe d'annonces, statut (operation_status, secondary_status), format, texte, video_id, page de destination, appel à l'action. Les annonces refusées ou seulement partiellement approuvées portent aussi review : l'état d'examen de TikTok, les motifs de refus et la suggestion, ainsi que les emplacements, zones et tranches d'âge dont elles sont exclues.

ParamètreTypeDescription
campaign_idsFacultatifarray<string>—
adgroup_idsFacultatifarray<string>—
ad_idsFacultatifarray<string>—
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

tiktok_performance_report

Lecture2 crédits

Performances TikTok par campagne, groupe d'annonces ou annonce sur une plage de dates : dépenses, impressions, clics, CTR, CPM, CPC, conversions, coût par conversion, taux de conversion, ROAS si disponible ; ventilation quotidienne et totaux en option. Données réelles uniquement ; connected=false sans compte.

ParamètreTypeDescription
levelFacultatifcampaign | ad_group | ad—
daysFacultatifinteger (1–365)—
start_dateFacultatifstring—
end_dateFacultatifstring—
dailyFacultatifbooleanune ligne par jour (stat_time_day)
campaign_idsFacultatifarray<string>—
adgroup_idsFacultatifarray<string>—
ad_idsFacultatifarray<string>—
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_audiences

Lecture1 crédits

Audiences personnalisées et similaires du compte publicitaire TikTok : audience_id, nom, type, taille (cover_num), validité. Utilisez audience_ids dans update_tiktok_ad_group pour les affecter.

ParamètreTypeDescription
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_videos

Lecture1 crédits

Vidéos de la bibliothèque d'assets du compte publicitaire TikTok : video_id, nom de fichier, durée, taille, URL d'aperçu et de couverture. Utilisez video_id dans create_tiktok_ad ou create_tiktok_whatsapp_campaign ; ajoutez de nouvelles vidéos depuis une URL publique avec upload_tiktok_video.

ParamètreTypeDescription
video_idsFacultatifarray<string>—
limitFacultatifinteger (1–500)newest first (default 500)
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

get_tiktok_video_cover

Lecture1 crédits

Images de couverture suggérées pour une vidéo de la bibliothèque TikTok (file/video/suggestcover) : id, url d'aperçu (valable une heure), taille. Importez l'url choisie avec upload_tiktok_image pour l'utiliser comme couverture de l'annonce (image_ids). Lecture seule.

ParamètreTypeDescription
video_idObligatoirestring—
countFacultatifinteger (1–10)—
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

search_tiktok_targeting

Lecture1 crédits

Convertit des noms de ciblage en ids TikTok : 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, villes et provinces), region (tool/region → pays ciblables pour l'objectif). Lecture seule.

ParamètreTypeDescription
typeObligatoireinterest | behavior | interest_keyword | location | region—
queryObligatoirestringnom à rechercher, p. ex. fashion, moda, Istanbul, Turkey
languageFacultatifstringlangue des noms pour interest/behavior/interest_keyword, p. ex. tr, en (par défaut : langue de la conversation)
objective_typeFacultatifstringpour location/region : objectif de campagne, TRAFFIC par défaut ; LEAD_GENERATION pour les annonces WhatsApp
promotion_typeFacultatifstringpour location/region ; WEBSITE par défaut, ou LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE avec LEAD_GENERATION
placementsFacultatifarray<string>PLACEMENT_TIKTOK par défaut
region_codesFacultatifarray<string>location : filtrer par code pays, p. ex. TR
geo_typesFacultatifarray<string>location : COUNTRY | PROVINCE | CITY | DISTRICT | DMA | ZIP_CODE
limitFacultatifinteger (1–100)—
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_identities

Lecture1 crédits

Identités publicitaires du compte TikTok (identity/get) : identity_id, identity_type, nom affiché, nom d'utilisateur et possibilité de récupérer les publications. Transmettez identity_id/identity_type à create_tiktok_ad ou list_tiktok_posts. Lecture seule.

ParamètreTypeDescription
identity_typeFacultatifCUSTOMIZED_USER | AUTH_CODE | TT_USER | BC_AUTH_TT—
identity_bc_idFacultatifstringrequis avec BC_AUTH_TT
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_pixels

Lecture1 crédits

Pixels de conversion TikTok du compte publicitaire (pixel/list) : pixel_id, pixel_code, nom, mode de configuration et événements suivis. Utilisez pixel_id pour les groupes d'annonces de conversion et pixel_code pour send_tiktok_conversion_event. Lecture seule.

ParamètreTypeDescription
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_auto_messages

Lecture1 crédits

Modèles de messages de bienvenue pour les publicités Message direct TikTok (creative/auto_message/get) : auto_message_id, titre, salutation, questions suggérées et statut d'examen. Transmettez auto_message_id à create_tiktok_ad. Lecture seule.

ParamètreTypeDescription
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_lead_forms

Lecture1 crédits

Formulaires instantanés de prospects TikTok du compte publicitaire (page/get, LEAD_GEN) : page_id, titre, statut, dates de création/mise à jour/publication et URL d'aperçu. Lecture seule.

ParamètreTypeDescription
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

get_tiktok_lead_form_fields

Lecture1 crédits

Champs de questions d'un formulaire instantané pour prospects TikTok (page/field/get) : clés, libellés et types de champs ainsi que métadonnées du formulaire, pour lire correctement les réponses collectées. Lecture seule.

ParamètreTypeDescription
page_idObligatoirestringid du formulaire instantané depuis list_tiktok_lead_forms
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

download_tiktok_leads

Lecture2 crédits

Télécharge les prospects collectés par un formulaire instantané ou une publicité à formulaire TikTok (page/lead/task + page/lead/task/download ; un ZIP est décompressé vers son CSV). Ouvre la tâche de téléchargement, l'interroge quelques secondes puis, une fois prête, renvoie un résumé respectueux de la vie privée : nombre total de lignes, noms des questions et premières lignes (limit, 20 par défaut) avec id du prospect, date de création, ids de publicité, de groupe d'annonces, de campagne et de formulaire, et réponses MASQUÉES (noms réduits aux initiales ; e-mails, téléphones et IBAN masqués). Le CSV complet non masqué est enregistré dans l'espace de fichiers privé du compte et renvoyé uniquement sous forme de download_url, un lien signé valable 15 minutes (le fichier enregistré est conservé 30 jours, puis supprimé) : donnez le lien à l'utilisateur, ne collez jamais le contenu du fichier dans la conversation ; si le fichier ne peut pas être enregistré, seul le résumé masqué est renvoyé. Si TikTok prépare encore le fichier, task_id est renvoyé : rappelez avec le même page_id/ad_id et ce task_id. region : où les publicités ont été diffusées (eu = EEE/Suisse/Royaume-Uni, us, other). Seuls les administrateurs du compte publicitaire peuvent télécharger. Données personnelles : à utiliser uniquement dans le cadre du consentement donné dans le formulaire. Lecture seule.

ParamètreTypeDescription
page_idFacultatifstringid du formulaire instantané depuis list_tiktok_lead_forms (ou indiquez ad_id)
ad_idFacultatifstringid de la publicité à formulaire ; télécharge les prospects de cette publicité au lieu d'un formulaire
task_idFacultatifstringid de tâche renvoyé par un appel précédent encore en RUNNING
regionFacultatifeu | us | otheroù les publicités étaient ciblées : eu = EEE/Suisse/Royaume-Uni, us = États-Unis, other (par défaut) = partout ailleurs
limitFacultatifinteger (1–100)lignes de l'aperçu masqué (20 par défaut) ; la liste complète n'est que dans le fichier de téléchargement
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_creative_portfolios

Lecture1 crédits

Portefeuilles de créations du compte publicitaire TikTok (creative/portfolio/list) : id du portefeuille, type (carte d'affichage, carte de téléchargement, code cadeau…), URL d'aperçu et paramètres principaux. Lecture seule.

ParamètreTypeDescription
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_gmv_max_stores

Lecture1 crédits

Boutiques TikTok Shop liées au compte publicitaire (gmv_max/store/list) avec disponibilité de GMV Max, statut, rôle, Business Center d'autorisation et régions ciblables. Lecture seule.

ParamètreTypeDescription
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_smart_plus

Lecture1 crédits

Campagnes, groupes d'annonces ou annonces Smart+ (automatisés) du compte publicitaire TikTok (smart_plus/*/get). Ils ne sont pas renvoyés par list_tiktok_campaigns / _ad_groups / _ads. Lecture seule.

ParamètreTypeDescription
levelFacultatifcampaign | adgroup | adcampaign par défaut
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_posts

Lecture1 crédits

Publications TikTok organiques d'une identité de compte TikTok associée (identity/video/get) pouvant être diffusées en Spark Ads : tiktok_item_id, texte, statut, durée, couverture et statut d'autorisation publicitaire. Lecture seule.

ParamètreTypeDescription
identity_idObligatoirestring—
identity_typeFacultatifTT_USER | BC_AUTH_TT | AUTH_CODETT_USER par défaut
identity_bc_idFacultatifstringobligatoire avec BC_AUTH_TT
limitFacultatifinteger (1–100)20 par défaut
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

tiktok_recommendations

Lecture2 crédits

Diagnostics et suggestions propres à TikTok pour les groupes d'annonces (tool/diagnosis/get) : lassitude des créations, suggestions d'enchère et de budget avec gain estimé, et problèmes de suivi des événements. Lecture seule ; à appliquer avec les outils de mise à jour.

ParamètreTypeDescription
adgroup_idsFacultatifarray<string>jusqu'à 20 ; par défaut : TikTok choisit les groupes d'annonces avec diagnostics
issue_categoriesFacultatifarray<string>CREATIVE | BID_AND_BUDGET | EVENT_TRACK
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

tiktok_report_query

Lecture2 crédits

Rapport TikTok libre (report/integrated/get) : toutes métriques et dimensions prises en charge, type de rapport, niveau de données, plage de dates ou durée de vie totale et filtres. Les lignes sont renvoyées exactement telles que TikTok les calcule. Lecture seule.

ParamètreTypeDescription
metricsObligatoirearray<string>noms de métriques TikTok, p. ex. spend, impressions, clicks, conversion, complete_payment_roas
dimensionsObligatoirearray<string>p. ex. campaign_id, adgroup_id, ad_id, stat_time_day, country_code, gender, age
report_typeFacultatifBASIC | AUDIENCE | PLAYABLE_MATERIAL | CATALOG | BC | TT_SHOP—
data_levelFacultatifstringp. ex. AUCTION_CAMPAIGN, AUCTION_ADGROUP, AUCTION_AD, AUCTION_ADVERTISER
daysFacultatifinteger (1–365)—
start_dateFacultatifstring—
end_dateFacultatifstring—
lifetimeFacultatifbooleantotaux sur toute la durée de vie au lieu d'une plage de dates
filteringFacultatifarray<object>filtres TikTok : [{field_name, filter_type, filter_value}]
limitFacultatifinteger (1–5000)—
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

list_tiktok_business_centers

Lecture1 crédits

Business Centers TikTok accessibles avec le jeton connecté (bc/get) : bc_id, nom, entreprise, statut, devise, fuseau horaire et votre rôle. Lecture seule.

Cet outil ne prend aucun paramètre.

list_tiktok_bc_advertisers

Lecture1 crédits

Comptes publicitaires d'un Business Center TikTok (bc/asset/get, ADVERTISER) : id de l'annonceur, nom, type de compte, votre rôle et statut de vérification. Lecture seule.

ParamètreTypeDescription
bc_idFacultatifstringid du Business Center (list_tiktok_business_centers) ; facultatif si le jeton n'atteint qu'un seul Business Center

list_tiktok_bc_pixels

Lecture1 crédits

Pixels détenus dans un Business Center TikTok (bc/asset/get, PIXEL), sur l'ensemble de ses comptes publicitaires. Lecture seule.

ParamètreTypeDescription
bc_idFacultatifstringid du Business Center (list_tiktok_business_centers) ; facultatif si le jeton n'atteint qu'un seul Business Center

list_tiktok_asset_groups

Lecture1 crédits

Groupes d'actifs d'un Business Center TikTok (bc/asset_group/list) : asset_group_id et nom. Lecture seule.

ParamètreTypeDescription
bc_idFacultatifstringid du Business Center (list_tiktok_business_centers) ; facultatif si le jeton n'atteint qu'un seul Business Center

tiktok_advertiser_qualification

Lecture1 crédits

Qualifications d'entreprise dans un TikTok Business Center (bc/advertiser/qualification/get) : nom de la société, statut de vérification, compte publicitaire propriétaire, nombre de comptes associés et région. Lecture seule.

ParamètreTypeDescription
bc_idFacultatifstringid du Business Center (list_tiktok_business_centers) ; facultatif lorsque le jeton n'accède qu'à un seul Business Center
advertiser_idFacultatifstringne garder que les qualifications détenues par ce compte publicitaire
verifiedFacultatifbooleanfiltrer vérifiées / non vérifiées

tiktok_change_history

Lecture2 crédits

Journal d'activité d'un TikTok Business Center (changelog/get) : quand, quel type d'activité, id de l'opérateur et texte de la modification, des plus récentes aux plus anciennes. Lecture seule.

ParamètreTypeDescription
bc_idFacultatifstringid du Business Center (list_tiktok_business_centers) ; facultatif lorsque le jeton n'accède qu'à un seul Business Center
start_dateFacultatifstringYYYY-MM-DD (UTC) ; par défaut : 7 derniers jours
end_dateFacultatifstring—
daysFacultatifinteger (1–365)—
activity_typeFacultatifstringALL (par défaut) | USER | ASSET | … tels que définis par TikTok
limitFacultatifinteger (1–500)—
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

Outils d'écriture24 outils

select_tiktok_advertiser

Écriture1 crédits

Choose which TikTok ad account (advertiser) all further TikTok reads and writes use. Per project: with a non-default project selected only that project's advertiser is saved; in the default project the connection's selection changes. Local setting; nothing is changed on TikTok. Switching is always allowed; adding another advertiser on the platform is subject to the plan's ads.accounts.max limit (error=entitlement body with next_plan and upgrade_url).

La description de cet outil n'est pas encore traduite ; le texte anglais d'origine vu par l'assistant est affiché.

ParamètreTypeDescription
advertiser_idObligatoirestring—

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

upload_tiktok_video

Écriture2 crédits

Importe une vidéo dans la bibliothèque d'assets du compte publicitaire TikTok depuis une URL publique (file/video/ad/upload, UPLOAD_BY_URL). Aperçu et validation d'abord ; le nouveau video_id est renvoyé dans le résultat de l'action.

ParamètreTypeDescription
video_urlObligatoirestringURL http(s) publique d'un fichier mp4/mov/mpeg/avi (idéalement moins de 10 Mo pour un import par URL)
file_nameFacultatifstring1-100 caractères, unique dans le compte ; par défaut : nom de fichier de l'URL + horodatage
auto_fixFacultatifbooleanlaisser TikTok détecter et corriger une faible résolution / un mauvais rapport d'aspect
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Importe une image (annonce image ou couverture vidéo) dans la bibliothèque d'assets TikTok depuis une URL publique (file/image/ad/upload, UPLOAD_BY_URL). Aperçu et validation d'abord ; l'image_id est renvoyé dans le résultat de l'action.

ParamètreTypeDescription
image_urlObligatoirestringURL http(s) publique d'un JPG/PNG (max. 1440x2560 pixels au total)
file_nameFacultatifstring1-100 caractères, unique dans le compte ; par défaut : nom de fichier de l'URL + horodatage
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Crée une campagne TikTok de bout en bout (campagne + groupe d'annonces, éventuellement l'annonce) en brouillon en pause. Écrit un brouillon dans le registre et ouvre un élément de validation avec aperçu ; envoyé à TikTok uniquement après validation et uniquement avec un compte connecté.

ParamètreTypeDescription
nameObligatoirestring—
objective_typeObligatoireTRAFFIC | WEB_CONVERSIONS | REACH | VIDEO_VIEWS | LEAD_GENERATION | APP_PROMOTION | PRODUCT_SALES—
daily_budgetFacultatifnumberdevise du compte
budget_modeFacultatifBUDGET_MODE_DAY | BUDGET_MODE_TOTAL | BUDGET_MODE_INFINITE—
goalFacultatifstring—
pixel_idFacultatifstring—
sales_destinationFacultatifWEBSITE | APP | WEB_AND_APP | TIKTOK_SHOPPRODUCT_SALES campaigns only
audienceFacultatifobjectcountries (liste ISO), age_min, age_max, genders ([1]=homme, [2]=femme), tiktok_location_ids, tiktok_interest_ids
ad_groupFacultatifobjectréglages facultatifs du groupe d'annonces ; par défaut : placement automatique, dès maintenant, diffusion régulière
adFacultatifobjectannonce facultative ; nécessite un video_id de la bibliothèque
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Crée un groupe d'annonces TikTok dans une campagne avec budget, enchère, ciblage, placements, calendrier et plages horaires. Aperçu et validation d'abord ; créé en pause sauf si operation_status=ENABLE.

ParamètreTypeDescription
campaign_idObligatoirestringcampaign_id TikTok
nameObligatoirestring—
budgetObligatoirenumberbudget quotidien, devise du compte
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
app_idFacultatifstringapp promotion only
identity_idFacultatifstring—
identity_typeFacultatifstringCUSTOMIZED_USER | TT_USER | BC_AUTH_TT
secondary_optimization_eventFacultatifstring—
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>ids de zones TikTok (Turquie 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>codes de langue, p. ex. 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) ; définit SCHEDULE_START_END
daypartingFacultatifstring336 caractères 0/1 : 7 jours x 48 demi-heures à partir du lundi 00:00
pixel_idFacultatifstring—
optimization_eventFacultatifstringp. ex. COMPLETE_PAYMENT, ON_WEB_CART, FORM
comment_disabledFacultatifboolean—
share_disabledFacultatifboolean—
search_result_enabledFacultatifboolean—
interest_keyword_idsFacultatifarray<string>issus de search_tiktok_targeting(type=interest_keyword)
actionsFacultatifarray<object>ciblage comportemental : [{action_scene: VIDEO_RELATED|CREATOR_RELATED|HASHTAG_RELATED, action_period: 0|7|15, video_user_actions: [...], action_category_ids: [ids issus de search_tiktok_targeting(type=behavior)]}]
deep_bid_typeFacultatifstringe.g. DEFAULT, MIN, PACING, VO_MIN_ROAS
roas_bidFacultatifnumber—
zipcode_idsFacultatifarray<string>from search_tiktok_targeting(type=location)
device_model_idsFacultatifarray<string>—
device_price_rangesFacultatifarray<number>price range bounds, e.g. [0, 250]
network_typesFacultatifarray<string>WIFI | 2G | 3G | 4G | 5G
carrier_idsFacultatifarray<string>—
schedule_typeFacultatifSCHEDULE_FROM_NOW | SCHEDULE_START_END—
saved_audience_idFacultatifstring—
frequencyFacultatifintegermax impressions per user within frequency_schedule days
frequency_scheduleFacultatifintegerfrequency cap window in days
brand_safety_typeFacultatifstringNO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY
blocked_pangle_app_idsFacultatifarray<string>—
targeting_expansionFacultatifobjecte.g. {expansion_enabled: true}
household_incomeFacultatifarray<string>e.g. TOP5, TOP10, TOP10_25, TOP25_50
spending_powerFacultatifALL | HIGH—
exclude_age_under_eighteenFacultatifboolean—
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Crée une annonce TikTok dans un groupe d'annonces à partir d'une vidéo de la bibliothèque (ou d'une publication Spark). Aperçu et validation d'abord.

ParamètreTypeDescription
adgroup_idObligatoirestring—
ad_nameFacultatifstring—
ad_textObligatoirestring1-100 caractères
video_idFacultatifstringissu de list_tiktok_videos
image_idsFacultatifarray<string>ids d'image de couverture / annonce image
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_idFacultatifstringid de publication Spark Ads
deeplinkFacultatifstring—
auto_message_idFacultatifstringwelcome message for Direct Message ads (list_tiktok_auto_messages / create_tiktok_auto_message)
identity_bc_idFacultatifstringBusiness Center id when identity_type is BC_AUTH_TT
operation_statusFacultatifENABLE | DISABLEDISABLE creates the ad paused; default ENABLE
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Modifie le budget d'une ou plusieurs campagnes TikTok. Passe par l'aperçu et la validation ; le registre n'est mis à jour que lorsque TikTok accepte.

ParamètreTypeDescription
campaign_idsObligatoirearray<string>ids de campagnes TikTok (ou un id de campagne Tecrube)
amountObligatoirenumberdevise du compte
campaign_idFacultatifstringAlias of campaign_ids (single id)
currencyFacultatifstringoptional ISO check; must equal the ad account currency
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

ÉcritureIrréversible2 crédits

Met en pause (DISABLE) ou active (ENABLE) des campagnes TikTok. Aperçu et validation d'abord.

ParamètreTypeDescription
campaign_idsObligatoirearray<string>—
operation_statusObligatoireENABLE | DISABLE | DELETEDELETE is permanent; only when the user explicitly asked
campaign_idFacultatifstringAlias of campaign_ids (single id)
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Met à jour un ou plusieurs groupes d'annonces TikTok à la fois : budget, enchère (bid_type/bid_price), ciblage (zones, âges, genre, langues, centres d'intérêt, audiences), calendrier et plages horaires, paramètres de commentaires/partage. Les placements et le mode de budget ne peuvent pas changer après la création (règle TikTok). Aperçu et validation d'abord.

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>ids de zones TikTok (Turquie 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>codes de langue, p. ex. 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) ; définit SCHEDULE_START_END
daypartingFacultatifstring336 caractères 0/1 : 7 jours x 48 demi-heures à partir du lundi 00:00
pixel_idFacultatifstringFixed at creation (defines the ad group's optimisation); rejected with an explanation
optimization_eventFacultatifstringp. ex. COMPLETE_PAYMENT, ON_WEB_CART, FORM
comment_disabledFacultatifboolean—
share_disabledFacultatifboolean—
search_result_enabledFacultatifboolean—
interest_keyword_idsFacultatifarray<string>issus de search_tiktok_targeting(type=interest_keyword)
actionsFacultatifarray<object>ciblage comportemental : [{action_scene: VIDEO_RELATED|CREATOR_RELATED|HASHTAG_RELATED, action_period: 0|7|15, video_user_actions: [...], action_category_ids: [ids issus de search_tiktok_targeting(type=behavior)]}]
deep_bid_typeFacultatifstringe.g. DEFAULT, MIN, PACING, VO_MIN_ROAS
roas_bidFacultatifnumber—
zipcode_idsFacultatifarray<string>from search_tiktok_targeting(type=location)
device_model_idsFacultatifarray<string>—
device_price_rangesFacultatifarray<number>price range bounds, e.g. [0, 250]
network_typesFacultatifarray<string>WIFI | 2G | 3G | 4G | 5G
carrier_idsFacultatifarray<string>—
schedule_typeFacultatifSCHEDULE_FROM_NOW | SCHEDULE_START_END—
saved_audience_idFacultatifstring—
frequencyFacultatifintegermax impressions per user within frequency_schedule days
frequency_scheduleFacultatifintegerfrequency cap window in days
brand_safety_typeFacultatifstringNO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY
blocked_pangle_app_idsFacultatifarray<string>—
targeting_expansionFacultatifobjecte.g. {expansion_enabled: true}
household_incomeFacultatifarray<string>e.g. TOP5, TOP10, TOP10_25, TOP25_50
spending_powerFacultatifALL | HIGH—
exclude_age_under_eighteenFacultatifboolean—
changesFacultatifobjectn'importe quels champs adgroup/update sous forme de dictionnaire
adgroup_idFacultatifstringAlias of adgroup_ids (single id)
placementsFacultatifarray<string>Not changeable after creation (TikTok rule); rejected with an explanation
placement_typeFacultatifstringNot changeable after creation (TikTok rule); rejected with an explanation
budget_modeFacultatifstringNot changeable after creation (TikTok rule); rejected with an explanation
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

ÉcritureIrréversible2 crédits

Met en pause ou active des groupes d'annonces TikTok (p. ex. ceux dont le CPA dépasse la cible). Aperçu et validation d'abord.

ParamètreTypeDescription
adgroup_idsObligatoirearray<string>—
operation_statusObligatoireENABLE | DISABLE | DELETEDELETE is permanent; only when the user explicitly asked
reasonFacultatifstring—
adgroup_idFacultatifstringAlias of adgroup_ids (single id)
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

ÉcritureIrréversible2 crédits

Met en pause ou active des annonces TikTok (p. ex. une création usée). Aperçu et validation d'abord.

ParamètreTypeDescription
ad_idsObligatoirearray<string>—
operation_statusObligatoireENABLE | DISABLE | DELETEDELETE is permanent; only when the user explicitly asked
reasonFacultatifstring—
ad_idFacultatifstringAlias of ad_ids (single id)
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Crée une audience personnalisée TikTok basée sur des règles à partir d'événements pixel, application ou engagement (p. ex. ajout au panier dans les 30 derniers jours sans achat). Aperçu et validation d'abord ; l'audience met des heures à se remplir.

ParamètreTypeDescription
nameObligatoirestring—
audience_typeFacultatifPIXEL | APP | ENGAGEMENT | ENGAGEMENT_ORGANIC_VIDEO | BUSINESS_ACCOUNT | LEAD_GENERATION | TIKTOK_SHOP—
retention_daysFacultatifinteger (1–365)—
eventFacultatifstringévénement pixel/application à inclure, p. ex. AddToCart, CompletePayment, ViewContent
exclude_eventFacultatifstringévénement à exclure, p. ex. CompletePayment pour les abandons de panier
pixel_idFacultatifstring—
event_source_idsFacultatifarray<string>ids de pixels / ids d'applications / ids de groupes d'annonces selon audience_type
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

delete_tiktok_audience

ÉcritureIrréversible2 crédits

Supprime définitivement des audiences personnalisées ou similaires TikTok. Appliqué à la demande de l'utilisateur, non annulable.

ParamètreTypeDescription
audience_idsObligatoirearray<string>ids from list_tiktok_audiences
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Crée une audience similaire TikTok à partir d'une audience personnalisée (tailles TikTok : NARROW ≈ la plus proche, BALANCED, BROAD). Aperçu et validation d'abord.

ParamètreTypeDescription
nameObligatoirestring—
source_audience_idObligatoirestring—
audience_sizeFacultatifNARROW | BALANCED | BROAD—
include_sourceFacultatifboolean—
location_idsFacultatifarray<string>—
placementsFacultatifarray<string>—
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Crée une annonce TikTok qui ouvre une conversation WhatsApp (click-to-WhatsApp) : campagne LEAD_GENERATION, groupe d'annonces avec emplacement d'optimisation Application de messagerie instantanée (WhatsApp) sur le placement TikTok, et une annonce vidéo dont la couverture est prise automatiquement dans la vidéo. chat_link construit le lien wa.me à partir du numéro de téléphone ; les URL de sites web sont refusées. Tout est créé en pause ; aperçu et validation d'abord.

ParamètreTypeDescription
nameObligatoirestring—
phone_numberObligatoirestringnuméro WhatsApp Business avec indicatif pays, p. ex. +90 532 000 00 00 (le format national commençant par 0 est refusé)
daily_budgetObligatoirenumberbudget quotidien du groupe d'annonces, devise du compte (minimum TikTok ≈ équivalent de 20 USD)
video_idObligatoirestringvidéo de la bibliothèque (list_tiktok_videos / upload_tiktok_video)
ad_textObligatoirestring1-100 caractères
connection_methodFacultatifchat_link | nativechat_link : lien wa.me construit à partir du numéro (CLICK uniquement, aucune configuration supplémentaire) ; native : numéro connecté à l'outil de gestion des messages TikTok (CLICK ou CONVERSATION sur liste autorisée)
prefilled_messageFacultatifstringchat_link uniquement : texte prérempli dans WhatsApp ; doit nommer l'offre ou le service de l'annonce, les salutations génériques sont refusées
optimization_goalFacultatifCLICK | CONVERSATION—
phone_region_codeFacultatifstringnative uniquement, lorsque l'indicatif est partagé (p. ex. US pour +1)
message_event_set_idFacultatifstringnative + CONVERSATION uniquement, lorsque le numéro ne correspond à aucun ensemble d'événements
image_idsFacultatifarray<string>id d'image de couverture ; omis = la couverture de la vidéo est récupérée et importée automatiquement
call_to_actionFacultatifstringSEND_MESSAGE par défaut (CALL_NOW non autorisé)
ad_nameFacultatifstring—
identity_idFacultatifstring—
identity_typeFacultatifstringCUSTOMIZED_USER | TT_USER | BC_AUTH_TT
display_nameFacultatifstring—
goalFacultatifstring—
audienceFacultatifobjectcountries (liste ISO), age_min (18+), age_max, genders ([1]=homme, [2]=femme), tiktok_location_ids, tiktok_interest_ids
ad_groupFacultatifobjectréglages facultatifs de ciblage/calendrier du groupe d'annonces ; les placements, le type de promotion et les résultats de recherche sont fixes pour les annonces de messagerie
landing_page_urlFacultatifstringNON accepté : un groupe d'annonces de messagerie n'a pas de destination web ; fournissez phone_number à la place
website_urlFacultatifstringNOT accepted (same rule as landing_page_url); rejected with an explanation
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Écriture5 crédits

Renomme une campagne TikTok (campaign/update) ; le nom dans le registre suit. Aperçu et approbation d'abord. Le budget et le statut ont leurs propres outils.

ParamètreTypeDescription
campaign_idObligatoirestringcampaign_id TikTok ou id de campagne Tecrübe
nameObligatoirestring—
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

Écriture5 crédits

Modifie sur place le texte d'une publicité TikTok (ad/update) : nom, texte, page de destination, incitation à l'action ou nom affiché. La publicité actuelle est lue d'abord et tous les autres champs sont conservés. Aperçu et approbation d'abord.

ParamètreTypeDescription
ad_idObligatoirestring—
adgroup_idFacultatifstringfacultatif ; lu depuis la publicité s'il est omis
ad_nameFacultatifstring—
ad_textFacultatifstring1-100 caractères
landing_page_urlFacultatifstring—
call_to_actionFacultatifstring—
display_nameFacultatifstring—
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

create_tiktok_auto_message

Écriture2 crédits

Crée un message de bienvenue pour les publicités Message direct TikTok (creative/auto_message/create) : une salutation plus 1 à 3 questions cliquables avec réponses automatiques. Renvoie auto_message_id après validation.

ParamètreTypeDescription
titleObligatoirestringnom du modèle
contentObligatoirestringsalutation
suggested_questionsObligatoirearray<object>—
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

create_tiktok_identity

Écriture2 crédits

Crée une identité publicitaire TikTok personnalisée (identity/create) : le nom affiché et l'avatar visibles sur les publicités non Spark. Aperçu et validation d'abord ; renvoie identity_id.

ParamètreTypeDescription
display_nameObligatoirestring—
image_uriFacultatifstringimage_id d'un avatar carré depuis upload_tiktok_image
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

create_tiktok_pixel

Écriture2 crédits

Crée un pixel de conversion TikTok (pixel/create). Aperçu et validation d'abord ; renvoie pixel_id et pixel_code à installer sur le site web.

ParamètreTypeDescription
nameObligatoirestring—
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

create_tiktok_customer_file_audience

Écriture6 crédits

Crée une audience personnalisée TikTok à partir d'une liste de clients (dmp/custom_audience/file/upload + create). Les valeurs sont normalisées et hachées en SHA-256 dans Tecrübe avant tout stockage ou envoi ; l'aperçu n'affiche que des nombres. Validation d'abord.

ParamètreTypeDescription
nameObligatoirestring—
identifiersObligatoirearray<string>e-mails, téléphones avec +indicatif pays ou id d'appareil ; les valeurs déjà hachées en SHA-256 sont aussi acceptées
id_typeFacultatifEMAIL | PHONE | IDFA | AAIDpar défaut EMAIL
retention_daysFacultatifinteger (1–365)—
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

share_tiktok_audience

Écriture4 crédits

Partage des audiences personnalisées TikTok avec d'autres comptes publicitaires du même Business Center, ou arrête le partage (dmp/custom_audience/share, /share/cancel). Aperçu et approbation d'abord.

ParamètreTypeDescription
audience_idsObligatoirearray<string>1-10 id d'audiences personnalisées
shared_advertiser_idsFacultatifarray<string>1-10 comptes publicitaires du même Business Center (facultatif pour l'arrêt du partage : tous)
actionFacultatifshare | unshare—
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

manage_tiktok_search_negative_keywords

Écriture4 crédits

Mots-clés négatifs des annonces de recherche TikTok d'une campagne ou d'un groupe d'annonces (search_ad/negative_keyword/*) : list lit directement ; add et delete passent par l'aperçu et l'approbation.

ParamètreTypeDescription
object_typeObligatoireCAMPAIGN | ADGROUP—
object_idObligatoirestring—
operationFacultatiflist | add | deletelist par défaut
keywordsFacultatifarray<string>pour add ; 80 caractères max. chacun
keyword_idsFacultatifarray<string>pour delete (issus de operation=list)
match_typeFacultatifPRECISE_WORD | PHRASE_WORD | BROAD_WORDpour add ; BROAD_WORD par défaut
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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

send_tiktok_conversion_event

Écriture1 crédits

Envoie à TikTok un événement de conversion web côté serveur (Events API 2.0, event/track). L'e-mail, le téléphone et l'id externe sont hachés en SHA-256 avant stockage ou envoi. Aperçu et approbation d'abord.

ParamètreTypeDescription
pixel_codeObligatoirestringissu de list_tiktok_pixels
event_nameObligatoirestringévénement standard, p. ex. CompletePayment, SubmitForm, Contact, AddToCart
emailFacultatifstring—
phoneFacultatifstringavec +indicatif du pays
external_idFacultatifstring—
ttclidFacultatifstringid de clic TikTok issu de l'URL de destination
valueFacultatifnumber—
currencyFacultatifstringISO 4217, obligatoire avec value
event_idFacultatifstringclé de déduplication partagée avec le pixel du navigateur
test_event_codeFacultatifstringfrom Events Manager › Test Events; the event is only shown there
urlFacultatifstringpage où l'événement s'est produit
advertiser_idFacultatifstringoptional: run in this TikTok ad account (advertiser id from list_accounts) for this call only; the saved account selection does not change

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