Ciblage avancé

À l’aide de la Recherche de ciblage, vous pouvez trouver un type de ciblage particulier en un seul appel d’API. Avec l’API Detailed Targeting, vous pouvez rechercher plusieurs types de ciblage en une seule demande. Vous pouvez également obtenir des suggestions basées sur votre requête.

L’API comporte quatre points de terminaison : Rechercher, Suggestions, Parcourir et Validation.

La réponse pour ces points de terminaison contient les éléments suivants :

Nom	Description
`id` type : chaîne	ID de l’audience cible
`name` type : chaîne	Nom de l’audience cible
`audience_size_lower_bound` nombre entier	Estimation de la taille minimale de l’audience cible
`audience_size_upper_bound` nombre entier	Estimation de la taille maximale de l’audience cible
`path` type : tableau de chaînes	Inclut la catégorie et toutes les catégories parentes auxquelles appartient le ciblage.
`description` type : chaîne	Brève description de l’audience cible

Si vous ne spécifiez pas le limit_type, nous filtrons les résultats de moins de 2 000 personnes en quatre catégories : work_employers, work_positions, education_majors, education_schools. Autrement, vous obtiendrez des résultats moins intéressants. Si vous utilisez le limit_type, nous filtrons pour l'une de ces quatre catégories et ne renvoyons pas toutes les données.

Rechercher

Permet de récupérer les audiences cibles pour vos publicités qui correspondent à votre recherche. Vous pouvez indiquer les paramètres suivants à ce point de terminaison :

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

Nom Description

Nom	Description
`q` type : chaîne	Obligatoire. Chaîne de requête
`limit` type : nombre entier	Facultatif. Nombre de résultats
`limit_type` type : chaîne	Facultatif. Limite le type d'audience à récupérer. Par défaut, tous les types sont inclus.
`locale` type : chaîne	Facultatif. Langue dans laquelle doivent être affichés les noms et les descriptions des audiences, le cas échéant. Par défaut, il s’agit de la langue du compte publicitaire.

q

type : chaîne

Obligatoire.

Chaîne de requête

limit

type : nombre entier

Facultatif.

Nombre de résultats

limit_type

type : chaîne

Facultatif.

Limite le type d'audience à récupérer. Par défaut, tous les types sont inclus.

locale

type : chaîne

Facultatif.

Langue dans laquelle doivent être affichés les noms et les descriptions des audiences, le cas échéant. Par défaut, il s’agit de la langue du compte publicitaire.

Suggestions

Renvoie des audiences supplémentaires que vous pouvez cibler sur la base de quelques audiences sélectionnées que vous spécifiez.

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

Indiquez ces paramètres :

Nom Description

Nom	Description
`targeting_list` type : tableau de `{'type':'{TYPE}', 'id':{ID}}`	Obligatoire. Tableau de paires `{'type':'{TYPE}', 'id':{ID}}` comme audience d’entrée pour les suggestions.
`limit` type : nombre entier	Facultatif. Nombre de résultats. La valeur par défaut est 30. La valeur maximale est 45.
`limit_type` type : chaîne	Facultatif. Limite le type d'audience à récupérer. Par défaut, tous les types sont inclus.
`locale` type : chaîne	Facultatif. Langue dans laquelle doivent être affichés les noms et les descriptions des audiences. Par défaut, il s’agit de la langue du compte publicitaire.

targeting_list

type : tableau de {'type':'{TYPE}', 'id':{ID}}

Obligatoire.

Tableau de paires {'type':'{TYPE}', 'id':{ID}} comme audience d’entrée pour les suggestions.

limit

type : nombre entier

Facultatif.

Nombre de résultats. La valeur par défaut est 30. La valeur maximale est 45.

limit_type

type : chaîne

Facultatif.

Limite le type d'audience à récupérer. Par défaut, tous les types sont inclus.

locale

type : chaîne

Facultatif.

Langue dans laquelle doivent être affichés les noms et les descriptions des audiences. Par défaut, il s’agit de la langue du compte publicitaire.

Parcourir

Permet d’obtenir un ciblage dans une taxonomie structurée pour les catégories Facebook, les fournisseurs de données tiers et certains centres d’intérêt. Les résultats de ce point de terminaison apparaissent dans la fonctionnalité Parcourir du composant UI Ciblage avancé du Gestionnaire de publicités.

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

Indiquez les paramètres optionnels suivants :

Nom Description

Nom	Description
`limit_type` type : chaîne	Limite le type d'audience à récupérer. Par défaut, tous les types sont inclus.
`locale` type : chaîne	Langue dans laquelle doivent être affichés les noms et les descriptions des audiences. Par défaut, il s’agit de la langue du compte publicitaire.

limit_type

type : chaîne

Limite le type d'audience à récupérer. Par défaut, tous les types sont inclus.

locale

type : chaîne

Langue dans laquelle doivent être affichés les noms et les descriptions des audiences. Par défaut, il s’agit de la langue du compte publicitaire.

Validation

Permet de vérifier si une audience est valide pour le ciblage ou non. Cela est utile si vous avez déjà créé un ensemble de publicités et si vous souhaitez vérifier que sa spécification de ciblage est toujours valide. Si le ciblage n'est pas valide, vous devez le supprimer de la spécification de ciblage.

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

En plus des champs de réponse standard de ciblage avancé, ce point de terminaison renvoie également les données suivantes :

Nom description

Nom	description
`valid` type : booléen	Indique si l’audience de ciblage est valide ou non.

valid

type : booléen

Indique si l’audience de ciblage est valide ou non.

Voici la liste des paramètres d'entrée :

Nom	Description
`targeting_list` type : tableau de `{'type':'{TYPE}', 'id':{ID}}`	Tableau de paires `{'type':'{TYPE}', 'id':{ID}}` pour validation. Privilégié.
`id_list` type : tableau de chaînes	Tableau d’ID pour validation. Réussit uniquement si un ID est unique dans notre base de données d'audience.
`name_list` type : tableau de chaînes	Tableau de chaînes pour validation. Centres d’intérêts uniquement, non sensible à la casse.
`locale` type : chaîne	Langue dans laquelle doivent être affichés les noms et les descriptions des audiences. Par défaut, il s’agit de la langue du compte publicitaire.

Indiquez au moins l’un des éléments suivants : targeting_list, id_list et name_list.