API Marketing

Audiences personnalisées des interactions

Créez des audiences basées sur les personnes qui ont interagi avec votre contenu sur Facebook ou Instagram. Les types d’audience actuellement pris en charge comprennent les Pages, les profils professionnels Instagram, les publicités à formulaire, les publicités Instant Experience, les achats et la réalité augmentée.

Ce guide décrit l’API en utilisant les audiences des interactions de Page comme exemple. Facebook met à jour votre audience personnalisée pour les interactions de Page en ajoutant continuellement les utilisateur·ices qui interagissent avec votre Page. Lorsque vous créez l’audience, Facebook peut la préremplir avec une liste de personnes ayant interagi avec votre Page dans la période de rétention donnée.

  • Depuis septembre 2018, nous ne prenons plus en charge subtype pour les audiences personnalisées de sites web et d’applications, les audiences personnalisées des interactions et les audiences des données de conversion hors ligne. En revanche, subtype est pris en charge par les audiences personnalisées des interactions pour les vidéos.

  • Si vous créez des audiences depuis l’Europe ou ciblez des personnes en Europe, consultez notre document sur les modifications non associées à une version du 2 décembre 2020.

Création d’une audience

Pour créer une audience personnalisée des interactions, votre compte publicitaire doit accepter les Conditions de service des audiences personnalisées dans le Gestionnaire de publicités.

Pour créer une audience répertoriant les utilisateur·ices ayant interagi avec votre Page en fonction de l’évènement page_engaged :

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Paramètres

NomDescription

name

chaîne

Obligatoire.
Nom de l’audience personnalisée.

rule

objet JSON

Obligatoire.
Règles pour définir l’audience. Suit la même syntaxe que l’audience personnalisée de site web.

Les audiences personnalisées des interactions constituent un type d’audience personnalisée. Les champs disponibles sont décrits dans la référence sur les audiences personnalisées.

Remarque : Chaque compte publicitaire peut créer jusqu’à 500 audiences personnalisées des interactions.

Règles d’interaction

Vous pouvez déterminer si Facebook ajoute ou non une personne à une audience personnalisée grâce aux règles relatives aux audiences.

Indiquez les champs type et id dans le paramètre event_sources de la règle afin de définir le type et l’id de l’objet d’interaction. Le champ id accepte un ID d’objet unique ou un tableau d’ID de même type.

Voici les types de sources d’évènements pris en charge et les types d’ID d’objet interaction correspondants :

  • page : ID de page Facebook.
  • lead : ID de formulaire de prospection.
  • ig_lead_generation : ID de formulaire de prospection.
  • canvas : ID de canvas.
  • ig_business : ID de profil professionnel Instagram.
  • shopping_page : ID de page d’une boutique Facebook.
  • shopping_ig : ID d’une boutique Instagram.
  • ar_experience : Instant Experience qui utilise un effet AR.
  • ar_effects : effet Facebook ou Instagram que vous possédez. Cela n’inclut pas les effets utilisés dans des publicités.

Chaque règle comporte un object_id et un event_name.

Pages

Configurez object_id sur l’ID de votre Page. Sous event_name, utilisez l’un des évènements d’interaction suivants :

  • page_engaged : personnes qui ont visité votre Page ou interagi avec l’un de ses contenus ou l’une de ses publicités, sur Facebook ou sur Messenger. C’est le type d’interaction le plus inclusif, car il comprend tous les autres types d’interaction.
  • page_visited : personnes qui ont visité votre Page.
  • page_liked : personnes qui aiment actuellement votre Page. (En savoir plus sur la rétention et sur les règles liées aux mentions J’aime la Page.)
  • page_messaged : personnes qui ont envoyé un message à votre Page.
  • page_cta_clicked : personnes qui ont cliqué sur un bouton call-to-action de votre Page (comme « Nous contacter » ou « Acheter »).
  • page_or_post_save : personnes qui ont enregistré votre Page ou l’une de vos publications de Page.
  • page_post_interaction : personnes qui ont interagi avec l’une de vos publications de Page. Les interactions comprennent les réactions (mentions J’aime, J’adore, Haha, Wouah, Triste, Grrr), les partages, les commentaires, les clics sur les liens et les défilements de carrousel.

Publicités à formulaire

Configurez object_id sur FORM_ID et définissez la règle rule de manière à effectuer le suivi de l’un des évènements de publicité à formulaire suivants :

  • lead_generation_submitted : ensemble des utilisateurs et utilisatrices qui ont rempli le formulaire et l’ont envoyé.
  • lead_generation_dropoff : ensemble des utilisateurs et utilisatrices qui ont fermé le formulaire sans l’envoyer, qu’ils ou elles aient renseigné des champs ou non.
  • lead_generation_opened : ensemble des utilisateurs et utilisatrices qui ont ouvert le formulaire de génération de prospects, qu’ils ou elles l’aient envoyé ou non.

Instant Experience

Définissez object_id sur "CANVAS_ID". La règle rule doit suivre l’un des évènements suivants :

  • instant_shopping_document_open
  • instant_shopping_document_pause
  • instant_shopping_document_resume
  • instant_shopping_document_close
  • instant_shopping_did_scroll
  • instant_shopping_element_click
  • instant_shopping_element_impression

Profil professionnel Instagram

object_id doit être "INSTAGRAM_BUSINESS_PROFILE_ID" et rule doit suivre l’un des évènements de profil professionnel Instagram suivants :

  • ig_business_profile_all : personnes qui ont visité votre profil professionnel Instagram ou interagi avec l’un de ses contenus ou l’une de ses publicités. C’est le type d’interaction le plus inclusif, car il comprend tous les autres types d’interaction. Il inclut ig_business_profile_engaged, ig_user_messaged_business et ig_user_messaged_business.
  • ig_business_profile_engaged : personnes qui ont interagi avec votre profil professionnel Instagram, l’un de ses contenus ou l’une de ses publicités.
  • ig_user_messaged_business : personnes qui ont envoyé un message à votre profil professionnel Instagram.
  • ig_business_profile_visit : personnes qui ont visité votre profil professionnel Instagram.
  • ig_business_profile_ad_saved : personnes qui ont enregistré une publicité ou du contenu organique à partir de votre profil professionnel Instagram.
  • ig_ad_like
  • ig_ad_comment
  • ig_ad_share
  • ig_ad_save
  • ig_ad_cta_click
  • ig_ad_carousel_swipe
  • ig_organic_like
  • ig_organic_comment
  • ig_organic_share
  • ig_organic_save
  • ig_organic_swipe
  • ig_organic_carousel_swipe

Le type Créateur multimédia Instagram n’est actuellement pas pris en charge pour la création d’audiences personnalisées des interactions par vidéo.

Achats

La règle d’interaction d’achats doit suivre l’un des évènements suivants :

  • VIEW_CONTENT : personnes qui ont consulté la page de détails de votre produit. Cette option est disponible dans le monde entier.
  • ADD_TO_CART : personnes qui ont ajouté votre produit à leur panier. Cette option est réservée aux entreprises qui ont activé le paiement, et disponible uniquement pour les consommateurs aux États-Unis.
  • PURCHASE : personnes qui ont acheté vos produits. Cette option est réservée aux entreprises qui ont activé le paiement, et disponible uniquement pour les consommateurs aux États-Unis.

Pour créer une règle qui ajoute les personnes qui ont consulté votre produit :

curl -i -X POST
-F 'name="test_api"'\
-F 'rule= {
	"inclusions": {
		"operator": "or",
		"rules": [
			{
				"event_sources": [
					{
						"id": "<ID>",
						"type": "shopping_ig"
					}
				]
				"retention_seconds": <RETENTION_SECONDS>,
				"filter": {
					"operator": "and",
					"filters": [
						{
						"field":"event",
						"operator":"eq",
						"value": "VIEW_CONTENT"
						}
					]
				}
			}
		]
	}
}
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Les paramètres page_messaged et ig_user_messaged_business peuvent ne pas être disponibles en Europe en raison des nouvelles règles de confidentialité.

Réalité augmentée

Les audiences personnalisées d’interaction avec la réalité augmentée peuvent contenir deux parties : les expériences AR et les effets AR.

  • Pour les audiences personnalisées d’interaction avec les expériences AR, configurez object_id sur l’ID du conteneur de données des publicités AR, et le champ event_name sur ar_camera_open ou camera_cta_click.
  • Pour les audiences personnalisées d’interaction avec les effets AR, configurez object_id sur l’ID de l’effet AR et event_name sur ar_effect_open.

Nombre max. de jours de rétention

Pour des raisons légales et de confidentialité, chaque type de source d’évènement est associé à un nombre maximal de jours de rétention différent :

  • Publicités de génération de prospects : 90 jours
  • Profil professionnel Instagram : 730 jours
  • Page : 730 jours
  • Instant Experiences, anciennement Canvas : 730 jours
  • Achats : 365 jours. Les données sont disponibles depuis avril 2020.
  • Réalité augmentée : 365 jours

Règles d’interaction avec section Exclusion

Les règles d’audience des interactions sont compatibles avec les règles d’audiences personnalisées de votre site web. Par conséquent, elles peuvent comporter plusieurs règles d’inclusion et d’exclusion. Les utilisateurs satisfaisant à au moins une des règles seront ajoutés à cette audience.

Dans l’exemple suivant, nous créons une audience qui inclut les utilisateurs qui ont visité votre page ou interagi avec elle, mais qui exclut les personnes ayant cliqué sur l’appel à l’action :

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       },
       "exclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_cta_clicked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Pour en savoir plus, consultez la section Audiences personnalisées de site web.

Règles multiples

Notez qu’une audience des interactions peut posséder plusieurs règles, et que les utilisateurs satisfaisant à au moins une des règles seront ajoutés à cette audience. Exemple de création d’une audience qui inclut les utilisateurs qui ont envoyé un message à votre page ou cliqué sur l’appel à l’action :

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 },
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Pages multiples

Les règles ne se limitent pas à une seule page. Vous pouvez avoir une page différente pour chaque règle. Dans ce cas, les personnes qui ont interagi avec au moins une des pages seront ajoutées à l’audience.

Voici un exemple d’audience qui inclut toutes les personnes ayant visité au moins une des trois pages suivantes :

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               },
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences

Pour plus de détails sur les audiences personnalisées, voir Audience personnalisée, Référence.

Rétention et règles des mentions J’aime la Page

Les audiences des mentions J’aime la Page n’ont pas de durée de rétention (retention_seconds=0). De même, les règles des mentions J’aime la Page ne peuvent pas être associées à d’autres évènements de Page.

L’exemple suivant montre comment créer une audience des mentions J’aime la Page :

curl -X POST \
  -F 'name="Page Likes Audience Name"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 0,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_liked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/customaudiences