Campagnes de shopping Advantage+

Les campagnes de shopping Advantage+ peuvent permettre aux annonceurs d’e-commerce, de vente directe au consommateur·ice et de marques d’obtenir de meilleures performances, une personnalisation plus poussée et davantage d’efficacité. Ces campagnes offrent une plus grande souplesse pour contrôler des leviers tels que le contenu publicitaire, le ciblage, les placements et le budget, et plus d’opportunités d’optimiser les campagnes qui génèrent des conversions.

Plutôt que de lancer plusieurs campagnes avec des audiences segmentées, les campagnes de shopping Advantage+ vous permettent de combiner toutes vos audiences pour un marché donné en une seule structure de campagne. Vous simplifiez ainsi la création et la gestion tout en réduisant le chevauchement d’audiences.

Configuration manuelle de campagnes et campagnes de shopping Advantage+

Configuration manuelle de campagnes BAUCampagne de shopping Advantage+

Plusieurs campagnes BAU

Remplacement du portefeuille BAU


Ciblage manuel avec 7 leviers de ciblage


Ciblage automatisé, automatisation pour augmenter l’efficacité de configuration avec 1 entrée pays


Allocations budgétaires strictes pour plusieurs campagnes


Flexibilité du budget pour une seule campagne


Test de jusqu’à 50 combinaisons de contenus publicitaires


Offre des publicités dynamiques et statiques avec jusqu’à 150 combinaisons de contenus publicitaires


Ce document explique comment configurer votre intégration pour les campagnes de shopping Advantage+. Vous devez :

  1. Définir une clientèle existante
  2. Créer une campagne
  3. Vérifier la création de la campagne
  4. Créer un ensemble de publicités
  5. Fournir un contenu publicitaire et créer des publicités
  6. Définir une limite d’âge minimale et une exclusion géo (consultez le document de référence Contrôles de compte publicitaire)

Étape 1 : définir votre clientèle existante

Les campagnes de shopping Advantage+ vous permettent de définir votre clientèle existante comme une collection d’identifiants d’audience personnalisée. Votre clientèle existante correspond à des personnes qui connaissent déjà votre entreprise/produit. Une fois cette définition configurée, vous pouvez l’utiliser pour segmenter votre budget pour les campagnes de shopping Advantage+ afin de limiter les dépenses sur la clientèle existante. Nous vous fournirons également des indicateurs sur les performances de vos campagnes parmi ces différents segments.

Vous pouvez définir votre publicité en publiant sur le point de terminaison /act_{ad_account_id}. Vous devrez inclure le paramètre suivant pour configurer cette définition :

ParamètreDescription

existing_customers

Tableau<string>

Tableau d’identifiants d’audience personnalisée auxquels le compte publicitaire a accès. Actuellement, les sources prises en charge pour l’audience personnalisée sont le site Web, l’activité de l’application, la liste de clients, le catalogue et l’activité hors ligne.


Pour plus d’informations sur la procédure de création d’une audience personnalisée, consultez cette page.

Exemple

curl -X POST \
  -F 'existing_customers=[<CUSTOM_AUDIENCE_ID>, <CUSTOM_AUDIENCE_ID>]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>

Pour plus d’informations sur le suivi des audiences nouvelles et existantes dans les outils de suivi tiers, consultez la section Paramètres d’URL du type d’audience.

Étape 2 : créer une campagne

Commencez par créer votre campagne publicitaire. Pour cela, adressez une requête POST à /act_{ad_account_id}/campaigns.

Paramètres


ParamètreDescription

name
chaîne

Obligatoire
Nom de la campagne de shopping Advantage+

objective
énumération

Obligatoire
Objectif de la campagne. Spécifiez OUTCOME_SALES pour ce type de publicité

special_ad_categories

liste<Object>

Obligatoire.
Catégories publicitaires spéciales associées à la campagne de shopping Advantage+

adlabels

liste<Object>

Facultatif
Étiquettes publicitaires associées à la campagne de shopping Advantage+

buying_type
chaîne

Facultatif
Les campagnes de shopping Advantage+ prennent en charge uniquement la valeur AUCTION

execution_options

liste<enum>

Facultatif
Valeur par défaut : set. Les autres options possibles sont les suivantes :

  • validate_only : si cette option est spécifiée, l’appel d’API n’effectuera pas la mutation, mais s’exécutera par le biais des règles de validation sur les valeurs de chaque champ.
  • include_recommendations : cette option ne peut pas être utilisée seule. Si cette option est utilisée, les recommandations en matière de configuration d’objets publicitaires seront incluses. Une section de recommandations distincte figurera dans la réponse, mais uniquement si des recommandations existent pour cette spécification.

Si le processus de validation ou d’examen de l’appel réussit, la réponse sera {"success": true}. S’il échoue, le système renverra une erreur avec des détails.

smart_promotion_type
énumération

Obligatoire
Pour spécifier qu’il s’agit d’une campagne de shopping Advantage+, définissez le type de promotion intelligente sur AUTOMATED_SHOPPING_ADS

status
énumération

Facultatif
Les options valides sont les suivantes : PAUSED et ACTIVE.


Si ce statut présente la valeur PAUSED, la totalité de ses publicités et ensembles de publicités actifs seront mis en pause et prendront le statut effectif CAMPAIGN_PAUSED

Exemple de création d’une campagne

curl -X POST \
  -F 'name=Advantage+ Shopping Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'smart_promotion_type=AUTOMATED_SHOPPING_ADS' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/campaigns

Mise à jour

Vous pouvez mettre à jour une campagne en adressant une requête POST à /{campaign_id}.

Paramètres


ParamètreDescription

name
chaîne

Nom de la campagne de shopping Advantage+

special_ad_categories

liste<Object>

Catégories publicitaires spéciales associées à la campagne de shopping Advantage+

adlabels

liste<Object>

Étiquettes publicitaires associées à la campagne de shopping Advantage+

execution_options

liste<enum>

Valeur par défaut : set. Les autres options possibles sont les suivantes :

  • validate_only : si cette option est spécifiée, l’appel d’API n’effectuera pas la mutation, mais s’exécutera par le biais des règles de validation sur les valeurs de chaque champ.
  • include_recommendations : cette option ne peut pas être utilisée seule. Si cette option est utilisée, les recommandations en matière de configuration d’objets publicitaires seront incluses. Une section de recommandations distincte figurera dans la réponse, mais uniquement si des recommandations existent pour cette spécification.

Si le processus de validation ou d’examen de l’appel réussit, la réponse sera {"success": true}. S’il échoue, le système renverra une erreur avec des détails.

topline_id
chaîne numérique ou entier

ID Topline

status
énumération

Vous pouvez utiliser l’un des statuts suivants pour un appel d’API de mise à jour :

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Si une campagne publicitaire est définie sur PAUSED, tous ses objets enfants actifs seront mis en pause et prendront le statut effectif CAMPAIGN_PAUSED.

Exemple de mise à jour d’une campagne

curl -X POST \
  -F 'name=Advantage+ Shopping Update Sample Campaign' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<CAMPAIGN_ID>

Étape 3 : vérifier qu’une campagne a été créée

Pour vérifier que vous avez bien créé une campagne de shopping Advantage+, vous pouvez adresser une requête GET à /<AD_CAMPAIGN_ID> avec le champ smart_promotion_type.

Une campagne de shopping Advantage+ valide renverra la valeur de champ AUTOMATED_SHOPPING_ADS.

Exemple

curl -X GET -G \
  -d 'fields=smart_promotion_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<AD_CAMPAIGN_ID>

Réponse

{
  "smart_promotion_type": "AUTOMATED_SHOPPING_ADS",
  "id": <AD_CAMPAIGN_ID>
}

Étape 4 : créer un ensemble de publicités

Une fois que vous disposez d’une campagne publicitaire, créez votre ensemble de publicités. Chaque campagne de shopping Advantage+ ne peut être associée qu’à un seul ensemble de publicités.

Pour créer un ensemble de publicités, adressez une requête POST à /act_{ad_account_id}/adsets.

Paramètres


ParamètreDescription

campaign_id
chaîne numérique ou entier

Obligatoire.
Campagne de shopping Advantage+ valide à laquelle vous souhaitez ajouter cet ensemble de publicités.

name
chaîne

Obligatoire
Nom de la campagne de shopping Advantage+

promoted_object
Objet

Obligatoire.
Objet dont cet ensemble de publicités effectue la promotion dans toutes ses publicités. Pour les campagnes de shopping Advantage+, indiquez :

  • pixel_id et
  • custom_event_type : l’ensemble de publicités de shopping Advantage+ prend en charge les évènements suivants :PURCHASE, ADD_TO_CART, INITIATED_CHECKOUT, ADD_PAYMENT_INFO, ADD_TO_WISHLIST, CONTENT_VIEW, COMPLETE_REGISTRATION, DONATE, START_TRIAL, SUBSCRIBE, SEARCH, OTHER.

targeting
Objet de ciblage

Obligatoire
Une structure de ciblage pour l’ensemble de publicités de shopping Advantage+. Seuls des paramètres geo_locations peuvent être spécifiés.

geo_locations
tableau

Obligatoire
Utilisé pour limiter l’audience de l’ensemble de publicités par

  • countries - Ciblage par pays. Nécessite un tableau de codes au format ISO 3166 à 2 chiffres.
    Exemple :
    {
      "geo_locations": {
        "countries": [“US”]
      },
    }
    
  • regions - État, province ou région. Consultez la section Recherche de ciblage, Régions pour les valeurs disponibles. Limite : 200.
    Exemple :
    {
      "geo_locations": {
        "regions": [{"key":"3847"}]
      },
    }
    

daily_budget
int64

Facultatif
Budget quotidien défini dans la devise de votre compte, uniquement autorisé pour les ensembles de publicités dont la durée (différence entre end_time et start_time) est supérieure à 24 heures.


Soit daily_budget, soit lifetime_budget doit présenter une valeur supérieure à 0.

lifetime_budget
int64

Facultatif
Budget global, défini dans la devise de votre compte. Si ce paramètre est spécifié, vous devez également indiquer une valeur end_time.


Soit daily_budget, soit lifetime_budget doit présenter une valeur supérieure à 0.

end_time
date/heure

Obligatoire lorsque lifetime_budget est spécifié.
Lorsque vous créez un ensemble de publicités avec un daily_budget, spécifiez end_time=0 pour définir cet ensemble comme continu et dépourvu de date de fin. Horodatage UTC UNIX


Exemple : 2015-03-12 23:59:59-07:00 ou 2015-03-12 23:59:59 PDT.

optimization_goal
énumération

Facultatif
Sélectionnez OFFSITE_CONVERSIONS comme l’objectif d’optimisation pour optimiser le nombre de conversions. Sélectionnez VALUE comme objectif d’optimisation si vous voulez optimiser la valeur des conversions. Dans le Gestionnaire de publicités, nous affichons la valeur la plus élevée comme stratégie d’enchère.

bid_strategy
énumération

Facultatif

  • LOWEST_COST_WITHOUT_CAP : Facebook enchérit automatiquement en votre nom afin d’obtenir les résultats au coût le plus bas. Augmentez automatiquement votre enchère effective selon vos besoins pour obtenir les résultats que vous souhaitez en fonction de votre optimization_goal indiqué. Il s’agit de la stratégie bid_strategy par défaut lorsque optimization_goal est OFFSITE_CONVERSION ou VALUE.
  • LOWEST_COST_WITH_MIN_ROAS : option d’enchères spécifique à l’optimisation de la valeur. Vous devez préciser un roas_average_floor, qui définira le retour minimum souhaité sur les dépenses publicitaires. Consultez la section Retour minimum sur les dépenses publicitaires.
  • COST_CAP : obtenez les meilleurs résultats possibles, sans dépasser les limites de coût par action que vous avez définies. Vous devez indiquer une valeur limite dans le champ bid_amount. Remarque : nous ne garantissons pas le respect des limites de coût. Consultez la section Limite de coût.

bid_amount

Obligatoire si bid_strategy est COST_CAP.

bid_constraints
Objet JSON

Facultatif

  • optimization_goal doit être VALUE.
  • bid_strategy doit être LOWEST_COST_WITH_MIN_ROAS.
  • Les enchères par ROAS minimum utilisent bid_constraints pour dépasser le « ROAS plancher », mais ne peuvent pas être associées à bid_constraints. Utilisez roas_average_floor à la place. Consultez la section Retour minimum sur les dépenses publicitaires.
  • La plage roas_average_floor valide est [100, 10000000] (inclus). Cela signifie que la plage de « ROAS minimum » valide est [0.01, 1000.0] ou [1%, 100000.0%] (inclus).

billing_event
énumération

Obligatoire
Évènement de facturation pour l’ensemble de publicités. Seul IMPRESSIONS est pris en charge pour les campagnes de shopping Advantage+.

existing_customer_budget_percentage
nombre

Facultatif
Spécifie le pourcentage maximum du budget qui peut être dépensé pour la clientèle existante associée à ce compte publicitaire. Des valeurs inférieures peuvent entraîner des coûts par conversion plus élevés. Les valeurs valides sont comprises entre 0 et 100.

adlabels

liste<Object>

Facultatif

Spécifie une liste d’étiquettes à associer à cet objet.

start_time
date/heure

Facultatif.
Heure de début de l’ensemble. Horodatage UTC UNIX


Exemple : 2015-03-12 23:59:59-07:00 ou 2015-03-12 23:59:59 PDT.

time_start
date/heure

Facultatif

Heure de début

time_stop
date/heure

Facultatif

Heure de fin

attribution_spec

liste<JSON Object>

Facultatif
Spécification d’attribution de conversion utilisée pour attribuer les conversions pour l’optimisation.

Exemple de création d’un ensemble de publicités

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'promoted_object={ "pixel_id": "<PIXEL_ID>", "CUSTOM_EVENT_TYPE": "PURCHASE" }' \
  -F 'daily_budget=<NUM>' \
  -F 'existing_customer_budget_percentage=<NUM>' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'targeting={"geo_locations": {"countries": ["US"]}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adsets

Mise à jour

Vous pouvez mettre à jour un ensemble de publicités en adressant une requête POST à /{ad_set_id}.

Paramètres


ParamètreDescription

adlabels

liste<Object>

Spécifie une liste d’étiquettes à associer à cet objet. Ce champ est facultatif.

daily_budget
int64

Budget quotidien défini dans la devise de votre compte, uniquement autorisé pour les ensembles de publicités dont la durée (différence entre end_time et start_time) est supérieure à 24 heures.


Soit daily_budget, soit lifetime_budget doit présenter une valeur supérieure à 0.

existing_customer_budget_percentage
nombre

Spécifie le pourcentage maximum du budget qui peut être dépensé sur la clientèle existante associée à ce compte publicitaire. Des valeurs inférieures peuvent entraîner des coûts par conversion plus élevés. Les valeurs valides sont comprises entre 0 et 100.

end_time
date/heure

Heure de fin, obligatoire lorsque le paramètre lifetime_budget est spécifié.


Exemple : 2015-03-12 23:59:59-07:00 ou 2015-03-12 23:59:59 PDT


Lorsque vous créez un ensemble de publicités avec un budget quotidien, spécifiez end_time=0 pour définir cet ensemble comme continu et dépourvu de date de fin.


Horodatage UTC UNIX.

execution_options

liste<enum>

Valeur par défaut : set. Les autres options possibles sont les suivantes :

  • validate_only : si cette option est spécifiée, l’appel d’API n’effectuera pas la mutation, mais s’exécutera par le biais des règles de validation sur les valeurs de chaque champ.
  • include_recommendations : cette option ne peut pas être utilisée seule. Si cette option est utilisée, les recommandations en matière de configuration d’objets publicitaires seront incluses. Une section de recommandations distincte figurera dans la réponse, mais uniquement si des recommandations existent pour cette spécification.

Si le processus de validation ou d’examen de l’appel réussit, la réponse sera {"success": true}. S’il échoue, le système renverra une erreur avec des détails.

start_time
date/heure

Heure de début de l’ensemble. Ce paramètre doit être fourni sous la forme d’un horodatage UNIX UTC.


Exemple : 2015-03-12 23:59:59-07:00 ou 2015-03-12 23:59:59 PDT.

status
énumération

Options disponibles pour les mises à jour :

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Si défini sur PAUSED, toutes ses publicités actives seront mises en pause et prendront le statut effectif ADSET_PAUSED.

lifetime_budget
int64

Budget global, défini dans la devise de votre compte. Si ce paramètre est spécifié, vous devez également indiquer une valeur end_time.


Soit daily_budget, soit lifetime_budget doit présenter une valeur supérieure à 0.

time_start
date/heure

Heure de début

time_stop
date/heure

Heure de fin

targeting
Objet de ciblage

Structure de ciblage pour votre ensemble de publicités. Les valeurs valides pour le ciblage sont geo_locations.

geo_locations
tableau

Obligatoire
Utilisé pour limiter l’audience de l’ensemble de publicités par

  • countries - Ciblage par pays. Nécessite un tableau de codes au format ISO 3166 à 2 chiffres.
    Exemple :
    {
      "geo_locations": {
        "countries": [“US”]
      },
    }
    
  • regions - État, province ou région. Consultez la section Recherche de ciblage, Régions pour les valeurs disponibles. Limite : 200.
    Exemple :
    {
      "geo_locations": {
        "regions": [{"key":"3847"}]
      },
    }
    

attribution_spec

liste<JSON Object>

Facultatif
Spécification d’attribution de conversion utilisée pour attribuer les conversions pour l’optimisation.

Exemple de mise à jour d’un ensemble de publicités

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Updated Ad Set' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<AD_SET_ID>

Étape 5 : fournir un contenu publicitaire et créer des publicités

Une fois que vous disposez d’un ensemble de publicités, vous pouvez créer votre publicité en la publiant sur le point de terminaison /act_{ad_account_id}/ads. Vous pouvez y inclure les paramètres suivants :

Paramètres


ParamètreDescription

name
chaîne

Obligatoire.
Nom de la publicité

adset_id
int64

Obligatoire.
ID de l’ensemble de publicités, requis lors de la création.

creative
Contenu publicitaire

Obligatoire.
Spécification du contenu publicitaire ou ID du contenu publicitaire que la publicité doit utiliser. Les champs valides sont les suivants :

  • object_story_spec
  • product_set_id
  • use_page_actor_override
  • creative_id

Pour en savoir plus sur les contenus publicitaires, consultez cette page


Fournissez le contenu publicitaire au format suivant : {"creative_id": <CREATIVE_ID>}


Ou fournissez une spécification de contenu publicitaire :

{
        "creative": {
          "name": <NAME>, 
          "object_story_spec": <SPEC>,
          "product_set_id": <PRODUCT_SET_ID>
        }
}

status
énumération

Facultatif.
Seules les valeurs ACTIVE et PAUSED sont valides lors de la création. Dans le cadre des tests, il est recommandé de définir les publicités sur le statut PAUSED afin de ne pas entraîner de dépenses accidentelles.

adlabels

liste<Object>

Facultatif.
Étiquettes publicitaires associées à cette publicité

execution_options

liste<enum>

Facultatif
Valeur par défaut : set.

  • validate_only : si cette option est spécifiée, l’appel d’API n’effectuera pas la mutation, mais s’exécutera par le biais des règles de validation sur les valeurs de chaque champ.
  • synchronous_ad_review : cette option ne doit pas être utilisée seule. Elle doit toujours être spécifiée avec l’option validate_only. Lorsque ces options sont spécifiées, l’appel d’API effectuera les validations d’intégrité des publicités, qui comprennent la vérification de la langue du message, la règle des 20 % de texte pour les images, etc., ainsi que les logiques de validation.
  • include_recommendations : cette option ne peut pas être utilisée seule. Si cette option est utilisée, les recommandations en matière de configuration d’objets publicitaires seront incluses. Une section de recommandations distincte figurera dans la réponse, mais uniquement si des recommandations existent pour cette spécification.

Si le processus de validation ou d’examen de l’appel réussit, la réponse sera {"success": true}. S’il échoue, le système renverra une erreur avec des détails.

Exemple de création d’une publicité

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Ad' \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/ads

Champs de contenu publicitaire

ChampDescription

object_story_spec
AdCreativeObjectStorySpec

Obligatoire
Utilisez ce champ si vous souhaitez créer une publication de Page non publiée et la convertir en publicité. ID de Page et contenu pour créer une nouvelle publication de Page non publiée.

use_page_actor_override
AdCreative

Obligatoire
Si true, nous affichons la Page Facebook associée aux publicités de shopping Advantage.

Exemple de création d’un contenu publicitaire

curl -X POST \
  -F 'object_story_spec=<SPEC>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

Mise à jour

Vous pouvez mettre à jour une publicité en adressant une requête POST à /{ad_id}.

Paramètres


ParamètreDescription

name
chaîne

Nouveau nom de la publicité

adlabels

liste<Object>

Étiquettes publicitaires associées à cette publicité.

execution_options

liste<enum>

Valeur par défaut : set. Les autres options possibles sont les suivantes :

  • validate_only : si cette option est spécifiée, l’appel d’API n’effectuera pas la mutation, mais s’exécutera par le biais des règles de validation sur les valeurs de chaque champ.
  • synchronous_ad_review : cette option ne doit pas être utilisée seule. Elle doit toujours être spécifiée avec l’option validate_only. Lorsque ces options sont spécifiées, l’appel d’API effectuera les validations d’intégrité des publicités, qui comprennent la vérification de la langue du message, la règle des 20 % de texte pour les images, etc., ainsi que les logiques de validation.
  • include_recommendations : cette option ne peut pas être utilisée seule. Si cette option est utilisée, les recommandations en matière de configuration d’objets publicitaires seront incluses. Une section de recommandations distincte figurera dans la réponse, mais uniquement si des recommandations existent pour cette spécification.

Si le processus de validation ou d’examen de l’appel réussit, la réponse sera {"success": true}. S’il échoue, le système renverra une erreur avec des détails.

status
énumération

Les valeurs possibles sont les suivantes :

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Dans le cadre des tests, il est recommandé de définir les publicités sur le statut PAUSED afin de ne pas entraîner de dépenses accidentelles.

creative
Contenu publicitaire

Spécification du contenu publicitaire à utiliser par cette publicité. Les champs valides sont object_story_spec, asset_feed_spec et use_page_actor_override et peuvent être consultés sur cette page. Pour en savoir plus sur les contenus publicitaires, consultez cette page


Indiquez le contenu publicitaire au format suivant :

{
    "creative": {
      "name": <NAME>, 
      "object_story_spec": <SPEC>,
      "product_set_id": <PRODUCT_SET_ID>
    }
}

Exemple de mise à jour d’une publicité

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Update Ad' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<AD_ID>