API Marketing

Publicités Boutiques

Publicités Boutiques est une solution qui permet d’améliorer la performance de vos publicités en envoyant les client·es potentiel·les vers votre site Web ou votre boutique, en fonction de l’endroit auquel ils ou elles sont le plus susceptibles d’effectuer un achat.

Avant de commencer

Pour créer une vente sur catalogue produits ou une publicité de conversion à l’aide d’une conversion sur un site Web et du lieu de conversion de la boutique, vous aurez besoin des éléments suivants :

Étape 1 : Créer une campagne

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

À ce niveau, vous devez définir votre objectif publicitaire via le champ objectif. Pour les publicités Boutiques, les objectifs pris en charge sont PRODUCT_CATALOG_SALES et CONVERSIONS pour expérience publicitaire non déterminée par les résultats (ODAX) et l’objectif OUTCOME_SALES pour ODAX.

  • Pour l'objectif PRODUCT_CATALOG_SALES, promoted_object est l'ID du catalogue produits. Veuillez noter que le catalogue produits doit être connecté à une boutique sur site pour être éligible pour les publicités Boutiques.
  • Pour l'objectif CONVERSIONS, le champ promoted_object n'est pas requis.

Exemples d’objectifs non ODAX

Exemple de création d'une campagne avec l'objectif PRODUCT_CATALOG_SALES

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

Exemple de création d’une campagne avec l'objectif CONVERSIONS

curl \
  -F 'name=Conversion Campaign' \
  -F 'objective=CONVERSIONS' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

Exemples d'objectifs ODAX

Exemple de création d’une campagne PRODUCT_CATALOG_SALES avec l’objectif OUTCOME_SALES

curl \
  -F 'name=Conversion Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'promoted_object={"product_catalog_id":"<PRODUCT_CATALOG_ID>"}' \
  -F 'status=PAUSED' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \ 
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

Exemple de création d’une campagneCONVERSIONS avec l’objectif OUTCOME_SALES

curl \
  -F 'name=Conversion Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'status=PAUSED' \
  -F 'special_ad_categories=[]'
  -F 'access_token=<ACCESS_TOKEN>' \ 
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

Étape 2 : Créer un ensemble de publicités

Pour les publicités Boutiques, vous devez spécifier le type de destination comme SHOP_AUTOMATIC pour votre ensemble de publicités.

  • Si l'objectif de la campagne est défini sur PRODUCT_CATALOG_SALES, vous devez fournir un ID d’ensemble de produits dans promoted_object pour promouvoir des produits provenant de cet ensemble.
  • Si l'objet de la campagne est défini sur CONVERSIONS, définissez votre promoted_object comme un compte marchand en activant la possibilité de paiement sur site.

Autres exigences pour les publicités Boutiques :

  • Les publicités Boutiques ne prennent en charge que PURCHASE comme évènement de conversion (CUSTOM_EVENT_TYPE) dans l’ensemble de produits (si l'objectif est PRODUCT_CATALOG_SALES) ou dans le pixel Meta (si l'objectif est CONVERSIONS).
  • Les publicités Boutiques ne prennent en charge que l'optimisation pour les conversions à distance (OFFSITE_CONVERSIONS comme optimization_goal).
  • Les publicités Boutiques ne prennent en charge qu'une stratégie d’enchère sans limite de coût.
  • Afin que les publicités Boutiques soient diffusées dans la boutique, le ciblage doit inclure des audiences dans les régions avec support du paiement sur site (actuellement, aux États-Unis).
  • Pour que les publicités Boutiques soient diffusées en boutiques, le placement doit inclure au moins une plateforme avec support de paiement sur site (actuellement, Facebook et Instagram).

Exemple de création d’un ensemble de publicités des publicités Boutiques avec une campagne dont l'objectif PRODUCT_CATALOG_SALES est facturé sur IMPRESSIONS

curl \
  -F 'name=Product Catalog Sales Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]} }' \
  -F 'destination_type=SHOP_AUTOMATIC' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_ID>","custom_event_type": "PURCHASE"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Exemple de création d'un ensemble de publicités des publicités Boutiques avec une campagne dont l'objectif CONVERSIONS est facturé sur IMPRESSIONS

curl \
  -F 'name=Conversion Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]}}' \
  -F 'destination_type=SHOP_AUTOMATIC' \
  -F 'promoted_object={"omnichannel_object":{"onsite":[{"commerce_merchant_settings_id":"<COMMERCE_ACCOUNT_ID>"}],
  "pixel":[{"pixel_id": "<PIXEL_ID>","custom_event_type": "PURCHASE"}]}}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<D_ACCOUNT_ID>/adsets

Étape 3 : Fournir un contenu publicitaire

Avec les ensembles de publicités des publicités Boutiques, vous pouvez créer les éléments suivants :

Les publicités Boutiques ne prennent pas en charge ce qui suit :

  • Formats publicitaires images/vidéo lorsque l'objectif de la campagne est PRODUCT_CATALOG_SALES
  • Formats publicitaires de collection
  • Ensemble de call-to-action défini pour l'envoi de messages sur une page, dans Instagram ou WhatsApp
  • Les destinations définies sur une application, un évènement ou des Instant Experiences lorsque l'objectif est CONVERSIONS

Publicités carrousel ou publicités image/vidéo

Vous pouvez créer une publicité carrousel comme les publicités hors Boutiques. Si l'objectif de votre campagne est CONVERSIONS, vous pouvez également créer une publicité image/vidéo.

page_id et/ou instagram_actor_id spécifié(s) dans object_story_spec doit/doivent comprendre au moins une boutique appartenant au compte marchand que vous avez choisi de promouvoir dans votre ensemble de publicités ou le catalogue que vous avez choisi de promouvoir dans votre campagne. Ils doivent également être connectés au même compte marchand.

En outre, pour les publicités Boutiques, vous devez spécifier une destination sur site comme destination alternative pour votre page de destination hors site. Pour cela, définissez le champ onsite_destination dans la asset_feed_spec de votre contenu publicitaire.

La destination sur site doit être l'une des suivantes :

  • Page de présentation de la boutique
    La boutique doit appartenir au compte marchand que vous promouvez dans votre ensemble de publicités.

  • Un ensemble de produits
    L'ensemble de produits doit appartenir au catalogue du compte marchand que vous promouvez dans votre ensemble de publicités et doit contenir au moins un produit en stock visible.

  • Un produit
    Le produit doit appartenir au catalogue du compte marchand que vous promouvez dans votre ensemble de publicités.

Exemple de champ onsite_destinations dans asset_feed_spec défini sur la page de boutique

asset_feed_spec= {
  "onsite_destinations": [
    {
      "storefront_shop_id": "<SHOP_STOREFRONT_ID>"
    }
  ]
}

Exemple de champ onsite_destinations dans asset_feed_spec défini dans l’ensemble de produits

asset_feed_spec= {
  "onsite_destinations": [
    {
      "shop_collection_product_set_id": "<PRODUCT_SET_ID>"
    }
  ]
}

Exemple de champ onsite_destinations dans asset_feed_spec défini sur un produit spécifique

asset_feed_spec= {
  "onsite_destinations": [
    {
      "details_page_product_id": "<PRODUCT_ID>"
    }
  ]
}

Exemple de contenu publicitaire pour une image publicitaire

curl \
  -F 'name=Sample Creative' \
  -F 'asset_feed_spec= {
        "onsite_destinations": [
          {
            "storefront_shop_id": "<SHOP_STOREFRONT_ID>"
          }
        ]
      }' \
  -F 'object_story_spec={ 
    "link_data": { 
      "image_hash": "<IMAGE_HASH>", 
      "link": "<OFFSITE_LANDING_URL>", 
      "message": "try it out" 
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>" 
  }' \
  -F 'degrees_of_freedom_spec={
      "creative_features_spec": {
        "standard_enhancements": {
          "enroll_status": "OPT_OUT"
        }
      }
    }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Publicités de catalogue Advantage+ avec un format carrousel

Afin de créer une publicité carrousel pour promouvoir des produits à partir d'un ensemble de produits, vous pouvez suivre la rubrique Démarrer avec les publicités de catalogue Advantage+ - Étape 3 : Fournir un contenu publicitaire.

page_id et/ou instagram_actor_id spécifié(s) dans object_story_spec doit/doivent comprendre au moins une boutique appartenant au compte marchand que vous avez choisi de promouvoir dans votre ensemble de publicités ou le catalogue que vous avez choisi de promouvoir dans votre campagne. Ils doivent également être connectés au même compte marchand.

Pour l’ensemble de produits défini dans le contenu publicitaire :

  • Si vous configurez une campagne avec PRODUCT_CATALOG_SALES comme objectif, l’ensemble de produits que vous choisissez doit appartenir au catalogue que vous avez défini dans votre campagne. Il doit également être le même que l’ensemble de produits que vous choisissez pour promouvoir dans votre ensemble de publicités.
  • Si vous configurez une campagne avec CONVERSIONS comme objectif, l’ensemble de produits que vous choisissez doit appartenir au catalogue du compte marchand que vous choisissez de promouvoir dans votre ensemble de publicités.

Les fonctionnalités supplémentaires prises en charge pour les publicités Boutiques sont optimisées pour les boutiques. Si nous estimons que cela permettrait d’améliorer la performance de vos publicités, nous ajouterons automatiquement différentes optimisations à vos publicités. Pour bénéficier de cette option, définissez shops_bundle sur true dans le asset_feed_spec de votre contenu publicitaire. (Cela comprend les tags de produits automatiques et les raisons de procéder à des achats à ce moment-là, ainsi que d'autres optimisations à l'avenir.)

Les optimisations de la boutique actuellement prises en charge sont les suivantes :

  • Tags de produits automatisés : nous pouvons ajouter automatiquement des tags de produits à votre publicité. Les tags de produit envoient les personnes directement à la page du produit pertinente dans votre boutique.
  • Raisons d’acheter : nous pouvons mettre en avant automatiquement des informations sur les produits de votre boutique, comme « Livraison gratuite », « Tendance » ou « Stock réduit ». Nous pouvons également ajouter une offre existante qui permet aux client·es de réaliser des économises sur les articles sélectionnés de votre boutique.

Pour accepter les tags de produits automatisés, définissez automated_product_tags sur true dans le template_data de la object_story_spec. Pour accepter les raisons d’acheter, définissez reasons_to_shop comme true dans le asset_feed_spec de votre contenu publicitaire.

Exemples de publicités carrousel promouvant un ensemble de produits avec option d'adhésion à des optimisations de boutique entièrement automatisées


Activation de shops_bundle

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'asset_feed_spec= {
        "shops_bundle": true
      }'\
  -F 'object_story_spec={ 
    "template_data": { 
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Activation de automated_product_tags

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'object_story_spec={ 
    "template_data": {
      "automated_product_tags": true
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>"
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Activation de reasons_to_shop

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'asset_feed_spec= {
        "reasons_to_shop": true
      }'\
  -F 'object_story_spec={ 
    "template_data": { 
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Note :

  • Les publicités Boutiques ne prennent pas en charge les catégories des publicités de catalogue Advantage+.
  • L’optimisation des tags de produits automatisée n'est prise en charge que sur Instagram.

Contenu publicitaire Advantage+ pour catalogue

Les publicités Boutiques prennent également en charge le contenu publicitaire Advantage+ pour catalogue. Cette fonctionnalité permet de montrer différents formats et contenus publicitaires à divers comptes de l’Espace Comptes, selon les éléments les plus susceptibles de les intéresser.

Vous pouvez suivre les instructions dans la rubrique Contenu publicitaire Advantage+ pour catalogue - Étape 3 : Fournir du contenu publicitaire pour configurer votre contenu publicitaire.

page_id et/ou instagram_actor_id spécifié(s) dans object_story_spec doit/doivent comprendre au moins une boutique appartenant au compte marchand que vous avez choisi de promouvoir dans votre ensemble de publicités ou le catalogue que vous avez choisi de promouvoir dans votre campagne. Ils doivent également être connectés au même compte marchand.

Pour l’ensemble de produits défini dans le contenu publicitaire :

  • Si vous configurez une campagne avec PRODUCT_CATALOG_SALES comme objectif, l’ensemble de produits que vous choisissez doit appartenir au catalogue que vous avez défini dans votre campagne. Il doit également être le même que l’ensemble de produits que vous choisissez pour promouvoir dans votre ensemble de publicités.
  • Si vous configurez une campagne avec CONVERSIONS comme objectif, l’ensemble de produits que vous sélectionnez doit appartenir au catalogue du compte marchand que vous choisissez de promouvoir dans votre ensemble de publicités.

Exemple de contenu publicitaire Advantage+ pour catalogue

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'asset_feed_spec= {
    "optimization_type":"FORMAT_AUTOMATION",
    "ad_formats": ["CAROUSEL", "COLLECTION"],
    "images": [{"hash": "<CUSTOMIZED_IMAGE_HASH>"}],
    "descriptions": [{"text": "{{product.description}}", "From {{product.current_price}}", ...]
    } 
   }'\
  -F 'object_story_spec={ 
    "template_data": { 
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    “instagram_actor_id” : “<INSTAGRAM_ACTOR_ID>” 
  }' \
  -F 'degrees_of_freedom_spec={
      "creative_features_spec": {
        "standard_enhancements": {
          "enroll_status": "OPT_OUT"
        }
      }
    }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Étape 4 : Créer une publicité

Enfin, vous pouvez créer une publicité faisant référence à un contenu publicitaire.

curl \
-F 'status=PAUSED' \
-F 'name=Test' \
-F 'adset_id=<ADSET_ID>' \
-F 'creative= {
       "creative_id": "<CREATIVE_ID>"
    },
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

Publicités Boutiques avec les campagnes de shopping Advantage+

Les publicités Boutiques sont prises en charge ensemble avec les campagnes de shopping Advantage+, dont on pense qu'elles sont encore plus performantes lorsqu'elles sont combinées.

Pour créer une campagne de shopping Advantage+ avec des publicités Boutiques, suivez les étapes dans Campagnes de shopping Advantage+ - Étape 2 : Créer une campagne afin de créer tout d’abord une campagne.

Lors de la création d'un ensemble de publicités pour les campagnes de shopping Advantage+ avec des publicités Boutiques, similaires aux publicités Boutiques seules, définissez le destination_type comme SHOP_AUTOMATIC et spécifiez votre compte marchand dans promoted_object.

curl \
  -F 'name=Advantage+ Shopping Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]}}' \
  -F 'destination_type=SHOP_AUTOMATIC' \
  -F 'promoted_object={"omnichannel_object":{"onsite":[{"commerce_merchant_settings_id":"<COMMERCE_ACCOUNT_ID>"}],"pixel":[{"pixel_id": "<PIXEL_ID>","custom_event_type": "PURCHASE"}]}}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Pour plus d'informations, consultez la rubrique Optimisation des conversions multi-canales pour les campagnes de shopping Advantage+.

Lors de la création d'une campagne de shopping Advantage+ avec des publicités Boutiques, la spécification est identique à celle des publicités Boutiques seules. Pour plus de détails, consultez la rubrique ci-dessus Étape 3 : Fournir un contenu publicitaire.

Éligibilité commerciale pour les publicités Boutiques

Pour obtenir des ID pertinents pour les publicités Boutiques, vous devez obtenir l’autorisation catalog_management de la part de votre client.

Afin de créer des publicités Boutiques pour une page, cette dernière doit comporter une boutique visible sur le site. Vous pouvez l’obtenir à partir de

curl -i -X GET \
"https://graph.facebook.com/v19.0/<PAGE_ID>/commerce_merchant_settings?fields=id,shops{id,fb_sales_channel{status,fb_page{id,name}},is_onsite_enabled,shop_status}&access_token=<PAGE_ACCESS_TOKEN>"

Exemple de réponse

{
  "id":"<commerce_account_id>",
  "shops": {
    "data": [
      {
        "fb_sales_channel": {
          "status": "STAGING",
          "fb_page": {
            "name": "Page 1",
            "id": "<page_id>"
          }
        },
        "id": "<shop_id_1>",
        "is_onsite_enabled": true,
        "shop_status": "INACTIVE"
      },
      {
        "fb_sales_channel": {
          "status": "ENABLED",
          "fb_page": {
            "name": "Page 2",
            "id": "<page_id>"
          }
        },
        "id": "<shop_id_2>",
        "is_onsite_enabled": true,
        "shop_status": "ACTIVE"
      }
    ],    
    // …
}

Pour la page avec laquelle vous souhaitez créer des publicités Boutiques, vérifiez que is_onsite_enabled et shop_status sont respectivement true et ACTIVE. Si c'est le cas, vous pourrez créer des publicités Boutiques pour la page en suivant les instructions du guide.

Obtenir les ID de commerce pour créer des publicités Boutiques

Pour créer une publicité Boutiques pour une page, vous avez besoin de :

Vous pouvez obtenir les ID du compte marchand et de la boutique en exécutant la requête précédente.

curl -i -X GET \
"https://graph.facebook.com/v19.0/<PAGE_ID>/commerce_merchant_settings?fields=id,shops{id,fb_sales_channel{fb_page{id,name}}}&access_token=<PAGE_ACCESS_TOKEN>"

Un compte marchand peut comprendre plusieurs boutiques, vous devez sélectionner celle qui contient la page avec laquelle vous souhaitez créer des publicités Boutiques.

Pour les ID de catalogue, d’ensemble de produits et de produit

curl -i -X GET \
"https://graph.facebook.com/v19.0/<PAGE_ID>/commerce_merchant_settings?fields=id,product_catalogs{id,product_sets}&access_token=<PAGE_ACCESS_TOKEN>"

Exemple de réponse

{
  "id": "<commerce_account_id>",
  "product_catalogs": {
    "data": [
      {
        "id": "<product_catalog_id>",
        "product_sets": {
          "data": [
            {
              "id": "<product_set_id>",
              "name": "Product Set 1",
              "filter": "{\"product_item_id\":{\"is_any\":[]}}"
            },
          ],
        }
      }
    ]
  }
}