API Marketing

Création d’un contenu de marque

Les créateurs, les célébrités et les sociétés de médias peuvent partager du contenu de marque sur Facebook. Les publications de contenu de marque correspondent à tout contenu qui présente ou qui est influencé par un annonceur ou une équipe marketing pour un échange de valeurs. Pour utiliser cette fonctionnalité, vous devez vous conformer à nos politiques sur le contenu de marque et à nos règles publicitaires. En outre, vous devez identifier votre partenaire commercial dans les publications à l’aide de l’outil de contenu de marque ou de l’API Marketing.

La plupart des personnes qui créent des publications de contenu de marque ont déjà accès à l’outil de contenu de marque et disposent déjà de Pages ou de profils vérifiés. Si l’outil de contenu de marque n’est pas disponible sur votre Page, envoyez une demande d’accès.

Vous pouvez utiliser l’API Marketing pour créer des publications de contenu de marque. Vous pouvez aussi utiliser l’outil de contenu de marque, qui est disponible dans le Gestionnaire de publicités et dans l’application Mentions. Consultez les Pages d’aide pour les publicités, contenu de marque.

Présentation

Créez du contenu de marque pour les différents formats de publication répertoriés dans les Pages d’aide pour les publicités, contenu de marque.

Vous pouvez appeler des points de terminaison différents pour chaque format de publication et insérer les sponsor_tags dans la publication. Une identification de sponsor redirige vers une Page Facebook.

Vous pouvez autoriser vos partenaires commerciaux à booster directement vos publications en y ajoutant le direct_share_status. Définissez direct_share_status = 1 pour autoriser un partenaire commercial à booster votre publication. Sinon, définissez direct_share_status = 0.

Créer une mise à jour de statut

Pour commencer, vous devez publier sur le point de terminaison feed d’une Page afin de créer une mise à jour de statut. La demande POST doit contenir les valeurs des champs sponsor_id, share_status et message.

curl -X POST "https://graph.facebook.com/PAGE_ID/feed" 
  -F "access_token=TOKEN" 
  -F "message=Check out some beautiful products in this grocery store" 
  -F "direct_share_status=1"
  
  {"id":"ID"}

Ajout de photos

Vous pouvez ajouter des photos à votre publication sur le point de terminaison photos d’une Page. La demande POST doit contenir les valeurs des champs sponsor_id, share_status et message.

Indiquez un champ url à associer à une photo existante. Vous pouvez également importer la photo sous forme de pièce jointe à la publication. Consultez la section Importation de photos.

  curl -X POST "https://graph.facebook.com/PAGE_ID/feed" 
  -F "access_token=TOKEN" 
  -F "message=Check out some beautiful products in this grocery store" 
  -F "direct_share_status=1" 
  -F "url=https://xx.cdn.net/v/t31.0-8/13064650_505613696297499_6399089570275517473_o.jpg"
  
 {"id":"372501189608751_701886166670250"}

Publication d’une vidéo

Pour publier une vidéo avec du contenu de marque, vous devez suivre plusieurs étapes :

  • Effectuez un appel pour indiquer que vous souhaitez importer une vidéo. L’API renvoie un ID d’objet vidéo que vous pouvez utiliser pour importer la vidéo.
  • Importez la vidéo.
  • Terminez le transfert de la vidéo en définissant le statut de partage. Indiquez également le sponsor_id pour la vidéo, qui ajoute du contenu de marque à l’actualité.

Consultez la section Importation de vidéos.

Dans cet exemple, nous lançons une demande, importons la vidéo et définissons le sponsor_id et le direct_share_status.

 curl -X POST "https://graph-video.facebook.com/VERSION/PAGE_ID/videos" 
  -F "access_token=$at" 
  -F "upload_phase=finish" 
  -F "upload_session_id=SESSION_ID" 
  -F "sponsor_id=ID" 
  **-F "direct_share_status=1"**

Si l’opération aboutit, vous verrez ceci :

{"success":true}

Vidéo en direct

Pour créer une vidéo en direct avec du contenu de marque, vous devez procéder comme suit :

  • Créez un objet vidéo en direct
  • Mettez à jour l’objet vidéo en direct et ajoutez le sponsor_id
  • Démarrez votre stream vidéo

Pour en savoir plus sur la création et la gestion de streams vidéo en direct, consultez notre API Live Video. Vous pouvez interroger la liste des vidéos en direct d’une Page et utiliser un ID de vidéo pour mettre à jour le sponsor_id. Vous pouvez aussi utiliser l’ID renvoyé lors de la création de votre vidéo en direct.

Mise à jour d’un contenu de marque

Nous ne prenons pas en charge les modifications apportées à un contenu de publication portant un ID de marque sur le web ou sur les appareils mobiles. Toutefois, vous pouvez utiliser l’API Marketing pour mettre à jour une publication afin d’y inclure ou de remplacer un sponsor. Pour remplacer le sponsor, modifiez la valeur du champ sponsor_id d’un objet de publication.

Pour ajouter un sponsor à une publication, effectuez une demande POST sur une publication de Page et indiquez un sponsor_id. Pour remplacer le sponsor d’une publication, transmettez le nouveau champ sponsor_id.

Vous pouvez autoriser ou empêcher un partenaire commercial de booster directement une publication. Indiquez le sponsor_id et la modification que vous apportez au direct_share_status.

curl -X POST "https://graph.facebook.com/PAGE_POST_ID" 
  -F "access_token=TOKEN" 
  -F "direct_share_status=1"
  
 {"success":true}