Version 2.9

Nouvelles fonctionnalités de l’API Marketing v2.9

Contenu créatif

Créez des campagnes Canvas sur Facebook au moyen de l’API Marketing. Grâce à l’image, au son et au mouvement, le format vidéo permet aux annonceurs d’atteindre leurs objectifs de marque et de réponse directe de manière efficace. Consultez la rubrique API Marketing, Publicités Canvas.

Publicités dynamiques

• Qualité du catalogue de publicités dynamiques, nous lançons de nouvelles API pour vous aider à diffuser des publicités dynamiques avec succès : les API Checks et Quality. Avec l’API Checks, vous pouvez vérifier que votre source de signaux fournit suffisamment d’informations pour diffuser les bonnes publicités avec les publicités dynamiques. Avec l’API Quality, vous pouvez vérifier que votre catalogue et votre fil disposent de suffisamment d’informations de qualité suffisante pour diffuser des publicités dynamiques. Pour en savoir plus, consultez la rubrique Publicités dynamiques, Qualité du catalogue et des signaux.

• Plusieurs images pour un seul article : affichez plusieurs images d’un seul article dans des publicités dynamiques au format carrousel. Désormais, nous prenons en charge jusqu’à 20 images provenant d’un catalogue pour représenter un article au format carrousel pour les publicités dynamiques. Cela vous permet de présenter un article, tel qu’un hôtel ou une destination, avec plusieurs images. Pour cela, nous proposons de nouvelles options : force_single_link = true et show_multiple_images = true. Pour en savoir plus, consultez la rubrique Publicités dynamiques, Gestion des publicités, Modèle de contenu créatif.

Gestion des publicités

• Copie de publicités : vous pouvez désormais dupliquer vos campagnes, ensembles de publicités et publicités existants à l’aide de nos API de copie de publicités. Ainsi, vous n’avez pas besoin de recréer vos publicités de bout en bout chaque fois. Vous pouvez dupliquer celles qui fonctionnent et créer des structures de modèle publicitaire. Consultez la rubrique Contenu créatif, placement et aperçu.

• Portée quotidienne estimée : nous disposons d’un nouveau point de terminaison /delivery_estimate au niveau du compte publicitaire et de l’ensemble de publicités. Ce point de terminaison vous permet d’obtenir les estimations de l’enchère et une prévision des résultats avec la portée quotidienne et les conversions pour un ensemble de publicités donné. Consultez la rubrique Ciblage, Portée quotidienne estimée.

• API de moteur de règles : utilisez l’API de moteur de règles pour gérer vos publicités de manière plus simple, plus efficace et plus intelligente, en fonction des règles de gestion que vous définissez. Le moteur de règles utilise un modèle basé sur les notifications push. Ainsi, plutôt que de devoir constamment interroger nos API pour obtenir des informations à jour sur vos publicités, nous vous envoyons de manière proactive des notifications push et réalisons les actions que vous avez indiquées lorsque les conditions d’une règle sont satisfaites. Pour obtenir des informations détaillées sur l’API de moteur de règles, cliquez ici.

• API Batch : regroupez vos demandes et envoyez-les de manière asynchrone. Regroupez plusieurs appels à l’API Graph dans une seule requête HTTP, et exécutez-les de manière asynchrone, sans blocage. Vous pouvez également indiquer des dépendances entre des opérations liées. Facebook traite chaque opération indépendante dans des processus parallèles et vos opérations dépendantes, les unes après les autres. Consultez la rubrique Requêtes asynchrones et par lot, API Batch.

Placement des publicités

• Placement publicitaire efficace : vous pouvez préciser des placements publicitaires dans les spécifications de ciblage. Cependant, il est possible que vous ne sachiez pas si Facebook a réellement diffusé votre publicité dans la totalité des placements. Si vous avez sélectionné des placements non valides pour un objectif particulier, Facebook ne l’a pas diffusée sur ce placement. Auparavant, vous deviez diffuser des publicités et tester pour déterminer le résultat réel. Avec les API de placement effective_, vous pouvez déterminer les placements publicitaires dans lesquels Facebook a réellement diffusé des publicités pour votre placement sélectionné et votre objectif publicitaire donné. Au moyen de l’API de recommandations, vous pouvez également apprendre pourquoi certains placements sont exclus par filtrage. Consultez la rubrique Ciblage avancé, Placement efficace.

Modifications importantes dans l’API Marketing v2.9

Gestion des publicités

• Placement Vidéo suggérée : ce placement faisait partie du placement Fil pour Facebook. Vous le choisissiez automatiquement si vous utilisiez le placement Fil. À compter de la version 2.9, nous avons séparé le placement Vidéo suggérée du placement Fil, pour que vous puissiez choisir de ne pas utiliser le placement Vidéo suggérée, même si vous choisissez le placement Fil. Pour les versions 2.8 et antérieures, si vous utilisiez le placement Fil pour Facebook, nous ne diffuserons plus automatiquement vos publicités dans le placement Vidéo suggérée lorsque vous choisissez d’utiliser le placement Fil.

• Objectif de sensibilisation locale : nous avons abandonné l’objectif de campagne LOCAL_AWARENESS. À compter de la version 2.9, nous n’accepterons pas l’objectif LOCAL_AWARENESS pour créer de nouvelles campagnes. Pour générer de la sensibilisation locale pour des ensembles de publicités pour un lieu unique, utilisez des campagnes REACH. Nous ne prenons plus en charge LOCAL_AWARENESS pour plusieurs lieux. Si vous disposez d’une campagne existante avec cet objectif, vous pouvez toujours la consulter ou la modifier, et vous pouvez créer des ensembles de publicités et des publicités dans celle-ci. Si vous copiez des campagnes à partir de campagnes existantes, le type de campagne détermine si la copie est possible. Avec LOCAL_AWARENESS et un lieu unique, nous la copions avec l’objectif REACH. Pour LOCAL_AWARENESS et plusieurs lieux, vous ne pouvez pas copier la campagne.

• Objectifs de publicités mobiles : afin de simplifier nos objectifs de publicités mobiles, nous ne prendrons bientôt plus en charge CanvasAppEngagement, CanvasAppInstalls, MobileAppInstalls et MobileAppEngagement. Ces objectifs sont également appelés CAE, MAE, CAI et MAI respectivement. À compter de la version 2.9, vous ne pouvez pas créer de nouvelles campagnes avec ces quatre objectifs. Voici les options que nous prenons en charge à la place :

  • Ensembles de publicités CAE avec des campagnes LINK_CLICKS, vous devez utiliser LINK_CLICKS pour créer des campagnes pour les publicités CAE.

  • Ensembles de publicités MAE avec des campagnes avec des objectifs LINK_CLICKS ou CONVERSIONS, vous devez utiliser LINK_CLICKS ou CONVERSIONS pour créer des campagnes pour les publicités MAE.

  • Ensembles de publicités CAI avec APP_INSTALLS, vous devez utiliser APP_INSTALLS pour créer des campagnes pour les publicités CAI.

  • Ensembles de publicités MAI avec APP_INSTALLS, vous devez utiliser APP_INSTALLS pour créer des campagnes pour les publicités MAI.

• Objectifs de publicités mobiles, compatibilité : lorsque vous dupliquez des campagnes CAE, MAE, CAI et MAI avec l’API Marketing ou les outils Facebook, nous traduisons automatiquement ces objectifs obsolètes dans leurs équivalents pour la version 2.9 :

  • Les campagnes MAI ou CAI sont converties avec l’objectif APP_INSTALLS.

  • Les campagnes CAE sont converties en campagnes LINK_CLICKS.

  • Les campagnes MAE sont converties en campagnes LINK_LICKS ou CONVERSIONS en fonction des optimisations que vous fournissez pour les ensembles de publicités présents dans la campagne. Si la campagne comprend des ensembles de publicités optimisés pour OFFSITE_CONVERSION, nous convertissons votre campagne MAE en une campagne CONVERSIONS. Sinon, nous convertissons votre campagne MAE en une campagne LINK_CLICKS.

• Catégories bloquées : nous ne prendrons plus en charge certaines catégories Audience Network, Vidéo intégrée et Instant Article en faveur de catégories plus unifiées sur ces placements. Ces catégories vous permettent d’éviter l’affichage de publicités avec certains contenus contestables, tels que les jeux de hasard, l’alcool, etc. Les catégories politics et religion sont obsolètes. Les catégories suivantes sont disponibles :

  • Pour les Instant Articles et l’Audience Network : debated_social_issues, mature_audiences, tragedy_and_conflict, dating et gambling.

  • Pour les Vidéos intégrées : debated_social_issues, mature_audiences et tragedy_and_conflict.

• SUPPLEMENTAL_MEDIA_ID est abandonné dans les contenus créatifs au niveau du compte publicitaire et des publicités. Vous ne pouvez plus lire ce champ.

• ACTION_SPEC est abandonné dans les contenus créatifs. Ce champ était utilisé avec les actualités sponsorisées que nous ne prenons plus en charge.

• Les champs actor_image_hash, actor_image_url et actor_name dans le contenu créatif sont abandonnés dans les versions 2.9 et 2.8. Ils étaient utilisés avec action_spec que nous avons également abandonné.

• link_title et link_description dans call_to_action sont obsolètes dans les contenus créatifs. Pour définir des titres et des descriptions pour le contenu créatif, utilisez name et description dans link_data, ou title et link_description dans video_data.

• run_status=3 : vous pouviez supprimer un contenu créatif avec ce champ et cette valeur. Cela provoquait une confusion, aussi nous avons remplacé le nom run_status par status et la valeur qui était un entier est désormais la chaîne DELETED. Pour supprimer un contenu créatif, utilisez status=DELETED.

• COVER_PHOTO_ID dans GET sur les points de terminaison créatifs {creative_id} et {ad_account_id}/adcreatives est obsolète. Il était rarement utilisé et disponible uniquement pour une utilisation interne et limitée.

• image_url ou image_hash : désormais, vous ne pouvez en fournir qu’un d’entre eux dans video_data pour object_story_spec du contenu publicitaire. Consultez la rubrique Contenu créatif, Référence.

• OBJECT_INSTAGRAM_ID dans GET pour les points de terminaison créatifs est obsolète, y compris {creative_id} et AD_ACCOUNT_ID/adcreatives. Ce champ n’était pas destiné à une utilisation externe.

• instagram_story_id était utilisé pour récupérer les identifiants de publication Instagram dans le contenu créatif dans les versions 2.8 et antérieures. Si vous avez utilisé ce champ lorsque vous avez fourni le contenu créatif, nous avons généré une exception, mais avons ignoré ce paramètre et transmis les résultats avec instagram_story_id. Si vous avez utilisé la réponse, vous obtiendrez une erreur. Pour corriger ce problème, nous avons remplacé instagram_story_id par effective_instagram_story_id et vous ne devez pas utiliser ce champ pour fournir un contenu créatif.

• Le type de renvoi de spent, today_spent et yesterday_spent pour tous les objets publicitaires est désormais String, pas Integer. Cela a un impact sur les campagnes, les ensembles de publicités et les publicités.

Publicités dynamiques

• Aucun ensemble de produits identique : nous n’autorisons plus des ensembles de produits qui sont identiques à un autre ensemble de produits du même catalogue. Si vous tentez de créer un ensemble de produits identique à partir du même catalogue, notre API renverra une exception FacebookApiException avec le code 10803 contenant l’identifiant de l’ensemble de produits identique.

• quoted_fields dans POST /{product_feed_id} est obsolète. Dans la version 2.6, nous avons supprimé quoted_fields sous POST /{product_feed_id/product_feeds}. Dans le cadre d’un nettoyage supplémentaire, nous ne prenons plus cela en charge.

• Le point de terminaison POST {catalog-id}/batch renvoie désormais STRING dans le cadre d’améliorations continues des catalogues produits des publicités dynamiques.

• Échec des mises à jour de l’audience : si vous utilisez des publicités dynamiques et tentez de mettre à jour une audience pour ces publicités, votre demande échoue avec une erreur. Pour apporter des modifications, vous devez supprimer l’audience associée à vos publicités dynamiques et en créer une nouvelle. Consultez les rubriques Publicités dynamiques, Audiences et Audiences personnalisées.

• template_url_spec remplace template_url. Cela vous permet d’effectuer un suivi des clics et de placer des URL propres au contexte au-delà des URL de catalogue produits dans vos publicités. Par exemple, incluez les dates d’arrivée et de départ de quelqu’un dans votre publicité. Consultez la rubrique Publicités dynamiques, Gestion des publicités.

Signaux et ciblage

• Changement de nom des sources d’évènements : auparavant, lorsque vous créiez ou interrogiez des conversions personnalisées, vous utilisiez des champs nommés pixel_id, pixel_rule et pixel_aggregation_rule. Puisque nous ajoutons la prise en charge des données de conversion hors ligne et des données de conversions personnalisées à partir des applications, nous renommons ces champs pour refléter ce champ d’application étendu. Ces champs sont désormais appelés event_source_id, rule et aggregation_rule.

• Pixel de suivi des conversions : il n’est plus pris en charge depuis le 15 février 2017. Dans le cadre de cette fin de prise en charge, nous avons supprimé la totalité des arêtes et des nœuds pour la création, la mise à jour, la lecture et la référence du pixel de suivi des conversions pour toutes les versions de l’API.

• L’option de ciblage publicitaire friends_of_connection associée aux identifiants d’évènement est abandonnée. Cela signifie que vous ne pouvez pas cibler les amis des personnes qui ont accepté votre invitation à un évènement Facebook.

• Prise en charge de delivery_estimate : nous avons apporté des modifications à la Portée estimée afin de prendre en charge delivery_estimate qui vient d’être lancé.

  • Nous avons supprimé le champ bid_estimations du point de terminaison /reach_estimates et déplacé toute la fonctionnalité documentée vers /delivery_estimate

  • /AD_ID/reachestimate a été abandonné. Pour accéder à cette information utilisez /ADSET_ID/delivery_estimate.

  • Nous avons supprimé le champ data.

Insights

• Fin de prise en charge de date_preset : nous abandonnons plusieurs valeurs de date_preset que nous remplaçons par de nouvelles valeurs. Les nouvelles valeurs sont conçues pour être plus simples à utiliser et pour s’aligner avec les attentes des annonceurs. Elles n’incluront plus de données provenant du jour actuel. Par exemple, une demande faite le 8 février et utilisant le préréglage de la plage de date « les 7 derniers jours » générera un rapport qui inclut les dates du 1er février au 7 février à 23 h 59, mais exclut le 8 février. Les valeurs suivantes sont obsolètes :

  • last_3_days est remplacé par last_3d.

  • last_7_days est remplacé par last_7d.

  • last_14_days est remplacé par last_14d.

  • last_28_days est remplacé par last_28d.

  • last_30_days est remplacé par last_30d.

  • last_90_days est remplacé par last_90d.

  • last_week est remplacé par last_week_sun_sat et last_week_mon_sun.

  • this_week est remplacé par this_week_sun_today et this_week_mon_today.

  • last_3_months a été abandonné.

  • Pour les versions 2.8 et antérieures, nous prenons en charge ces nouvelles valeurs ainsi que les anciennes valeurs du préréglage de la date.

• date_preset par défaut : si vous faisiez une demande Insights sans date_preset, nous utilisions last_30_days par défaut, qui incluait l’activité du jour actuel à partir de minuit dans le fuseau horaire du compte publicitaire. À compter de la version 2.9, la valeur par défaut est last_30d. Cela inclut la totalité des 30 jours précédents, se termine à 23 h 59 la nuit précédente, dans le fuseau horaire de votre compte, et n’inclut pas le jour actuel.

• video_complete_watched_actions est abandonné. Il fournissait les mêmes informations que video_30_sec_watched_actions.

• unique_impression et unique_social_impressions sont abandonnés. Utilisez à la place reach et social_reach.

• newsfeed_clicks, newsfeed_impressions, newsfeed_avg_position, video_avg_sec_watched_actions et video_avg_pct_watched_actions sont des indicateurs obsolètes qui sont abandonnés.

• Les champs suivants sont abandonnés sous action_type: : follow, gift_sale, video_play et vote.

• click_to_play_video est désormais accessible par la répartition action_video_type.

• Le champ de répartition placement pour les données de diffusion est abandonné dans l’API Insights. Seuls ["publisher_platform", "platform_position"] sont pris en charge dans la version 2.9. Dans la version 2.8, nous prenons toujours en charge ["placement"] ou ["publisher_platform", "platform_position"] en tant que répartitions.

• attribution_spec : auparavant, vous utilisiez deux champs distincts pour les fenêtres d’attribution par clic et par vue dans l’API Insights. Vous devez à présent utiliser attribution_spec pour les définir tous les deux. Lorsque vous définissez attribution_spec, vous remplacez tout réglage existant. Si vous aviez défini les deux attributions, vous ne supprimez que l’attribution par vue lorsque vous définissez attribution_spec sur event_type = CLICK_THROUGH.