Utilisation dans Bruno
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.
Exemples de demandes à Bruno
Ces exemples utilisent des noms et des données fictifs. Pour les essayer, connectez l’application et accordez les accès nécessaires. Bruno vous demandera de valider les actions qui l’exigent.
Lire les performances d’une campagne
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 dans votre demande
- 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)
Sources de cet exemple
Préparer une audience personnalisée à partir d’une liste client
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 dans votre demande
- 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
Sources de cet exemple
Créer une campagne puis une structure de diffusion
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 dans votre demande
- advertiser_id
- objectif de campagne
- mode de budget et montant
- ID de campagne si modification, ou création initiale si nouveau projet
Sources de cet exemple
À savoir avant de commencer
- 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.
Pour connecter cette application
- Rechercher TikTok Ads Manager dans Apps, puis vérifier la connexion et les droits proposés. Connexion indiquée par Pipedream : OAuth.
- Les actions possibles dépendent de votre compte et des accès accordés. Un abonnement à l’application peut être nécessaire.
- Bruno demande votre confirmation avant de créer, modifier ou supprimer des données. Les actions proposées par un connecteur Bruno peuvent différer de celles du catalogue Pipedream.
- Le nom anglais est conservé sous chaque action pour la retrouver dans Pipedream.
Actions proposées
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.
Nom d’origine : Create Audience
Documentation Pipedream →Créer une audience similaire
Crée une audience ressemblante à partir d’une audience personnalisée existante.
Nom d’origine : Create Lookalike Audience
Documentation Pipedream →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.
Nom d’origine : Create or Update Ad
Documentation Pipedream →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.
Nom d’origine : Create or Update Ad Group
Documentation Pipedream →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.
Nom d’origine : Create or Update Campaign
Documentation Pipedream →Obtenir les informations de l’annonceur
Retourne les informations du compte annonceur, comme le nom, la devise, le fuseau horaire et le statut.
Nom d’origine : Get Advertiser Info
Documentation Pipedream →Obtenir un rapport
Exécute un rapport synchrone pour récupérer les métriques de performance des campagnes, groupes d’annonces ou annonces.
Nom d’origine : Get Report
Documentation Pipedream →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.
Nom d’origine : Get Spark Ad Video Info
Documentation Pipedream →Lister les groupes d’annonces
Liste les groupes d’annonces avec leurs identifiants, statuts, budgets, calendriers et ciblages.
Nom d’origine : List Ad Groups
Documentation Pipedream →Lister les annonces
Liste les annonces d’un compte avec leurs identifiants, statuts et détails créatifs.
Nom d’origine : List Ads
Documentation Pipedream →Lister les audiences
Liste les audiences personnalisées avec leurs identifiants, types, couverture, validité et expiration.
Nom d’origine : List Audiences
Documentation Pipedream →Lister les campagnes
Liste les campagnes avec leurs identifiants, statuts, objectifs et budgets.
Nom d’origine : List Campaigns
Documentation Pipedream →Envoyer un événement de conversion
Envoie un événement de conversion côté serveur à TikTok via l’API Events.
Nom d’origine : Send Conversion Event
Documentation Pipedream →Mettre à jour une audience
Renomme une audience personnalisée ou modifie ses membres par ajout, retrait ou remplacement.
Nom d’origine : Update Audience
Documentation Pipedream →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.
Nom d’origine : Upload Creative
Documentation Pipedream →
Déclencheurs répertoriés par Pipedream
Aucune action ou aucun déclencheur répertorié ici. Une connexion ne suffit pas à rendre une action disponible dans Bruno.
Source vérifiée le : TikTok Ads Manager sur Pipedream.