> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Vue d'ensemble de l'API Ads

> Sponsorisez vos publications en les transformant en annonces Facebook grâce à l'API d'Ayrshare.

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

<PlansAvailable plans={["premium"]} maxPackRequired={false} />

## Introduction à l'API Ads

L'API Ads d'Ayrshare fournit un accès programmatique pour créer, gérer et analyser les annonces publicitaires sur les réseaux sociaux.

Prenant actuellement en charge **Facebook**, l'API Facebook Ads, également connue sous le nom de Facebook Marketing API, vous permet de transformer des publications existantes en annonces payantes.
Cela comprend la sponsorisation de publications (transformation d'une publication en annonce), la gestion des annonces, le suivi des performances et l'analyse des dépenses publicitaires.

Les annonces créées et mises à jour via Ayrshare sont toujours consultables dans le Facebook Ads Manager.
Ayrshare gère tous les paramètres au niveau de l'annonce, de l'ensemble d'annonces et de la campagne.
Il n'est jamais nécessaire de modifier manuellement les paramètres directement dans le Facebook Ads Manager.

<Note>
  1. Les fonctionnalités Ads nécessitent le module complémentaire payant Ads, qui peut être activé sur la
     page Account du [tableau de bord Web](https://app.ayrshare.com/account).

  2. L'utilisateur
     doit avoir [associé une méthode
     de paiement](https://business.facebook.com/billing_hub/payment_settings/?placement=ads_manager)
     sur Facebook (Meta) avant de créer une annonce.

  3. Les User Profiles associés à une Page Facebook avant le 1er avril 2025 doivent être
     ré-associés pour activer les annonces.
</Note>

Pour plus d'informations, consultez notre [guide de l'API Facebook Ads](https://www.ayrshare.com/blog/facebook-ads-api-boosting-with-the-marketing-api/).

## Flux de création d'une annonce

<img class="center" src="https://mintcdn.com/ayrshare-docs/Nmrhj2Gh7WSf62Bh/images/apis/ads/ads-flow.webp?fit=max&auto=format&n=Nmrhj2Gh7WSf62Bh&q=85&s=3e57ee2134ddc3bb0937acf5b3d31781" alt="Ads Flow" width="1596" height="437" data-path="images/apis/ads/ads-flow.webp" />

Sponsoriser une publication sur Facebook est un moyen rapide et simple de transformer l'une de vos
publications existantes en annonce. Voici un aperçu général du flux pour l'implémenter dans
votre plateforme :

<Steps>
  <Step title="Choisir le compte publicitaire Facebook">
    Votre utilisateur choisira le compte publicitaire Facebook sur lequel tous les détails de facturation sont déjà configurés.

    <Card title="Obtenir les comptes publicitaires Facebook" href="/apis/ads/facebook/get-ad-accounts" horizontal />
  </Step>

  <Step title="Sélectionner la publication">
    Sélectionnez une publication depuis votre Page Facebook. Il peut s'agir d'une photo, d'une vidéo, d'une mise à jour de statut, etc.

    > **Astuce :** Les publications avec un bon engagement organique (likes, partages, commentaires) ont tendance à mieux performer lorsqu'elles sont sponsorisées.
  </Step>

  <Step title="Cliquer sur « Boost Post »">
    Votre utilisateur cliquera sur un bouton tel que « Boost Post » dans votre plateforme pour commencer
    à configurer l'annonce.

    <Card title="Sponsoriser une publication en la soumettant à la plateforme publicitaire de Facebook" href="/apis/ads/facebook/boost-post" horizontal />
  </Step>

  <Step title="Définir l'objectif, l'audience, le budget et la durée">
    L'utilisateur peut définir un certain nombre de paramètres.

    <ul className="custom-bullets">
      <li>
        Choisir la stratégie d'objectif pour cette
        publication sponsorisée en sélectionnant un objectif.
      </li>

      <li>Personnaliser l'audience en fonction de l'âge, du sexe,
      de la localisation, des centres d'intérêt, etc.</li>
      <li>Choisir le montant total à dépenser.</li>
      <li>Définir la
      période de diffusion de l'annonce.</li>
    </ul>
  </Step>

  <Step title="Vérifier et sponsoriser">
    Vérifiez tous les paramètres. Si tout semble correct, l'utilisateur cliquera sur un bouton tel que **« Boost Post Now »**.
  </Step>

  <Step title="Examen et lancement de l'annonce">
    Facebook examinera l'annonce — cela prend généralement de quelques minutes
    à quelques heures. Une fois approuvée, la publication sponsorisée est mise en ligne et diffusée selon
    la configuration.
  </Step>

  <Step title="Suivre les dépenses et les performances">
    Surveillez les éléments suivants :

    * Portée
    * Engagement
    * Clics
    * Dépenses
    * Budget restant

    <Card title="Obtenir les dépenses publicitaires et les statistiques Facebook" href="/apis/ads/facebook/get-ad-history" horizontal />
  </Step>
</Steps>

## Bonnes pratiques de l'API Ads

1. **Gestion du budget** : Commencez avec de petits budgets de test (par exemple, 5-10 \$/jour) pour optimiser les performances avant d'augmenter l'échelle.
2. **Durée de l'annonce** : Facebook exige une durée d'exécution minimale d'environ 30 heures entre les heures de début et de fin.
3. **Ciblage par centre d'intérêt** : Choisissez 2 à 5 centres d'intérêt pertinents pour une précision de ciblage optimale.
4. **Directives créatives** : Utilisez des images de haute qualité et des messages concis pour améliorer les taux d'engagement.
5. **Suivi des performances** : Vérifiez régulièrement les performances de votre annonce et ajustez le ciblage ou les éléments créatifs selon les besoins.

Pour des informations détaillées sur chaque endpoint, y compris les paramètres de requête, les formats de réponse et des exemples, veuillez vous référer aux pages de documentation des endpoints individuels de l'API.