Publicités collaboratives

Les publicités collaboratives sont une solution complémentaire des publicités de catalogue Advantage+. Cette solution permet aux annonceurs de marque de collaborer en toute sécurité avec les retailers ou les partenaires marketing et d’atteindre les objectifs fixés en matière de publicité, en ciblant par exemple un produit pour les ventes au moyen du contenu fourni par le retailer.

Le retailer ou le partenaire marketing doit partager un segment de catalogue avec l'annonceur de marque avec tous ses produits. Ce segment est une partie de son catalogue ou un super ensemble d'ensembles de produits. L’annonceur de marque peut alors accepter ce segment de catalogue et commencer à diffuser des publicités de catalogue Advantage+ à l’aide de ce segment de catalogue. Les annonceurs de marque ne peuvent pas modifier le segment de catalogue mais ils peuvent créer leurs propres ensembles de produits à partir de celui-ci.

Un annonceur diffuse essentiellement une campagne de publicités de catalogue Advantage+ pour les ventes sur catalogue avec un catalogue produits. Par conséquent, il peut utiliser les rapports de publicités Facebook standard qui comprennent désormais des indicateurs relatifs au segment de catalogue.

De plus, il est possible d’utiliser les rapports au niveau du produit et les rapports au niveau du retailer pour que l’annonceur voit uniquement les achats de la marque.

Étapes avancées

Pour les retailers et les partenaires marketing :

Étape 1 : Intégrer les publicités collaboratives
Étape 2 : Créer un segment de catalogue : le segment doit contenir des produits appartenant à l'une de ses marques partenaires potentielles.
Étape 3 : Partager un segment de catalogue avec une marque partenaire
(Pour les partenaires marketing uniquement) Étape 4 : Fournir des outils de découverte pour les marques

Pour les marques :

Étape 1 : Accepter le segment de catalogue
Étape 2 : Créer une campagne publicitaire avec le segment de catalogue
Étape 3 : Consulter les rapports : consulter les rapports relatifs aux produits dans le segment de catalogue.
Étape 4 optionnelle : Débogage : utiliser des outils pour diagnostiquer et résoudre les problèmes, voir Publicités de catalogue Advantage+, outils de débogage.

Étapes pour les retailers et les partenaires marketing

Étape 1 : Intégrer les publicités collaboratives

Pour effectuer cette étape, votre application doit disposer des autorisations business_management et catalog_management.

Actuellement, cette opération n’est pas prise en charge par l’API et doit être effectuée via l’UI. Pour démarrer ce processus, cliquez sur « Devenir distributeur partenaire » dans l’Annuaire des retailers utilisant des publicités collaboratives.

Étape 2 : Créer un segment de catalogue

Pour effectuer cette étape, votre application doit disposer des autorisations business_management et catalog_management.

Créez un segment de catalogue à partir d'un de vos catalogues existants. Le segment doit contenir tous les produits que vous souhaitez partager avec votre marque partenaire.

Pour créer un segment de catalogue via l’API, faites une demande POST à l’arête owned_product_catalogs. Les champs suivants sont requis pour la création d’un segment de catalogue :

parent_catalog_id : catalogue parent à partir duquel votre segment a été créé. Ce catalogue doit être conforme avec les publicités collaboratives. Vous trouverez le statut de votre catalogue dans le Gestionnaire des ventes.
catalog_segment_filter : règle codée au format JSON utilisée pour créer le segment de catalogue.

Étape 3 : Partager un segment de catalogue

Pour effectuer cette étape, votre application doit disposer des autorisations business_management et catalog_management.

Partagez votre segment de catalogue avec votre marque partenaire. Pour faire cette action via l’ API, faites une demande POST à /{catalog_segment_id}/agencies. Dans votre appel, vous pouvez ajouter les champs suivants :

Champ Description

Champ	Description
`business` type : chaîne numérique ou nombre entier	Obligatoire. ID de l'entreprise avec laquelle le catalogue sera partagé.
`permitted_tasks` type : tableau < enum {MANAGE, ADVERTISE} >	Obligatoire. Tâches que l’entreprise sera autorisée à exécuter. Les options disponibles sont : `['ADVERTISE', 'MANAGE']`.
`utm_settings` type : objet JSON {enum{campaign_source,campaign_medium,campaign_name}: string}	Facultatif. Vous pouvez spécifier `campaign_source`, `campaign_medium` et `campaign_name`. Par exemple : `{campaign_source: “fb_campaign_source”}`.

business

type : chaîne numérique ou nombre entier

Obligatoire.

ID de l'entreprise avec laquelle le catalogue sera partagé.

permitted_tasks

type : tableau < enum {MANAGE, ADVERTISE} >

Obligatoire.

Tâches que l’entreprise sera autorisée à exécuter. Les options disponibles sont : ['ADVERTISE', 'MANAGE'].

utm_settings

type : objet JSON {enum{campaign_source,campaign_medium,campaign_name}: string}

Facultatif.

Vous pouvez spécifier campaign_source, campaign_medium et campaign_name.

Par exemple : {campaign_source: “fb_campaign_source”}.

(Pour les partenaires marketing uniquement) Étape 4 : Fournir des outils de découverte pour les marques

Pour effectuer cette étape, votre application doit disposer de l’autorisation business_management. L'appel d'API doit inclure un token d'accès utilisateur·ice et celui-ci ou celle-ci doit disposer d'une autorisation pour la demande de partenaire, d'entreprise ou de collaboration suggérée.

En tant que partenaire marketing, vous devez offrir aux marques un moyen de découvrir d'éventuels partenaires de publicités collaboratives. Vous pouvez utiliser les points de terminaison suivants pour trouver des retailers avec lesquels travailler :

GET {business-id}?fields=collaborative_ads_suggested_partners : trouver des partenaires pour une activité spécifique.
GET collaborative_ads_directory?fields=collaborative_ads_merchants : obtenir la liste complète des retailers utilisant des publicités collaboratives.
GET {cpas-advertiser-partnership-recommendation-id}?fields=advertiser_business_id,brand_business_id,brands,countries,merchant_business_id,status,status_reason : obtenir une seule recommandation de retailer.

Si une marque trouve un partenaire, vous pouvez contacter le retailer pour une demande de collaboration. Pour ce faire, faites la demande POST suivante à /{cpas-collaboration-request-id} :

{business-id}/collaborative_ads_collaboration_requests?
brands=”[“[BRAND NAME]”, “[BRAND NAME 2]”]”&
contact_email=[CONTACT_EMAIL]&
contact_first_name=[CONTACT_FIRST_NAME]&
contact_last_name=[CONTACT_LAST_NAME]&
phone_number=[PHONE NUMBER]&
receiver_business=[RECEIVING BUSINESS ID]
requester_agency_or_brand=[REQUESTING ENTITY - AGENCY, BRAND or MERCHANT]

Suivez vos contacts avec les points de terminaison suivants :

Étapes pour les marques

Étape 1 : Accepter le segment de catalogue

Si votre marque n'a pas accepté les conditions de service pour la nouvelle activité partagée, vous devez le faire.

Une fois l’élément partagé reçu, l’admin de l’entreprise doit effectuer les actions suivantes :

Accéder à l’Espace de collaboration.
Sélectionner l'activité pour laquelle les conditions de service sont acceptées.
Sélectionner Partenaires dans le panneau de navigation de gauche.
Cliquer sur le bouton Acceptez les éléments pour lancer le processus d'acceptation.

Une fois les conditions acceptées, votre marque peut ajouter des personnes dans le segment de catalogue à l’aide du point de terminaison /{product-catalog-id}/assigned_users. Remarque : Cela nécessite l’autorisation business_management.

Étape 2 : Créer une campagne publicitaire

Pour effectuer cette étape, votre application doit disposer des autorisations business_management et ads_management.

Votre marque peut utiliser le segment de catalogue accepté pour créer des campagnes publicitaires. Vous devez utiliser un compte publicitaire distinct pour chaque retailer pour lequel vous souhaitez diffuser des publicités collaboratives. Une fois que le compte publicitaire dédié est lié à un retailer, il ne peut sélectionner que les segments de catalogue appartenant à ce retailer.

Pour créer et diffuser des publicités, procédez comme vous le faites normalement pour votre propre catalogue produits en indiquant toutefois un catalog_segment_ID au lieu d’un ID de catalogue :

curl \
  -F 'name=Product Catalog Sales Campaign' \
  -F 'objective=PRODUCT_CATALOG_SALES' \
  -F 'promoted_object={"product_catalog_id":"<CATALOG_SEGMENT_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

Si vous réussissez, vous obtiendrez un nouvel ID de campagne publicitaire :

{
"id": "<CAMPAIGN_ID>"
}

Quatre champs peuvent normalement être définis avec les publicités de catalogue Advantage+ mais il n’est pas possible de les définir avec un segment de catalogue :

multi_share_end_card est défini sur false par défaut et vous ne pouvez pas le modifier
Vous ne pouvez pas modifier description en template_data
Les template_url_spec que vous pouvez utiliser pour les URL de lien profond doivent renvoyer vers le site Web commercial
Les spécifications de suivi personnalisées sont désactivées

Étape 3 : Consulter les rapports

Une fois les publicités diffusées, les annonceurs de marque peuvent obtenir des indicateurs sur les performances des publicités. Nous avons plusieurs nouveaux indicateurs d’insight à différents niveaux d'objets publicitaires. Voir catalog_segment_value et les indicateurs connexes pour les objets suivants :

catalog_segment_value comprend une répartition des évènements de conversion, y compris les achats, les ajouts au panier et la visualisation des produits pour le segment de catalogue au niveau de chaque objet publicitaire. Cela regroupe les événements sur le site Web, les sources mobiles et omnicanales. En savoir plus sur les Indicateurs d’insight estimés et en cours de développement.

Étape 4 : Déboguer et diagnostiquer les problèmes

Les marques doivent désormais résoudre et déboguer tous les problèmes liés à la diffusion de leurs publicités de catalogue Advantage+ pour le segment de catalogue.

Voir Outils de débogage des publicités de catalogue Advantage+

Insights

Les indicateurs estimés suivants sont liés aux publicités collaboratives : voir À propos des indicateurs estimés, des indicateurs en développement et des indicateurs rapportés par des tiers.

Pour interroger l'un de nos indicateurs de rapport :

Votre application doit disposer des autorisations ads_management et business_management. Voir Contrôle app.
Vous devez disposer d'un token d'accès utilisateur·ice et celui-ci ou celle-ci doit être autorisé·e à consulter les rapports pour le compte publicitaire concerné.

Les demandes peuvent être faites sur les objets suivants : compte publicitaire, campagne publicitaire, ensemble de publicités et publicité.

La répartition action_converted_product_id n’est pas prise en charge au niveau du compte publicitaire.

Metric	Description
`catalog_segment_value`	Value from conversion events, including a breakdown of purchases, add-to-carts and view products for the catalog segment at each ad object level.
`catalog_segment_value_omni_purchase_roas`	Total return on ad spend (ROAS) from purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailer' connected Facebook Business Tools. The amount is attributed to your ads.
`catalog_segment_value_website_purchase_roas`	Total return on ad spend (ROAS) from website purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailers' connected Facebook Business Tools. The amount is attributed to your ads.
`catalog_segment_value_mobile_purchase_roas`	The total return on ad spend (ROAS) from mobile app purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailers' connected Facebook Business Tools. The amount is attributed to your ads.
`catalog_segment_actions`	Similar to `catalog_segment_value`, when using this metric a breakdown of actions is given for the catalog segment at each ad object level.
`converted_product_value`	Value of conversions driven by your ads for a given product ID. This number is recorded by your Retailer partner's Pixel or App SDK. The API only returns Product IDs —see `/{product-item-id}` for information. If you want to get brand names as well, please use Ads Manager.
`converted_product_quantity`	Quantity of conversions driven by your ads for a given product ID. This number is recorded by your Retailer partner's Pixel or App SDK. The API only returns Product IDs —see `/{product-item-id}` for information. If you want to get brand names as well, please use Ads Manager.

Répartitions

Les répartitions sont utilisées pour regrouper vos résultats d’insights en différents ensembles : voir Répartitions. Vous pouvez utiliser les répartitions suivantes avec les indicateurs de publicités collaboratives :

Date : pour obtenir des insights pour une période spécifique. Pour utiliser cette répartition, ajoutez time_range à votre requête. Par exemple : &time_range[since]=2020-03-01&time_range[until]=2020-04-01.
Niveau produit : pour obtenir des insights sur un produit spécifique. Utilisez cette répartition pour converted_product_value et converted_product_quantity metrics an ajoutant &action_breakdowns=action_converted_product_id à votre requête.

Combiner des répartitions

Utilisez les combinaisons de répartitions suivantes pour les publicités collaboratives :

La répartition action_converted_product_id n’est pas prise en charge au niveau du compte publicitaire.

action_converted_product_id
action_type, action_converted_product_id