Réservation

La réservation vous permet de planifier et d’acheter vos campagnes à un prix fixe, en vous offrant une couverture optimisée et une fréquence contrôlée tout en vous aidant à prévoir les performances de votre campagne. Ce procédé est comparable à l’achat traditionnel de publicités télévisées. Il s’agit d’une option spécialisée et avancée que la plupart des annonceurs n’utilisent que s’ils souhaitent être sûrs que leurs publicités couvrent un certain nombre de comptes de l’Espace Comptes.

La réservation est compatible avec tous les types de publicités et tous les appareils. Étant donné que Facebook cible en fonction de personnes réelles et non de cookies, nous pouvons prévoir la couverture et contrôler la fréquence de manière plus précise sur les différents appareils.

Restrictions

• Disponible pour certains comptes publicitaires. Vérifiez le paramètre CAN_USE_REACH_AND_FREQUENCY dans le compte publicitaire.
• La valeur de stop_time de l’ensemble de publicités doit se situer dans les 180 jours suivant une prévision.
• Les comptes font également l’objet de limites selon les pays ; vérifiez avec un appel d’API GET : https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>?fields=rf_spec.
• Ne définissez qu’un pays à la fois dans target_spec.
• Aucune version d’iOS minimale pour user_os, comme iOS_ver_2.0_and_above.
• Lorsque vous créez ou mettez à jour une campagne de réservation, vous ne pouvez pas définir le budget quotidien ou global, la limite d’impressions quotidienne ou globale, la limite de répétition, l’enchère externe ni le champ PacingType.

Recherchez rf_spec pour connaître les limites applicables :

Les résultats se présentent comme suit :

{
  "rf_spec": {
    "min_reach_limits": {
      "US": 1000000,
      "CA": 1000000,
    },
    "countries": [
      "US",
      "CA",
    ],
    "min_campaign_duration": {
      "US": 3,
      "CA": 3,
    },
    "max_campaign_duration": {
      "US": 30,
      "CA": 30,
    },
    "max_days_to_finish": {
      "US": 56,
      "CA": 56,
    }
  }
}

Création de prévisions

Les prévisions contiennent le nombre de comptes de l’Espace Comptes que votre publicité peut couvrir dans une plage de dates en fonction d’une couverture, d’une répétition, d’une audience et d’un budget donnés. Les estimations de réservation peuvent vous aider à simuler les résultats globaux de votre campagne et s’adapteront en fonction de votre objectif, budget, audience, brand safety et objectif de performance, ainsi qu’en fonction de vos formats et placements et paramètres de contrôle de répétition.

Vous pouvez modifier une campagne de réservation après l’avoir réservée, mais une fois que la campagne lancée, vous ne pouvez plus la modifier ni la mettre en pause, sauf pour changer vos contenus publicitaires. Si vous modifiez uniquement le contenu d’une publicité, la prévision restera la même. Vous pouvez supprimer la campagne pour l’annuler et l’arrêter, mais vous devrez dans ce cas la réserver à nouveau et pourriez alors recevoir un nouveau CPM et une nouvelle prévision concernant les résultats de la campagne. Ne réservez que des campagnes que vous avez l’intention de diffuser. ** Pour les tests, limitez vos réservations à la taille et à la durée minimales ; assurez-vous de les annuler, car nous vous réservons un inventaire de publicités réel.

Limites

Voici les limites par défaut pour les prévisions :

• Audiences ciblées d’au moins 300 000 comptes dans l’Espace Comptes
• Couverture minimale de 200 000 comptes dans l’Espace Comptes
• Les ensembles de publicités doivent être diffusés pendant au minimum une journée et au maximum 90 jours. (Le nombre de jours est calculé en fonction de la durée de la campagne, en jours. Par exemple, si la campagne débute à 12 h 00 le jour 1 et se termine à 10 h 00 le jour 2, la campagne est considérée comme ayant été diffusée pendant deux jours, même s’il s’est écoulé moins de 24 heures.)
• L’heure de fin de l’ensemble de publicités doit se situer dans les 180 jours après une prévision.
• La campagne doit finir après 6 h le dernier jour dans le fuseau horaire du compte publicitaire.

Lecture des prévisions

Pour en savoir plus, précisez les champs. Pour voir toutes les reachfrequencyprediction d’un compte, envoyez une requête HTTP GET à https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions?fields={COMMA_SEPERATED_FIELD_LIST}.

Pour couvrir toutes les reachfrequencyprediction en fonction d’un identifiant de reachfrequencyprediction, envoyez une requête HTTP GET avec les champs de votre choix : https://graph.facebook.com/{API_VERSION}/{RF_PREDICTION_ID}?fields={COMMA_SEPERATED_FIELD_LIST}.

Par défaut, Meta renvoie l'ID. Pour plus de détails sur les champs, consultez la section Prévision de réservation, Lecture.

Codes de statut de réponse

Ils indiquent les résultats possibles pour status dans reachfrequencyprediction. Les limitations initiales apparaissent, le cas échéant. Elles peuvent toutefois varier à l’avenir d’un compte publicitaire à l’autre ou en fonction du pays :

Utilisation des prévisions

Fournissez votre identifiant de prévision et ses données pour créer un nouvel identifiant qui servira en tant qu’identifiant de réservation. Associez ensuite cet identifiant de réservation à votre ensemble de publicités. La création d’une réservation rend l’inventaire indisponible pour les autres, vous devez donc l’associer avant qu’il expire.

Si la réservation réussit, nous vous réservons temporairement l’inventaire. Vous disposez d’environ une heure après la réservation pour affecter une publicité à un ensemble de publicités.

Réservation

Réservez des prévisions pour vos ensembles de publicités afin de bloquer votre prix et de disposer d’une couverture prévisible. Réservez une audience identifiée par reachfrequencyprediction pour une durée définie avec reserve pour action. Vous pouvez utiliser un identifiant de prévision unique pour créer plusieurs réservations. Par exemple :

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
// Response 
{"id":9876543210"}

Pour réserver un inventaire en fonction d’une prévision, envoyez une requête POST à https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions.

Pour reach, budget et impression, vous pouvez réserver une prévision à un point précis de curve_budget_reach plutôt qu’au tuple initial de couverture/budget de la prévision. Utilisez les champs suivants :

Meta réserve les prévisions de manière asynchrone ; vous devez analyser et vérifier le statut de la prévision. Le statut initial de la prévision est 2 (EN ATTENTE). Une fois l’opération terminée, le statut est 1, SUCCESS ou 15, FAIL, ce qui signifie que nous manquons d’inventaire pour pouvoir finaliser cette réservation.

Étant donné que le système de réservation est dynamique, vous pouvez constater de légères modifications de la disponibilité de l’inventaire entre le moment de votre prévision et le moment de la réservation. Toutefois, Meta respecte les valeurs que vous obtenez au moment de la prévision, tant que les modifications restent sous un seuil raisonnable.

Affectation à des ensembles de publicités

Une fois que vous avez réussi à réserver une prévision, créez un ensemble de publicités avec cette dernière :

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

Pour affecter une prévision correctement, votre ensemble de publicités doit respecter ces critères :

• Ne précisez pas les points suivants :
• start_time : dérivé de la prévision
• end_time : dérivé de la prévision
• targeting : dérivé de la prévision
• bid_amount
• optimization_goal
• lifetime_budget ou daily_budget
• Vous pouvez affecter des réservations des ensembles de publicités sans publicité active. Toutefois, vous devez disposer d’au moins une publicité active avant le lancement de l’ensemble de publicités.
• Vous devez inclure rf_prediction_id, qui relie la prévision au nouvel ensemble de publicités.
• L’attribut buying_type de la campagne publicitaire est RESERVED.

Vous pouvez également associer reachfrequencyprediction aux ensembles de publicités afin de modifier la prévision. Adressez une requête POST à https://graph.facebook.com/{ad_set_id} avec rf_prediction_id pour la reachfrequencyprediction que vous souhaitez utiliser.

Vous trouverez ci-dessous les limites applicables à l’ensemble de publicités :

• Options relatives aux plateformes d’éditeur·ices : facebook et instagram.
• Options de placement Facebook : feed et rightcolumn.
• Options de placement Instagram : stream, story, explore, explore_home et reels. Si le placement comprend instagram, vous devez utiliser destination_ids, et non destination_id. Le champ destination_ids doit contenir l’identifiant de Page Facebook en tant que destination_id, en plus de l’identifiant de compte Instagram.
• Utilisez les audiences personnalisées ou les catégories partenaires, mais pas les deux à la fois.
• Les audiences personnalisées de site Web, les fans ou le ciblage par exclusion des interactions avec les vidéos ne sont pas autorisés.
• Le champ promoted_object de l’ensemble de publicités doit correspondre au champ destination_id de la prévision. Pour les publications de Page, il doit s’agir de l’ID de Page précisé ; pour les publicités pour une application, il doit correspondre à l’ID d’application indiqué.
• La fréquence des publicités standard et planifiée est prise en charge, mais pas la diffusion accélérée.

Nous facturons les campagnes de réservation en fonction des impressions réelles diffusées. Si la date de début de la campagne arrive alors que l’ensemble de publicités ne contient pas de publicités actives, la campagne ne peut pas être diffusée et il n’y a aucuns frais. Meta libère le reste de l’inventaire, mais nous pouvons pénaliser le compte publicitaire si cela se reproduit trop souvent.

Lorsque vous créez une campagne avec le type d’achat Réservation de Meta, vous acceptez de payer les coûts proposés pour l’inventaire publicitaire que vous réservez. Si vous voulez changer la taille de votre audience ou la fréquence des publicités, vos coûts seront modifiés en conséquence. Vous pouvez effectuer ces changements à tout moment avant le début de votre campagne. Vous pouvez modifier le contenu de votre publicité jusqu’au lancement de votre campagne.

Gestion des publicités

Les ensembles de publicités de type Réservation peuvent contenir plusieurs publicités ; vous pouvez ajouter d’autres publicités à tout moment. Si l’ensemble de publicités est actif, mais ne contient aucune publicité active, vous devez créer votre première publicité sous 24 heures pour les ensembles de publicités d’une durée de 3 à 30 jours, ou sous 6 heures pour les ensembles de publicités d’une durée d’un à deux jours. Si vous ne le faites pas, nous supprimons la réservation.

Dissociation de prévisions, modification d’ensembles de publicités

Vous pouvez effectuer des modifications ou interrompre votre campagne de réservation avant son lancement. Une fois la campagne démarrée, vous pourrez seulement modifier votre contenu publicitaire, votre budget ou attribuer une date de fin ultérieure. Si vous modifiez uniquement le contenu d’une publicité, la prévision reste la même.

Une modification de votre budget ou de la date de fin génère une nouvelle prévision pour votre campagne qui s’affichera dans les estimations de réservation.

Vous ne pouvez pas interrompre votre campagne de réservation après son lancement, mais vous pouvez la supprimer pour l’annuler à tout moment.

Pour mettre en pause ou modifier un ensemble après son démarrage, consultez Mise en pause ou redémarrage des ensembles de publicités en cours de diffusion et Modification des ensembles de publicités en cours de diffusion. Pour supprimer un ensemble actif, consultez la référence sur les ensembles de publicités. Toute impression distribuée sera facturée.

Notez que pour éviter les échecs potentiels, nous vous déconseillons vivement de supprimer toutes les publicités lorsqu’un ensemble de publicités de réservation est en cours de diffusion.

Si vous attribuez une réservation à un ensemble de publicités avant qu’il soit activé, vous ne pouvez pas modifier la plupart des attributs, sauf si vous dissociez cette réservation. Envoyez une requête HTTP POST à l’ensemble et définissez rf_prediction_id sur 0. Vous pouvez uniquement modifier l’attribut name sur l’objet de l’ensemble de publicités.

Pour dissocier une réservation :

curl \
-F "rf_prediction_id=0" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

Une fois qu’un ensemble de publicités est actif, la réservation ne peut plus être dissociée et les attributs de l’ensemble ne peuvent plus être modifiés, à l’exception de quelques attributs de publicité mis sur liste blanche et répertoriés ci-dessous :

• name
• creative_id
• creative_spec
• conversion_specs
• tracking_specs
• view_tags

Mise en pause et redémarrage d’ensembles de publicités

Vous pouvez mettre en pause un ensemble actif. Consultez la référence sur les ensembles de publicités. Si vous mettez en pause un ensemble de publicités pendant plus de 30 minutes, nous ne garantissons plus la prévision pour cet ensemble.

Pour réactiver un ensemble mis en pause pendant plus de 30 minutes, vous avez besoin d’une nouvelle prévision. Envoyez une requête POST à reachfrequencypredictions. Voir les sections Création de prévisions et Réservation. Vous devez transmettre un existing_campaign_id pour que l’ensemble actif soit réactivé dans la requête. Après avoir créé et réservé une nouvelle prévision, vous pouvez associer reachfrequencyprediction à l’ensemble de publicités en adressant une requête HTTP POST à https://graph.facebook.com/{ad_set_id}, en spécifiant rf_prediction_id pour la prévision que vous souhaitez utiliser.

Modification d’ensembles des publicités en cours de diffusion

Vous pouvez effectuer ces mises à jour après le début d’un ensemble.

• Augmentez ou diminuez le budget et la couverture de l’ensemble de publicités. Le budget ou la couverture doit être supérieur aux dépenses actuelles ou à la couverture générée.
• Prolongez le calendrier de l’ensemble de publicités à 90 jours.

Vous ne pouvez pas modifier ou mettre en pause un ensemble actif s’il répond à l’un des critères suivants :

• sous-diffusion importante ; diffusion inférieure à 10 % de la prévision ; ensembles dont les dépenses dépassent le budget ;
• ensembles de publicités diffusés pendant une seule journée ;
• ensembles de publicités se terminant dans les prochaines 24 heures.

Pour modifier des ensembles de publicités en cours de diffusion, obtenez une nouvelle prévision. Consultez les sections Création de prévisions et Réservation. Vous devez transmettre un existing_campaign_id pour que l’ensemble actif soit réactivé dans la demande.

Après avoir créé et réservé une nouvelle prévision, vous pouvez associer reachfrequencyprediction à l’ensemble de publicités en adressant une requête HTTP POST à https://graph.facebook.com/{ad_set_id}, en spécifiant l’ID de la reachfrequencyprediction que vous voulez utiliser dans rf_prediction_id.

Réutilisation des audiences réservées

Si vous annulez une réservation, l’inventaire réservé et libéré pour les autres annonceurs. Toutefois, vous pouvez réutiliser l’audience d’une prévision précédemment réservée si vous ne l’utilisez pas déjà. Cela nous permet de tenir compte de l’inventaire supplémentaire pour créer une prévision, sans que vous soyez contraint(e) d’annuler une réservation existante.

Incluez rf_prediction_id_to_share lorsque vous créez une réservation. Il s’agit de l’identifiant d’une prévision précédente. Cela permet d’annuler la réservation précédente pour que vous puissiez utiliser cet inventaire pour votre nouvelle réservation.

Pour réserver la nouvelle prévision, vous devez également transmettre le paramètre supplémentaire rf_prediction_id_to_release, qui correspond à l’identifiant de la réservation précédente.

Rotation et séquençage des publicités

Vous pouvez effectuer une rotation des publicités de l’ensemble de publicités que vous utilisez. Il n’est pas nécessaire de dissocier la réservation de l’ensemble de publicités pour effectuer cette opération. Ajoutez une ou plusieurs publicités à l’ensemble de publicités et attendez qu’il soit activé. À ce stade, vous pouvez modifier l’état de la publicité initiale pour la mettre en pause. Vous devez disposer d’au moins une publicité active dans l’ensemble de publicités.

Vous pouvez concevoir une séquence de publicités diffusées dans l’ordre. Commencez par créer l’ensemble de publicités et les publicités. Précisez ensuite la séquence au niveau de l’ensemble de publicités dans creative_sequence. Chaque publicité de cet ensemble de publicités peut ne pas apparaître, apparaître une seule fois où apparaître plusieurs fois dans la séquence.

Si la durée de la série creative_sequence est égale à zéro, cela signifie que vous n’utilisez aucun séquençage. Si la durée est autre que zéro, nous vous recommandons d’utiliser la même valeur pour frequency_cap dans rf_prediction_id. Si la durée est supérieure à frequency_cap, nous tronquons les dernières publicités de la série. Si la durée est inférieure à frequency_cap, nous remplissons automatiquement la série de manière récursive en répétant la séquence depuis le début. Pour clarifier les résultats, définissez la même durée pour creative_sequence et frequency_cap.

Chaque publicité de la séquence a pour statut ACTIVE, PENDING_REVIEW ou CREDIT_CARD_NEEDED. Une publicité précise de la séquence sera diffusée auprès d’un utilisateur ou d’une utilisatrice si toutes les publicités précédentes de la séquence ont été diffusées. Les publicités qui ne sont pas incluses dans la creative_sequence ne seront pas diffusées.

Les publicités d’un ensemble de publicités utilisant le séquençage des publicités, qu’elles fassent partie de la séquence ou non, ne peuvent pas toutes être mises en pause, archivées ni supprimées.

Cette fonctionnalité est uniquement disponible pour les ensembles de publicités de réservation, c’est-à-dire lorsque le buying_type de la campagne publicitaire à laquelle ils appartiennent est RESERVED et que rf_prediction_id est défini pour ces ensembles de publicités.

Pour en savoir plus, consultez la documentation sur les ensembles de publicités.

Réservation sur Instagram

Pour prévoir la couverture sur Instagram, vous pouvez créer une campagne en définissant buying_type sur RESERVED.

La réservation vous aide à planifier et réserver des campagnes de notoriété et d’interactions, en optimisant la couverture, l’augmentation de la mémorisation publicitaire et ThruPlay.

Les estimations de couverture du Gestionnaire de publicités et l’API peuvent aider les partenaires à évaluer les résultats qu’ils peuvent obtenir. Les intérêts de la communauté Instagram prévalent ; nous essayons d’atteindre les objectifs de couverture avec circonspection et d’évoluer progressivement. Toutes les politiques régissant les estimations de réservation pour Facebook s’appliquent à Instagram.

Codes d’erreur

Exemples

Création d’une reachfrequencyprediction pour un destination_id d’application :

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<APP_ID>' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Création d’une reachfrequencyprediction pour un destination_id de Page :

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<PAGE_ID>' \
-F 'prediction_mode=1' \
-F "objective=POST_ENGAGEMENT" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Création d’une reachfrequencyprediction pour un destination_id d’application avec un placement Instagram :

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook","instagram"], "device_platforms":["mobile"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_ids=[<APP_ID>,<INSTAGRAM_ACCOUNT_ID>]' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Interrogez le point de terminaison suivant à l’aide de requêtes HTTP GET afin de récupérer le statut jusqu’à ce qu’il soit différent de 2 :

https://graph.facebook.com/67890123456?fields=status

Si le statut est 1 (réussite), alors il peut être associé à un ensemble de publicités ou réservé.

Réserver une prévision :

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
{"id":"9876543210"}

Interrogez le point de terminaison suivant à l’aide de requêtes HTTP GET afin de récupérer le statut jusqu’à ce que ce qu’il soit différent de 2 :

https://graph.facebook.com/<API_VERSION>/<PREDICTION_ID>?fields=status

Si le statut est 1 (réussite), alors il peut être associé à un ensemble de publicités. Configurons la structure de votre campagne en créant une campagne, un ensemble de publicités, un contenu publicitaire et une publicité, et en affectant la réservation à l’ensemble de publicités.

Création d’une campagne publicitaire :

curl \
-F "name=Test" \
-F "buying_type=RESERVED" \
-F "status=ACTIVE" \
-F "objective=POST_ENGAGEMENT" \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

{"id":"1122334455"}

Création d’un ensemble de publicités :

curl  \
-F "name=TestReachSet" \
-F "status=1" \
-F "campaign_id=<CAMPAIGN_ID>" \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets"

{"id":"09876543"}

Génération d’un contenu publicitaire :

curl \
-F "name=sample creative" \
-F "type=1" \
-F "title=hello world" \
-F "body=hi i'm an ad" \
-F "link_url="https://www.facebook.com/" \
-F "image_hash=4aca812b4eadb72818a2c4124abd121a" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives"

{"id":"1323123123123"}

Création d’une publicité :

// Create an ad
curl \
-F "name=my ad" \
-F "adset_id=<AD_SET_ID>" \
-F "creative={'creative_id':<CREATIVE_ID>}" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads"

{"id":"3213213123"}

Affectation d’une nouvelle prévision à l’ensemble de publicités :

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"