Publicités de catalogue Advantage+ pour les applications mobiles

Les SDK Facebook vous permettent de configurer des publicités de catalogue Advantage+ sur mobile. Vous devriez incorporer des liens profonds ou des liens profonds différés dans votre application pour que ses utilisateurs et utilisatrices jouissent d’une expérience optimale.

Étape 1 : Configurer le SDK Facebook Mobile pour iOS/Android

Intégrez le SDK Facebook pour iOS ou Android.

Étape 2 : Configurer Mobile App Events

Sur le Web, utilisez les évènements de pixel Meta tels que ViewContent pour suivre les interactions entre les évènements. Sur mobile, vous pouvez suivre les mêmes évènements avec App Events.

Vous devez envoyer les trois mêmes évènements obligatoires à partir de votre application comme vous le faites à partir de votre pixel : ViewContent, AddToCart et Purchase. Les publicités de catalogue Advantage+ nécessitent que ces évènements fonctionnent correctement.

Évènement iOSÉvènement AndroidÉquivalent Web

FBSDKAppEventNameViewedContent

AppEventsConstants:: EVENT_NAME_VIEWED_CONTENT

ViewContent

FBSDKAppEventNameAddedToCart

AppEventsConstants:: EVENT_NAME_ADDED_TO_CART

AddToCart

[[FBSDKAppEvents shared] logPurchase:(double) currency:(NSString *) parameters:(NSDictionary *)];

AppEventsConstants:: EVENT_NAME_PURCHASED

Purchase

Par exemple, un évènement ViewContent se déclenche lorsqu’une personne consulte un produit dans une application :

[[FBSDKAppEvents shared] logEvent:FBSDKAppEventNameViewedContent
  valueToSum:54.23
  parameters:@{
    FBSDKAppEventParameterNameCurrency    : @"USD",
    FBSDKAppEventParameterNameContentType : @"product",
    FBSDKAppEventParameterNameContentID   : @"123456789"
  }
];
Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "1234");

logger.logEvent(AppEventsConstants.EVENT_NAME_VIEWED_CONTENT,
                120.00,
                parameters);

Vous pouvez également fournir un ensemble de valeurs JSON pour l’ID de produit lorsqu’un évènement intervient pour plusieurs produits. Vous pouvez, par exemple, envoyer plusieurs produits avec l’évènement Purchase.

[[FBSDKAppEvents shared] logPurchase:54.23 currency : @"USD" parameters:@{
  FBSDKAppEventParameterNameContentID   : @"['1234','5678']",
  FBSDKAppEventParameterNameContentType : @"product"
  }
];
Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "['1234', '5678']");

logger.logEvent(AppEventsConstants.EVENT_NAME_PURCHASED,
                180.00,
                parameters);

ID de contenu multiples

Si vous avez plusieurs ID de contenu, fournissez un ensemble de valeurs JSON échappé, par exemple :

"[\"1234\",\"5678\"]"

Paramètres facultatifs

Pour chaque évènement d’application, vous pouvez envoyer des paramètres supplémentaires, notamment quand une personne effectue un achat :

NomDescription

_valueToSum

chaîne

Facultatif.
Valeur du produit ou montant de l’achat

fb_currency

chaîne

Facultatif.
Devise du produit ou montant de l’achat

Utiliser un Partenaire de mesure mobile (MMP)

Si vous utilisez un Mobile Measurement Partner pour signaler des évènements à Facebook, vous pouvez ajuster votre implémentation pour envoyer également les évènements obligatoires. Ce processus diffère selon le MMP, mais ressemble généralement à ce qui suit :

  1. Ajustez votre intégration pour signaler les trois évènements obligatoires pour le MMP, ainsi que les paramètres obligatoires.
  2. Avec votre MMP, mappez vos noms d’évènement sur les noms d’évènement Facebook.
  3. Testez App Events.

Évènements obligatoires pour MMP

Les évènements suivants sont obligatoires :

NomDescription

fb_mobile_content_view

Lorsqu’un compte d’Espace Comptes a consulté un produit.

fb_mobile_add_to_cart

Lorsqu’un article a été ajouté au panier.

fb_mobile_purchase

Lorsqu’un ou plusieurs articles ont été achetés.

Pour que les publicités de catalogue Advantage+ fonctionnent, vous devez également ajouter deux paramètres supplémentaires :

  • L’ID de l’article consulté, ajouté au panier ou acheté.
  • Une précision indiquant s’il s’agit d’un ID de product ou de product_group.

Les paramètres supplémentaires disponibles sont les suivants :

NomDescription

fb_content_type

chaîne

product ou product_group

fb_content_id

chaîne

Obligatoire.
Une chaîne contenant un ensemble encodé au format JSON des ID des produits ou groupes de produits du retailer

_valueToSum

chaîne

Facultatif.
Valeur des produits achetés

fb_currency

chaîne

Facultatif.
Devise du produit ou montant de l’achat

Note : vous devez également envoyer les paramètres _valueToSum et fb_currency lorsqu’une personne achète des articles.

Tester App Events

Le moyen le plus facile pour tester le fonctionnement de votre intégration est d’utiliser l’Assistant publicitaire des apps afin d’afficher les évènements et paramètres signalés à Facebook en temps réel.

  1. Sélectionnez une application.
  2. Deux outils s’affichent alors en bas de page. Sélectionnez Tester App Events.
  3. Vous avez deux options : consulter les évènements signalés par vous ou par un ID publicitaire spécifique. Dans la plupart des cas, l’option Moi est suffisante. Assurez-vous que Facebook est installé sur votre appareil et que vous êtes connecté·e.
  4. À mesure que vous réalisez des actions, les évènements s’affichent dans l’outil avec leurs paramètres.

Si votre intégration a réussi, les noms des trois évènements suivants s’affichent :

  • FB_MOBILE_CONTENT_VIEW
  • FB_MOBILE_ADD_TO_CART
  • FB_MOBILE_PURCHASE

En savoir plus sur les évènements d’application iOS et Android.

Pour vérifier que vos évènements d’application fonctionnent, vous pouvez consulter les évènements récents dans le

Gestionnaire d’évènements Facebook

.

Étape 3 : Configurer les liens profonds

Si vous fournissez des liens profonds dans votre fil de produits, toute personne qui interagit avec votre publicité sur Facebook peut directement accéder à un emplacement spécifique de votre application. Par exemple, lorsqu’une personne clique sur une publicité dans Facebook sur mobile, elle voit la publicité dans votre application mobile. Voir les sections Liens profonds et Vérifier les liens profonds pour obtenir plus d’informations.

Redirection vers le Web par rapport à l’App Store

Si vous utilisez les liens profonds, vous pouvez indiquer un comportement de redirection au cas où une personne n’aurait pas installé votre application. Quand vous fournissez des liens profonds dans votre fil de produits, les personnes qui ne disposent pas de votre application voient l’URL Web du produit dans la publicité.

Comme votre objectif consiste certainement à augmenter les ventes, vous voudrez probablement que les clients et clientes potentiel·elle·s puissent accéder aux pages produits, plutôt que de devoir installer votre application. Donc, dans ce cas, le système bascule par défaut sur les URL Web, même si vous pouvez spécifier un autre comportement pour plus de contrôle. Configurez le comportement de redirection sur applink_treatment lorsque vous créez votre publicité de catalogue Advantage+ et utilisez l’une des options suivantes :

NomDescription

web_only

Renvoie toujours l’utilisateur ou l’utilisatrice vers l’URL Web indiquée. Tous les liens profonds de votre fil sont alors remplacés.

deeplink_with_web_fallback

Si l’application est installée et que les liens profonds correspondants existent, renvoie l’utilisateur ou l’utilisatrice vers votre application. Si l’une de ces conditions n’est pas remplie, renvoie l’utilisateur ou l’utilisatrice vers l’URL du site Web.

deeplink_with_appstore_fallback

Si l’application est installée et que les liens profonds correspondants existent, renvoie l’utilisateur ou l’utilisatrice vers votre application. Si l’application n’est pas installée, renvoie l’utilisateur ou l’utilisatrice vers l’App Store pour la rechercher.

Étape 4 : Configurer le fil de produits

Vous devez maintenant indiquer les liens profonds menant vers vos publicités de catalogue Advantage+. Voir la section Catalogue produits, Liens profonds pour obtenir plus d’informations.

Étape 5 : Spécifications de suivi

Pour mesurer les évènements de conversion de votre site Web et de vos applications mobiles, assurez-vous que toutes les publicités de catalogue Advantage+ disposent des spécifications de suivi définies pour les évènements suivants :

ÉvènementSpécification de suivi

offsite_conversion

{ 'action.type': 'offsite_conversion', 'fb_pixel': FB_PIXEL_ID }

app_custom_event

{'action.type':'app_custom_event','application':APP_ID}

mobile_app_install

{'action.type':'mobile_app_install','application':APP_ID}

Facebook peut ainsi suivre tous les évènements concernant une publicité de catalogue Advantage+, que l’utilisateur ou l’utilisatrice consulte votre site Web ou votre application. Pour définir ces spécifications de suivi, procédez comme suit :

use FacebookAds\Object\Ad;
use FacebookAds\Object\Fields\AdFields;

$ad = new Ad(<AD_ID>);

$ad->{'tracking_spec'} = array(
  array(
    'action.type' => array('app_custom_event'),
    'application' => array($app_id),
  ),
  array(
    'action.type' => array('offsite_conversion'),
    'offsite_pixel' => array(<PIXEL_ID>),
  ),
  array(
    'action.type' => array('mobile_app_install'),
    'application' => array($app_id),
  ),

);
$ad->update();
curl \
  -F 'tracking_spec=[ 
    {"action.type":["app_custom_event"],"application":["101"]}, 
    {"action.type":["offsite_conversion"],"offsite_pixel":["<PIXEL_ID>"]}, 
    {"action.type":["mobile_app_install"],"application":["101"]} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<AD_ID>