Marketing Mix Modeling Breakdown on Insights API

Die Marketing Mix Modeling Breakdown on Insights API ist eine Self-Service-Option zur Datenextraktion, mit der Kund*innen schnell und einfach Meta-Anzeigendaten für Marketing Mix Modeling exportieren können, ohne einen Meta Marketing Science Partner oder Drittanbieter-Agenturen und mobile Messpartner einschalten zu müssen.

Die API-Aufrufe werden mit dem breakdowns=mmm-Parameter in die Insights API integriert. Anders als bei anderen Aufschlüsselungen werden keine Kombinationen mit breakdowns oder action_breakdowns unterstützt.

Die Antworten enthalten ähnliche Metriken und Aufschlüsselungen wie die Ergebnisse aus dem Marketing Mix Modeling-Datenexport in Anzeigenberichten. Marketing Mix Modeling-Daten sind nur auf Anzeigengruppenebene verfügbar, was dem Standardverhalten (gleich dem level=adset-Parameter) entspricht. Derzeit sind die unterstützten Metriken für Marketing Mix Modeling impressions und spend. Hinweis:spend ist eine geschätzte Metrik. Weitere Informationen findest du unter Insights API, geschätzte und veraltete Kennzahlen.

Kurzanleitung

So rufst du die Marketing Mix Modeling-Daten ab:

curl \
  -F "access_token=ACCESS_TOKEN" \ 
  -F "breakdowns=mmm" \ 
  "https://graph.facebook.com/v21.0/act_AD_ACCOUNT_ID/insights"

Die Insights API verwendet Standardwerte für Parameter, die im Aufruf nicht angegeben werden. Wir empfehlen, die Parameter time_range und date_preset zu verwenden. Die Genauigkeit der Antwort kann durch die Verwendung von time_increment weiter erhöht werden.

Beispiel

Mit diesem API-Aufruf werden die täglichen Marketing Mix Modeling-Daten für letzte Woche abgerufen:

curl \
  -F "access_token=ACCESS_TOKEN" \ 
  -F "breakdowns=mmm" \ 
  -F "date_preset=last_7d" \ 
  -F "time_increment=1” \ 
  "https://graph.facebook.com/v21.0/act_AD_ACCOUNT_ID/insights"

Weitere Informationen zur Insights API und zur Freischaltung der Marketing API findest du in der Kurzanleitung zur Insights API.

Abfragen auf der Business Manager-Ebene

Ein gängiger Anwendungsfall wäre, Marketing Mix Modeling-Daten für einen einzelnen Business Manager abzurufen. Dieser Vorgang wird nicht direkt unterstützt, da die Insights API auf der Ebene des Werbekontos und darunter arbeitet.

1. Um Daten für einen Business Manager herunterzuladen, musst du zunächst mit den Endpunkten owned_ad_accounts und client_ad_accounts die verfügbaren Werbekonten abfragen.

   curl \
     -F "access_token=ACCESS_TOKEN" \ 
     "https://graph.facebook.com/v21.0/BUSINESS_ID/owned_ad_accounts"
   

   curl \
     -F "access_token=ACCESS_TOKEN" \ 
     "https://graph.facebook.com/v21.0/BUSINESS_ID/client_ad_accounts"
   

2. Iteriere über die zurückgegebenen individuellen Werbekonten-IDs, um die Marketing Mix Modeling-Daten für jedes Werbekonto abzufragen.

Begrenzungen und Best Practices

Die Genauigkeit von Marketing Mix Modeling-Daten führt dazu, dass die Antwort eine große Anzahl von Datensätzen sowie eine große Datensatzgröße umfasst. Das kann dazu führen, dass bei deinen Anfragen während der Berechnung eine Zeitüberschreitung auftritt. Um dies zu vermeiden, solltest du die Größe der Anfrage mithilfe von time_range und filtering verringern und den gesamten Zeitraum in Abschnitten abfragen. Weitere Informationen findest du unter Insights API, Begrenzungen und Best Practices.

Diese Version unterstützt nur eine bestimmte filtering für die Abfrage der Marketing Mix Modeling-Daten. Für ein Feld sind nur diese aufgeführten Operatorkombinationen erlaubt und andere Nutzungen von filtering geben einen Fehler zurück.

Wir empfehlen, den Marketing Mix Modeling-Datenexport in Anzeigenberichten zu nutzen, um historische Daten zu exportieren, wenn die API nicht benötigt wird.

Alternativ kannst du den Ablauf für asynchrone Jobs der Insights API verwenden. Dadurch wird ein Job erstellt, der die Daten asynchron berechnet. Der Endpunkt antwortet mit der id einer Anzeigenberichtsausführung, die du nach dem Jobstatus und zum Abrufen der berechneten Daten abfragen kannst. Beachte aber, dass bei manchen Anfragen auch bei einem asynchronen Job eine Zeitüberschreitung auftreten kann. Weitere Informationen findest du unter Asynchrone Jobs der Insights API.

Beachte bitte, dass diese Version geringfügig andere Spaltenüberschriftzuordnungen und eine andere Reihenfolge der Spaltenüberschriften aufweisen kann als der Marketing Mix Modeling-Datenexport in Anzeigenberichten. Darüber hinaus kannst du die Standarddaten der Marketing Mix Modeling-Aufschlüsselung ganz flexibel mit anderen über die API abgefragten Tabellen verknüpfen.