# Fiche connecteur TikTok Ads Manager
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## TikTok Ads Manager
URL : https://get-bruno.com/features/connectors/tiktok-ads-manager
Référence texte : https://get-bruno.com/features/connectors/tiktok-ads-manager/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Marketing
Description : TikTok Ads Manager sert à créer et gérer des campagnes publicitaires TikTok, des audiences et des créations, à consulter les informations du compte, à lancer des rapports synchrones et à envoyer des événements de conversion côté serveur.
Authentification : OAuth
Présentation : TikTok Ads Manager sert à créer et gérer des campagnes publicitaires TikTok, des audiences et des créations, à consulter les informations du compte, à lancer des rapports synchrones et à envoyer des événements de conversion côté serveur.
Usage : Lire les performances d’une campagne
Exemple de demande : Je veux vérifier les résultats de la campagne « Lancement Atelier Martin » sur la période du 1er au 7 octobre, avec impressions, clics et dépenses.
Résultat attendu : Un rapport synchrone avec les métriques demandées pour les campagnes, les groupes d’annonces ou les annonces, selon le niveau choisi.
À préciser : report_type ; advertiser_id ou bc_id selon le type de rapport ; data_level si le rapport l’exige ; dimensions incluant l’identifiant de l’entité et une dimension temporelle adaptée au niveau choisi (campaign_id, adgroup_id ou ad_id, avec stat_time_day ou stat_time_hour)
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/tiktok-ads-manager/actions/get-report
Usage : Préparer une audience personnalisée à partir d’une liste client
Exemple de demande : Je veux créer une audience « Clients Atelier Martin » à partir d’un fichier catalogue.csv contenant des identifiants hachés SHA256.
Résultat attendu : Une audience personnalisée créée à partir du fichier ou de la liste fournie, avec des identifiants ajoutés en une seule opération.
À préciser : nom de l’audience ; fichier CSV ou liste d’identifiants hachés SHA256 ; type d’identifiant : EMAIL_SHA256, PHONE_SHA256, IDFA_SHA256 ou GAID_SHA256
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/tiktok-ads-manager/actions/create-audience
Usage : Créer une campagne puis une structure de diffusion
Exemple de demande : Je veux préparer une campagne « Soldes printemps » avec objectif CONVERSIONS, puis un groupe d’annonces avec budget et ciblage.
Résultat attendu : Une campagne créée ou mise à jour, puis un groupe d’annonces rattaché avec ses réglages de diffusion.
À préciser : advertiser_id ; objectif de campagne ; mode de budget et montant ; ID de campagne si modification, ou création initiale si nouveau projet
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/tiktok-ads-manager/actions/create-or-update-campaign ; https://pipedream.com/apps/tiktok-ads-manager/actions/create-or-update-ad-group
Limites propres au service : Les rapports synchrones exigent des paramètres compatibles avec le type de rapport demandé : report_type, identifiant d’annonceur ou bc_id selon le cas, data_level quand il est requis, dates ou query_lifetime=true, et des dimensions incluant l’identifiant de l’entité plus une dimension temporelle. Les événements de conversion exigent un pixel_id et des identifiants utilisateur hachés SHA256. Pour créer ou mettre à jour une annonce avec un nouveau visuel ou une nouvelle vidéo, il faut d’abord téléverser la création pour obtenir un asset ID. Une audience personnalisée modifiée doit conserver au moins 1 000 membres après l’opération.
Vocabulaire français : Créer une audience — Crée une audience personnalisée TikTok à partir d’identifiants client hachés, avec envoi des membres inclus dans la même opération. (https://pipedream.com/apps/tiktok-ads-manager/actions/create-audience)
Vocabulaire français : Créer une audience similaire — Crée une audience ressemblante à partir d’une audience personnalisée existante. (https://pipedream.com/apps/tiktok-ads-manager/actions/create-lookalike-audience)
Vocabulaire français : Créer ou mettre à jour une annonce — Crée une annonce TikTok ou met à jour une annonce existante, avec nécessité d’un identifiant d’asset pour les créations. (https://pipedream.com/apps/tiktok-ads-manager/actions/create-or-update-ad)
Vocabulaire français : Créer ou mettre à jour un groupe d’annonces — Crée ou met à jour un groupe d’annonces, qui porte le placement, le ciblage, le budget, le calendrier et l’optimisation. (https://pipedream.com/apps/tiktok-ads-manager/actions/create-or-update-ad-group)
Vocabulaire français : Créer ou mettre à jour une campagne — Crée ou met à jour une campagne TikTok avec objectif, mode de budget et budget de départ. (https://pipedream.com/apps/tiktok-ads-manager/actions/create-or-update-campaign)
Vocabulaire français : Obtenir les informations de l’annonceur — Retourne les informations du compte annonceur, comme le nom, la devise, le fuseau horaire et le statut. (https://pipedream.com/apps/tiktok-ads-manager/actions/get-advertiser-info)
Vocabulaire français : Obtenir un rapport — Exécute un rapport synchrone pour récupérer les métriques de performance des campagnes, groupes d’annonces ou annonces. (https://pipedream.com/apps/tiktok-ads-manager/actions/get-report)
Vocabulaire français : Obtenir les informations d’une vidéo Spark Ad — Récupère les informations d’une publication liée à une identité pour l’utiliser comme créatif Spark Ad. (https://pipedream.com/apps/tiktok-ads-manager/actions/manage-spark-ad)
Vocabulaire français : Lister les groupes d’annonces — Liste les groupes d’annonces avec leurs identifiants, statuts, budgets, calendriers et ciblages. (https://pipedream.com/apps/tiktok-ads-manager/actions/list-ad-groups)
Vocabulaire français : Lister les annonces — Liste les annonces d’un compte avec leurs identifiants, statuts et détails créatifs. (https://pipedream.com/apps/tiktok-ads-manager/actions/list-ads)
Vocabulaire français : Lister les audiences — Liste les audiences personnalisées avec leurs identifiants, types, couverture, validité et expiration. (https://pipedream.com/apps/tiktok-ads-manager/actions/list-audiences)
Vocabulaire français : Lister les campagnes — Liste les campagnes avec leurs identifiants, statuts, objectifs et budgets. (https://pipedream.com/apps/tiktok-ads-manager/actions/list-campaigns)
Vocabulaire français : Envoyer un événement de conversion — Envoie un événement de conversion côté serveur à TikTok via l’API Events. (https://pipedream.com/apps/tiktok-ads-manager/actions/send-conversion-event)
Vocabulaire français : Mettre à jour une audience — Renomme une audience personnalisée ou modifie ses membres par ajout, retrait ou remplacement. (https://pipedream.com/apps/tiktok-ads-manager/actions/update-audience)
Vocabulaire français : Téléverser une création — Téléverse une image ou une vidéo dans la bibliothèque d’assets TikTok et renvoie son identifiant d’asset. (https://pipedream.com/apps/tiktok-ads-manager/actions/upload-creative)
- action : Create Audience — Create a new TikTok custom audience from hashed customer identifiers. Uploads the identifiers first, then creates the audience — both steps happen in one tool call. Provide either identifiers (a list of SHA256-hashed values passed directly) or file_path (a CSV file with one identifier per line). identifier_type controls the hash format: EMAIL_SHA256 for hashed emails, PHONE_SHA256 for hashed phone numbers, IDFA_SHA256 or GAID_SHA256 for device IDs. To add members to an existing audience, use Update Audience instead. See the documentation (https://pipedream.com/apps/tiktok-ads-manager/actions/create-audience)
- action : Create Lookalike Audience — Create a TikTok lookalike audience based on an existing custom audience. TikTok finds users who share characteristics with the source audience. Use List Audiences to find the source audience ID. audience_size controls reach vs accuracy: NARROW = most similar (smallest), BALANCED = mixed, BROAD = largest reach. Location IDs: 6252001 = United States, 6269131 = United Kingdom. Newly created audiences require up to 48 hours to be analyzed before they become active. See the documentation (https://pipedream.com/apps/tiktok-ads-manager/actions/create-lookalike-audience)
- action : Create or Update Ad — Create a new TikTok ad or update an existing one. Omit ad_id to create; provide it to update. Creative assets must be uploaded first using Upload Creative — the API requires asset IDs, not file URLs. identity_type and identity_id are required in v1.3; use CUSTOMIZED_USER for non-Spark Ads. For create, see documentation. For update, see documentation. (https://pipedream.com/apps/tiktok-ads-manager/actions/create-or-update-ad)
- action : Create or Update Ad Group — Create a new TikTok ad group or update an existing one. Omit adgroup_id to create; provide it to update. Ad groups control placement, targeting, budget, schedule, bidding, and optimization within a campaign. billing_event must correspond to the chosen optimization_goal — e.g., CLICK → CPC, CONVERT/INSTALL → OCPM, REACH/SHOW → CPM, ENGAGED_VIEW → CPV. Use campaign IDs from Create or Update Campaign or List Campaigns . For create, see documentation. For update, see documentation. (https://pipedream.com/apps/tiktok-ads-manager/actions/create-or-update-ad-group)
- action : Create or Update Campaign — Create a new TikTok campaign or update an existing one. Omit campaign_id to create; provide it to update. objective_type , budget_mode , and budget are required when creating but are not accepted by the update endpoint. Common objective types: REACH , TRAFFIC , VIDEO_VIEWS , LEAD_GENERATION , APP_PROMOTION , CONVERSIONS , PRODUCT_SALES . After creating a campaign, use Create or Update Ad Group to add targeting and budget. For create, see documentation. For update, see documentation. (https://pipedream.com/apps/tiktok-ads-manager/actions/create-or-update-campaign)
- action : Get Advertiser Info — Identity tool — call this first when a user references 'my account' or 'my campaigns'. Returns account details (name, currency, timezone, status) for the given advertiser ID. Find your advertiser ID in the TikTok Ads Manager URL after aadvid= . See the documentation. (https://pipedream.com/apps/tiktok-ads-manager/actions/get-advertiser-info)
- action : Get Report — Run a synchronous report to retrieve performance metrics for campaigns, ad groups, or ads. report_type is required. advertiser_id is required for BASIC, AUDIENCE, PLAYABLE_MATERIAL, CATALOG, and TT_SHOP reports; use bc_id for BC reports. data_level is required for BASIC, AUDIENCE, and CATALOG reports. start_date and end_date are required unless query_lifetime is true. dimensions must include an entity ID dimension for the chosen level ( campaign_id , adgroup_id , or ad_id ) plus a time dimension ( stat_time_day or stat_time_hour ). Common metrics: impressions , clicks , spend , cpc , cpm , ctr , reach , conversion , cost_per_conversion . See the documentation (https://pipedream.com/apps/tiktok-ads-manager/actions/get-report)
- action : Get Spark Ad Video Info — Get information about one or more TikTok posts published via a linked identity, for use as Spark Ad creatives. Returns video duration, dimensions, cover image, authorization status, and visibility. Requires an identity ( identity_type + identity_id ) — use /identity/get/ to find identities linked to your ad account. Pass either item_id (single post) or item_ids (up to 20 posts). Pass the returned item_id to Create or Update Ad as tiktok_item_id to create a Spark Ad. See the documentation (https://pipedream.com/apps/tiktok-ads-manager/actions/manage-spark-ad)
- action : List Ad Groups — List ad groups in a TikTok Ads account with optional filters. Returns ad group IDs, names, status, budget, schedule, and targeting. Use campaign IDs from List Campaigns to filter. Use ad group IDs returned here as input to List Ads or Create or Update Ad . See the documentation (https://pipedream.com/apps/tiktok-ads-manager/actions/list-ad-groups)
- action : List Ads — List ads in a TikTok Ads account with optional filters. Returns ad IDs, names, status, and creative details. Use campaign or ad group IDs from List Campaigns / List Ad Groups to narrow results. See the documentation (https://pipedream.com/apps/tiktok-ads-manager/actions/list-ads)
- action : List Audiences — List custom audiences in a TikTok Ads account. Returns audience IDs, names, types, coverage, validity, and expiry. Returns both owned and shared audiences — use is_creator in the response to check ownership. Use audience IDs returned here as input to Update Audience or Create Lookalike Audience . See the documentation (https://pipedream.com/apps/tiktok-ads-manager/actions/list-audiences)
- action : List Campaigns — List campaigns in a TikTok Ads account with optional filters. Returns campaign IDs, names, status, objective, and budget. Use campaign IDs returned here as input to List Ad Groups or Get Report . See the documentation (https://pipedream.com/apps/tiktok-ads-manager/actions/list-campaigns)
- action : Send Conversion Event — Send a server-side web conversion event to TikTok via the Events API. Use this to report purchases, sign-ups, and other conversions without relying on browser-side tracking. pixel_id is the TikTok Pixel ID found in Events Manager — not the same as advertiser_id . Standard event names: Purchase , CompleteRegistration , ViewContent , AddToCart , InitiateCheckout , Subscribe , Contact , Download . User identifiers ( email , phone_number , external_id ) must be SHA256-hashed before passing. timestamp uses ISO 8601 format (e.g., 2024-01-15T19:49:27Z ). Defaults to current time if omitted. See the documentation (https://pipedream.com/apps/tiktok-ads-manager/actions/send-conversion-event)
- action : Update Audience — Update a TikTok custom audience — rename it, or add/remove/replace members via a file of hashed identifiers. To rename only, provide audience_name and omit identifiers / file_path . To modify members, provide identifiers or file_path and set action ( APPEND , REMOVE , or REPLACE ). The file upload and audience update happen in one tool call. Audience size must remain ≥ 1,000 after the operation. Use List Audiences to find the audience_id . See the documentation (https://pipedream.com/apps/tiktok-ads-manager/actions/update-audience)
- action : Upload Creative — Upload an image or video to the TikTok Ads Asset Library and return its asset ID. Always run this tool before Create or Update Ad when using new creative — the ad creation API requires asset IDs, not file URLs. Provide a publicly accessible URL or a /tmp file path. Returns image_id for images and video_id for videos. Supported image formats: JPG, JPEG, PNG. Supported video formats: MP4, MOV, MPEG, AVI. For images, see See the documentation. For videos, see See the documentation. (https://pipedream.com/apps/tiktok-ads-manager/actions/upload-creative)