Ciblage de base

Le ciblage de base se compose des critères suivants :

Les annonceurs diffusant des publicités relatives au logement, à l’emploi, au crédit, aux élections et à la politique, et établis aux États-Unis ou diffusant des publicités destinées aux États-Unis sont soumis à d’autres restrictions.

Données démographiques et évènements

Obtenez les données démographiques de base et les données de ciblage géographique pour définir les paramètres de la Recherche de ciblage. Ensuite, ajoutez les options dans la spécification targeting, qui contient les attributs de l’ensemble de publicités définissant les personnes qui verront la publicité.

Remarque : à moins d’utiliser des audiences personnalisées, vous devez spécifier au moins un pays dans le ciblage.

Ciblage par données démographiques

curl -X POST \ -F 'name=My AdSet' \ -F 'optimization_goal=REACH' \ -F 'billing_event=IMPRESSIONS' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id=<CAMPAIGN_ID>' \ -F 'targeting={ "geo_locations": {"countries":["US"]}, "industries": [{"id":6009003307783,"name":"Accounting and finance"}], "life_events": [{"id":6003054185372,"name":"Recently Moved"}], "relationship_statuses": [2,4] }' \ -F 'status=ACTIVE' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets

Champs

NomDescription

genders

tableau

Ciblage par genre. Valeur par défaut : all (tous). 1 = homme et 2 = femme.

age_min

entier

Âge minimal. Valeur par défaut : 18. Si cette option est utilisée, l’âge minimum est de 13 ans. Si l’application propose des paramètres personnalisés pour les restrictions d’âge, les restrictions de l’application seront utilisées pour les publicités associées aux objectifs APP_INSTALL. Par exemple, si vous choisissez 13 pour age_min, mais que l’âge minimum pour votre application est 18, nous utiliserons 18 pour le ciblage publicitaire.

age_max

entier

Âge maximal. Si cette option est utilisée, l’âge maximum est de 65 ans.

Lieu

Recherchez et récupérez des valeurs pour le ciblage géographique dans l’API Targeting Search. Deux paramètres sont associés à ce ciblage : geo_locations pour cibler des lieux précis et, éventuellement, excluded_geo_locations pour exclure des zones.

Utilisez country_groups à la place de geo_locations pour cibler des régions plus larges, telles que l’Europe ou l’Amérique du Nord.

Using radius can cause an error, code: 100, subcode 1815946, when targeting multiple locations. We recommend creating an ad for each location or not using radius in your call.

Champs

NomDescription

countries

tableau

Ciblage par pays. Nécessite un tableau de codes de pays. Consultez la section Pays de la page Recherche de ciblage.
Exemple : 'countries': ['US']

regions

tableau

État, province, département ou région. Valeurs disponibles : consultez la section Régions de la page Recherche de ciblage. Limite : 200.
Exemple : 'regions': [{'key':'3847'}]

cities

tableau

Renseignez les valeurs de key, radius et distance_unit. Pour key, consultez la section Villes de la page Recherche de ciblage. radius correspond à une distance autour des villes, comprise entre 17 et 80 kilomètres (entre 10 et 50 miles). distance_unit est l’unité de distance : mile ou kilomètre. Limite : 250.
Exemple : 'cities': [{'key':'2430536', 'radius':12, 'distance_unit':'mile'}]

zips

tableau

Ciblage par code postal. Consultez l’API Targeting Search. Limite : 50 000 (contre 2 500 auparavant). Si vous en utilisez plus de 2 500, nous créons le tableau location_cluster qui représente un groupe de codes postaux.
Exemple : 'zips':[{'key':'US:94304'},{'key':'US:00501'}]

Pour lire un location_cluster et voir les emplacements ciblés, utilisez GET /location_cluster_ID

places

tableau

Indiquez un nom spécifique pour le lieu. Limite : 200.
Exemple :"places":[{"key":129672430416115,"name":"SFO", "radius":10, "distance_unit":"mile"}]

custom_locations

tableau

Disponible pour l’ensemble des objectifs. Indiquez un lieu exact avec les coordonnées de latitude et de longitude ou une adresse comme centre de la zone. Précisez également un rayon pour votre lieu, entre 1 et 80 kilomètres (entre 0,63 et 50 miles). distance_unit correspond à l’unité de distance (mile ou kilomètre) ; l’unité par défaut est le mile. Limite : 200. address_string n’accepte pas la boîte postale seule. Vous devez, au minimum, indiquer une adresse.
Exemple :'custom_locations':[{'address_string': '1601 Willow Road, Menlo Park, CA', 'radius': 5},{'latitude': 36, 'longitude': -121.0, 'radius': 5, 'distance_unit': 'kilometer'},]

custom_locations.latitude

virgule flottante

Latitude du lieu

custom_locations.longitude

virgule flottante

Longitude du lieu

custom_locations.name

chaîne

Nom à utiliser pour l’adresse. Vous pouvez utiliser le paramètre avec les valeurs latitude et longitude pour effectuer un ciblage géographique sans fournir address_string.

custom_locations.radius

virgule flottante

Rayon autour de la latitude/longitude, exprimé en miles, sauf si une unité différente est précisée dans le paramètre distance_unit. Entre 1 et 80 kilomètres (entre 0,63 et 50 miles).

custom_locations.distance_unit

chaîne

Facultatif.

kilometer ou mile ; valeur par défaut : mile

custom_locations.address_string

chaîne

Adresse au niveau de la latitude/longitude. Par exemple : 1601 Willow Rd, Menlo Park, CA. Format suggéré : numéro de rue, nom de rue, ville, état / province / département, pays. Sans code postal.

geo_markets

tableau

Marchés géographiques avec code DMA ou ComScore. Limite : 2 500.
Exemple :'geo_markets':[{'key': 'DMA:501', 'name': 'New York'},{'key': COMSCORE_MARKET:2001', 'name': 'New York, NY'}, {'key': 'DMA:543', 'name': 'Springfield-Holyoke'},]

electoral_district

tableau

Clé pour les circonscriptions électorales. Pour obtenir les circonscriptions, consultez la section Circonscriptions électorales de la page Recherche par ciblage.
Exemple : 'electoral_districts':[{'key':'US:AK00'},{'key':'US:CA01'},{'key':'US:NY14'}]

location_types

tableau

Le tableau ['home', 'recent'] est la seule option disponible. En absence de location_types, le tableau par défaut sera ['home', 'recent'].

  • recent : personnes dont le lieu récent se situe dans la zone sélectionnée, telle qu’elle a été déterminée sur la base des données de l’application mobile. Non disponible pour exclure des lieux.
  • home : personnes dont le lieu indiqué dans le champ « Ville actuelle » de leur profil Facebook se trouve dans une zone. Facebook valide cette valeur avec l’adresse IP et les informations relatives aux lieux sur les profils de leurs ami·es.

country_groups

tableau

Régions géographiques et zones de libre-échange. Consultez la section Groupes de pays de la page Recherche de ciblage.

Fournissez un tableau de codes de groupes de pays :

  • worldwide : monde entier.
  • africa : Afrique.
  • afta : zone de libre-échange ANASE.
  • android_app_store : pays acceptant les applications payantes dans la boutique d’applications Android.
  • android_free_store : pays acceptant les applications gratuites dans la boutique d’applications Android.
  • apec : Coopération économique pour l’Asie-Pacifique.
  • asia : Asie.
  • caribbean : Caraïbes.
  • central_america : Amérique centrale.
  • cisfta : Accord de libre-échange au sein de la Communauté des États indépendants.
  • eea : Espace économique européen.
  • emerging_markets : pays des marchés émergents.
  • europe : Europe.
  • gcc : Conseil de coopération du Golfe.
  • itunes_app_store : pays pris en charge pour l’App Store iTunes.
  • mercosur : MERCOSUR.
  • nafta : Accord de libre-échange nord-américain (ALENA).
  • north_america : Amérique du Nord.
  • oceania : Océanie.
  • south_america : Amérique du Sud.

Exemple : 'country_groups': ['asia','mercosur']

Exemples :

Ciblage par pays

curl -X POST \ -F 'name="My Reach Ad Set"' \ -F 'optimization_goal="REACH"' \ -F 'billing_event="IMPRESSIONS"' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id="<AD_CAMPAIGN_ID>"' \ -F 'targeting={ "geo_locations": { "countries": [ "US" ] }, "facebook_positions": [ "feed" ] }' \ -F 'status="PAUSED"' \ -F 'promoted_object={ "page_id": "<PAGE_ID>" }' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets

Ciblage géographique avec exclusions

curl -X POST \ -F 'name="My Reach Ad Set"' \ -F 'optimization_goal="REACH"' \ -F 'billing_event="IMPRESSIONS"' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id="<AD_CAMPAIGN_ID>"' \ -F 'targeting={ "excluded_geo_locations": { "regions": [ { "key": "3847" } ] }, "geo_locations": { "countries": [ "US" ] }, "facebook_positions": [ "feed" ] }' \ -F 'status="PAUSED"' \ -F 'promoted_object={ "page_id": "<PAGE_ID>" }' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets

Ciblage par code postal

curl -X POST \ -F 'name=My AdSet' \ -F 'optimization_goal=REACH' \ -F 'billing_event=IMPRESSIONS' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id=<CAMPAIGN_ID>' \ -F 'targeting={ "geo_locations":{ "zips":[{"key":"US:94304"},{"key":"US:00501"}]} }' \ -F 'status=ACTIVE' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets

Ciblage par lieux personnalisés, marchés géographiques et types de lieu

Le code suivant permet de cibler les personnes répondant aux critères suivants :

  • Habitant dans un rayon de cinq miles de 1601 Willow Road, Menlo Park, Californie
  • Habitant dans un rayon de cinq kilomètres autour de la latitude 36 et la longitude -121,0
  • Codes DMA 501 et 543, et COMSCORE_MARKETS 2001 et 2054
curl -X POST \ -F 'name=My AdSet' \ -F 'optimization_goal=REACH' \ -F 'billing_event=IMPRESSIONS' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id=<CAMPAIGN_ID>' \ -F 'targeting={ "geo_locations": { "custom_locations": [ {"address_string":"1601 Willow Road, Menlo Park, CA","radius":"5"}, { "latitude": "36", "longitude": "-121.0", "radius": "5", "distance_unit": "kilometer" } ], "geo_markets": [ {"key":"DMA:501","name":"New York"}, {"key":"DMA:543","name":"Springfield-Holyoke"}, {"key":"COMSCORE_MARKET:2001","name":"New York, NY"}, {"key":"COMSCORE_MARKET:2051","name":"New Orleans, LA"} ], "location_types": ["recent","home"] } }' \ -F 'status=ACTIVE' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets

Recherche et ciblage

Pour cibler les hommes âgés de 20 à 24 ans, dans un rayon de 10 miles de Menlo Park en Californie, ou résidant au Texas ou au Japon :

Étape 1

Commencez par obtenir le code de pays du Japon :

curl -G \ -d 'location_types=["country"]' \ -d 'type=adgeolocation' \ -d 'q=japan' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/search
Étape 2

Obtenez le code régional du Texas :

curl -G \ -d 'location_types=["region"]' \ -d 'type=adgeolocation' \ -d 'q=texas' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/search
Étape 3

Recherchez le code de la ville de Menlo Park en Californie :

curl -G \ -d 'location_types=["city"]' \ -d 'type=adgeolocation' \ -d 'q=menlo' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/search
Étape 4

Précisez le genre dans genders, ainsi qu’une fourchette d’âge avec age_min et age_max.

Étape 5

Nos spécifications de ciblage sont prêtes avec les codes de pays, de région et de ville :

curl \ -F 'name=My First AdSet' \ -F 'daily_budget=10000' \ -F 'bid_amount=300' \ -F 'billing_event=IMPRESSIONS' \ -F 'optimization_goal=REACH' \ -F 'campaign_id=<CAMPAIGN_ID>' \ -F 'promoted_object={"page_id":"<PAGE_ID>"}' \ -F 'targeting={ "age_max": 24, "age_min": 20, "device_platforms": ["mobile"], "genders": [1], "geo_locations": { "countries": ["JP"], "regions": [{"key":"3886"}], "cities": [ { "key": "2420605", "radius": 10, "distance_unit": "mile" } ] }, "publisher_platforms": ["facebook","audience_network"] }' \ -F 'status=PAUSED' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets

Ciblage de plusieurs villes

Définissez custom_type sur multi_city et configurez country ou country_group comme indiqué précédemment.

curl \ -F 'name=My AdSet' \ -F 'optimization_goal=REACH' \ -F 'billing_event=IMPRESSIONS' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id=<CAMPAIGN_ID>' \ -F 'targeting={ "geo_locations": { "custom_locations": [ { "custom_type": "multi_city", "min_population": 500000, "max_population": 1000000, "country": "BR" }, {"custom_type":"multi_city","country_group":"Europe"} ], "location_types": ["recent","home"] } }' \ -F 'status=ACTIVE' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets
Paramètres
Nom Description

min_population

entier

Seuil de population minimale au niveau duquel les villes sont choisies pour le ciblage.

max_population

entier

Seuil de population maximale au niveau duquel les villes sont choisies pour le ciblage.

Ciblage basé sur les centres d’intérêt

Effectuez un ciblage basé sur des centres d’intérêt en fonction du journal d’une personne, des Pages avec la mention J’aime, ou des mots-clés associés aux pages ou aux applications utilisées par une personne. Consultez la section Centres d’intérêt de la page Recherche de ciblage.

Pour cibler les amateurs de football, commencez par la requête suivante :

curl -G \ -d 'type=adinterest' \ -d 'q=soccer' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/search

Ajoutez ce centre d’intérêt à une spécification de ciblage grâce aux paramètres name et id, où path est le chemin d’accès de ce centre d’intérêt dans les outils publicitaires.

curl -X POST \ -F 'name="My First AdSet"' \ -F 'daily_budget=10000' \ -F 'bid_amount=300' \ -F 'billing_event="IMPRESSIONS"' \ -F 'optimization_goal="REACH"' \ -F 'campaign_id="<CAMPAIGN_ID>"' \ -F 'promoted_object={ "page_id": "<PAGE_ID>" }' \ -F 'targeting={ "facebook_positions": [ "feed" ], "geo_locations": { "countries": [ "US" ], "regions": [ { "key": "4081" } ], "cities": [ { "key": 777934, "radius": 10, "distance_unit": "mile" } ] }, "genders": [ 1 ], "age_max": 24, "age_min": 20, "publisher_platforms": [ "facebook", "audience_network" ], "device_platforms": [ "mobile" ], "flexible_spec": [ { "interests": [ { "id": "<INTEREST_ID>", "name": "<INTEREST_NAME>" } ] } ] }' \ -F 'status="PAUSED"' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets

Voici un autre exemple :

curl \ -F 'name=My AdSet' \ -F 'optimization_goal=REACH' \ -F 'billing_event=IMPRESSIONS' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id=<CAMPAIGN_ID>' \ -F 'targeting={ "geo_locations": {"countries":["US"]}, "interests": [ {"id":6003139266461,"name":"Movies"}, {"id":6003397425735,"name":"Tennis"}, {"id":6003659420716,"name":"Cooking"} ] }' \ -F 'status=ACTIVE' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets

Champs

Nom Description

interests

tableau

Tableau d’objets avec le champ id et un champ name facultatif :
'interests':[{id: 6003139266461, 'name': 'Movies'}, {id: 6003139266462}, 6003139266463]

Ciblage comportemental

Effectuez un ciblage sur la base des activités numériques, des appareils utilisés par les personnes, des achats passés ou planifiés et des voyages. Consultez les options dans Browse, telles que Grands voyageurs. Consultez la section Comportements de la page Recherche de ciblage.

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

Ajoutez le comportement à la spécification targeting :

curl \ -F 'name=My First AdSet' \ -F 'daily_budget=10000' \ -F 'bid_amount=300' \ -F 'billing_event=IMPRESSIONS' \ -F 'optimization_goal=REACH' \ -F 'campaign_id=<CAMPAIGN_ID>' \ -F 'promoted_object={"page_id":"<PAGE_ID>"}' \ -F 'targeting={ "age_max": 24, "age_min": 20, "behaviors": [{"id":6002714895372,"name":"All frequent travelers"}], "device_platforms": ["mobile"], "genders": [1], "geo_locations": { "countries": ["JP"], "regions": [{"key":"3886"}], "cities": [ { "key": "2420605", "radius": 10, "distance_unit": "mile" } ] }, "interests": [{"id":6003107902433,"name":"Association football (Soccer)"}], "publisher_platforms": ["facebook","audience_network"] }' \ -F 'status=PAUSED' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets

Autre exemple :

curl -X POST \ -F 'name="My AdSet"' \ -F 'optimization_goal="REACH"' \ -F 'billing_event="IMPRESSIONS"' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id="<CAMPAIGN_ID>"' \ -F 'targeting={ "facebook_positions": [ "feed" ], "geo_locations": { "countries": [ "US" ] }, "behaviors": [ { "id": 6007101597783, "name": "Business Travelers" }, { "id": 6004386044572, "name": "Android Owners (All)" } ] }' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets

Champs

Nom Description

behaviors

tableau

Tableau d’objets avec le champ id et un champ name facultatif :
'behaviors':[{id: 6004386044572, 'name': 'Android Owners (All)'}, {id: 6004386044573}, 6004386044574]

En savoir plus

Autre ciblage :

  • Audience Network : diffusez des publicités sur Audience Network et étendez la couverture de votre lien ou de vos publicités pour une application.