Publicités jouables pour applications mobiles

Les publicités jouables sont des publicités interactives qui permettent aux annonceurs d’applications mobiles de proposer un aperçu de leur application avant son téléchargement. Les publicités jouables contiennent une vidéo de présentation et un message sur lequel l’utilisateur peut appuyer pour essayer. Lorsqu’un utilisateur appuie sur la vidéo, une démo du jeu s’ouvre en plein écran et lui permet d’interagir. La publicité peut afficher un call-to-action pendant toute la durée de la démo ou à la fin de celle-ci.

Les publicités jouables sont diffusées sur :

Limitations

  • Les vidéos de présentation ne sont pas diffusées dans les placements Audience Network.
  • Dans les placements Instagram, seules les vidéos de présentation sont visibles.
  • Les publicités jouables sont uniquement disponibles avec l’objectif Installations d’applications.

Importez une publicité jouable à l’aide du Gestionnaire de publicités plutôt qu’avec l’API.

Caractéristiques

Consultez l’article Publicités jouables dans les pages d’aide sur les publicités pour connaître les caractéristiques des vidéos de présentation, et en savoir plus sur les fichiers HTML et Zip.

Créer une publicité jouable avec l’API

Conditions requises

Vous aurez besoin des éléments suivants :

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

Envoyez une demande POST au point de terminaison /act_AD_ACCOUNT_ID/adsets pour créer un ensemble de publicités.

Lorsque vous avez plusieurs placements, vous pouvez importer plusieurs vidéos et spécifier laquelle utiliser pour chaque placement de votre publicité. Dans l’exemple suivant, plusieurs placements sont spécifiés avec publisher_platforms, facebook_positions et audience_network_positions.

Formaté pour plus de lisibilité.
curl -X POST "https://graph.facebook.com/act_AD_ACCOUNT_ID/adsets
  ?name=AD_SET_NAME
  &access_token=ACCESS_TOKEN
  &bid_amount=2
  &billing_event=IMPRESSIONS
  &campaign_id=AD_CAMPAIGN_ID
  &daily_budget=1000
  &optimization_goal=APP_INSTALLS
  &promoted_object={  
    'application_id':'APP_ID',
    'object_store_url':'APP_STORE_URL'
    }
  &targeting={
    'device_platforms': ['mobile'],
    'geo_locations': {countries:['US']},
    'publisher_platforms': ['facebook','audience_network'],
    'facebook_positions': ['feed'],
    'audience_network_positions': ['rewarded_video','classic'],
    'user_os': ['ANDROID']
    }"

Si la demande aboutit, elle renvoie un ID d’ensemble de publicités jouables.

Étape 2 : Importer un fichier HTML ou Zip dans votre compte publicitaire

Envoyez une demande POST au point de terminaison /act_AD_ACCOUNT_ID/adsets pour importer votre ensemble de publicités jouables. Utilisez le paramètre source pour un fichier HTML ou le paramètre source_zip pour un fichier Zip.

Formaté pour plus de lisibilité.
curl -X POST "https://graph.facebook.com/act_{your-ad-account}/adplayables
  ?name={your-playable-ad-name}
  &source=@{your-source-location}  
  &access_token={your-system-access-token}"

Si la demande aboutit, elle renvoie un ID d’élément jouable.

Étape 3 : Importer un fichier vidéo de présentation dans un compte publicitaire

Envoyez une demande POST au point de terminaison /act_AD_ACCOUNT_ID/advideos pour importer une vidéo de présentation. Utilisez le paramètre source pour un fichier HTML ou le paramètre source_zip pour un fichier Zip.

Formaté pour plus de lisibilité.
curl -X POST "https://graph-video.facebook.com/act_AD_ACCOUNT_ID/advideos
  ?source=@SOURCE_LOCATION
  &access_token=AD_ACCOUNT_ID"

Si la demande aboutit, elle renvoie un ID de vidéo de présentation.

Étape 4 : Créer un contenu publicitaire

Envoyez une demande POST au point de terminaison /act_AD_ACCOUNT_ID/adsets pour créer un contenu publicitaire.

Formaté pour plus de lisibilité.
curl -X POST "https://graph.facebook.com/act_AD_ACCOUNT_ID/adcreatives
  ?name=PLAYABLE_AD_CREATIVE_NAME
  &access_token=ACCESS_TOKEN
  &playable_asset_id=PLAYABLE_ASSET_ID
  &object_story_spec={
    'page_id': 'PAGE_ID',
    'video_data': {
      'call_to_action': {
        'type':'INSTALL_MOBILE_APP',
        'value':{
          'application':'APP_ID',
          'link':'LINK_URL'
        }
      },
      'image_url': 'THUMBNAIL_URL',
      'link_description': 'CTA_MESSAGE',
      'video_id': 'LEAD_IN_VIDEO_ID'
    }
  }"

Si la demande aboutit, elle renvoie un ID de contenu publicitaire.

Étape 5 : Créer une publicité

Envoyez une demande POST au point de terminaison /act_AD_ACCOUNT_ID/adsets.

Formaté pour plus de lisibilité.
curl -X POST "https://graph.facebook.com/act_AD_ACCOUNT_ID/ads
  ?name=PLAYABLE_AD_NAME
  &access_token=ACCESS_TOKEN
  &adset_id=PLAYABLE_AD_SET_ID
  &creative={'creative_id':'PLAYABLE_AD_CREATIVE_ID'}
  &status=PAUSED"
  

Après avoir testé la publicité, changez le paramètre status en ACTIVE.

Vous ne pouvez pas tester les publicités sur des iPads. Pour les tests sous iOS, utilisez un appareil mobile.

Résolution des erreurs

Lorsque vous importez des éléments jouables au cours de la création d’une publicité jouable, un message d’erreur peut apparaître et signaler que cet élément n’est pas valide.

Vous trouverez ci-dessous les messages d’erreur les plus fréquents et des conseils pour résoudre le problème.

ErreurCorrection possible

ID d’application non valide

Ce message d’erreur s’affiche si la section Application n’est pas sélectionnée ou n’a pas l’autorisation de créer une publicité pour cette application. Sélectionnez la section Application et vérifiez que vous disposez des autorisations appropriées pour créer la publicité pour cette application.

Appel de la fonction clic sur CTA manquant

Le code jouable n’utilise pas la fonction JavaScript FbPlayableAd.onCTAClick() pour le call-to-action. Utilisez cette fonction dans votre code CTA.

Trop d’éléments secondaires dans le paquet importé

Votre fichier Zip contient plus de 100 fichiers. Utilisez moins de 100 fichiers.

Importation trop volumineuse

Votre fichier Zip fait plus de 5 Mo. Réduisez la taille du fichier Zip pour qu’il fasse moins de 5 Mo.

Fichier importé trop volumineux

Votre fichier HTML ou le fichier index.html fait plus de 2 Mo. Réduisez la taille du fichier.

Fichier importé contenant une redirection vers un lien externe

Un ou plusieurs éléments contiennent un code de redirection JavaScript. Supprimez ce code.

HTML non pris en charge par la publicité jouable

Cette erreur apparaît en cas d’échec de l’analyse antivirus.

Objectif non pris en charge par les publicités jouables

L’objectif sélectionné n’est pas pris en charge. Seul l’objectif Installations d’applications est pris en charge par les publicités jouables. Avant de créer votre publicité, sélectionnez l’objectif Installations d’applications dans le Gestionnaire de publicités.

Placement non pris en charge par les publicités jouables

Vous avez sélectionné un placement non pris en charge par les publicités jouables.