Options de spécification du flux d’éléments

Voici les options que vous pouvez utiliser dans votre asset_feed_spec. Pour plus d’informations de référence, consultez la page relative à la spécification du flux d’éléments publicitaires.

Nom de propriété Description

images

type : tableau de liste

Obligatoire pour les formats SINGLE_IMAGE et CAROUSEL_IMAGE.

Ensemble d’images éligibles. Les images fournies dans cet ensemble doivent figurer dans la bibliothèque d’images du compte publicitaire.


Spécifiez ce champ sous la forme d’un tableau de liste contenant {"url": "{IMAGE_URL}", "hash": "{IMAGE_HASH}", "url_tags": "{TAG}"}. Indiquez obligatoirement soit l’élément url, soit l’élément hash.

videos

type : tableau de liste

Obligatoire pour le format SINGLE_VIDEO.

Ensemble d’éléments video_id. Les éléments video_id fournis dans cet ensemble doivent appartenir au compte publicitaire.


Spécifiez ce champ sous la forme d’un tableau de liste contenant {"video_id": "{VIDEO_ID}", "thumbnail_url": "{THUMBNAIL_URL}", "url_tags": "{TAG}"}.

carousels
type : tableau de liste

Facultatif.
Ensemble de child_attachments avec les booléens multi_share_end_card et multi_share_optimized, et des adlabels. Les child_attachments fournis dans cet ensemble doivent appartenir au compte publicitaire.



Spécifiez les child_attachments sous la forme d’un tableau de liste contenant {"image_label": {"name": "{IMAGE_LABEL}"}, "video_label": {"name": "{VIDEO_LABEL}"}, "title_label": {"name": "{TITLE_LABEL}"}, "description_label": {"name": "{DESC_LABEL}", "link_url_label": {"name": "{LINK_URL}"}}. Indiquez obligatoirement soit l’élément image_label, soit l’élément video_label.

bodies

type : tableau de liste

Facultatif.

Ensemble de corps de texte. Message principal ou texte de la publicité.


Spécifiez ce champ sous la forme d’un tableau de liste contenant {"text": "{BODY_TEXT}", "url_tags": "{TAG}"}.

call_to_action_types

type : tableau de liste

Obligatoire pour tous les objectifs, à l’exception de OUTCOME_AWARENESS.

Ensemble de valeurs de type call-to-action.


Spécifiez ce champ sous la forme d’un tableau de liste contenant {"{CALL_TO_ACTION}"}. Vous pouvez indiquer jusqu’à 5 valeurs.

titles

type : tableau de liste

Facultatif.

Ensemble de titres. Le terme « titre » désigne un titre bref de la publicité, généralement affiché à côté d’un lien, d’une image ou d’une vidéo.


Spécifiez ce champ sous la forme d’un tableau de liste contenant {"text": "{TITLE}", "url_tags": "{TAG}"}.

descriptions

type : tableau de liste

Facultatif.

Ensemble de textes descriptifs secondaires, qui sont moins mis en évidence que les corps de texte ou les titres. Ces textes apparaissent généralement à côté d’un lien, d’une image ou d’une vidéo. Si aucun texte descriptif n’est spécifié, Facebook extrait le lien que vous avez fourni pour le générer. Si vous ne souhaitez pas utiliser le texte extrait, entrez un seul espace pour définir une chaîne de description vierge.


Spécifiez ce champ sous la forme d’un tableau de liste contenant {"text": "{DESCRIPTION}", "url_tags": "{TAG}"}.

link_urls

type : tableau de liste

Obligatoire.

Ensemble d’URL de lien.


Spécifiez ce champ sous la forme d’un tableau de liste contenant {"website_url": "{URL}"}.

ad_formats

type : tableau de chaînes

Obligatoire.

Ensemble de formats publicitaires Facebook dans lesquels nous devons créer les publicités. Les formats pris en charge sont les suivants : SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO, AUTOMATIC_FORMAT.


Spécifiez ce champ sous la forme d’un tableau de chaînes ["{AD_FORMAT}"].

optimization_type

type : chaîne

Facultatif.

Type d’optimisation utilisé dans le flux d’éléments. Les valeurs possibles sont ASSET_CUSTOMIZATION, LANGUAGE, PLACEMENT et REGULAR.

message_extensions

type : tableau de chaînes

Facultatif.
Type d’extension de message utilisé dans le flux d’éléments.


Valeur possible : whatsapp

onsite_destinations
type : tableau de liste

Obligatoire pour les publicités Boutiques. Valable pour les publicités statiques ; format SINGLE_IMAGE, SINGLE_VIDEO ou CAROUSEL.
Spécifiez ce champ sous la forme d’un tableau de liste contenant l’une des valeurs suivantes pour spécifier la page de destination de votre boutique sur site.

{"storefront_shop_id": "<SHOP_STOREFRONT_ID>"}
or 
{"shop_collection_product_set_id": "<PRODUCT_SET_ID>" 
or 
{"details_page_product_id": "<PRODUCT_ID>"}

shops_bundle
type : booléen

Obligatoire pour les publicités Boutiques. Valable pour les publicités de catalogue Advantage+.
Spécifiez ce champ pour l’optimisation des boutiques. Inclut les types d’optimisation de boutique reasons_to_shop et automated_product_tags.
Valeurs possibles : true, false

reasons_to_shop
type : booléen

Obligatoire pour les publicités Boutiques. Valable pour les publicités de catalogue Advantage+.
Spécifiez ce champ pour l’optimisation des boutiques. Met automatiquement à la une certaines informations produit de votre boutique, telles que « Livraison gratuite », « Tendance » ou « Stock limité ».
Valeurs possibles : true, false

Restrictions de spécification du flux d’éléments

Formats publicitaires

  • ad_formats pris en charge : SINGLE_IMAGE, CAROUSEL, SINGLE_VIDEO et AUTOMATIC_FORMAT.
  • Un seul paramètre ad_format est autorisé par flux d’éléments.
  • ad_format compte pour un élément dans un flux d’éléments.

Nombre d’éléments :

  • Maximum de 30 éléments au total. Par exemple, vous disposez de 28 éléments avec 10 images, 5 bodies, 5 titles, 5 description, 1 ad_format, 1 link_url et 1 call_to_action_types.
  • Nombre total d’images : <= 10.
  • Nombre total de vidéos : <= 10. Si vous utilisez Instagram comme placement, seules les vidéos au format carré ou paysage sont autorisées.
  • Nombre total de corps de texte : <= 5.
  • Nombre total de call-to-actions : <= 5.
  • Nombre total de titres : <= 5.
  • Nombre total de liens : <= 5.
  • Nombre total de descriptions : <= 5.

Exigences concernant les images :

  • Caractéristiques d’image recommandées : 1.9:1.
  • Taille d’image recommandée : 1 200 x 628 pixels.
  • Pour le format CAROUSEL_IMAGE, vous devez fournir au moins 2 images.
  • Si vous utilisez Instagram comme placement, optez pour des images carrées pour optimiser les performances.

Exigences concernant le texte :

  • Titre et texte de description : 255 caractères maximum.
  • Corps de texte : 1 024 caractères maximum.
  • Si vous ne spécifiez aucune description, nous extrayons le lien que vous avez fourni pour récupérer une description.
  • Pour CAROUSEL_IMAGE, les titres sont facultatifs.

Les url_tags sont facultatifs et uniquement disponibles pour images, videos, bodies, descriptions et titles. Facebook ajoute des url_tags à l’URL du lien en tant que paramètres pour chacun des éléments d’une publicité.

Par exemple, voici une combinaison de flux d’éléments valide pour le format SINGLE_IMAGE :

  • images
  • bodies
  • titles
  • descriptions
  • 1 format : SINGLE_IMAGE
  • link_urls
"link_urls=[{'website_url':'<WEBSITE_URL>'}, {'website_url':'<WEBSITE_URL>'}]" 

Utilisation de liens profonds

Vous pouvez utiliser des liens profonds dans les spécifications du flux d’éléments pour les campagnes avec les objectifs suivants :

  • APP_INSTALLS
  • CONVERSIONS
  • LINK_CLICKS

Pour ce faire, ajoutez deeplink_url dans link_urls lorsque vous créez votre asset_feed_spec.

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F "asset_feed_spec={'images': [{'hash':'image_hash'}], 'bodies': [{'text':'Body 1'}, {'text':'Body 2'}], 'titles': [{'text':'Title 1'}, {'text':'Title 2'}], 'descriptions': [{'text':' '}], 'ad_formats': ['SINGLE_IMAGE'], 'link_urls': [{'website_url':'App's object store URL','deeplink_url':'deeplink URL'}]}" \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
    

Site Web vers les publicités WhatsApp

Vous pouvez créer des publicités qui renvoient les internautes vers votre site Web présentant un bouton WhatsApp au bas de l’écran pour leur permettre de vous contacter instantanément. Les internautes pourront ainsi entrer en contact avec vous via WhatsApp tout en consultant votre site Web.

Pour ce faire, ajoutez message_extensions lorsque vous créez votre asset_feed_spec.

curl \
-F 'object_story_spec={
       "page_id": "<PAGE_ID>"
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>",
    }' \
-F 'asset_feed_spec={"images": [{"hash":"image_hash"}], "bodies": [{"text":"Body 1"}, {"text":"Body 2"}],"titles": [{"text":"Title 1"}, {"text":"Title 2"}], "descriptions": [{"text":" "}], "ad_formats": ["SINGLE_IMAGE"], "link_urls": [{"website_url":"business URL"}], "message_extensions": [{"type": "whatsapp"}]}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives