API Ads Insights

L’API Ads Insights fournit des données et des statistiques de performance pour les publicités Meta. Grâce à ses options de rapport flexibles, vous pouvez personnaliser vos requêtes et obtenir presque tous les indicateurs disponibles dans le Gestionnaire de publicités Meta.

Avant de commencer

Pour accéder à l’API Ads Insights, vous aurez besoin des éléments suivants :

• Une application Consultez la page Développement d’applications Meta pour plus d’informations.
• L’autorisation ads_read. (Pour plus d’informations, consultez les pages sur les Autorisations et l’Autorisation.)

Vous devez également configurer vos publicités pour suivre les actions qui vous intéressent. Pour cela, vous pouvez utiliser des outils tels que l’API Conversions ou le pixel Meta.

Appeler l’API Ads Insights

L’API Ads Insights est disponible à partir de tous les objets publicitaires. (Pour plus d’informations sur la hiérarchie des publicités Meta, cliquez ici.)

Par défaut, les requêtes GET renvoient les indicateurs de base de l’objet publicitaire, généralement pour les 30 derniers jours.

Exemple de requête

curl -G \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights

Exemple de réponse :

{
  "data": [
    {
      "account_id": "<AD_ACCOUNT_ID>",
      "campaign_id": "<CAMPAIGN_ID>",
      "date_start": "2025-03-14",
      "date_stop": "2025-04-12",
      "impressions": "361324",
      "spend": "5339.5"
    }
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

Personnaliser vos invitations

Vous pouvez obtenir des données beaucoup plus spécifiques en utilisant trois composants principaux dans votre demande : les paramètres (pour spécifier des éléments tels que les plages de temps, les fenêtres d’attribution, etc.), les champs (c’est-à-dire les indicateurs) et les répartitions. Par exemple, pour connaître le nombre de clics (tous) par genre survenus au cours des 7 derniers jours de votre campagne, vous pourriez inclure :

• Paramètres : date_preset=last_7d
• Champs : clicks
• Répartitions : gender

Exemple de requête

curl -G \ -d "date_preset=last_7d" \ -d "fields=clicks" \ -d "breakdowns=gender" \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/v26.0/<CAMPAIGN_ID>/insights

Exemple de réponse

{
  "data": [
    {
      "clicks": "7346",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "female"
    },
    {
      "clicks": "3788",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "male"
    },
    {
      "clicks": "79",
      "date_start": "2025-04-06",
      "date_stop": "2025-04-12",
      "gender": "unknown"
    },
  ],
  "paging": {
    "cursors": {
    "before": "MAZDZD",
    "after": "MAZDZD"
    }
  }
}

En savoir plus

L’API Ads Insights peut être très utile, c’est pourquoi nous vous recommandons de poursuivre votre lecture pour découvrir comment maîtriser ses fonctionnalités :

• Paramètres et champs
• Indicateurs
• Répartitions
• Requêtes asynchrones
• Limites et recommandations
• Guides spécifiques pour les rapports de conversions, les rapports au niveau du produit et les modèles de marketing mix

Vous trouverez également une documentation de référence générée automatiquement pour l’edge d’insights de chaque objet publicitaire :

• Insights des comptes publicitaires
• Insights des campagnes publicitaires
• Insights des ensembles de publicités
• Insights des publicités

Si vous envisagez d’inclure des données provenant de l’API Ads Insights dans votre solution, veuillez également consulter les Conditions générales de la plateforme Meta et les Politiques développeur de l’API Marketing.