Marketing API

Detailliertes Targeting

Mit der Targeting-Suche kannst du über einen API-Aufruf nach einer Targeting-Art suchen. Mit der Detailed Targeting API kannst du in einer Anfrage nach mehreren Targeting-Arten gleichzeitig suchen. Außerdem erhältst du Vorschläge basierend auf deiner Abfrage.

Die API hat vier Endpunkte: Suche, Vorschläge, Durchsuchen und Validierung.

Die Antwort für diese Endpunkte enthält Folgendes:

Name Beschreibung

id

Typ: String

Zielgruppen-ID

name

Typ: String

Name der Zielgruppe

audience_size_lower_bound

Ganzzahl

Geschätzte untere Grenze der Zielgruppengröße

audience_size_upper_bound

Ganzzahl

Geschätzte obere Grenze der Zielgruppengröße

path

Typ: Array von Strings

Enthält die Kategorie und alle übergeordneten Kategorien, zu denen dieses Targeting gehört

description

Typ: String

Eine kurze Beschreibung der Zielgruppe

Wenn du limit_type nicht angibst, werden die Ergebnisse mit weniger als 2.000 Personen in vier Kategorien unterteilt: work_employers, work_positions, education_majors, education_schools. Andernfalls sind die Ergebnisse weniger aussagekräftig. Solltest du limit_type verwenden, wird nach einer dieser vier Kategorien gefiltert und nicht alles zurückgegeben.

Rufe Zielgruppen für deine Werbeanzeigen ab, die deiner Suchabfrage entsprechen. Bei diesem Endpunkt kannst du die folgenden Parameter angeben:

curl -G \
-d "q=harvard" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsearch
Name Beschreibung

q

Typ: String

Erforderlich.

Abfrage-String.

limit

Typ: Ganzzahl

Optional.

Anzahl der Ergebnisse.

limit_type

Typ: String

Optional.

Wähle die Art von Zielgruppe aus, die abgerufen werden soll. Standardmäßig alle Arten.

Gültige Werte:

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

Typ: String

Optional.

Das Gebietsschema für die Anzeige von Zielgruppennamen und -beschreibungen, falls verfügbar. Standardmäßig das Gebietsschema des Werbekontos.

Vorschläge

Gibt anhand einiger von dir angegebener Zielgruppen zusätzliche Zielgruppen zurück, die du ansprechen kannst.

curl -G \
-d "targeting_list=[{'type':'interests','id':6003263791114}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsuggestions

Gib die folgenden Parameter an:

Name Beschreibung

targeting_list

Typ: Array von {'type':'{TYPE}', 'id':{ID}}

Erforderlich.

Array von {'type':'{TYPE}', 'id':{ID}}-Paaren, die als Eingabezielgruppe für Vorschläge dienen.

limit

Typ: Ganzzahl

Optional.

Anzahl der Ergebnisse. Standardwert ist 30. Höchstwert ist 45.

limit_type

Typ: String

Optional.

Wähle die Art von Zielgruppe aus, die abgerufen werden soll. Standardmäßig alle Arten.

Gültige Werte:

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

Typ: String

Optional.

Das Gebietsschema für die Anzeige von Zielgruppennamen und -beschreibungen. Standardmäßig das Gebietsschema des Werbekontos.

Durchsuchen

Erhalte Targeting in einer strukturierten Taxonomie für Facebook-Kategorien, externe Datenanbieter und einige Interessen. Ergebnisse aus diesem Endpunkt erscheinen in der Funktion „Durchsuchen“ in der UI-Komponente „Detailliertes Targeting“ im Werbeanzeigenmanager.

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingbrowse

Gib die folgenden optionalen Parameter an:

Name Beschreibung

limit_type

Typ: String

Wähle die Art von Zielgruppe aus, die abgerufen werden soll. Standardmäßig alle Arten.

locale

Typ: String

Das Gebietsschema für die Anzeige von Zielgruppennamen und -beschreibungen. Standardmäßig das Gebietsschema des Werbekontos.

Validierung

Überprüfe, ob eine Zielgruppe für das Targeting gültig ist oder nicht. Das bietet sich an, wenn du bereits eine Anzeigengruppe erstellt hast und sicherstellen möchtest, dass ihre Targeting-Spezifikation noch gültig ist. Wenn das Targeting nicht gültig ist, solltest du es aus der Targeting-Spezifikation löschen.

curl -G \
-d "targeting_list=[{'type':'interests','id':6003283735711}, {'type':'relationship_statuses','id':100}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingvalidation

Zusätzlich zu den standardmäßigen Antwortfeldern für „Detailliertes Targeting“ gibt dieser Endpunkt auch Folgendes zurück:

Name Beschreibung

valid

Typ: Boolescher Wert

Gibt an, ob die Zielgruppe gültig ist oder nicht.

Hier ist die Liste der Eingabeparameter:

Name Beschreibung

targeting_list

Typ: Array von {'type':'{TYPE}', 'id':{ID}}

Array von {'type':'{TYPE}', 'id':{ID}}-Paaren zur Validierung. Bevorzugt.

id_list

Typ: Array von Strings

Array von IDs zur Validierung. Nur erfolgreich, wenn eine ID in unserer Zielgruppendatenbank eindeutig identifizierbar ist.

name_list

Typ: Array von Strings

Array von Strings zur Validierung. Nur Interessen, ohne Beachtung der Groß-/Kleinschreibung.

locale

Typ: String

Das Gebietsschema für die Anzeige von Zielgruppennamen und -beschreibungen. Standardmäßig das Gebietsschema des Werbekontos.

Gib mindestens einen der folgenden Parameter an: targeting_list, id_list oder name_list.