Targeting-Suche

Du kannst die Zielgruppen für Anzeigengruppen anhand einer Reihe von Kriterien bestimmen, die du in den Targeting-Spezifikationen angibst. Die meisten Ziele sind vordefinierte Werte wie das Land „Japan“ oder die Stadt „Tokio“.

Gültige Werte findest du mit der Targeting-Suche in der Marketing API: https://graph.facebook.com/{API_VERSION}/search. Du musst deinen Abfrage-String im UTF8-Format angeben.

Targeting-Optionsstatus

Mit dem Parameter targeting_option_list kannst du den aktuellen und/oder geplanten Status von Targeting-Objekten überprüfen:

curl -G \
  -d 'targeting_option_list=[<TARGETING_OPTION_ ID>,<TARGETING_OPTION_ID>]' 
  -d 'type=targetingoptionstatus'  
  https://graph.facebook.com/<API_VERSION>/search

Antwort:

{"data":[{"id":"<TARGETING_OPTION_ ID>","current_status":"NON-DELIVERABLE"},{"id":"<TARGETING_OPTION_ID>","current_status":"NON-DELIVERABLE","future_plan":[{"key":"2018-05-10T00:00:00+0000","value":"DEPRECATING"}]}]

Zurückgegebene Felder

Geografische Angaben

Suche Zielgruppen nach Land, Ländergruppe, Ort, Bundesstaat, Postleitzahl und anderen geografischen Gebieten unter type=adgeolocation. Du kannst optionale Parameter mit type=adgeolocation angeben. So findest du den Ländercode der Vereinigten Staaten von Amerika:

curl -G \
  -d 'location_types=["country"]' \
  -d 'type=adgeolocation' \
  -d 'q=un' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Antwort:

{
  "data": [
    {
      "key": "GB", 
      "name": "United Kingdom", 
      "type": "country", 
      "supports_city": false, 
      "supports_region": false
    }, 
    {
      "key": "AE", 
      "name": "United Arab Emirates", 
      "type": "country", 
      "supports_city": false, 
      "supports_region": false
    }, 
    {
      "key": "UM", 
      "name": "United States Minor Outlying Islands", 
      "type": "country", 
      "supports_city": false, 
      "supports_region": false
    }
  ]
}

key ist eine feste Zahl und in jeder Kategorie wie Länder oder Ländergruppen eindeutig. Andere Felder wie name können sich ändern. Verwende key, um Targeting-Spezifikationen zu definieren.

In der Antwort:

• Wenn supports_region = true, liegen Regionscodes für dieses Land vor.
• Wenn supports_city = true, liegen Ortscodes für dieses Land vor.

Länder

Jedes Land, auf das du abzielen kannst, hat einen Ländercode. Optionale Parameter für type=adgeolocation&location_types=['country']:

Ländergruppe

Alle Ländergruppen haben einen Code, um nach ihnen zu suchen und eine Liste von Ländern abzurufen. Für alle Ländergruppen namens mercosur:

curl -G \
  -d 'location_types=["country_group"]' \
  -d 'type=adgeolocation' \
  -d 'q=mercosur' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Antwort:

{
  "data": [
    {
      "key": "mercosur",
      "name": "Mercosur",
      "type": "country_group",
      "country_codes": [
        "BR",
        "AR",
        "UY",
        "PY",
        "VE"
      ],
      "is_worldwide": false,
      "supports_region": true,
      "supports_city": true
    }
  ]
}

Wenn is_worldwide = true, ist das eine weltweite Ländergruppe. Wenn supports_region = true, liegen Regionscodes für die Ländergruppe vor. Wenn supports_city = true, liegen Ortscodes für die Gruppe vor.

Regionen

So suchst du nach allen Regionen, deren Code mit al beginnt:

curl -G \
  -d 'location_types=["region"]' \
  -d 'type=adgeolocation' \
  -d 'q=al' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Antwort:

{
  "data": [
    {
      "key": "3843",
      "name": "Alabama",
      "type": "region",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "3844",
      "name": "Alaska",
      "type": "region",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "527",
      "name": "Alberta",
      "type": "region",
      "country_code": "CA",
      "country_name": "Canada",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "1089",
      "name": "Alsace",
      "type": "region",
      "country_code": "FR",
      "country_name": "France",
      "supports_region": true,
      "supports_city": true
    }
  ]
}

Optionen für type=adgeolocation&location_types=['region']:

Wenn supports_region = true, kannst du diese Region als Zielgruppe ansprechen. Wenn supports_city = true, liegen Ortscodes für die Region vor.

Orte

Seit März 2019 haben wir mehrere Orte für andere Rollen neu klassifiziert. Du kannst aber weiterhin city verwenden. Mit der Suche werden Ergebnisse zurückgegeben, die ehemals Orte waren.

So suchst du nach Codes für alle Orte, die mit Manhattan beginnen:

curl -G \
     -d 'location_types=["city"]' \
     -d 'type=adgeolocation' \
     -d 'q=Manhattan' \
     -d 'access_token=ACCESS_TOKEN' \
     https://graph.facebook.com/VERSION/search

Antwort:

{
  "data": [
    {
      "key": "2447439",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Kansas",
      "region_id": 3859,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2439596",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Illinois",
      "region_id": 3856,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2479541",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Montana",
      "region_id": 3869,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2428908",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Florida",
      "region_id": 3852,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2703980",
      "name": "Manhattan",
      "type": "subcity",
      "country_code": "US",
      "country_name": "United States",
      "region": "New York",
      "region_id": 3875,
      "supports_region": true,
      "supports_city": true,
      "geo_hierarchy_level": "SUBCITY",
      "geo_hierarchy_name": "BOROUGH"
    },
   ...

Wenn supports_region = „true“, kann die Region für diesen Ort für das Targeting verwendet werden. Wenn supports_city = true, ist dieser Ort für das Targeting verfügbar.

Geografische Bereiche

Wir haben andere geografische Bereiche, die für das Targeting herangezogen werden können. Einige dieser Bereiche sind noch nicht definiert, wie unten dargestellt.

Die Hierarchie der geografischen Bereiche sieht folgendermaßen aus, sortierst vom kleinsten zum größten Bereich:

• REGION
• LARGE_GEO_AREA
• MEDIUM_GEO_AREA
• SMALL_GEO_AREA
• METRO_AREA
• CITY
• SUBCITY
• NEIGHBORHOOD
• SUBNEIGHBORHOOD

Postleitzahl

Du kannst auch nach Postleitzahlen suchen, um Zielgruppen auf Facebook zu bestimmen. Für die Suche nach Postleitzahlen empfehlen wir die Verwendung von adgeolocation mit location_types=['zip']. Im Meta-Hilfebereich findest du eine Liste der Länder mit unterstützten Postleitzahlen.

Suche nach Postleitzahlen, die mit 9 beginnen:

curl -G \
  -d 'location_types=["zip"]' \
  -d 'type=adgeolocation' \
  -d 'q=9' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/LATEST-API-VERSION/search

Antwort:

{
  "data": [
    {
      "key": "US:90028",
      "name": "90028",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "Los Angeles",
      "primary_city_id": 2420379,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:94110",
      "name": "94110",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "San Francisco",
      "primary_city_id": 2421836,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:94501",
      "name": "94501",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "Alameda",
      "primary_city_id": 2417628,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:95190",
      "name": "95190",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "San Jose",
      "primary_city_id": 2421846,
      "supports_region": true,
      "supports_city": true
    }
  ]
}

Gebietsschemata

Das Targeting nach Gebietsschemata verwendet Gebietsschemacodes. So suchst du nach allen Gebietsschemata, die mit en beginnen:

curl -G \
  -d 'type=adlocale' \
  -d 'q=en' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Antwort:

{
{
      "data": [
        {
          "key": 51, 
          "name": "English (Upside Down)"
        }, 
        {
          "key": 6, 
          "name": "English (US)"
        }, 
        {
          "key": 24, 
          "name": "English (UK)"
        }
      ]
    }
}

DMA-Codes

Um diese Codes abzurufen, gib type=adgeolocation und location_types=['geo_market'] in deiner Abfrage an. So suchst du nach DMA-Codes, die mit „New“ beginnen:

curl -G \
  -d 'location_types=["geo_market"]' \
  -d 'type=adgeolocation' \
  -d 'q=New' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Das Ergebnis:

{
  "data": [
    {
      "key": "DMA:622",
      "name": "New Orleans",
      "type": "geo_market",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "DMA:501",
      "name": "New York",
      "type": "geo_market",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "DMA:533",
      "name": "Hartford & New Haven",
      "type": "geo_market",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
....
    }
  ]
}

Wahlbezirke

Um nach Wahlbezirken für das Targeting zu suchen, gib type=adgeolocation und location_types=['electoral_district'] an. So suchst du nach Wahlbezirken in Kalifornien:

curl -G \
  -d 'location_types=["electoral_district"]' \
  -d 'type=adgeolocation' \
  -d 'q=California' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Antwort:

{
  "data": [
    {
      "key": "US:CA14",
      "name": "California's 14th District",
      "type": "electoral_district",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:CA02",
      "name": "California's 2nd District",
      "type": "electoral_district",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "supports_region": true,
      "supports_city": true
    },
 ...
}

Metadaten von Geolocations

Du kannst weitere optionale Parameter mit type=adgeolocationmeta verwenden:

curl -G \
  -d 'cities=[2418779]' \
  -d 'zips=["US:90210"]' \
  -d 'countries=["US","JP"]' \
  -d 'regions=[10]' \
  -d 'type=adgeolocationmeta' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Die Antwort ist ein JSON-Objekt mit Metadaten für die angegebenen Geolocations:

{
  "data": {
    "countries": {
      "US": {
        "key": "US", 
        "type": "country", 
        "name": "United States", 
        "supports_city": true, 
        "supports_region": true
      }, 
      "JP": {
        "key": "JP", 
        "type": "country", 
        "name": "Japan", 
        "supports_city": true, 
        "supports_region": true
      }
    }, 
    "regions": {
      "10": {
        "key": "10", 
        "type": "region", 
        "name": "Dubai", 
        "country_code": "AE", 
        "supports_city": true, 
        "supports_region": false
      }
    }, 
    "cities": {
      "2418779": {
        "key": "2418779", 
        "type": "city", 
        "name": "Danville", 
        "region_id": 3847, 
        "region": "California", 
        "country_code": "US", 
        "supports_city": true, 
        "supports_region": true
      }
    }, 
    "zips": {
      "US:90210": {
        "key": "US:90210", 
        "type": "zip", 
        "name": "90210", 
        "primary_city": "Beverly Hills", 
        "region_id": 3847, 
        "region": "California", 
        "country_code": "US", 
        "supports_city": true, 
        "supports_region": true
      }
    }
  }
}

Optionen:

Radiusvorschläge

Um Zielgruppen im Umkreis eines bestimmten Standorts anzusprechen, rufe mit suggested_radius einen vorgeschlagenen Umkreis ab, der eine ausreichende Anzahl von Personen erreicht:

curl -G \
  -d 'latitude=37.449478' \
  -d 'longitude=-122.173016' \
  -d 'type=adradiussuggestion' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Die Antwort ist ein JSON-Objekt mit suggested_radius und distance_unit.

{
  "data": [
    {
      "suggested_radius": 10,
      "distance_unit": "mile"
    }
  ]
}

Beispiel für den Abruf von suggested_radius unter Angabe von distance_unit:

curl -G \
  -d 'latitude=37.449478' \
  -d 'longitude=-122.173016' \
  -d 'type=adradiussuggestion' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

{
  "data": [
    {
      "suggested_radius": 16,
      "distance_unit": "kilometer"
    }
  ]
}

Verwende die folgenden Parameter:

Siehe auch Local Awareness Ads zur Verwendung mit Vorschlägen.

Interessen

Sende eine GET-Anfrage an den /search-Endpunkt und setze dabei type auf adinterest und q auf das gewünschte Interesse:

curl -G \
  -d 'type=adinterest' \
  -d 'q=baseball' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Die Antwort gibt die folgenden Felder zurück:

Interessenvorschläge

Sende eine GET-Anfrage an den /search-Endpunkt und setze dabei type auf adinterestsuggestion, um eine Liste der vorgeschlagenen Interessen für dein Interesse abzurufen.

Beispielabfrage

curl -G \
  -d 'interest_list=["Basketball"]' \
  -d 'type=adinterestsuggestion' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/search

Beispielantwort

{
  "data": [
    {
      "id": "6003598240487",
      "name": "la biblia",
      "audience_size": 7419780,
      "path": [
  ],
      "description": null
   },
   {
      "id": "6003022269556",
      "name": "Rugby football",
      "audience_size": 13214830,
      "path": [
  ],
      "description": null
   },
   {
      "id": "6003146664949",
      "name": "Netball",
      "audience_size": 4333770,
      "path": [
  ],
"description": null
   },
   {
      "id": "6003013291881",
      "name": "Kaizer Chiefs F.C.",
      "audience_size": 1812850,
      "path": [
  ],
      "description": null
  },
  ....
  {
      "id": "6003400886535",
      "name": "espn sportscenter",
      "audience_size": 222960,
      "path": [
  ],
     "description": null
  },
  {
     "id": "6002925969459",
     "name": "watching movies",
     "audience_size": 4630950,
     "path": [
  ],
     "description": null
  },
  {
     "id": "6003214125247",
     "name": "lakers",
     "audience_size": 340360,
     "path": [
  ],
     "description": null
  }

Verfügbare Optionen:

Einschränkungen

• Nicht alle verfügbaren Interessen werden bei einer Suche zurückgegeben.
• Interessen können jederzeit umbenannt werden. In diesem Fall kann die Validierung anhand des Namens fehlschlagen. Daher empfehlen wir dir, Interessen anhand von interest_fbid_list und nicht anhand des Namens zu validieren. Überprüfe die Gültigkeit der Begriffe durch eine Abfrage mit type=adinterestvalid und dem zu validierenden Interesse:

curl -G \
  -d 'interest_list=["Japan","nonexistantkeyword"]' \
  -d 'type=adinterestvalid' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Antwort:

{
  "data": [
    {
      "name": "Japan",
      "valid": true,
      "id": 6003700426513,
      "audience_size": 68310258
    },
    {
      "name": "nonexistantkeyword",
      "valid": false
    }
  ]
}

Optionen:

Interessen

Um mögliche Interessen für das Targeting zu durchsuchen, sende eine GET-Anfrage an den /search-Endpunkt. Setze dabei type auf adTargetingCategory und class auf interests.

curl -G \
  -d 'type=adTargetingCategory' \
  -d 'class=interests' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Einschränkungen

• Nicht alle verfügbaren Interessen werden bei einer Suche zurückgegeben.

Verhalten

Du kannst für das Targeting die Handlungen oder das bisherige Kaufverhalten eines Nutzers als Basis verwenden. Mit type=adTargetingCategory&class=behaviors rufst du alle verfügbaren Optionen für das Targeting nach Verhalten ab.

curl -G \
  -d 'type=adTargetingCategory' \
  -d 'class=behaviors' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Die Antwort enthält Folgendes:

Demografische Angaben

Hierzu gehören Arbeitsplatz, Ausbildung, Berufsbezeichnungen und Beziehungsstatus. Du kann das Targeting auch auf Basis der Aktualität eines Lebensereignisses durchführen: 3 Monate, 6 Monate und 1 Jahr. Wenn du dich an Schulen richten möchtest, kannst du diese anhand von ID und Name referenzieren.

So suchst du nach allen Schulen, die mit ha beginnen:

curl -G \
  -d 'type=adeducationschool' \
  -d 'q=ha' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Antwort:

 {
  "data": [
    {
      "name": "Harvard University", 
      "id": 105930651606,
      "coverage": 8395398,
      "subtext": "Cambridge, Massachusetts"
    }, 
    {
      "name": "Hajvery University", 
      "id": 148971135122588,
      "coverage": 124162
    }, 
    {
      "name": "Harvard-Westlake School", 
      "id": 107799365910274,
      "coverage": 14106
    }
  ]
}

Studiengänge

Um auf Studiengänge abzuzielen, verwende ID und Name. So suchst du nach allen Studiengängen, die mit ph beginnen:

curl -G \
  -d 'type=adeducationmajor' \
  -d 'q=ph' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Antwort:

{
  "data": [
    {
      "name": "Photography", 
      "id": 108170975877442,
      "coverage": 613618
    }, 
    {
      "name": "Physics", 
      "id": 109279729089828,
      "coverage": 942491
    }, 
    {
      "name": "Philosophy", 
      "id": 108026662559095,
      "coverage": 701271
    }
  ]
}

Arbeitgeber

Referenziere Arbeitgeber, an die du dich richten möchtest, anhand von ID und Name. So suchst du nach allen Arbeitgebern, die mit mic beginnen:

curl -G \
  -d 'type=adworkemployer' \
  -d 'q=mic' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Antwort:

{
  "data": [
    {
      "name": "Western Michigan University", 
      "id": 10022826163,
      "coverage": 24366
    }, 
    {
      "name": "University of Michigan", 
      "id": 21105780752,
      "coverage": 17357
    }, 
    {
      "name": "Michigan State University - SPARTANS", 
      "id": 8891783019,
      "coverage": 65853
    }
  ]
}

Berufsbezeichnung

Jede selbstdeklarierte Berufsbezeichnung, auf die abgezielt werden kann, hat eine ID und einen Namen. So findest du alle Berufsbezeichnungen, in denen Business Analyst vorkommt:

curl -G \
  -d 'type=adworkposition' \
  -d 'q=Business Analyst' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Antwort:

{
   "data": [
    {
      "name": "Business Analyst", 
      "id": 105763692790962,
      "coverage": 282124
    }, 
    {
      "name": "Financial Analyst", 
      "id": 112930925387573,
      "coverage": 212889
    }
  ]
}

Die Antwort enthält die folgenden Felder:

Nachfolgend sind gängige Parameter für diese API aufgeführt. Typspezifische Eingabeparameter findest du in den nachstehenden Details.

Gib basierend auf der Kategorie der AutoVervollständigen-Daten den entsprechenden type an. Zum Abrufen von Gebietsschemata gibst du type=adlocale an. Gültige Kategorien sind:

Suchen mit demografischen Angaben

Du kannst alle verfügbaren Optionen für das Targeting nach demografischen Angaben mit type=adTargetingCategory und einer class abrufen.

Die Antwort enthält die folgenden Felder: