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éditsComptes 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éditsCampagnes 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ètre | Type | Description |
|---|---|---|
campaign_idsFacultatif | array<string> | — |
statusFacultatif | STATUS_DELIVERY_OK | STATUS_NOT_DELIVERY | STATUS_DISABLE | STATUS_DELETE | STATUS_NOT_DELETE | STATUS_ALL | filtre de statut principal, p. ex. STATUS_DELIVERY_OK, STATUS_DISABLE |
advertiser_idFacultatif | string | optional: 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éditsGroupes 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ètre | Type | Description |
|---|---|---|
campaign_idsFacultatif | array<string> | — |
adgroup_idsFacultatif | array<string> | — |
advertiser_idFacultatif | string | optional: 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éditsAnnonces 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ètre | Type | Description |
|---|---|---|
campaign_idsFacultatif | array<string> | — |
adgroup_idsFacultatif | array<string> | — |
ad_idsFacultatif | array<string> | — |
advertiser_idFacultatif | string | optional: 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éditsPerformances 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ètre | Type | Description |
|---|---|---|
levelFacultatif | campaign | ad_group | ad | — |
daysFacultatif | integer (1–365) | — |
start_dateFacultatif | string | — |
end_dateFacultatif | string | — |
dailyFacultatif | boolean | une ligne par jour (stat_time_day) |
campaign_idsFacultatif | array<string> | — |
adgroup_idsFacultatif | array<string> | — |
ad_idsFacultatif | array<string> | — |
advertiser_idFacultatif | string | optional: 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éditsAudiences 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ètre | Type | Description |
|---|---|---|
advertiser_idFacultatif | string | optional: 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éditsVidé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ètre | Type | Description |
|---|---|---|
video_idsFacultatif | array<string> | — |
limitFacultatif | integer (1–500) | newest first (default 500) |
advertiser_idFacultatif | string | optional: 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éditsImages 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ètre | Type | Description |
|---|---|---|
video_idObligatoire | string | — |
countFacultatif | integer (1–10) | — |
advertiser_idFacultatif | string | optional: 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éditsConvertit 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ètre | Type | Description |
|---|---|---|
typeObligatoire | interest | behavior | interest_keyword | location | region | — |
queryObligatoire | string | nom à rechercher, p. ex. fashion, moda, Istanbul, Turkey |
languageFacultatif | string | langue des noms pour interest/behavior/interest_keyword, p. ex. tr, en (par défaut : langue de la conversation) |
objective_typeFacultatif | string | pour location/region : objectif de campagne, TRAFFIC par défaut ; LEAD_GENERATION pour les annonces WhatsApp |
promotion_typeFacultatif | string | pour location/region ; WEBSITE par défaut, ou LEAD_GEN_CLICK_TO_SOCIAL_MEDIA_APP_MESSAGE avec LEAD_GENERATION |
placementsFacultatif | array<string> | PLACEMENT_TIKTOK par défaut |
region_codesFacultatif | array<string> | location : filtrer par code pays, p. ex. TR |
geo_typesFacultatif | array<string> | location : COUNTRY | PROVINCE | CITY | DISTRICT | DMA | ZIP_CODE |
limitFacultatif | integer (1–100) | — |
advertiser_idFacultatif | string | optional: 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éditsIdentité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ètre | Type | Description |
|---|---|---|
identity_typeFacultatif | CUSTOMIZED_USER | AUTH_CODE | TT_USER | BC_AUTH_TT | — |
identity_bc_idFacultatif | string | requis avec BC_AUTH_TT |
advertiser_idFacultatif | string | optional: 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éditsPixels 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ètre | Type | Description |
|---|---|---|
advertiser_idFacultatif | string | optional: 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éditsModè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ètre | Type | Description |
|---|---|---|
advertiser_idFacultatif | string | optional: 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éditsFormulaires 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ètre | Type | Description |
|---|---|---|
advertiser_idFacultatif | string | optional: 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éditsChamps 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ètre | Type | Description |
|---|---|---|
page_idObligatoire | string | id du formulaire instantané depuis list_tiktok_lead_forms |
advertiser_idFacultatif | string | optional: 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éditsTé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ètre | Type | Description |
|---|---|---|
page_idFacultatif | string | id du formulaire instantané depuis list_tiktok_lead_forms (ou indiquez ad_id) |
ad_idFacultatif | string | id de la publicité à formulaire ; télécharge les prospects de cette publicité au lieu d'un formulaire |
task_idFacultatif | string | id de tâche renvoyé par un appel précédent encore en RUNNING |
regionFacultatif | eu | us | other | où les publicités étaient ciblées : eu = EEE/Suisse/Royaume-Uni, us = États-Unis, other (par défaut) = partout ailleurs |
limitFacultatif | integer (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_idFacultatif | string | optional: 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éditsPortefeuilles 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ètre | Type | Description |
|---|---|---|
advertiser_idFacultatif | string | optional: 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éditsBoutiques 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ètre | Type | Description |
|---|---|---|
advertiser_idFacultatif | string | optional: 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éditsCampagnes, 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ètre | Type | Description |
|---|---|---|
levelFacultatif | campaign | adgroup | ad | campaign par défaut |
advertiser_idFacultatif | string | optional: 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éditsPublications 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ètre | Type | Description |
|---|---|---|
identity_idObligatoire | string | — |
identity_typeFacultatif | TT_USER | BC_AUTH_TT | AUTH_CODE | TT_USER par défaut |
identity_bc_idFacultatif | string | obligatoire avec BC_AUTH_TT |
limitFacultatif | integer (1–100) | 20 par défaut |
advertiser_idFacultatif | string | optional: 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éditsDiagnostics 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ètre | Type | Description |
|---|---|---|
adgroup_idsFacultatif | array<string> | jusqu'à 20 ; par défaut : TikTok choisit les groupes d'annonces avec diagnostics |
issue_categoriesFacultatif | array<string> | CREATIVE | BID_AND_BUDGET | EVENT_TRACK |
advertiser_idFacultatif | string | optional: 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éditsRapport 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ètre | Type | Description |
|---|---|---|
metricsObligatoire | array<string> | noms de métriques TikTok, p. ex. spend, impressions, clicks, conversion, complete_payment_roas |
dimensionsObligatoire | array<string> | p. ex. campaign_id, adgroup_id, ad_id, stat_time_day, country_code, gender, age |
report_typeFacultatif | BASIC | AUDIENCE | PLAYABLE_MATERIAL | CATALOG | BC | TT_SHOP | — |
data_levelFacultatif | string | p. ex. AUCTION_CAMPAIGN, AUCTION_ADGROUP, AUCTION_AD, AUCTION_ADVERTISER |
daysFacultatif | integer (1–365) | — |
start_dateFacultatif | string | — |
end_dateFacultatif | string | — |
lifetimeFacultatif | boolean | totaux sur toute la durée de vie au lieu d'une plage de dates |
filteringFacultatif | array<object> | filtres TikTok : [{field_name, filter_type, filter_value}] |
limitFacultatif | integer (1–5000) | — |
advertiser_idFacultatif | string | optional: 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éditsBusiness 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éditsComptes 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ètre | Type | Description |
|---|---|---|
bc_idFacultatif | string | id du Business Center (list_tiktok_business_centers) ; facultatif si le jeton n'atteint qu'un seul Business Center |
list_tiktok_bc_pixels
Lecture1 créditsPixels détenus dans un Business Center TikTok (bc/asset/get, PIXEL), sur l'ensemble de ses comptes publicitaires. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
bc_idFacultatif | string | id du Business Center (list_tiktok_business_centers) ; facultatif si le jeton n'atteint qu'un seul Business Center |
list_tiktok_asset_groups
Lecture1 créditsGroupes d'actifs d'un Business Center TikTok (bc/asset_group/list) : asset_group_id et nom. Lecture seule.
| Paramètre | Type | Description |
|---|---|---|
bc_idFacultatif | string | id du Business Center (list_tiktok_business_centers) ; facultatif si le jeton n'atteint qu'un seul Business Center |
tiktok_advertiser_qualification
Lecture1 créditsQualifications 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ètre | Type | Description |
|---|---|---|
bc_idFacultatif | string | id du Business Center (list_tiktok_business_centers) ; facultatif lorsque le jeton n'accède qu'à un seul Business Center |
advertiser_idFacultatif | string | ne garder que les qualifications détenues par ce compte publicitaire |
verifiedFacultatif | boolean | filtrer vérifiées / non vérifiées |
tiktok_change_history
Lecture2 créditsJournal 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ètre | Type | Description |
|---|---|---|
bc_idFacultatif | string | id du Business Center (list_tiktok_business_centers) ; facultatif lorsque le jeton n'accède qu'à un seul Business Center |
start_dateFacultatif | string | YYYY-MM-DD (UTC) ; par défaut : 7 derniers jours |
end_dateFacultatif | string | — |
daysFacultatif | integer (1–365) | — |
activity_typeFacultatif | string | ALL (par défaut) | USER | ASSET | … tels que définis par TikTok |
limitFacultatif | integer (1–500) | — |
advertiser_idFacultatif | string | optional: 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éditsChoose 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ètre | Type | Description |
|---|---|---|
advertiser_idObligatoire | string | — |
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éditsImporte 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ètre | Type | Description |
|---|---|---|
video_urlObligatoire | string | URL http(s) publique d'un fichier mp4/mov/mpeg/avi (idéalement moins de 10 Mo pour un import par URL) |
file_nameFacultatif | string | 1-100 caractères, unique dans le compte ; par défaut : nom de fichier de l'URL + horodatage |
auto_fixFacultatif | boolean | laisser TikTok détecter et corriger une faible résolution / un mauvais rapport d'aspect |
advertiser_idFacultatif | string | optional: 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éditsImporte 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ètre | Type | Description |
|---|---|---|
image_urlObligatoire | string | URL http(s) publique d'un JPG/PNG (max. 1440x2560 pixels au total) |
file_nameFacultatif | string | 1-100 caractères, unique dans le compte ; par défaut : nom de fichier de l'URL + horodatage |
advertiser_idFacultatif | string | optional: 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éditsCré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ètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
objective_typeObligatoire | TRAFFIC | WEB_CONVERSIONS | REACH | VIDEO_VIEWS | LEAD_GENERATION | APP_PROMOTION | PRODUCT_SALES | — |
daily_budgetFacultatif | number | devise du compte |
budget_modeFacultatif | BUDGET_MODE_DAY | BUDGET_MODE_TOTAL | BUDGET_MODE_INFINITE | — |
goalFacultatif | string | — |
pixel_idFacultatif | string | — |
sales_destinationFacultatif | WEBSITE | APP | WEB_AND_APP | TIKTOK_SHOP | PRODUCT_SALES campaigns only |
audienceFacultatif | object | countries (liste ISO), age_min, age_max, genders ([1]=homme, [2]=femme), tiktok_location_ids, tiktok_interest_ids |
ad_groupFacultatif | object | réglages facultatifs du groupe d'annonces ; par défaut : placement automatique, dès maintenant, diffusion régulière |
adFacultatif | object | annonce facultative ; nécessite un video_id de la bibliothèque |
advertiser_idFacultatif | string | optional: 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éditsCré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ètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | campaign_id TikTok |
nameObligatoire | string | — |
budgetObligatoire | number | budget quotidien, devise du compte |
budget_modeFacultatif | BUDGET_MODE_DAY | BUDGET_MODE_TOTAL | — |
placement_typeFacultatif | PLACEMENT_TYPE_AUTOMATIC | PLACEMENT_TYPE_NORMAL | — |
placementsFacultatif | array<string> | PLACEMENT_TIKTOK | PLACEMENT_PANGLE | PLACEMENT_GLOBAL_APP_BUNDLE |
promotion_typeFacultatif | string | WEBSITE | APP_ANDROID | APP_IOS | LEAD_GENERATION |
app_idFacultatif | string | app promotion only |
identity_idFacultatif | string | — |
identity_typeFacultatif | string | CUSTOMIZED_USER | TT_USER | BC_AUTH_TT |
secondary_optimization_eventFacultatif | string | — |
operation_statusFacultatif | ENABLE | DISABLE | — |
optimization_goalFacultatif | string | CLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT |
billing_eventFacultatif | string | CPC | CPM | OCPM | CPV |
bid_typeFacultatif | string | BID_TYPE_NO_BID | BID_TYPE_CUSTOM |
bid_priceFacultatif | number | — |
conversion_bid_priceFacultatif | number | — |
pacingFacultatif | PACING_MODE_SMOOTH | PACING_MODE_FAST | — |
location_idsFacultatif | array<string> | ids de zones TikTok (Turquie 298795, US 6252001, UK 2635167, DE 2921044) |
age_groupsFacultatif | array<string> | AGE_13_17 | AGE_18_24 | AGE_25_34 | AGE_35_44 | AGE_45_54 | AGE_55_100 |
genderFacultatif | GENDER_UNLIMITED | GENDER_MALE | GENDER_FEMALE | — |
languagesFacultatif | array<string> | codes de langue, p. ex. tr, en |
interest_category_idsFacultatif | array<string> | — |
operating_systemsFacultatif | array<string> | ANDROID | IOS |
audience_idsFacultatif | array<string> | — |
excluded_audience_idsFacultatif | array<string> | — |
schedule_start_timeFacultatif | string | YYYY-MM-DD HH:MM:SS (UTC) |
schedule_end_timeFacultatif | string | YYYY-MM-DD HH:MM:SS (UTC) ; définit SCHEDULE_START_END |
daypartingFacultatif | string | 336 caractères 0/1 : 7 jours x 48 demi-heures à partir du lundi 00:00 |
pixel_idFacultatif | string | — |
optimization_eventFacultatif | string | p. ex. COMPLETE_PAYMENT, ON_WEB_CART, FORM |
comment_disabledFacultatif | boolean | — |
share_disabledFacultatif | boolean | — |
search_result_enabledFacultatif | boolean | — |
interest_keyword_idsFacultatif | array<string> | issus de search_tiktok_targeting(type=interest_keyword) |
actionsFacultatif | array<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_typeFacultatif | string | e.g. DEFAULT, MIN, PACING, VO_MIN_ROAS |
roas_bidFacultatif | number | — |
zipcode_idsFacultatif | array<string> | from search_tiktok_targeting(type=location) |
device_model_idsFacultatif | array<string> | — |
device_price_rangesFacultatif | array<number> | price range bounds, e.g. [0, 250] |
network_typesFacultatif | array<string> | WIFI | 2G | 3G | 4G | 5G |
carrier_idsFacultatif | array<string> | — |
schedule_typeFacultatif | SCHEDULE_FROM_NOW | SCHEDULE_START_END | — |
saved_audience_idFacultatif | string | — |
frequencyFacultatif | integer | max impressions per user within frequency_schedule days |
frequency_scheduleFacultatif | integer | frequency cap window in days |
brand_safety_typeFacultatif | string | NO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY |
blocked_pangle_app_idsFacultatif | array<string> | — |
targeting_expansionFacultatif | object | e.g. {expansion_enabled: true} |
household_incomeFacultatif | array<string> | e.g. TOP5, TOP10, TOP10_25, TOP25_50 |
spending_powerFacultatif | ALL | HIGH | — |
exclude_age_under_eighteenFacultatif | boolean | — |
advertiser_idFacultatif | string | optional: 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éditsCré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ètre | Type | Description |
|---|---|---|
adgroup_idObligatoire | string | — |
ad_nameFacultatif | string | — |
ad_textObligatoire | string | 1-100 caractères |
video_idFacultatif | string | issu de list_tiktok_videos |
image_idsFacultatif | array<string> | ids d'image de couverture / annonce image |
ad_formatFacultatif | SINGLE_VIDEO | SINGLE_IMAGE | CAROUSEL | — |
landing_page_urlFacultatif | string | — |
call_to_actionFacultatif | string | LEARN_MORE | SHOP_NOW | SIGN_UP | CONTACT_US | DOWNLOAD … |
identity_idFacultatif | string | — |
identity_typeFacultatif | string | CUSTOMIZED_USER | TT_USER | BC_AUTH_TT |
display_nameFacultatif | string | — |
tiktok_item_idFacultatif | string | id de publication Spark Ads |
deeplinkFacultatif | string | — |
auto_message_idFacultatif | string | welcome message for Direct Message ads (list_tiktok_auto_messages / create_tiktok_auto_message) |
identity_bc_idFacultatif | string | Business Center id when identity_type is BC_AUTH_TT |
operation_statusFacultatif | ENABLE | DISABLE | DISABLE creates the ad paused; default ENABLE |
advertiser_idFacultatif | string | optional: 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éditsModifie 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ètre | Type | Description |
|---|---|---|
campaign_idsObligatoire | array<string> | ids de campagnes TikTok (ou un id de campagne Tecrube) |
amountObligatoire | number | devise du compte |
campaign_idFacultatif | string | Alias of campaign_ids (single id) |
currencyFacultatif | string | optional ISO check; must equal the ad account currency |
advertiser_idFacultatif | string | optional: 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éditsMet en pause (DISABLE) ou active (ENABLE) des campagnes TikTok. Aperçu et validation d'abord.
| Paramètre | Type | Description |
|---|---|---|
campaign_idsObligatoire | array<string> | — |
operation_statusObligatoire | ENABLE | DISABLE | DELETE | DELETE is permanent; only when the user explicitly asked |
campaign_idFacultatif | string | Alias of campaign_ids (single id) |
advertiser_idFacultatif | string | optional: 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éditsMet à 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ètre | Type | Description |
|---|---|---|
adgroup_idsObligatoire | array<string> | — |
adgroup_nameFacultatif | string | — |
budgetFacultatif | number | — |
optimization_goalFacultatif | string | CLICK | CONVERT | REACH | VIDEO_VIEW | LEAD | ENGAGEMENT |
billing_eventFacultatif | string | CPC | CPM | OCPM | CPV |
bid_typeFacultatif | string | BID_TYPE_NO_BID | BID_TYPE_CUSTOM |
bid_priceFacultatif | number | — |
conversion_bid_priceFacultatif | number | — |
pacingFacultatif | PACING_MODE_SMOOTH | PACING_MODE_FAST | — |
location_idsFacultatif | array<string> | ids de zones TikTok (Turquie 298795, US 6252001, UK 2635167, DE 2921044) |
age_groupsFacultatif | array<string> | AGE_13_17 | AGE_18_24 | AGE_25_34 | AGE_35_44 | AGE_45_54 | AGE_55_100 |
genderFacultatif | GENDER_UNLIMITED | GENDER_MALE | GENDER_FEMALE | — |
languagesFacultatif | array<string> | codes de langue, p. ex. tr, en |
interest_category_idsFacultatif | array<string> | — |
operating_systemsFacultatif | array<string> | ANDROID | IOS |
audience_idsFacultatif | array<string> | — |
excluded_audience_idsFacultatif | array<string> | — |
schedule_start_timeFacultatif | string | YYYY-MM-DD HH:MM:SS (UTC) |
schedule_end_timeFacultatif | string | YYYY-MM-DD HH:MM:SS (UTC) ; définit SCHEDULE_START_END |
daypartingFacultatif | string | 336 caractères 0/1 : 7 jours x 48 demi-heures à partir du lundi 00:00 |
pixel_idFacultatif | string | Fixed at creation (defines the ad group's optimisation); rejected with an explanation |
optimization_eventFacultatif | string | p. ex. COMPLETE_PAYMENT, ON_WEB_CART, FORM |
comment_disabledFacultatif | boolean | — |
share_disabledFacultatif | boolean | — |
search_result_enabledFacultatif | boolean | — |
interest_keyword_idsFacultatif | array<string> | issus de search_tiktok_targeting(type=interest_keyword) |
actionsFacultatif | array<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_typeFacultatif | string | e.g. DEFAULT, MIN, PACING, VO_MIN_ROAS |
roas_bidFacultatif | number | — |
zipcode_idsFacultatif | array<string> | from search_tiktok_targeting(type=location) |
device_model_idsFacultatif | array<string> | — |
device_price_rangesFacultatif | array<number> | price range bounds, e.g. [0, 250] |
network_typesFacultatif | array<string> | WIFI | 2G | 3G | 4G | 5G |
carrier_idsFacultatif | array<string> | — |
schedule_typeFacultatif | SCHEDULE_FROM_NOW | SCHEDULE_START_END | — |
saved_audience_idFacultatif | string | — |
frequencyFacultatif | integer | max impressions per user within frequency_schedule days |
frequency_scheduleFacultatif | integer | frequency cap window in days |
brand_safety_typeFacultatif | string | NO_BRAND_SAFETY | STANDARD_INVENTORY | LIMITED_INVENTORY | EXPANDED_INVENTORY |
blocked_pangle_app_idsFacultatif | array<string> | — |
targeting_expansionFacultatif | object | e.g. {expansion_enabled: true} |
household_incomeFacultatif | array<string> | e.g. TOP5, TOP10, TOP10_25, TOP25_50 |
spending_powerFacultatif | ALL | HIGH | — |
exclude_age_under_eighteenFacultatif | boolean | — |
changesFacultatif | object | n'importe quels champs adgroup/update sous forme de dictionnaire |
adgroup_idFacultatif | string | Alias of adgroup_ids (single id) |
placementsFacultatif | array<string> | Not changeable after creation (TikTok rule); rejected with an explanation |
placement_typeFacultatif | string | Not changeable after creation (TikTok rule); rejected with an explanation |
budget_modeFacultatif | string | Not changeable after creation (TikTok rule); rejected with an explanation |
advertiser_idFacultatif | string | optional: 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éditsMet 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ètre | Type | Description |
|---|---|---|
adgroup_idsObligatoire | array<string> | — |
operation_statusObligatoire | ENABLE | DISABLE | DELETE | DELETE is permanent; only when the user explicitly asked |
reasonFacultatif | string | — |
adgroup_idFacultatif | string | Alias of adgroup_ids (single id) |
advertiser_idFacultatif | string | optional: 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éditsMet en pause ou active des annonces TikTok (p. ex. une création usée). Aperçu et validation d'abord.
| Paramètre | Type | Description |
|---|---|---|
ad_idsObligatoire | array<string> | — |
operation_statusObligatoire | ENABLE | DISABLE | DELETE | DELETE is permanent; only when the user explicitly asked |
reasonFacultatif | string | — |
ad_idFacultatif | string | Alias of ad_ids (single id) |
advertiser_idFacultatif | string | optional: 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éditsCré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ètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
audience_typeFacultatif | PIXEL | APP | ENGAGEMENT | ENGAGEMENT_ORGANIC_VIDEO | BUSINESS_ACCOUNT | LEAD_GENERATION | TIKTOK_SHOP | — |
retention_daysFacultatif | integer (1–365) | — |
eventFacultatif | string | événement pixel/application à inclure, p. ex. AddToCart, CompletePayment, ViewContent |
exclude_eventFacultatif | string | événement à exclure, p. ex. CompletePayment pour les abandons de panier |
pixel_idFacultatif | string | — |
event_source_idsFacultatif | array<string> | ids de pixels / ids d'applications / ids de groupes d'annonces selon audience_type |
advertiser_idFacultatif | string | optional: 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éditsSupprime définitivement des audiences personnalisées ou similaires TikTok. Appliqué à la demande de l'utilisateur, non annulable.
| Paramètre | Type | Description |
|---|---|---|
audience_idsObligatoire | array<string> | ids from list_tiktok_audiences |
advertiser_idFacultatif | string | optional: 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éditsCré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ètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
source_audience_idObligatoire | string | — |
audience_sizeFacultatif | NARROW | BALANCED | BROAD | — |
include_sourceFacultatif | boolean | — |
location_idsFacultatif | array<string> | — |
placementsFacultatif | array<string> | — |
advertiser_idFacultatif | string | optional: 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éditsCré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ètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
phone_numberObligatoire | string | numéro WhatsApp Business avec indicatif pays, p. ex. +90 532 000 00 00 (le format national commençant par 0 est refusé) |
daily_budgetObligatoire | number | budget quotidien du groupe d'annonces, devise du compte (minimum TikTok ≈ équivalent de 20 USD) |
video_idObligatoire | string | vidéo de la bibliothèque (list_tiktok_videos / upload_tiktok_video) |
ad_textObligatoire | string | 1-100 caractères |
connection_methodFacultatif | chat_link | native | chat_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_messageFacultatif | string | chat_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_goalFacultatif | CLICK | CONVERSATION | — |
phone_region_codeFacultatif | string | native uniquement, lorsque l'indicatif est partagé (p. ex. US pour +1) |
message_event_set_idFacultatif | string | native + CONVERSATION uniquement, lorsque le numéro ne correspond à aucun ensemble d'événements |
image_idsFacultatif | array<string> | id d'image de couverture ; omis = la couverture de la vidéo est récupérée et importée automatiquement |
call_to_actionFacultatif | string | SEND_MESSAGE par défaut (CALL_NOW non autorisé) |
ad_nameFacultatif | string | — |
identity_idFacultatif | string | — |
identity_typeFacultatif | string | CUSTOMIZED_USER | TT_USER | BC_AUTH_TT |
display_nameFacultatif | string | — |
goalFacultatif | string | — |
audienceFacultatif | object | countries (liste ISO), age_min (18+), age_max, genders ([1]=homme, [2]=femme), tiktok_location_ids, tiktok_interest_ids |
ad_groupFacultatif | object | ré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_urlFacultatif | string | NON accepté : un groupe d'annonces de messagerie n'a pas de destination web ; fournissez phone_number à la place |
website_urlFacultatif | string | NOT accepted (same rule as landing_page_url); rejected with an explanation |
advertiser_idFacultatif | string | optional: 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éditsRenomme 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ètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | campaign_id TikTok ou id de campagne Tecrübe |
nameObligatoire | string | — |
advertiser_idFacultatif | string | optional: 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éditsModifie 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ètre | Type | Description |
|---|---|---|
ad_idObligatoire | string | — |
adgroup_idFacultatif | string | facultatif ; lu depuis la publicité s'il est omis |
ad_nameFacultatif | string | — |
ad_textFacultatif | string | 1-100 caractères |
landing_page_urlFacultatif | string | — |
call_to_actionFacultatif | string | — |
display_nameFacultatif | string | — |
advertiser_idFacultatif | string | optional: 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éditsCré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ètre | Type | Description |
|---|---|---|
titleObligatoire | string | nom du modèle |
contentObligatoire | string | salutation |
suggested_questionsObligatoire | array<object> | — |
advertiser_idFacultatif | string | optional: 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éditsCré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ètre | Type | Description |
|---|---|---|
display_nameObligatoire | string | — |
image_uriFacultatif | string | image_id d'un avatar carré depuis upload_tiktok_image |
advertiser_idFacultatif | string | optional: 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éditsCré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ètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
advertiser_idFacultatif | string | optional: 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éditsCré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ètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
identifiersObligatoire | array<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_typeFacultatif | EMAIL | PHONE | IDFA | AAID | par défaut EMAIL |
retention_daysFacultatif | integer (1–365) | — |
advertiser_idFacultatif | string | optional: 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éditsPartage 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ètre | Type | Description |
|---|---|---|
audience_idsObligatoire | array<string> | 1-10 id d'audiences personnalisées |
shared_advertiser_idsFacultatif | array<string> | 1-10 comptes publicitaires du même Business Center (facultatif pour l'arrêt du partage : tous) |
actionFacultatif | share | unshare | — |
advertiser_idFacultatif | string | optional: 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éditsMots-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ètre | Type | Description |
|---|---|---|
object_typeObligatoire | CAMPAIGN | ADGROUP | — |
object_idObligatoire | string | — |
operationFacultatif | list | add | delete | list par défaut |
keywordsFacultatif | array<string> | pour add ; 80 caractères max. chacun |
keyword_idsFacultatif | array<string> | pour delete (issus de operation=list) |
match_typeFacultatif | PRECISE_WORD | PHRASE_WORD | BROAD_WORD | pour add ; BROAD_WORD par défaut |
advertiser_idFacultatif | string | optional: 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éditsEnvoie à 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ètre | Type | Description |
|---|---|---|
pixel_codeObligatoire | string | issu de list_tiktok_pixels |
event_nameObligatoire | string | événement standard, p. ex. CompletePayment, SubmitForm, Contact, AddToCart |
emailFacultatif | string | — |
phoneFacultatif | string | avec +indicatif du pays |
external_idFacultatif | string | — |
ttclidFacultatif | string | id de clic TikTok issu de l'URL de destination |
valueFacultatif | number | — |
currencyFacultatif | string | ISO 4217, obligatoire avec value |
event_idFacultatif | string | clé de déduplication partagée avec le pixel du navigateur |
test_event_codeFacultatif | string | from Events Manager › Test Events; the event is only shown there |
urlFacultatif | string | page où l'événement s'est produit |
advertiser_idFacultatif | string | optional: 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.