Contenu publicitaire

Personnalisation des éléments de segment

Cette solution permet de personnaliser les éléments publicitaires en fonction des types de ciblages géographiques. Pour les personnaliser en fonction des placements, voir Personnalisation des éléments de placement.

La personnalisation des éléments de segment est l’une des trois API utilisant des règles de personnalisation des éléments. Voir la page Règles de personnalisation des éléments.

Avec le déploiement de l’API Marketing V8.0, tous les cas d’utilisation sans lien avec la géolocalisation ont été abandonnés pour la Personnalisation des éléments de segment. Toutes les règles de ciblage doivent à présent intégrer des informations de géolocalisation à leur spécification de personnalisation. La règle par défaut fait exception. Elle n’a pas besoin d’inclure de géolocalisation.

Premiers pas

Avant de démarrer, vérifiez les restrictions concernant ce produit. Si votre cas d’utilisation satisfait à nos spécifications, passez aux étapes suivantes :

Étape 2 : fournir un contenu publicitaire

Options de personnalisation

La publicité peut être personnalisée en fonction des géolocalisations. Pour ce faire, créez une règle comportant une spécification de personnalisation. Le type de personnalisation suivant est pris en charge :

  • Géolocalisations : prise en charge de countries, regions, cities, geo_markets, zips et location_types.

Le format utilisé pour définir une spécification de personnalisation est similaire au format de ciblage principal. Voir la page Ciblage.

Créer des règles de personnalisation des éléments

Les règles de personnalisation des éléments permettent de regrouper les éléments qui apparaissent ensemble pour une géolocalisation donnée. Chaque règle comporte un paramètre customization_spec qui définit la géolocalisation des personnes visualisant les éléments au moment de la diffusion des publicités.

Lorsque vous créez une règle, vous pouvez définir une priorité. Dans le cas contraire, nous attribuons à chacune un numéro de priorité en fonction de sa position dans la liste de règles fournie. Par exemple, la priorité 1 est affectée à la première règle de la liste.

Pour éviter de fournir une combinaison aléatoire d’éléments aux personnes qui ne correspondent à aucune règle, configurez une règle par défaut. Pour ce faire, procédez comme suit :

  • Créez un paramètre customization_spec vide. À la fin de la règle, placez des accolades d’ouverture et de fermeture comme celles-ci : {}.
  • Attribuez à la règle la priorité la plus faible. Elle correspond au nombre total de règles, règle par défaut comprise. Avec 10 règles plus celle par défaut, la priorité de la règle par défaut est donc 11.

La règle par défaut associe un élément de contenu publicitaire aux personnes qui ne satisfont à aucune des règles précédentes.

Les règles de votre configuration non définies par défaut doivent correspondre à un pourcentage élevé de l’audience ciblée.

Configurer la spécification du fil d’éléments

Créez un paramètre asset_feed_spec et ajoutez vos règles de personnalisation au champ asset_customization_rules. Il est possible d’ajouter jusqu’à 50 règles de personnalisation.

Pour chaque règle, vous devez préciser les paramètres customization_spec et priority, ainsi que les étiquettes des éléments. Le paramètre customization_spec ne peut pas comporter plus de 50 conditions par règle.

Exemple de configuration d’un fil d’éléments :

curl \
-F 'object_story_spec={
       "page_id": "<YOUR_PAGE_ID>",
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>"
    }' \
-F 'asset_feed_spec={
 "images": [
   {"hash":"<IMAGE_HASH>", "adlabels":[{"name":"image1"}]}, 
   {"hash":"<IMAGE_HASH>", "adlabels":[{"name":"image2"}]}
 ], 
 "bodies": [
   {"text":"Motor City Mission Corps", "adlabels":[{"name":"body1"}]}
 ], 
 "titles": [
   {"text":"Link title 1 goes here", "adlabels":[{"name":"title1"}]}, 
   {"text":"Link title 2 goes here", "adlabels":[{"name":"title2"}]},
   {"text":"Link title 3 goes here", "adlabels":[{"name":"title3"}]}
 ], 
 "call_to_action_types":[
   "LEARN_MORE"
 ],
 "descriptions": [
   {"text":"Begin Your Adventure"}
 ], 
 "ad_formats": [
   "SINGLE_IMAGE"
 ], 
 "link_urls": [
   {"website_url":"https://www.example.com/"}
 ],
 "asset_customization_rules": [
   { 
     "customization_spec": {
        "geo_locations": {
          "countries": ["US"]
        }
     },
     "image_label": {"name": "image1"},
     "title_label": {"name": "title1"},
     "priority": 1
   },
   {
     "customization_spec": {
       "geo_locations": {
          "countries": ["GB"]
        }
     }, 
     "image_label": {"name": "image1"},
     "title_label": {"name": "title2"},
     "priority": 2
   },
   {
     "customization_spec": {
       "geo_locations": {
         "cities": [
           {"key": "2481714"},
           {"key": "2481868"}
         ]
       }
     },
     "image_label": {"name": "image1"},
     "title_label": {"name": "title3"},
     "priority": 4
   },
   {
     "customization_spec": {}, 
     "image_label": {"name":"image2"},
     "title_label": {"name":"title1"},
     "priority": 5
  }]}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

Consultez toutes les options disponibles pour la spécification du fil d’éléments. Consultez la page Règles de personnalisation des éléments pour continuer les étapes.

Étape 3 facultative : obtenir un aperçu de votre publicité

Affichez un aperçu des différentes versions des règles de ciblage de votre publicité à l’aide du point de terminaison /generatepreview. Il est également possible d’ajouter un champ dynamic_asset_label avec un numéro de priorité de règle pour voir une version linguistique spécifique.

Par exemple, pour afficher l’aperçu d’une règle de priorité 1 :

curl -G --data-urlencode 
'creative={ 
  "object_story_spec": { 
    "page_id": "<PAGE_ID>" 
  },
  "asset_feed_spec": {
    ...
    "asset_customization_rules": [
      { 
        "customization_spec": { 
          "geo_locations": { 
          "countries": ["US"] 
          } 
        },
        "image_label": {
          "name": "image1"
        },
        "title_label": {
          "name": "title1"
        },
        "priority": 1
    },
    ...
    ]
  }
}' 
-d 'ad_format=DESKTOP_FEED_STANDARD' 
-d 'dynamic_asset_label=1'
-d 'access_token=<ACCESS_TOKEN>' 
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/generatepreviews

Restrictions

Catégorie publicitaire spéciale : les annonceurs diffusant des publicités relatives au logement, à l’emploi et au crédit, et établis aux États-Unis ou diffusant des publicités destinées aux États-Unis sont soumis à des restrictions particulières. Ils doivent respecter les restrictions de Catégorie publicitaire spéciale appliquées à asset_feed_spec. En savoir plus sur la Catégorie publicitaire spéciale.

Campagne, Validation des objectifs : APP_ENGAGEMENT n’est pas pris en charge.

Placements pris en charge : tous les placements sont pris en charge.

Type d’achat : couverture et répétition ou AUCTION.

Personnalisation du placement : si la personnalisation du placement est utilisée dans l’une des règles, toutes les règles doivent l’intégrer.

Les restrictions asset_feed_spec sont identiques à celles des publicités basées sur un fil d’éléments sans règles de personnalisation, exception faite des points suivants :

  • Chaque image ou vidéo doit être associée à une étiquette.
  • Une seule image ou vidéo par paramètre asset_customization_rule est admissible pour affichage.
  • Formats publicitaires : deux paramètres ad_formats sont pris en charge (SINGLE_IMAGE et SINGLE_VIDEO). Un seul paramètre ad_format est autorisé par fil d’éléments.
  • Il n’est possible d’indiquer qu’un seul élément dans call_to_actions_types.
  • Pour chaque paramètre de placement du ciblage d’un ensemble de publicités, vous devez fournir au moins un paramètre asset_customization_rule.