Facebook Ads
Sponsoriser une publication
Sponsorisez une publication en la soumettant à la plateforme publicitaire de Facebook
POST
Sponsorisez une publication Facebook existante pour créer une annonce.
Cet endpoint vous permet de convertir vos publications organiques en annonces payantes avec des paramètres de ciblage, de budget et de planification personnalisés.
- Les montants du budget et de l’enchère doivent être spécifiés en USD avec jusqu’à deux décimales.
- L’annonce doit être diffusée pendant au moins 30 heures pour respecter les exigences de Facebook.
- Vous pouvez utiliser l’endpoint interests pour trouver les ID de centres d’intérêt pour le ciblage.
- Facebook peut prendre jusqu’à 24 heures pour examiner et approuver les publications sponsorisées.
- Si vous utilisez
fbPostIddirectement (au lieu depostIdAyrshare), assurez-vous qu’il s’agit d’un ID de publication Facebook valide.
Objectifs publicitaires
Chaque annonce doit avoir un objectif. L’objectif détermine la manière dont l’annonce sera optimisée pour l’affichage.engagement: Cet objectif vise à augmenter l’engagement tout en garantissant que l’annonce atteigne le nombre maximum d’utilisateurs uniques. Il équilibre la visibilité avec l’engagement, en montrant l’annonce à autant de personnes différentes que possible susceptibles d’interagir avec elle.interactions: Conçu pour stimuler les interactions, telles que les likes, les commentaires et les partages, sur l’annonce. Facebook priorise l’affichage de l’annonce aux utilisateurs les plus susceptibles d’interagir avec elle.awareness_views: Se concentre sur l’augmentation de la notoriété de la marque en maximisant le nombre de fois que l’annonce est affichée. Il priorise l’affichage de l’annonce autant de fois que possible dans le cadre du budget, quelle que soit la portée unique.awareness_audience: Vise à améliorer la notoriété de la marque en maximisant le nombre de personnes uniques qui voient l’annonce. Il garantit que l’annonce atteint autant d’utilisateurs différents que possible et maximise la taille de l’audience unique plutôt que de la montrer plusieurs fois à la même audience.
Paramètres d’en-tête
Paramètres du corps
L’ID du compte publicitaire Facebook sur lequel sponsoriser la publication. L’ID du compte peut être récupéré depuis
l’endpoint des comptes publicitaires.
Nom de votre annonce (apparaît dans le Facebook Ad Manager) au format
{adName} - {postId or fbPostId} - {current date}.Montant maximum de l’enchère en USD. Le montant minimum de l’enchère est de 1,00 $.
Budget quotidien en USD. Le budget minimum est de 1,00 $.
L’ID de publication sociale Facebook de la publication à sponsoriser, qui vous permet
de créer une annonce à partir d’une publication créée directement sur Facebook. Il s’agit de l’ID de la publication sur
Facebook, pas d’Ayrshare. Requis si
postId n’est pas défini.L’objectif de l’annonce. Valeurs :
engagement, interactions, awareness_views et
awareness_audience. Consultez les détails des objectifs publicitaires ci-dessus pour
plus d’informations.Localisations cibles de l’annonce avec un objet de tableaux :
countries, regions, cities.L’ID de publication Ayrshare de la publication à sponsoriser. Requis si
fbPostId n’est pas défini.Le statut de l’annonce. Valeurs :
active et paused.Vous pouvez modifier ultérieurement le statut de l’annonce en utilisant l’endpoint update ad.Contrôle le partage du budget de l’ad set au niveau de la campagne par Meta.
Meta exige désormais ce champ sur chaque campagne créée sans budget au niveau de la campagne, donc Ayrshare l’envoie toujours — la valeur par défaut est
false pour la rétrocompatibilité.Définissez sur true pour permettre à Meta de partager jusqu’à ~20 % du budget d’un ad set avec d’autres ad sets de la même campagne afin d’optimiser les performances globales. Consultez la référence du groupe de campagnes publicitaires de Meta pour plus de détails.Suivez l’annonce à l’aide d’un Facebook Pixel.
Ajoutez des balises UTM à l’URL de l’annonce.Par exemple, si l’URL de destination est
https://www.mysite.com/my-post et que les balises d’URL ajoutées sont :utm_source=ayrshare, utm_medium=social et utm_campaign=ayrshare-social.L’URL de l’annonce sera :
https://www.mysite.com/my-post?utm_source=ayrshare&utm_medium=social&utm_campaign=ayrshare-social.Meta exige que les annonceurs des catégories publicitaires spéciales auto-identifient la catégorie de leur campagne.Si votre entreprise appartient à l’une de ces catégories, vous devez sélectionner la catégorie appropriée lors de la sponsorisation de votre publication.Les valeurs suivantes sont prises en charge :
housing: Annonces qui promeuvent ou renvoient directement à une opportunité de logement ou à un service connexe, y compris, mais sans s’y limiter, les annonces de vente ou de location d’une maison ou d’un appartement, l’assurance habitation, l’assurance hypothécaire, les prêts hypothécaires, les réparations domiciliaires et les services d’évaluation ou de prêt sur valeur nette du domicile.financial_product_services: Annonces qui promeuvent ou renvoient directement à une offre de produits et services financiers, y compris le crédit.employment: Annonces qui promeuvent ou renvoient directement à une opportunité d’emploi, y compris, mais sans s’y limiter, les emplois à temps partiel ou à temps plein, les stages ou les programmes de certification professionnelle. Les annonces connexes appartenant à cette catégorie incluent des promotions pour des tableaux d’emploi ou des salons de l’emploi, des services d’agrégation ou des annonces détaillant les avantages qu’une entreprise peut offrir, indépendamment d’une offre d’emploi spécifique.issues_elections_politics: Annonces réalisées par, au nom de, ou concernant un candidat à une fonction publique, une personnalité politique, un parti politique ou plaidant pour l’issue d’une élection à une fonction publique. Cela inclut également les annonces concernant toute élection, référendum ou initiative de vote, y compris les campagnes électorales « Allez voter ». Les annonces réglementées comme publicité politique ou concernant des questions sociales dans tout lieu où l’annonce est diffusée. Si vous sélectionnez questions, élections ou politique, vous devez sélectionner le pays dans lequel vous souhaitez diffuser ces annonces. Vous devez être autorisé à diffuser des annonces concernant des questions sociales, des élections ou la politique dans le pays spécifié.
Date et heure de fin au format ISO 8601 (doit être au moins 30 heures après le début), par exemple
2025-03-01T00:00:00Z.Si non défini, l’annonce sera diffusée indéfiniment et aura une date de fin ongoing.Excluez des localisations à l’aide d’un objet avec des tableaux de
countries, regions et cities.Le genre de l’audience. Valeurs :
all, male, female.Les centres d’intérêt cibles de l’annonce sous forme d’un tableau d’ID de centres d’intérêt
Facebook.
Âge maximum pour le ciblage de l’annonce (par défaut : 65).
Âge minimum pour le ciblage de l’annonce (par défaut : 18).
Date et heure de début au format ISO 8601, par exemple
2025-03-01T00:00:00Z.Si non défini, l’annonce démarrera immédiatement.Le bénéficiaire de l’annonce pour la conformité au Digital Services Act (DSA) pour les pays de l’UE. Doit être défini
conjointement avec
dsaPayor si l’un ou l’autre est fourni. Veuillez consulter notre guide
DSA pour plus d’informations.Le payeur de l’annonce pour la conformité au Digital Services Act (DSA) pour les pays de l’UE. Doit être défini
conjointement avec
dsaBeneficiary si l’un ou l’autre est fourni.