Workflow n8n pour le bulk upload Meta Ads

Brancher n8n sur l’API Marketing de Meta pour pousser des créatives en masse est faisable, mais quatre contraintes de l’API décident de la réussite du pipeline. Elles sont expliquées ci-dessous. Le graphe de nœuds prêt à importer est dans la documentation Notion, envoyée par email.

Les prérequis

• Une application Meta avec la permission ads_management.
• Un jeton d’accès à longue durée de vie. Un jeton utilisateur court expire au bout de quelques heures et cassera le workflow en pleine nuit.
• L’identifiant du compte publicitaire, au format act_<id>.
• Une page Facebook associée, obligatoire pour créer une créative.

Contrainte 1 : l’ordre de création n’est pas négociable

L’API impose trois étapes, dans cet ordre, et chacune renvoie un identifiant nécessaire à la suivante :

1. Uploader le média et récupérer son identifiant : un image_hash pour une image, un video_id pour une vidéo.
2. Créer l’AdCreative en référençant cet identifiant, la page, le lien et les textes.
3. Créer l’Ad en référençant l’AdCreative et l’ad set de destination.

Un pipeline qui essaie de créer l’annonce avant la créative échoue systématiquement. C’est la première cause d’échec des workflows maison.

Contrainte 2 : les vidéos sont traitées en asynchrone

Une image est utilisable immédiatement après l’upload. Une vidéo, non : Meta la met en file de traitement et l’identifiant existe avant que la vidéo soit prête.

Le workflow doit donc interroger le statut de traitement et attendre qu’il soit terminé avant de créer la créative. Sans cette attente, la création part avec une vidéo non prête et l’appel échoue de façon intermittente, ce qui est le pire cas à déboguer.

C’est ce que fait le nœud d’attente du template : une boucle de vérification avec un intervalle, pas un délai fixe.

Contrainte 3 : les quotas

L’API applique des limites de débit par application et par compte publicitaire. Un envoi de cinquante créatives en rafale les atteint.

Deux réflexes :

• Traiter en série ou par petits lots, pas en parallèle sur cinquante branches.
• Reprendre sur code 429 avec un délai croissant, et ne pas confondre un quota atteint avec une erreur de données. Un 429 se réessaie, un 400 non.

Contrainte 4 : l’échec doit être partiel, pas total

Sur un lot de trente créatives, une seule qui échoue ne doit pas annuler les vingt-neuf autres. Le workflow doit tenir un journal de ce qui est passé et de ce qui a échoué, avec le message d’erreur de l’API, sinon vous relancez tout à l’aveugle.

Ce que ce workflow ne fait pas

Il ne détecte pas vos formats et il ne lit pas votre nomenclature : il pousse ce que vous lui donnez, nommé comme vous l’avez nommé. La préparation des fichiers reste manuelle en amont.

Il ne désactive pas non plus l’Advantage+ créative par créative. Ce réglage se pose à la création de l’AdCreative et doit être explicitement inclus dans le corps de la requête, sinon vous héritez du défaut de Meta.

Enfin, il suppose que vous maintenez le workflow. Chaque évolution de version de l’API Marketing peut casser un appel : c’est le coût réel d’un pipeline maison, et il faut l’assumer avant de choisir cette voie plutôt qu’un outil.

Pour aller plus loin

Le raisonnement complet sur le bulk upload, sans n8n, est dans le guide bulk upload Meta Ads. La convention de nommage à appliquer en amont est ici.