Ads Insights API

Die Ads Insights API liefert Performance-Daten und Statistiken für Meta-Anzeigen. Dank der flexiblen Optionen zur Berichterstellung kannst du deine Anfragen anpassen und fast alle Kennzahlen abrufen, die im Meta-Werbeanzeigenmanager verfügbar sind.

Bevor du loslegst

Um auf die Ads Insights API zuzugreifen, benötigst du Folgendes:

Eine App. (Weitere Informationen findest du unter Meta-App-Entwicklung.)
Die Berechtigung „ads_read“. (Weitere Informationen findest du unter Berechtigungen und Autorisierung.)

Richte außerdem deine Werbeanzeigen so ein, dass die für dich relevanten Handlungen nachverfolgt werden. Dazu kannst du Tools wie die Conversions API oder das Meta-Pixel verwenden.

Abrufen der Ads Insights API

Die Ads Insights API ist als Edge für alle Werbeanzeigenobjekte verfügbar. (Weitere Informationen zur Anzeigenhierarchie von Meta findest du hier.)

Ressource	Bereitstellung von
`/{ad-account-id}/insights`	Insights aus einem Werbekonto
`/{campaign-id}/insights`	Insights aus einer Werbekampagne
`/{ad-set-id}/insights`	Insights aus einer Anzeigengruppe
`/{ad-id}/insights`	Insights aus einer Werbeanzeige

Standardmäßig geben GET-Anfragen grundlegende Kennzahlen für das Anzeigenobjekt zurück, in der Regel für die letzten 30 Tage.

Beispielanfrage

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

Beispielantwort:

{
  "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"
    }
  }
}

Deine Anfragen anpassen

Du kannst wesentlich genauere Daten erhalten, indem du drei Hauptkomponenten in deiner Anfrage nutzt: Parameter (zur Angabe von Zeiträumen, Attributionsfenster usw.), Felder (d. h. Kennzahlen) und Aufschlüsselungen. Wenn du beispielsweise die Anzahl der Klicks (alle) nach Geschlecht für die letzten 7 Tage deiner Kampagne ermitteln möchtest, musst du Folgendes einfügen:

Parameter: date_preset=last_7d
Felder: clicks
Aufschlüsselungen: gender

Beispielanfrage

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

Beispielantwort

{
  "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"
    }
  }
}

Mehr dazu

Die Ads Insights API kann eine leistungsstarke Ressource sein. Du solltest dich daher unbedingt weiter darüber informieren, wie du ihre Funktionen optimal einsetzt:

Parameter und Felder
Kennzahlen
Aufschlüsselungen
Asynchrone Anfragen
Limits und Best Practices
Spezifische Leitfäden für Conversions-Berichte, Berichte auf Produktebene und Marketing Mix Modeling

Außerdem findest du automatisch erstellte Referenzdokumentationen für die Insights-Edge jedes Anzeigenobjekts:

Wenn du Daten aus der Ads Insights API in deine Lösung einbeziehen möchtest, solltest du auch die Meta-Plattform-Nutzungsbedingungen und die Entwicklungsrichtlinien für die Marketing API lesen.