API Marketing

Publicités de collection

Le format des publicités de collection inclut une Instant Experience qui facilite la découverte, la recherche et l’achat de produits et de services sur appareil mobile grâce à une expérience visuelle immersive. Votre publicité dans le fil présente quatre produits sous une image ou une vidéo principale qui s’ouvre dans une Instant Experience en mode plein écran lorsque quelqu’un interagit avec. Il existe deux types de publicités de collections : les publicités avec images et les publicités vidéo.

Prenez en considération toutes les références « Canvas » lorsque vous voulez représenter une Instant Experience, car il s’agit de l’ancien nom de ce format.

Vous pouvez créer une publicité au format collection en créant une Instant Experience. Commencez avec un modèle ou choisissez votre propre disposition personnalisée. Pour en savoir plus, reportez-vous aux Pages d’aide sur le format Instant Experience.

Vous pouvez également inclure des interfaces utilisateur·ice de création de publicités Facebook correspondant au format collection dans votre site web à l’aide du SDK JavaScript pour créer une boîte de dialogue Publicités de collection.

Pour des informations générales sur l’utilisation des collections, reportez-vous à :

Pour créer des collections utilisées dans les boutiques ou ajouter des métadonnées à un ensemble de produits, consultez la section sur l’API Product Set Collection de la page Plateforme de commerce.

For API calls, your AD_ACCOUNT_ID should be formatted as act_XXXXXXXXXXXXXXX.

Objectifs et placements pris en charge

Les publicités de collections peuvent être utilisées pour répondre aux objectifs suivants :

  • Trafic
  • Conversions
  • Ventes sur le catalogue produits (pris en charge lorsque vous utilisez les collections avec un ensemble de produits)
  • Visites en point de vente (pris en charge lorsque vous utilisez les collections avec un ensemble de produits)
  • Notoriété de la marque
  • Portée

Pour les objectifs Trafic et Conversions, vous pouvez également utiliser des diaporamas vidéo. Pour obtenir des informations complémentaires, consultez la section Pages d’aide pour les entreprises : Choisir le bon objectif publicitaire.

Les placements suivants sont pris en charge :

Pour obtenir des informations complémentaires sur les placements, consultez les Pages d’aide pour les entreprises À propos des placements et Placements publicitaires disponibles en fonction des objectifs marketing.

Publicités de collections à partir d’un ensemble de produits

Avant de créer votre publicité de collection, vous devez fournir un contenu publicitaire et une Instant Experience. Vous devez fournir au moins quatre éléments représentant des photos ou quatre éléments représentant des produits avec des tags de produit à afficher dans la rotation. Les éléments photo d’enfants dans un carrousel sont également valides.

Créez des publicités de collection à partir de votre catalogue. Une publicité de collection présente trois produits sous une image ou une vidéo principale et s’affiche dans le Fil sur mobile. Vous pouvez utiliser des diaporamas vidéo avec cette fonctionnalité.

La publicité apparaît dans le Fil et les personnes peuvent appuyer dessus pour afficher une expérience plein écran.

Pour utiliser un ensemble de produits, vous devez connaître le fonctionnement des publicités de catalogue Advantage+ et avoir déjà configuré un catalogue produits. Pour en savoir plus, consultez les pages Publicités de catalogue Advantage+ et Publicités de catalogue Advantage+, Catalogue produits.

Création de publicités

Lorsque vous créez une publicité de collection à partir d’ensembles de produits, vous devez créer également explicitement une publicité Instant Experience en fournissant les éléments corrects. Lorsque vous utilisez cette Instant Experience dans une publicité de collection, Facebook génère automatiquement la publicité de collection. Votre publicité Instant Experience doit contenir :

Image Instant Experience

Créez une Instant Experience avec une image :

curl \
  -F 'canvas_photo={ 
    "photo_id": "PHOTO_ID", 
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

Ou créez une Instant Experience avec une vidéo :

curl \
  -F 'canvas_video={ 
    "video_id": "VIDEO_ID", 
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

Ou créez une Instant Experience avec une vidéo modèle :

curl -X POST \
  -F canvas_template_video={
      "name": "Cover Image or Video",
	"bottom_padding": "0",
	"top_padding": "0",
	"product_set_id": <Product_Set_ID>,
	"template_video_spec": {
	    "customization": {
	        "text_color": "FFFFFF",
	        "text_background_color": "000000",
		  "name_template": "{{product.name}}",
		  "body_template": "{{product.current_price strip_zeros}}"
	    },
	}
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<PAGE_ID>/canvas_elements

Ensemble de produits Instant Experience

Ensuite, vous créez un canvas_product_set avec un product_set_id issu de votre catalogue produits. Vous devez définir l’option show_in_feed sur true pour créer une publicité de collection.

curl \
  -F 'canvas_product_set={ 
    "max_items": 50,
    "product_set_id": "<PRODUCT_SET_ID>",
    "item_headline": "{{product.name}}",
    "item_description": "{{product.current_price}}"
    "image_overlay_spec": {
      "overlay_template": "pill_with_text",
      "text_type": "price",
      "text_font": "dynads_hybrid_bold",
      "position": "top_left",
      "theme_color": "background_e50900_text_ffffff",
      "float_with_margin": true,
    },
    "storefront_setting": {
        "enable_sections": true,
        "customized_section_titles": [
            { "title_id": "popular", "customized_title": "My Populars" },
            { "title_id": "favorites", "customized_title": "My Favorites" }
        ],
        "product_set_layout": {
            "layout_type": "GRID_3COL"
        }
    },
    "retailer_item_ids": [0, 0, 0],
    "show_in_feed": true
  }' \
  https://graph.facebook.com/v19.0/<PAGE_ID>/canvas_elements

Remarque : dans les exemples ci-dessus, les champs item_headline, item_description, image_overlay_spec, storefront_setting et retailer_item_ids sont tous facultatifs. Auparavant, ces paramètres étaient spécifiés dans le même appel pour créer la publicité de collection et une ressource Instant Experience sous-jacente. Désormais, vous les associez à cet appel.

Renseignez tous les champs obligatoires dans le paramètre image_overlay_spec. Pour plus d’informations, consultez la section Données de lien de contenu publicitaire, Spécification de superposition d’image de la référence sur l’API Marketing.

Le paramètre storefront_setting prend en charge les champs product_set_layout, enable_sections et customized_section_titles.

Champs product_set_layout
NomDescription

layout_type

chaîne

Obligatoire.. Mode d’affichage de l’ensemble de produits.
Valeurs : GRID_2COL, GRID_3COL, CAROUSEL, HSCROLL_LIST

Pour pouvoir utiliser customized_section_titles, enable_sections doit être défini sur true. Le champ customized_section_titles requiert un ensemble d’objets, chacun avec les paramètres title_id et customized_title.

Champs customized_section_titles
NomDescription

title_id

chaîne

Obligatoire.
Chaîne d’énumération représentant la chaîne du titre de section par défaut que vous souhaitez remplacer.
Valeurs : keep_shopping, take_another_look, you_may_also_like, related_products, trending, popular, top_items, favorites, most_viewed, top_picks_for_you, suggested_for_you, featured_favorites, just_for_you, explore_more, shop_by_category

customized_title

chaîne

Obligatoire.
Autre chaîne personnalisée vue par le lecteur ou·la lectrice comme titre de section.

Pied de page Instant Experience

Créez le pied de page Instant Experience avec un lien.

curl \
  -F 'canvas_button={ 
    "rich_text": {
      "plain_text": "See more at www.abc.com."
    },
    "open_url_action": {
      "url": "https://www.abc.com"
    }
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

Si vous le souhaitez, vous pouvez également créer un bouton à utiliser dans le pied de page.

curl \
  -F 'canvas_footer={ 
    "child_elements": [BUTTON_ELEMENT_ID]
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements

Le texte que vous fournissez dans votre pied de page est relativement flexible. Par le passé, vous deviez fournir See more...., mais vous pouvez désormais fournir un texte personnalisé avec le bouton URL.

Instant Experience complète

curl \
  -F 'body_element_ids=[
    PHOTO/VIDEO_ELEMENT_ID,
    PRODUCT_SET_ELEMENT_ID,
    FOOTER_ELEMENT_ID
  ]' \
  -F 'is_published=true' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvases

Pour créer l’Instant Experience avec une vidéo modèle, un ensemble de produits, un bouton, une adresse de magasin et un pied de page facultatif que vous avez définis, vous devrez inclure le paramètre source_template_id :

curl \
  -F 'body_element_ids=[
    TEMPLATE_VIDEO_ELEMENT_ID,
    PRODUCT_SET_ELEMENT_ID,
    FOOTER_ELEMENT_ID
  ]' \
  -F 'name="Dynamic Video Instant Experience"', \
  -F 'source_template_id="1932289657009030"', \
  -F 'is_published=true' \
  https://graph.facebook.com/v19.0/<PAGE_ID\/canvases

Pour un modèle de boutique, vous devez spécifier source_template_id = 1932289657009030 qui est défini dans la section Utiliser des modèles dans Instant Experience. La disposition de chaque modèle est fixe. Toutefois, vous pouvez remplacer le contenu par défaut par vos vidéos dynamiques, produits, textes et liens. Pour plus d’informations, voir Utiliser des modèles dans Instant Experience.

Création de la publicité de collection avec l’Instant Experience

Enfin, vous devez créer une publicité de collection. Cela permet aux personnes de cliquer sur vos images ou sur votre élément vidéo à partir de votre publicité de collection.

Si le premier élément de votre publicité Instant Experience est une photo, vous devez définir object_type sur SHARE.

curl \
  -F 'name=Collection Sample Image Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "link": "https://fb.com/canvas_doc/CANVAS_ID", 
      "message": "AD_MESSAGE",
      "name": "AD_HEADLINE", 
    }, 
    "page_id": "PAGE_ID" 
  }' \
  -F 'object_type=SHARE' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

Si le premier élément de votre publicité Instant Experience est une vidéo, envoyez la requête suivante :

curl \
  -F 'name=Collection Sample Video Creative' \
  -F 'object_story_spec={ 
    "video_data": {
      "call_to_action": {
        "type":"LEARN_MORE",
        "value":{
          "link":"https://fb.com/canvas_doc/CANVAS_ID",
        }
      },
      "image_url": "THUMBNAIL_IMAGE_URL",
      "message": "AD_MESSAGE",
      "title": "AD_HEADLINE", 
    }, 
    "page_id": "PAGE_ID" 
  }' \
  -F 'object_type=VIDEO' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

Si le premier élément de votre publicité Instant Experience est une vidéo modèle, envoyez la requête suivante :

curl -X POST \
  -F 'name="Dynamic Video Collection Ad"' \
  -F 'adset_id=<ADSET_ID>' \
  -F 'status=PAUSED \
  -F 'creative={
       "object_story_spec": {
         "instagram_actor_id": "<INSTAGRAM_PAGE_ID>",
         "page_id": "<MAIN_PAGE_ID>",
         "template_data":{
           "call_to_action":{
             "type":"LEARN_MORE"
           },
           "format_option":"collection_video",
           "link":"https://fb.com/canvas_doc/CANVAS_ID",   
           "name":"Test Dynamic Ads with dynamic video",
           "retailer_item_ids":[
             "0",
             "0",
             "0",
             "0"
           ]
         }
       },
       "object_type": "SHARE",
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

Aperçus de publicités

Si vous disposez de la fonctionnalité Aperçu de la publicité, vous pouvez fournir un ad_format et un token d’accès utilisateur·ice pour générer des aperçus à partir de votre publicité ou contenu publicitaire.

curl -X GET \
  -d 'ad_format="MOBILE_FEED_STANDARD"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<CREATIVE_ID>/previews

Remarque : pour les publicités Instant Experience avec vidéo modèle, les formats pris en charge sont BIZ_DISCO_FEED_MOBILE, GROUPS_MOBILE, MOBILE_FEED_STANDARD, SUGGESTED_VIDEO_DESKTOP, SUGGESTED_VIDEO_MOBILE et WATCH_FEED_MOBILE.

Voir Aperçus de la publicité pour plus d’informations.

Publicités de collection standard

Vous pouvez utiliser un modèle afin de créer rapidement une Instant Experience pour un objectif commercial particulier. La disposition de chaque modèle est fixe. Toutefois, vous pouvez remplacer le contenu par défaut par vos propres images, vidéos, produits, textes et liens. Pour plus d’informations, voir Utiliser des modèles dans Instant Experience.

Il existe deux types de publicités de collection avec des Instant Experience : avec images et avec vidéos, selon la ressource que vous utilisez. Une fois que vous disposez d’un contenu publicitaire, vous pouvez créer une publicité.

Créer une publicité avec images

curl 
  -F 'name=Instant Experiences Collection Sample Image Creative' 
  -F 'object_story_spec={ 
    "link_data": {
      "link": "https://fb.com/canvas_doc/ELIGIBLE_CANVAS_ID", 
      "message": "Ad message", 
      "name": "name", 
      "picture": "IMAGE_URL", 
      "collection_thumbnails": [
        {"element_crops": {"100x100": [[0, 0], [100, 100]]},"element_id": "PHOTO_ELEMENT_WITH_PRODUCT_TAGS_ID",},
        {"element_child_index": 0,"element_id": "",},
        {"element_child_index": 1,"element_id": "PRODUCT_LIST_ELEMENT_ID",},
      ],
    }, 
    "page_id": "PAGE_ID" 
  }' 
  -F 'access_token=ACCESS_TOKEN' 
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

Créer une publicité vidéo

curl 
  -F 'name=Instant Experiences Collection Sample Video Creative' 
  -F 'object_story_spec={ 
    "page_id": "PAGE_ID", 
    "video_data": { 
      "call_to_action": {"type":"LEARN_MORE","value":{"link":"https://fb.com/canvas_doc/ELIGIBLE_CANVAS_ID"}}, 
      "image_url": "IMAGE_URL",
      "collection_thumbnails": [
        {"element_crops": {"100x100": [[0, 0], [100, 100]]},"element_id": "PHOTO_ELEMENT_NO_PRODUCT_TAGS_ID",},
        {"element_child_index": 0,"element_id": "PHOTO_ELEMENT_WITH_PRODUCT_TAGS_ID",},
        {"element_child_index": 1,"element_id": "PRODUCT_LIST_ELEMENT_ID",},
      ],
      "title": "My title", 
      "video_id": "VIDEO_ID" 
    } 
  }' 
  -F 'access_token=ACCESS_TOKEN' 
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

Paramètres

NomDescription

link

chaîne

Obligatoire
Redirige le lecteur ou la lectrice vers une Instant Experience.

collection_thumbnails

tableau

Obligatoire
Tableau de miniatures. Quatre miniatures sont requises.

Champs collection_thumbnails

NomDescription

element_id

chaîne numérique

Obligatoire
ID d’élément photo Canvas ou de liste de produits. La photo Canvas doit être associée à l’Instant Experience jointe à cette publicité de collection. Une image associée à cet ID apparaît dans l’Instant Experience une fois que quelqu’un a cliqué sur la publicité. Un ID d’élément d’image principale n’est pas valide.

element_child_index

entier

Obligatoire pour un élément photo avec des tags et des listes de produit
L’index de produit issu d’un ensemble d’ID d’éléments photo avec tags de produits. Ou l’index de produit issu d’un ensemble product_id_list, qui contient les éléments de la liste de produits.
Remarque : indiquez un entier positif.

element_crops
AdsImageCrops

Obligatoire pour un élément photo
Objet JSON définissant les dimensions de recadrage pour l’image spécifiée. Seule la clé de recadrage 100x100 est autorisée.

Créer des audiences d’engagement

Vous pouvez automatiquement créer des audiences pour les personnes qui interagissent avec votre publicité de collections. Cette option est similaire aux audiences des interactions pour les Instant Experience standard. Pour plus d’informations, consultez Audiences d’engagement dans Instant Experience.

Vous pouvez cibler vos publicités Instant Experience avec affichage plein écran pour les personnes ayant appuyé sur votre publicité de collection. Nous appelons ce type d’audience une audience d’engagement avec expérience plein écran. Développez cette audience en créant une audience personnalisée, puis définissez object_id sur CANVAS_ID, et configurez une règle pour suivre l’un des évènements.

Création d’une audience ayant ouvert une Instant Experience

curl \
    -F 'name=Collection Engagement Audience' 
    -F 'description=People who opened this Instant Experience' 
    -F 'rule=[{"object_id":"CANVAS_ID","event_name":"instant_shopping_document_open"}]' 
    -F 'access_token=ACCESS_TOKEN' 
https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/customaudiences

Création d’une audience ayant cliqué sur une publicité de collection

curl \
    -F 'name=Collection Engagement Audience' 
    -F 'description=People who clicked any links in this Instant Experience' 
    -F 'rule=[{"object_id":"CANVAS_ID","event_name":"instant_shopping_element_click"}]'
    -F 'access_token=ACCESS_TOKEN' 
https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/customaudiences

Boîte de dialogue Publicités de collection

Les publicités de collection sont basées sur des Instant Experience associées à un modèle. Par conséquent, pour créer une publicité de collection via une boîte de dialogue, vous utilisez la boîte de dialogue Instant Experience avec des paramètres supplémentaires. Ceci génère le processus d’interface de création de publicité de collection Facebook sur votre site Web. Pour en savoir plus sur ce composant d’interface, consultez la page Boîtes de dialogue.

Pour configurer le Facebook SDK for JavaScript, consultez les pages :

Le SDK JavaScript s’appuie sur les autorisations de l’utilisateur·ice connecté·e pour créer des publicités Instant Experience. Si l’utilisateur·ice ne dispose pas des autorisations nécessaires à la création d’une publicité Instant Experience pour la page et l’entreprise spécifiées, la boîte de dialogue affiche une erreur. L’utilisateur·ice doit également avoir accès aux catalogues et ensembles de produits. Pour garantir l’absence d’erreurs, l’utilisateur·ice doit avoir accès au compte Business Manager et disposer d’autorisations relatives à la création de publicités pour la page.

Vous pouvez ensuite déclencher l’ouverture de la boîte de dialogue des publicités de collection.

FB.ui({         
  display: 'popup',
  method: 'instant_experiences_builder',
  account_id: 'AD_ACCOUNT_ID'.
  business_id: 'BUSINESS_ID',
  page_id: 'PAGE_ID',
  template_id: 'TEMPLATE_ID'
}, function(response) {
  // callback
});

Vous pouvez fournir les paramètres suivants pour le plugin :

Nom Description

display

Obligatoire
Paramètre obligatoire défini sur la valeur de popup.

method

Obligatoire
Paramètre obligatoire défini sur la valeur de instant_experiences_builder.

account_id

Obligatoire
Votre ID de compte publicitaire.

business_id

Obligatoire
Votre ID d’entreprise.

page_id

Obligatoire
ID de page à associer à Instant Experience.

template_id

Obligatoire
ID du modèle à utiliser.

product_catalog_id

Facultatif
ID du catalogue produits à utiliser dans la collection. Il est obligatoire si la valeur product_set_id est indiquée.

product_set_id

Facultatif
ID de l’ensemble de produits à utiliser dans la collection.

Vous trouverez tous les types de modèles valides et leur ID correspondant dans la section Utilisation d’un modèle dans Instant Experience.

Les paramètres product_catalog_id et product_set_id sont facultatifs. Toutefois, si vous spécifiez product_set_id, vous devrez également spécifier product_catalog_id. Une fois que vous avez spécifié ces ID, il est impossible pour l’utilisateur·ice de modifier la collection dans l’interface. Si aucun paramètre n’est renseigné, l’utilisateur·ice peut sélectionner le catalogue et l’ensemble de produits définis dans l’interface. Pour afficher un aperçu d’une publicité, nous vous recommandons d’utiliser la boîte de dialogue Aperçu des publicités Instant Experience.

Le plugin indique la réponse suivante si l’opération réussit :


{
  "success": true,
  "id": "CANVAS_ID"
}

L’id renvoyé correspondra à une Instant Experience non publiée. Elle devra être publiée avant de pouvoir être utilisée dans les campagnes de publicité.

Si aucune réponse n’est reçue ou si une réponse undefined est envoyée, cela signifie que l’utilisateur·ice a fermé la boîte de dialogue avant de terminer l’Instant Experience, ou qu’il ou elle a enregistré l’Instant Experience, mais ne l’a pas terminée. Vous pouvez interroger l’API Graph pour afficher toutes les Instant Experience qui appartiennent à une page et vérifier s’il reste des publicités Instant Experience non terminées.

Ajout de catalogues de destinations

Vous pouvez afficher des contenus publicitaires issus d’un catalogue de destinations dans l’image principale d’une publicité de collection. Vous pouvez également afficher un carrousel d’images d’hôtels sur cette destination. Pour ce faire, vous devez fournir une image de remplacement qui s’affiche sur l’image principale au cas où nous ne trouverions aucune destination correspondante pour les hôtels dans le carrousel. Pour en savoir plus, consultez la section Catalogue de destinations.

Tenez compte de ces limitations :

  • Le contenu vidéo n’est pas pris en charge.
  • Nous acceptons uniquement l’affichage d’une combinaison d’images de catalogues d’hôtels et de destinations.
  • Nous ne prenons pas en charge l’affichage d’autres combinaisons de catalogues.

Pour utiliser cette fonctionnalité, ajoutez le paramètre destination_set_id lors de la création de votre élément canvas_photo, puis suivez l’autre procédure standard pour créer votre Instant Experience et publicité de collection.

Exemple

curl \
  -F 'canvas_photo={ 
    "photo_id": "PHOTO_ID", 
    "destination_set_id": "DESTINATION_SET_ID",
  }' \
  https://graph.facebook.com/v19.0/PAGE_ID/canvas_elements