Skip to main content
GET
Suchen Sie nach verfügbaren Interessen für das Facebook-Werbe-Targeting mit einem Schlüsselwort. Verwenden Sie diesen Endpunkt, um Interessen-IDs für den Endpunkt Beitrag bewerben nachzuschlagen. Dieser Endpunkt hilft Ihnen dabei, interessenbasierte Targeting-Optionen für Ihre Facebook-Anzeigen zusammen mit Schätzungen der Zielgruppengröße zu entdecken.
  • Interessen-IDs können im Array interests beim Bewerben von Beiträgen verwendet werden.
  • Ergebnisse werden 10 Minuten zwischengespeichert.
  • Verwenden Sie spezifische, relevante Suchbegriffe für die besten Ergebnisse.
  • Facebook kann je nach Branche und Region Ihres Werbekontos unterschiedliche Ergebnisse zurückgeben.
  • Die Felder audienceSizeLowerBound und audienceSizeUpperBound in der JSON-Antwort geben einen geschätzten Bereich der Zielgruppengröße für das Interesse an und sind für das Targeting nützlich.
  • Verwenden Sie specialAdCategories, um nur die Interessen zurückzugeben, die Meta für eine Kampagne in einer speziellen Anzeigenkategorie zulässt. Gefilterte Anfragen erfordern zusätzlich accountId.

Header-Parameter

Query-Parameter

Die Suchanfrage zum Abrufen von Facebook-Werbe-Interessen.Vergessen Sie nicht, die Suchanfrage zu maskieren, zum Beispiel Rhythm%20and%20blues%20music.
array
Beschränken Sie die Ergebnisse auf die Interessen, die Meta einer Kampagne in einer speziellen Anzeigenkategorie als Targeting erlaubt. Verwenden Sie dies, bevor Sie einen Beitrag zu Wohnen, Beschäftigung, Finanzen oder Politik bewerben, damit Sie Interessen-IDs auswählen, für die die Anzeige tatsächlich freigegeben wird.Die folgenden Werte werden unterstützt und entsprechen dem gleichnamigen Parameter von Beitrag bewerben:
  • housing
  • employment
  • financial_product_services – financial_products_services und credit werden als gleichwertig akzeptiert und derselben Kategorie zugeordnet
  • issues_elections_politics
  • none – wird aus Symmetrie zu Beitrag bewerben akzeptiert, wo es „in keiner speziellen Anzeigenkategorie“ bedeutet. Es wird als regulated_categories=["NONE"] an Meta gesendet: accountId ist erforderlich, und eine erfolgreiche Antwort gibt ["NONE"] zurück. Das garantiert nicht dieselben Ergebnisse wie eine ungefilterte Suche; eine Ablehnung durch Meta gibt code: 368 zurück. Lassen Sie specialAdCategories ganz weg, statt none zu senden, wenn Sie eine gewöhnliche ungefilterte Suche wünschen.
Werte sind unabhängig von Groß- und Kleinschreibung. Ein unbekannter Wert wird mit einem 400 und code: 101 abgelehnt, der die akzeptierten Werte auflistet. Diese Meldung ist in Metas Großschreibung verfasst und nennt auch die oben genannten alternativen Schreibweisen; sie lautet daher NONE, HOUSING, FINANCIAL_PRODUCTS_SERVICES, EMPLOYMENT, ISSUES_ELECTIONS_POLITICS, FINANCIAL_PRODUCT_SERVICES, CREDIT – dieselben hier aufgeführten Kategorien, keine zusätzlichen. Beitrag bewerben gibt die identische Meldung zurück. Ein leerer Wert, wie in ?specialAdCategories=, wird auf dieselbe Weise abgelehnt.Übergeben Sie mehrere Kategorien, indem Sie den Parameter wiederholen, zum Beispiel ?search=nursing&specialAdCategories=employment&specialAdCategories=housing. Die Klammerform ?specialAdCategories[]=employment&specialAdCategories[]=housing funktioniert ebenfalls. Ein kommagetrennter String wie ?specialAdCategories=employment,housing wird nicht unterstützt und mit einem 400 und code: 101 abgelehnt. Alle angeforderten Kategorien werden in einer einzigen Suche an Meta gesendet. Ayrshare gibt Metas Ergebnisse zurück und berechnet oder garantiert keine Schnittmenge unabhängig voneinander zulässiger Interessen. Eine Kategorie zu wiederholen oder zwei Schreibweisen derselben Kategorie zu senden, wird zu einer einzigen Kategorie zusammengefasst.Wenn Sie mehr als eine Kategorie angeben, wird das in der Antwort zurückgegebene Feld specialAdCategories alphabetisch sortiert und nicht in der von Ihnen gesendeten Reihenfolge zurückgegeben.Lassen Sie specialAdCategories ganz weg, und der Endpunkt verhält sich exakt wie zuvor: eine ungefilterte Suche, kein accountId erforderlich und dieselbe Antwortstruktur.
string
Erforderlich, wenn specialAdCategories angegeben ist, andernfalls ignoriert. Die ID des Facebook-Werbekontos, für das die Interessen gesucht werden, ohne das Präfix act_ – derselbe Wert, den Beitrag bewerben entgegennimmt. Sie können sie über den Werbekonten-Endpunkt abrufen. Sie muss numerisch sein; ein vorangestelltes act_ wird akzeptiert und entfernt, alles andere wird mit einem 400 und code: 101 abgelehnt.
Meta bietet die kategoriebezogene Interessensuche nur auf einem Werbekonto an, daher wird eine Anfrage, die specialAdCategories ohne accountId angibt, mit einem 400 und code: 101 abgelehnt, bevor eine Suche ausgeführt wird. Eine Anfrage ohne specialAdCategories ist unverändert und benötigt weiterhin kein accountId.
number
Standard:100
Begrenzt die Anzahl der zurückgegebenen Werbe-Interessen.
Eine gefilterte Antwort gibt die angewendeten Kategorien im Feld specialAdCategories zurück, sodass Sie überprüfen können, worauf die Ergebnisse eingegrenzt wurden. Eine ungefilterte Antwort lässt dieses Feld vollständig weg, statt es leer zurückzugeben. Gefilterte Ergebnisse lassen außerdem das Feld topic bei jedem Interesse weg, weil Metas kategoriebezogene Suche es nicht zurückgibt – lesen Sie stattdessen name. Eine Suche ohne zulässige Interessen gibt 200 mit einem leeren interests-Array und count: 0 zurück, keinen Fehler, und eine gefilterte Suche fällt nie auf ungefilterte Ergebnisse zurück.