Référence complète du CLI

Voici la référence complète du CLI d'Ads Uploader. Pour une introduction et un guide de démarrage, consulte Configuration par CLI.

Commandes

Authentification

Navigation

Import de médias

Les arguments HTTPS, y compris les liens publics vers des fichiers Google Drive, sont détectés automatiquement. Tu peux mélanger des chemins locaux et des URL : les fichiers locaux sont importés en premier, puis le serveur importe les URL dans le même lot, afin que le regroupement fonctionne sur toutes les entrées. Les dossiers Drive publics doivent être partagés avec le paramètre Anyone with the link (Viewer).

Les fichiers locaux sont préparés en parallèle, et les pannes réseau transitoires sont réessayées automatiquement avec backoff. Les imports d'URL et de dossiers Drive utilisent des pipelines de fichiers parallèles à concurrence limitée dans une tâche en arrière-plan, tandis que le CLI affiche un compteur terminés/total et chaque fichier actif. Tu as rarement besoin de toucher à ces flags, mais ils sont disponibles :

Création d'annonces

Gestion des tâches

Flags de création

Ces flags s'appliquent à ads create, ads create:preview et ads create:interactive. Ils peuvent être utilisés à la place d'un fichier de spécification ou avec lui.

Flags de navigation

Ces flags sont disponibles sur campaigns, adsets, adset et campaign :

Recherche de ciblage

Le ciblage par ville, par zip et le ciblage avancé utilisent des identifiants Meta plutôt que des noms. Fais une recherche via Ads Uploader pour obtenir des valeurs à coller dans une spécification :

ads targeting:search "Austin" --type city
ads targeting:search "90210" --type zip
ads targeting:search "advertising" --type detailed

Les résultats de ciblage avancé incluent id, name, type, une fourchette de taille d'audience et le chemin de catégorie. Le type identifie la catégorie de ciblage avancé, comme interests, behaviors, work_employers ou work_positions. Recherche toujours ces identifiants ; ne les devine jamais.

Flags de détail

Ces flags sont disponibles sur ad :

Flags communs

Format du fichier de spécification

Le fichier de spécification JSON contrôle chaque aspect de la création d'annonces. Fournis une source de modèle (adPresetId ou copyFromAd) plus soit uploadId, soit des mediaItems capturés avec un mediaHash Facebook pour chaque image et un mediaId pour chaque vidéo. Les vidéos standard, carrousel, flexibles et par placement ont aussi besoin de thumbnailHash ; les vidéos Multi Media utilisent leur URL de miniature publique capturée.

Spécification minimale

{
  "adPresetId": "your_preset_id",
  "uploadId": "batch_abc123"
}

Exemple complet

{
  "adPresetId": "preset_id_here",
  "uploadId": "batch_abc123",
  "adSet": {
    "name": "My New Ad Set",
    "dailyBudget": 50
  },
  "adNamePattern": "{filename}",
  "texts": {
    "perAd": {
      "hero.jpg": {
        "headlines": ["Main Headline"],
        "bodies": ["Ad copy here."],
        "descriptions": ["Short description"],
        "cta": "SHOP_NOW",
        "link": "https://example.com/landing"
      }
    }
  },
  "creativeEnhancements": "none",
  "options": {
    "status": "PAUSED",
    "pauseAt": "adSet"
  }
}

Source de modèle

Il t'en faut une pour indiquer au CLI quelle configuration d'annonce utiliser comme base.

Lorsque tu utilises copyFromAd, fournis l'import, ou lance un build web enregistré dont les images capturées ont un mediaHash et les vidéos un mediaId. Tu peux facultativement définir la campagne et l'ensemble d'annonces :

{
  "copyFromAd": "120233848667930472",
  "uploadId": "batch_abc123",
  "campaign": { "id": "120233848666410472" },
  "adSet": { "id": "120233848666620472" }
}

Pour trouver le bon ID d'annonce, navigue dans ton compte : ads campaigns puis ads campaign <id> puis ads adset <id> puis ads ad <id>.

Options de profil

Par défaut, les nouvelles annonces héritent de la page Facebook, du compte Instagram et du profil Threads de l'annonce modèle ou du préréglage. C'est le même contrôle Options de profil disponible via le panneau Valeurs par défaut dans l'application web. Remplace l'un d'eux par un bloc profile (ou par les flags --page / --instagram / --use-page-identity / --threads, qui ont priorité sur le fichier de spécification) :

{
  "copyFromAd": "120233848667930472",
  "uploadId": "batch_abc123",
  "profile": {
    "pageId": "123456789012345",
    "instagramId": "17841400000000000",
    "threadsId": "987654321098765"
  }
}

Exécute ads pages pour lister les ID de page que tu peux utiliser, ainsi que le compte Instagram lié à chaque page.

Si tu remplaces uniquement la page, Ads Uploader utilise automatiquement son compte Instagram lié. Si aucun compte Instagram n'est lié, il utilise la page Facebook comme identité Instagram. Threads reste réinitialisé car il peut appartenir à l'ancienne page ; définis-le explicitement si besoin.

Pour un choix explicite d'acteur-page, utilise --use-page-identity ou définis "useFacebookPage": true dans profile. Ne le combine pas avec --instagram ou instagramId. Tu peux aussi changer uniquement le profil Instagram ou Threads sans toucher à la page, en ne définissant que ces champs.

Pour les lancements multicampagnes, assigne les identités indépendamment avec profile.campaigns. Indexe chaque remplacement par l'id de la campagne correspondante (recommandé) ou par un nom de campagne non ambigu :

{
  "campaign": {
    "mode": "duplicate",
    "campaigns": [
      { "id": "prospecting", "name": "Prospecting" },
      { "id": "retargeting", "name": "Retargeting" }
    ]
  },
  "profile": {
    "campaigns": {
      "prospecting": { "pageId": "page_1", "instagramId": "ig_1", "threadsId": null },
      "retargeting": { "pageId": "page_2", "useFacebookPage": true, "threadsId": "threads_2" }
    }
  }
}

Chaque clé de profile.campaigns doit correspondre à une campagne dans campaign.campaigns ; les clés non appariées ou ambiguës sont rejetées avant le lancement.

Structure de la campagne

Par défaut, les annonces vont dans la campagne de l'annonce modèle. Tu peux créer une nouvelle campagne en fournissant campaign.name.

Pour les modes multicampagnes, utilise campaign.mode avec un tableau campaigns :

{
  "campaign": {
    "mode": "duplicate",
    "campaigns": [
      { "name": "Campaign A" },
      { "name": "Campaign B" }
    ]
  }
}

Modes d'ensemble d'annonces

Par défaut, les annonces vont dans l'ensemble d'annonces existant de l'annonce modèle. Les modes suivants te donnent le contrôle sur la façon dont les annonces sont réparties entre les ensembles d'annonces.

Créer un nouvel ensemble d'annonces :

{ "adSet": { "name": "My Ad Set" } }

Utiliser un ensemble d'annonces existant par ID :

{ "adSet": { "id": "120233848666620472" } }

Un ensemble d'annonces par fichier importé :

{ "adSet": { "mode": "perUpload" } }

Regroupement automatique en ensembles d'annonces de taille fixe :

{ "adSet": { "mode": "autoGroup", "adsPerAdSet": 5 } }

Groupes personnalisés avec contrôle total sur quels fichiers vont où :

{
  "adSet": {
    "groups": [
      { "name": "Images - April 10", "media": ["hero.jpg", "banner.jpg"] },
      { "name": "Videos - April 10", "media": ["promo.mp4"] }
    ]
  }
}

Modèle de nommage des ensembles d'annonces pour les modes à plusieurs ensembles d'annonces :

{ "adSet": { "mode": "perUpload", "namePattern": "Ad Set {index:01}" } }

Le regroupement par variantes regroupe les annonces par identifiant de variation dans le même ensemble d'annonces :

{ "adSet": { "mode": "autoGroup", "groupVariations": true, "variationIdentifier": "-" } }

Remplacement du budget et de l'enchère

Remplace le budget quotidien et/ou le montant de l'enchère sur les nouveaux ensembles d'annonces. Les valeurs sont dans les unités monétaires de ton compte (p. ex. 50 pour 50 $ ou 50 euros).

dailyBudget et bidAmount utilisent les unités monétaires du compte. minimumRoas est un ratio, donc 1.5 signifie un objectif de ROAS de 1,5x.

• Campagnes ABO (le budget est sur l'ensemble d'annonces) : combine dailyBudget avec bidAmount pour les stratégies à plafond d'enchère/de coût, ou avec minimumRoas pour LOWEST_COST_WITH_MIN_ROAS.
• Campagnes CBO (le budget est sur la campagne) : ne définis pas dailyBudget sur l'ensemble d'annonces. Utilise campaign.dailyBudget ou campaign.lifetimeBudget (mutuellement exclusifs) pour remplacer le budget de la campagne source, ou omets les deux pour en hériter. Les dépenses minimale et maximale de l'ensemble d'annonces peuvent être des montants entiers ou des pourcentages de 5-100 % du budget de campagne (par paliers de 5 %) ; les pourcentages fonctionnent aussi avec une campagne CBO existante. Définis bidAmount ou minimumRoas sur l'ensemble d'annonces quand sa stratégie source utilise ce contrôle.

bidAmount et minimumRoas sont mutuellement exclusifs car ils appartiennent à des stratégies d'enchère différentes.

{ "adSet": { "dailyBudget": 50 } }
{ "adSet": { "bidAmount": 5 } }
{ "adSet": { "minimumRoas": 1.5 } }
{ "adSet": { "dailyBudget": 50, "bidAmount": 5 } }

Également disponibles comme flags du CLI : --daily-budget 50, --bid-amount 5, --minimum-roas 1.5, --campaign-daily-budget 100, --campaign-lifetime-budget 1000, --adset-min-spend 20, --adset-max-spend 80, --adset-min-spend-pct 20 et --adset-max-spend-pct 80.

Ciblage de l'ensemble d'annonces

Le ciblage s'applique aux nouveaux ensembles d'annonces. Omets le bloc targeting de niveau supérieur pour hériter de l'audience de l'ensemble d'annonces source telle quelle. N'importe quel mode peut utiliser adSet.targetingPerAdSet, indexé comme texts.perAdset par le nom final de l'ensemble d'annonces, son ID, ou un campaign::key sûr en cas de collision. Le mode personnalisé prend aussi en charge adSet.groups[].targeting. La priorité est targetingPerAdSet, puis groups[].targeting, puis la valeur par défaut du build, puis l'audience source. Le ciblage par ensemble de publicités n'existe que dans les spécifications, car les flags du CLI ne peuvent pas cibler un ensemble de publicités planifié en particulier.

Avec plusieurs campagnes, la copie de chaque ensemble de publicités dans chaque campagne est ciblée séparément ; utilise "Campaign name::Ad set name" comme clé pour cibler une copie précise.

{
  "targeting": {
    "countries": ["US"],
    "cities": [
      {
        "key": "2525495",
        "name": "Austin",
        "region": "Texas",
        "countryCode": "US",
        "radius": 25,
        "distance_unit": "mile"
      }
    ],
    "zips": [
      {
        "key": "US:90210",
        "name": "90210",
        "region": "California",
        "countryCode": "US"
      }
    ],
    "selectionVersion": 4,
    "ageSelected": true,
    "ageMin": 21,
    "ageMax": 55,
    "genderSelected": true,
    "genders": "women",
    "detailedTargetingSelected": true,
    "detailedTargetingGroups": [[
      {
        "id": "112002898811624",
        "name": "Advertising agency",
        "type": "work_employers"
      }
    ]]
  }
}

{
  "targeting": { "countries": ["US"], "ageMin": 21, "ageMax": 55 },
  "adSet": {
    "mode": "perUpload",
    "namePattern": "Ad Set {index:01}",
    "targetingPerAdSet": {
      "Ad Set 02": { "countries": ["CA"], "genders": "women" },
      "Ad Set 01": { "countries": ["GB"] }
    }
  }
}

Pour le mode personnalisé, groups[].targeting reste valide et conserve le remplacement à côté de son groupe de médias :

{
  "adSet": {
    "mode": "custom",
    "groups": [{
      "name": "Canada Women",
      "media": ["canada.jpg"],
      "targeting": { "countries": ["CA"], "genders": "women" }
    }]
  }
}

Utilise ads targeting:search pour trouver la key de la ville (type city), la key du zip comme US:90210 (type zip), et l'id, le name et le type de chaque sélection avancée (type detailed). Omets les pays, les villes et les zips pour hériter des lieux de la source. Les pays, les villes et les zips sont combinés comme des alternatives : ajouter Austin ou un zip à countries: ["US"] cible toujours l'ensemble des États-Unis ; omets les pays pour cibler uniquement la ville ou le zip. Les codes postaux n'ont pas de rayon.

Configuration de texte

Le texte commun applique le même texte à toutes les annonces :

{
  "texts": {
    "common": {
      "headlines": ["Headline 1", "Headline 2"],
      "bodies": ["Primary text"],
      "descriptions": ["Description"]
    },
    "strategy": "flexible"
  }
}

Le texte par annonce te permet de définir un texte unique pour chaque fichier :

{
  "texts": {
    "perAd": {
      "hero.jpg": {
        "headlines": ["Hero Headline"],
        "bodies": ["Hero copy"],
        "descriptions": ["Hero desc"],
        "cta": "LEARN_MORE",
        "link": "https://example.com/hero",
        "urlTags": "utm_content=hero"
      },
      "banner.jpg": {
        "headlines": ["Banner Headline"],
        "bodies": ["Banner copy"]
      }
    }
  }
}

Les clés par annonce sont des noms de fichier (pas des chemins complets). Chaque entrée prend en charge : headlines, bodies, descriptions, cta, link, displayUrl, urlTags. Les champs que tu ne spécifies pas héritent de l'annonce modèle.

Le texte par ensemble de publicités applique un bloc de texte à chaque annonce d'un ensemble de publicités de destination. Utilise un nom/ID d'ensemble simple lorsqu'il est unique, ou une entrée campaign::key lorsque le même nom d'ensemble apparaît dans plusieurs campagnes :

{
  "texts": {
    "perAdset": {
      "Prospecting::prospecting_set": {
        "headlines": ["Prospecting headline"],
        "bodies": ["Prospecting copy"],
        "descriptions": ["Prospecting description"],
        "cta": "SHOP_NOW",
        "link": "https://example.com/prospecting",
        "displayUrl": "example.com/prospecting",
        "urlTags": "utm_campaign=prospecting",
        "aiDisclosure": false
      }
    }
  }
}

Chaque clé texts.perAdset doit correspondre à un ensemble de publicités planifié. Les clés non appariées sont rejetées plutôt que de revenir au texte commun.

Les préréglages de texte te permettent de charger une configuration de texte enregistrée :

{ "textPresetId": "preset_id_here" }

Tu ne peux pas combiner textPresetId avec texts.

Les options de stratégie contrôlent la façon dont plusieurs variations de texte sont gérées :

• "flexible" (par défaut) laisse Meta optimiser parmi tes variations de texte. Plusieurs titres et textes deviennent des options que Facebook combine librement.
• "separate" crée une annonce distincte pour chaque combinaison de texte.

CTA et liens

Un CTA de niveau supérieur s'applique à toutes les annonces. Les CTA par annonce dans texts.perAd et les CTA par ensemble de publicités dans texts.perAdset le remplacent.

{
  "cta": {
    "type": "SHOP_NOW",
    "link": "https://example.com",
    "displayUrl": "example.com"
  },
  "urlTags": "utm_source=facebook&utm_medium=paid"
}

Types de CTA standard : LEARN_MORE, SHOP_NOW, SIGN_UP, SUBSCRIBE, GET_OFFER, CONTACT_US, DOWNLOAD, ORDER_NOW, BUY_NOW, BOOK_NOW, APPLY_NOW, GET_QUOTE, GET_IN_TOUCH, WATCH_MORE, PLAY_GAME

Les CTA spécifiques à l'objectif sont hérités de l'annonce modèle et ne doivent pas être définis manuellement. Les définir sur le mauvais type de campagne provoquera une erreur de l'API Facebook.

Test fractionné d'URL (destination fractionnée)

Fournis de 2 à 5 URL de destination sous texts.urlVariants et chaque ensemble d'annonces généré est dupliqué une fois par URL pour que Meta optimise chaque combinaison d'annonce et de page de destination indépendamment.

{
  "texts": {
    "common": { "headlines": ["Hero"], "bodies": ["Copy"] },
    "urlVariants": [
      { "link": "https://example.com/homepage", "label": "homepage" },
      { "link": "https://example.com/quiz", "label": "quiz-v2" }
    ]
  }
}

• label est facultatif. Lorsqu'il est omis, le dernier slug de chemin de l'URL est utilisé (/quiz-v2 → quiz-v2), avec repli sur le nom d'hôte pour les URL racines.
• En mode ensemble d'annonces unique, le label de chaque variante devient le nom complet de l'ensemble d'annonces.
• Dans les modes perUpload et autoGroup, le nom de chaque ensemble d'annonces dupliqué ajoute _{label} au modèle (ou remplace un token {destination} si tu en inclus un).
• Le token {date} dans un label se résout à la date du jour (p. ex. launch-{date} → launch-2026-04-27).
• Chaque URL de destination doit être unique. Les URL identiques (ou les variantes avec barre oblique finale ou avec une casse différente de la même URL) sont fusionnées en une seule entrée, alors assure-toi d'avoir au moins 2 destinations distinctes.
• Le budget de ton ensemble d'annonces est multiplié par le nombre de variantes, puisque chaque doublon est son propre ensemble d'annonces.
• Non compatible avec les annonces sources à destination spéciale (formulaire de prospects, Messenger, WhatsApp, DM Instagram, appel). Le CLI rejette cette combinaison avec une erreur claire, ces formats ne passent pas par cta.link.
• Les substitutions de link par annonce dans texts.perAd perdent face à l'URL de la variante lorsque les deux sont définies.

Améliorations créatives

Contrôle les améliorations créatives Advantage+ :

{ "creativeEnhancements": "none" }

Fonctionnalités disponibles : text_translation, inline_comment, enhance_cta, text_optimizations, reveal_details_over_time, show_destination_blurbs, image_brightness_and_contrast, image_touchups, video_auto_crop, video_filtering, pac_relaxation, image_animation, image_templates, adapt_to_placement, product_extensions, product_tags, description_automation, add_text_overlay, music, carousel_to_video, carousel_dynamic_description, multi_share_end_card, multi_share_optimized

La clé show_destination_blurbs s’affiche sous le nom Show spotlights, et pac_relaxation sous le nom Flex media.

Lorsque tu sélectionnes des fonctionnalités précises, ne liste que celles pertinentes pour le type de média. Les fonctionnalités vidéo (video_auto_crop, video_filtering) ne s'appliquent qu'aux annonces vidéo. Les fonctionnalités carrousel (carousel_to_video, carousel_dynamic_description, multi_share_end_card, multi_share_optimized) ne s'appliquent qu'aux annonces carrousel.

product_tags s'applique aux annonces image et vidéo et n'est disponible qu'en clonage. Il ne peut être activé que lorsque l'annonce source a un catalogue associé et des tags produits explicitement positionnés ; tous les tags de la source et leurs positions sont préservés. "all" ne l'inclut que pour une source éligible et n'invente jamais un tag produit.

Annonces carrousel

Regroupe les fichiers importés en annonces carrousel avec un texte par carte et un texte global de carrousel facultatif. cardTexts contrôle les cartes individuelles. Le texte global du carrousel peut être placé sur l'objet carrousel ou défini dans texts.perAd à l'aide du name du carrousel ; les champs placés l'emportent lorsque les deux sont présents.

{
  "carousel": [
    {
      "name": "My Carousel",
      "cards": ["slide1.jpg", "slide2.jpg", "slide3.jpg"],
      "headlines": ["Overall Carousel Headline"],
      "bodies": ["Overall primary text"],
      "descriptions": ["Overall description"],
      "cta": "SHOP_NOW",
      "link": "https://example.com/carousel",
      "urlTags": "utm_content=my_carousel",
      "cardTexts": [
        { "headline": "Slide 1", "description": "First card", "link": "https://example.com/1" },
        { "headline": "Slide 2", "description": "Second card", "link": "https://example.com/2" }
      ]
    }
  ]
}

Forme alternative pour le texte global :

{
  "texts": {
    "perAd": {
      "My Carousel": {
        "headlines": ["Overall Carousel Headline"],
        "bodies": ["Overall primary text"],
        "descriptions": ["Overall description"],
        "cta": "SHOP_NOW",
        "link": "https://example.com/carousel",
        "urlTags": "utm_content=my_carousel"
      }
    }
  },
  "carousel": [
    {
      "name": "My Carousel",
      "cards": ["slide1.jpg", "slide2.jpg", "slide3.jpg"]
    }
  ]
}

Les cartes doivent référencer des noms de fichier de l'import. Minimum 2 cartes par carrousel. Les fichiers revendiqués par un carrousel sont retirés de la liste d'annonces standard.

Annonces flexibles

Regroupe plusieurs ressources en une seule annonce flexible où Meta choisit la meilleure ressource par placement :

{
  "flexible": [
    {
      "name": "Multi-Asset Ad",
      "assets": ["hero.jpg", "promo.mp4", "banner.jpg"]
    }
  ]
}

Minimum 2 ressources par groupe. Les fichiers revendiqués par un groupe flexible sont retirés de la liste d'annonces standard.

Annonces multimédias

Regroupe de 2 à 10 images ou vidéos importées en une annonce Multi Media de Meta :

{
  "multimedia": [
    {
      "name": "Mixed Media Ad",
      "assets": ["hero.jpg", "promo.mp4", "banner.jpg"],
      "assetTexts": [
        {
          "headline": "Hero headline",
          "primaryText": "Hero primary text",
          "description": "Hero description",
          "link": "https://example.com/hero",
          "displayUrl": "example.com/hero"
        }
      ]
    }
  ]
}

Les ressources doivent référencer des noms de fichier de l'import. assetTexts est facultatif et s'aligne sur assets par index ; chaque champ est une substitution unique pour cette ressource et les champs vides reviennent au texte principal et aux URL de l'annonce. La ressource principale rendue utilise le texte et l'URL principaux de l'annonce, et toute substitution du texte principal d'une ressource devient la première option de texte principal. Les vidéos ont besoin d'une URL de miniature publique mise en cache issue du traitement de l'import. Les fichiers revendiqués par un groupe Multi Media sont retirés de la liste d'annonces standard.

Nommage des annonces

Personnalise la façon dont tes annonces sont nommées :

{ "adNamePattern": "{filename} - {date}" }

Options

{
  "options": {
    "status": "PAUSED",
    "pauseAt": "adSet",
    "schedule": {
      "startTime": "2026-04-01T09:00:00",
      "endTime": "2026-04-30T23:59:59"
    }
  }
}

Import et détection de variantes

Les groupes de variantes sont détectés automatiquement à partir des conventions de noms de fichier, tout comme dans l'application web. Consulte Variations de format d'image pour tous les détails sur les conventions de nommage.

Suffixes de ratio : hero_1x1.jpg + hero_4x5.jpg + hero_9x16.jpg + hero_16x9.jpg + hero_1.91x1.jpg sont regroupés en une seule annonce à variantes. Jusqu'à 5 ratios par groupe.

Position du token : le token de ratio peut apparaître à la fin (hero_4x5.jpg), au milieu (hero_4x5_v2.jpg) ou au début (4x5_hero.jpg).

Suffixes de mots hérités : hero.jpg + hero_vertical.jpg + hero_horizontal.jpg fonctionnent toujours et correspondent à 9x16 et 16x9.

Le délimiteur par défaut est _. Tu peux le changer (ou en accepter plusieurs) dans Compte > Valeurs par défaut > Placements > Séparateur de nom de fichier.

Modèles courants

Importer et créer avec un préréglage

ads upload ./creatives/hero.jpg ./creatives/banner.jpg
ads create:preview spec.json
ads create spec.json

Où spec.json contient :

{ "adPresetId": "PRESET_ID", "uploadId": "BATCH_ID" }

Copier les paramètres d'une annonce existante

Navigue dans ton compte pour trouver l'annonce :

ads campaigns
ads campaign 120233848666410472
ads adset 120233848666620472
ads ad 120233848667930472

Crée ensuite une spécification qui la référence :

{
  "copyFromAd": "120233848667930472",
  "uploadId": "BATCH_ID"
}

L'annonce source doit avoir des paramètres de créatif en ligne. Si elle a été construite à partir d'une publication de page existante, le CLI la rejettera avant d'envoyer une requête de création.

Enregistrer un préréglage d'API à partir d'une annonce existante

ads presets:save --from-ad 120233848667930472 --name "Spring Purchase Template"
ads create --preset PRESET_ID --upload BATCH_ID

Cela enregistre la même forme de préréglage d'API que celle utilisée par l'application web. L'annonce source doit avoir des paramètres de créatif en ligne ; les annonces basées sur des publications de page ne peuvent pas être enregistrées comme préréglages d'API.

Texte par annonce avec un texte unique par fichier

{
  "adPresetId": "PRESET_ID",
  "uploadId": "BATCH_ID",
  "texts": {
    "perAd": {
      "hero.jpg": {
        "headlines": ["Summer Sale Now On"],
        "bodies": ["Save up to 50% on all items"],
        "cta": "SHOP_NOW",
        "link": "https://example.com/summer"
      },
      "banner.jpg": {
        "headlines": ["New Collection Available"],
        "bodies": ["Browse our latest styles"],
        "cta": "LEARN_MORE",
        "link": "https://example.com/new"
      }
    }
  }
}

Regroupement automatique en plusieurs ensembles d'annonces

{
  "adPresetId": "PRESET_ID",
  "uploadId": "BATCH_ID",
  "adSet": { "mode": "autoGroup", "adsPerAdSet": 3 }
}

Notes importantes

1. Toujours prévisualiser d'abord. create:preview détecte les erreurs de configuration avant de toucher à Facebook.
2. Les annonces sont actives par défaut. Utilise --status PAUSED ou "status": "PAUSED" dans la spécification pour les créer en pause.
3. uploadId provient de la sortie de l'import. C'est l'ID d'import renvoyé par ads upload.
4. Les imports sont liés à un compte publicitaire. Les fichiers sont importés directement dans la bibliothèque de médias Facebook du compte sélectionné. L'ID d'import ne peut être utilisé qu'avec le même compte.
5. copyFromAd a besoin d'un média résoluble. Fournis uploadId, ou lance un build enregistré dont les images capturées ont un mediaHash et les vidéos un mediaId. Facultativement, fournis campaign.id et adSet.id pour contrôler le placement.
6. Les clés de texte par annonce sont des noms de fichier. Utilise "hero.jpg", pas "/path/to/hero.jpg".
7. textPresetId et texts sont mutuellement exclusifs. Utilise l'un ou l'autre, pas les deux.
8. Les CTA spécifiques à l'objectif sont hérités du modèle. Ne définis pas MESSAGE_PAGE, WHATSAPP_MESSAGE, etc. manuellement.