API Marketing

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.

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

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.

Valeurs acceptées :

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

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':6003263791114}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsuggestions

Indiquez ces paramètres :

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.

Valeurs acceptées :

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

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

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

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.