Ads

Booster un post Instagram par API via l'API

POST /ads/boost transforme un post déjà publié en annonce, dans le compte que le client a connecté. C'est le même arbre que POST /ads (campagne, ensemble et annonce), mais le visuel vient du post : textes et médias ne font pas partie d'un boost. Vous n'implémentez pas l'API Meta et ne passez pas par la revue d'app.

L'appel

POST /api/ads/boost?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>

{
  "name": "Impulsionar post",
  "status": "active",
  "campaign": {
    "facebook_ads": {
      "objective": "engagement"
    }
  },
  "adset": {
    "budget": {
      "amount": 20,
      "type": "daily"
    },
    "targeting": {
      "countries": [
        "BR"
      ]
    },
    "facebook_ads": {
      "optimization_goal": "post_engagement",
      "billing_event": "impressions"
    }
  },
  "ad": {
    "post_id": "18191649508387596",
    "facebook_ads": {
      "instagram_account_id": "17841442920331135"
    }
  }
}

Ce que vous pouvez faire

  • Lister les posts qui peuvent être boostés dans GET /ads/facebook_ads/posts.
  • Booster un post en créant une campagne et un ensemble neufs, ou en réutilisant des existants avec {"id": ...}.
  • Définir budget, pays, optimisation et facturation de l'ensemble.
  • Demander status active pour activer à la dernière étape.
  • Envoyer link_url et call_to_action en option.

Règles et limites

  • Tout est créé en pause et le status demandé est appliqué à la dernière étape.
  • Idempotency-Key est obligatoire dans le header ; répéter avec la même clé renvoie 200 avec Idempotent-Replay: true.
  • ad.post_id vient de GET /ads/facebook_ads/posts. Sans le paramètre source, la liste renvoie des médias Instagram, les seuls qui servent au boost ; avec source=facebook la liste ne sert qu'à la découverte.
  • facebook_ads.instagram_account_id est obligatoire : la propriété du post est prouvée par lui.
  • Le visuel d'une annonce boostée ne peut pas être remplacé ensuite : 422 boosted_creative_not_replaceable.
  • Si une étape échoue, ce qui a été créé est annulé et répéter avec la même clé reprend. La réponse est synchrone (201).

Champs principaux

ChampTypeObligatoireDescription
namestringOuiNom de l'annonce, et des niveaux créés qui n'en ont pas.
statusstringNonÉtat final de l'arbre (active ou paused). Tout est créé en pause et activé à la dernière étape.
campaignobjectNon{"id": ...} pour une campagne existante ; sans id, décrit celle à créer.
adsetobjectOui{"id": ...} pour un ensemble existant ; sans id, décrit celui à créer (budget, audience, optimisation).
ad.post_idstringOuiLe post à booster, issu de GET /ads/facebook_ads/posts.
ad.facebook_ads.instagram_account_idstringOuiLe compte Instagram propriétaire du post. La propriété du post est prouvée par lui.
ad.link_urlstringNonURL de destination, le cas échéant.
ad.call_to_actionstringNonBouton de l'annonce. Valeurs dans GET /ads/options.

Pour qui

  • Bouton Booster dans votre produit

    Affichez les posts du client et, en un clic, créez le boost avec le budget et l'audience choisis.

  • Automatisation pour les posts performants

    Quand un post dépasse un seuil d'engagement dans vos métriques, créez le boost automatiquement, en pause, pour approbation.

  • Agent IA de réseaux sociaux

    L'agent choisit le post, propose budget et audience et le crée en pause pour que le gestionnaire l'approuve.

Fonctionne avec

  • Meta Ads

Questions fréquentes

Puis-je booster des posts Facebook ?

La liste des posts Facebook (source=facebook) sert à la découverte, pas au boost. Le boost utilise des médias Instagram.

Puis-je changer le texte ou l'image d'une annonce boostée ?

Non. Le visuel vient du post, et le remplacer renvoie 422 boosted_creative_not_replaceable.

Le boost dépense-t-il tout de suite ?

Seulement si vous envoyez status active. Tout est créé en pause et l'activation est la dernière étape.

Voir aussi

Voir tout ce que vous pouvez faire avec Ads

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.