Personnalisation des éléments de placement

Cette solution permet de personnaliser les éléments de contenu publicitaire affichés dans différents placementspublicitaires. Gardez le contrôle sur le contenu publicitaire tout en utilisant plusieurs placements différents.

L’API de personnalisation des éléments de placement est l’une de nos trois API qui utilisent les règles de personnalisation des éléments. Découvrez d’autres informations sur les Règles de personnalisation des éléments.

Premiers pas

Étape 1 : Créer une campagne publicitaire et un ensemble de publicités
Étape 2 : Fournir un contenu publicitaire et personnaliser les éléments
Étape 3 : Créer une publicité
Étape 4 (facultative) : Obtenir des insights et analyser les résultats
Étape 5 (facultative) : Lire le contenu publicitaire

Il n’est plus possible de personnaliser des éléments de placement à partir de publications existantes via l’API. Cette option est uniquement disponible dans le Gestionnaire de publicités.

Étape 2 : Fournir un contenu publicitaire

Utilisez asset_feed_spec pour fournir un contenu publicitaire. Vous pouvez spécifier plusieurs éléments de contenu publicitaire pour chaque type d’élément, y compris des images, des vidéos, des carrousels, des titres et du contenu destiné au corps du texte. Ne fournissez qu’une description de lien, car celle-ci ne peut pas être personnalisée en fonction du placement.

Pour personnaliser les éléments :

Définissez des asset_customization_rules dans votre asset_feed_spec.
Pour chaque règle, ajoutez customization_spec et les étiquettes des éléments.

Pour qu’il soit possible de personnaliser les éléments de placement, chaque asset_feed_spec doit être associé à plusieurs règles de personnalisation.

Voir Règles de personnalisation des éléments.

Propriétés prises en charge

Nom de propriété Description

Nom de propriété	Description
`customization_spec` type : Champs pris en charge	Obligatoire. Placements d’affichage des éléments.
`image_label` format : `{"name": "{LABEL_NAME}"}`	Obligatoire pour le format `SINGLE_IMAGE`. Étiquette de l’image à afficher. Elle est associée aux éléments image de votre `asset_feed_spec`.
`video_label` format : `{"name": "{LABEL_NAME}"}`	Obligatoire pour le format `SINGLE_VIDEO`. Étiquette de la vidéo que vous souhaitez afficher. Elle est associée aux éléments vidéo de votre `asset_feed_spec`.
`carousel_label` format : `{"name": "{LABEL_NAME}"}`	Obligatoire pour le format `CAROUSELS`. Étiquette du carrousel à afficher. Elle est associée aux éléments carrousel de votre `asset_feed_spec`. Remarque : si vous fournissez des carrousels via la personnalisation des éléments de placement, toutes les pièces jointes enfants doivent être définies dans la spécification du flux d’éléments et référencées via les étiquettes de publicité. Les pièces jointes enfants ne peuvent pas être définies en ligne. Voir Options de spécification du flux d’éléments pour en savoir plus sur le format `carousels`.

customization_spec

type : Champs pris en charge

Obligatoire.

Placements d’affichage des éléments.

image_label

format : {"name": "{LABEL_NAME}"}

Obligatoire pour le format SINGLE_IMAGE.

Étiquette de l’image à afficher. Elle est associée aux éléments image de votre asset_feed_spec.

video_label

format : {"name": "{LABEL_NAME}"}

Obligatoire pour le format SINGLE_VIDEO.

Étiquette de la vidéo que vous souhaitez afficher. Elle est associée aux éléments vidéo de votre asset_feed_spec.

carousel_label
format : {"name": "{LABEL_NAME}"}

Obligatoire pour le format CAROUSELS.

Étiquette du carrousel à afficher. Elle est associée aux éléments carrousel de votre asset_feed_spec.

Remarque : si vous fournissez des carrousels via la personnalisation des éléments de placement, toutes les pièces jointes enfants doivent être définies dans la spécification du flux d’éléments et référencées via les étiquettes de publicité. Les pièces jointes enfants ne peuvent pas être définies en ligne. Voir Options de spécification du flux d’éléments pour en savoir plus sur le format carousels.

Champs pris en charge dans `customization_spec`

Nom de propriété	Description
`publisher_platforms`	Obligatoire. Placements possibles pour votre publicité. Les différentes options possibles sont : `facebook`, `instagram`, `messenger` et `audience_network`.
`facebook_positions`	Facultatif, mais obligatoire si Facebook est sélectionné dans `publisher_platforms`. Placement spécifique à Facebook. Les différentes options possibles sont : `feed`, `right_hand_column`, `marketplace`, `video_feeds`, `search` et `story`.
`instagram_positions`	Facultatif, mais obligatoire si Instagram est sélectionné dans `publisher_platforms`. Placements spécifiques à Instagram. Les différentes options possibles sont : `stream`, `story`, `explore`, `explore_home`, `profile_feed` et `ig_search`. Remarque : Le placement `explore_home` ne prend en charge que le format `SINGLE_IMAGE`.
`messenger_positions`	Facultatif, mais obligatoire si Messenger est sélectionné dans `publisher_platforms`. Placements spécifiques à Messenger. Les différentes options possibles sont : `messenger_home`, `sponsored_messages` et `story`.
`audience_network_positions`	Facultatif, mais obligatoire si Audience Networks est sélectionné dans `publisher_platforms`. Placement spécifique à Audience Network. Les différentes options possibles sont : `classic`, `instream_video` et `rewarded_video`.

Découvrez d’autres informations sur les différentes options de placement disponibles.

Exemple : configuration du flux

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }' \
  -F 'asset_feed_spec={
      "videos": [
      {
        "adlabels": [
          {
            "name": "labelfb"
          }
        ],
        "video_id": "<VIDEO_ID>"
      },
      {
        "adlabels": [
          {
            "name": "labelig"
          }
        ],
        "video_id": "<VIDEO_ID>"
      }
    ],
    "bodies": [
      {
        "text": "Begin Your Adventure"
      }
    ],
    "link_urls": [
      {
        "website_url": "<WEBSITE_URL>",
        "display_url": "<DISPLAY_URL>"
      }
    ],
    "titles": [
      {
        "text": "Level Up"
      }
    ],
    "ad_formats": [
      "SINGLE_VIDEO"
    ],
    "call_to_action_types": [
      "WATCH_MORE"
    ],
    "descriptions": [
      {
        "text": "Description"
      }
    ],
    "asset_customization_rules": [
      {
        "customization_spec": {          
          "publisher_platforms": [
            "facebook"
          ],          
          "facebook_positions": [
            "feed",
            "instream_video"
          ]
        },
        "video_label": {
          "name": "labelfb"
        }
      },
      {
        "customization_spec": {          
          "publisher_platforms": [
            "instagram"
          ],          
          "instagram_positions": [
            "stream"           
          ]
        },
        "video_label": {
          "name": "labelig"
        }
      }
    ]
  }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Exemple : personnalisation des éléments de l’accueil Explorer Instagram

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE-ID>",
       "instagram_actor_id": "<INSTAGRAM-ID>",
     }' \
  -F 'asset_feed_spec={
        "ad_formats": [
          "SINGLE_IMAGE"
        ],
        "asset_customization_rules": [
          {
            "image_label": {
              "name": "<IMAGE-LABEL>"
            },
            "customization_spec": {
              "publisher_platforms": [
                "instagram"
              ],
              "instagram_positions": [
                "explore_home"
              ]
            }
          }
        ],
        "bodies": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "call_to_action_types": [
          "LEARN_MORE"
        ],
        "images": [
          {
            "hash": "<IMAGE-HASH>",
            "adlabels": [
              {
                "name": "adlabel1"
              }
            ]
          },
          {
            "hash": "<IMAGE-HASH>",
            "image_crops": {
              "100x100": [
                [
                  604,
                  0
                ],
                [
                  1659,
                  1055
                ]
              ]
            },
            "adlabels": [
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "link_urls": [
          {
            "website_url": "",
            "display_url": "",
            "deeplink_url": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "optimization_type": "PLACEMENT",
        "titles": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ]
      }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Exemple : personnalisation des éléments des résultats de recherche dans Instagram

curl 
  -F 'object_story_spec={
       "page_id": "<PAGE-ID>",
       "instagram_actor_id": "<INSTAGRAM-ID>",
     }' \
  -F 'asset_feed_spec={
        "ad_formats": [
          "SINGLE_IMAGE"
        ],
        "asset_customization_rules": [
          {
            "image_label": {
              "name": "placement_asset_f1048d832ecd558_1661539731099"
            },
            "customization_spec": {
              "publisher_platforms": [
                "instagram"
              ],
              "instagram_positions": [
                "ig_search"
              ]
            }
          }
        ],
        "bodies": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "call_to_action_types": [
          "LEARN_MORE"
        ],
        "images": [
          {
            "hash": "9ffd7307eae1f9c6e5250fc8760d285f",
            "adlabels": [
              {
                "name": "adlabel1"
              }
            ]
          },
          {
            "hash": "9ffd7307eae1f9c6e5250fc8760d285f",
            "image_crops": {
              "100x100": [
                [
                  604,
                  0
                ],
                [
                  1659,
                  1055
                ]
              ]
            },
            "adlabels": [
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "link_urls": [
          {
            "website_url": "<WEBSITE_URL>",
            "display_url": "<DISPLAY_URL>",
            "deeplink_url": "<DEEPLINK_URL>",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "optimization_type": "PLACEMENT",
        "titles": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ]
      }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Consultez toutes les options disponibles pour la spécification du flux d’éléments.

Étape 5 (facultative) : Lire le contenu publicitaire

Pour les publicités avec personnalisation des éléments de placement, les champs de contenu publicitaire relatifs à Instagram doivent être récupérés via {ad-account-id}/ads. Par exemple :