Recherche de ciblage

Définissez le ciblage des ensembles de publicités sur la base d’un certain nombre de critères que vous fournissez dans les spécifications de ciblage. La plupart des cibles sont des valeurs prédéfinies, telles que le pays (Japon) ou la ville (Tokyo).

Recherchez les valeurs valides avec la recherche de ciblage de l’API Marketing : https://graph.facebook.com/{API_VERSION}/search. Vous devez indiquer votre chaîne de requête au format UTF8.

Statut de l’option de ciblage

Pour vérifier le statut actuel et/ou planifié des objets de ciblage, utilisez le paramètre targeting_option_list :

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

Réponse :

{"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"}]}]

Champs renvoyés

Ciblage géographique

Effectuez une recherche du ciblage par pays, groupe de pays, ville, état/province/département, code postal et autres zones géographiques avec type=adgeolocation. Vous pouvez indiquer des paramètres facultatifs avec type=adgeolocation. Pour rechercher le code de pays des États-Unis :

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

Réponse :

{
  "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 est un nombre fixe unique par catégorie ; des pays ou des groupes de pays, par exemple. Les autres champs, dont name, peuvent faire l’objet de modifications. Utilisez key pour définir des spécifications de ciblage.

Dans la réponse :

• si supports_region est défini sur true, ce pays comporte des codes de région ;
• si supports_city est défini sur true, ce pays comporte des codes de ville.

Pays

Un code de pays est associé à tous les pays que vous pouvez cibler. Paramètres facultatifs pour type=adgeolocation&location_types=['country'] :

Groupe de pays

Tous les groupes de pays possèdent un code à rechercher et reçoivent une liste de pays. Pour tous les groupes de pays nommés 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

Réponse :

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

Si is_worldwide est défini sur true, il s’agit d’un groupe mondial. Si supports_region est défini sur true, le groupe de pays comporte des codes de région. Si supports_city est défini sur true, le groupe comporte des codes de ville.

Régions

Pour rechercher toutes les régions commençant par le code al :

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

Réponse :

{
  "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
    }
  ]
}

Options pour type=adgeolocation&location_types=['region'] :

Si supports_region est défini sur true, vous pouvez cibler cette région. Si supports_city est défini sur true, la région comporte des codes de ville.

Villes

Depuis mars 2019, nous avons modifié le rôle de plusieurs villes, mais vous pouvez continuer à utiliser city. Vous obtiendrez des résultats de recherche pour les anciennes villes.

Pour rechercher des codes pour toutes les villes commençant par Manhattan :

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

Réponse :

{
  "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"
    },
   ...

Si supports_region est défini sur true, la région correspondant à cette ville est disponible pour le ciblage. Si supports_city est défini sur true, cette ville est disponible pour le ciblage.

Zones géographiques

D’autres zones géographiques sont à votre disposition pour le ciblage. Certaines de ces zones sont encore à définir, comme mentionné ci-dessous.

La hiérarchie des zones géographiques se présente comme suit, de la plus grande à la plus petite :

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

Code postal

Vous pouvez également rechercher des codes postaux pour effectuer un ciblage sur Facebook. Pour ce type de recherche, il est conseillé d’utiliser adgeolocation avec location_types=['zip']. Accédez aux Pages d’aide Meta pour afficher la liste des pays dont les codes postaux sont pris en charge.

Recherche des codes postaux commençant par 9 :

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

Réponse :

{
  "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
    }
  ]
}

Paramètres régionaux

Paramètres régionaux pouvant faire l’objet d’un ciblage par code. Pour rechercher tous les paramètres régionaux commençant par en :

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

Réponse :

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

Codes DMA

Pour obtenir ces codes, indiquez type=adgeolocation et location_types=['geo_market'] dans votre requête. Pour rechercher des codes DMA commençant par « New » :

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

Résultat :

{
  "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
    },
    {
....
    }
  ]
}

Circonscriptions électorales

Pour rechercher les circonscriptions électorales à cibler, indiquez type=adgeolocation et location_types=['electoral_district']. Pour rechercher des circonscriptions électorales en Californie :

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

Réponse :

{
  "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
    },
 ...
}

Métadonnées des zones géographiques

Vous pouvez utiliser d’autres paramètres facultatifs avec type=adgeolocationmeta :

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

La réponse est un objet JSON avec des métadonnées pour les zones géographiques spécifiées :

{
  "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
      }
    }
  }
}

Les valeurs possibles sont les suivantes :

Suggestions de rayons

Pour effectuer un ciblage autour d’un lieu bien précis, vous pouvez utiliser suggested_radius afin d’obtenir une suggestion de rayon ciblant suffisamment de personnes :

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

La réponse est un objet JSON avec suggested_radius et distance_unit.

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

Exemple de récupération de suggested_radius avec un paramètre distance_unit spécifié :

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"
    }
  ]
}

Utilisez les paramètres suivants :

Voir aussi les Publicités de sensibilisation locale à utiliser avec les suggestions.

Centres d’intérêt

Envoyez une requête GET au point de terminaison /search et définissez type sur adinterest, et q sur le centre d’intérêt à rechercher :

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

Les champs suivants sont renvoyés :

Suggestions basées sur les centres d’intérêt

Envoyez une requête GET au point de terminaison /search et définissez type sur adinterestsuggestion pour obtenir une liste de suggestions de centres d’intérêt basés sur le vôtre.

Exemple de requête

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

Exemple de réponse

{
  "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
  }

Options possibles :

Limites

• Une recherche ne renverra pas tous les centres d’intérêt disponibles.
• Les centres d’intérêt peuvent être renommés à tout moment et la validation par nom peut échouer lorsque cela se produit. Il est donc conseillé de valider les centres d’intérêt par interest_fbid_list plutôt que par nom. Vérifiez si les termes sont valides en effectuant une requête avec type=adinterestvalid et avec le centre d’intérêt à valider :

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

Réponse :

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

Les valeurs possibles sont les suivantes :

Centres d’intérêt

Pour parcourir les centres d’intérêt qu’il est possible de cibler, envoyez une demande GET au point de terminaison /search en définissant type sur adTargetingCategory, et class sur interests.

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

Limites

• Une recherche ne renverra pas tous les centres d’intérêt disponibles.

Comportements

Vous pouvez effectuer un ciblage en fonction des actions ou du comportement d’achat passé d’un utilisateur ou d’une utilisatrice. Pour récupérer toutes les options de ciblage comportemental possibles, utilisez type=adTargetingCategory&class=behaviors.

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

La réponse contient les données suivantes :

Données démographiques

Ces données incluent le lieu de travail, le niveau d’éducation, les types d’intitulé du poste et les types de situation amoureuse. Vous pouvez également effectuer un ciblage en fonction de l’ancienneté d’un évènement marquant : 3 mois, 6 mois et 1 an. Vous pouvez faire référence aux établissements scolaires à cibler en utilisant un ID et un nom.

Pour rechercher tous les établissements scolaires commençant par ha :

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

Réponse :

 {
  "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
    }
  ]
}

Matières principales enseignées

Vous pouvez cibler les matières principales par ID et par nom. Pour rechercher toutes les matières principales commençant par ph :

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

Réponse :

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

Employeur

Vous pouvez référencer les employeurs pouvant faire l’objet d’un ciblage par ID et par nom. Pour rechercher tous les employeurs commençant par mic :

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

Réponse :

{
  "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
    }
  ]
}

Intitulé du poste

Un ID et un nom sont associés à tous les intitulés de poste auto-déclarés pouvant faire l’objet d’un ciblage. Pour obtenir tous les intitulés de poste incluant Business Analyst :

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

Réponse :

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

La réponse comprend les champs suivants :

Les paramètres suivants sont utilisés couramment pour cette API. Pour connaître les paramètres d’entrée propres à un type, reportez-vous aux informations ci-dessous.

Fournissez le type approprié en fonction de la catégorie de données à remplissage automatique. Pour récupérer des paramètres régionaux, indiquez type=adlocale. Les catégories valides sont les suivantes :

Exploration des données démographiques

Pour récupérer toutes les options de ciblage démographique possibles, utilisez type=adTargetingCategory et class.

La réponse contient les champs suivants :