Les éléments de changelog sont classés de la manière suivante :
Les nouvelles fonctionnalités, les modifications et les dépréciations n’ont d’effets que sur la version concernée. Les modifications importantes avec un préavis de 90 jours concernent toutes les versions.
Les modifications importantes ne sont pas incluses ici, car elles ne sont pas liées à des versions particulières.
Publiée le 1er mai 2018 | Disponible jusqu’au 28 juillet 2020 | Publication de blog
subscribed_domains_phishing
pour inscrire des domaines pour les alertes concernant le hameçonnage.groups_access_member_info
et publish_to_groups
./comments
renvoie des données vides pour les nœuds suivants :
Expiration du token d’accès : Un token d’accès est non valide si l’utilisateur n’a pas engagé l’app dans les 90 derniers jours.
id
first_name
last_name
middle_name
name
name_format
picture
short_name
age_range
context
cover
currency
devices
gender
link
locale
timezone
updated_time
verified
Les autorisations rsvp_event
et user_managed_groups
sont obsolètes. L’autorisation user_managed_groups
peut toujours être utilisée à des fins de test, mais ne peut pas être soumise pour l'Examen de connexion.
groups_access_member_info
: pour recevoir des données relatives aux membres sur le contenu du groupe.
publish_to_groups
: pour publier du contenu dans un groupe au nom d’un utilisateur.
user_age_range
: pour accéder à la tranche d’âge d’une personne.
user_gender
: pour accéder à la donnée genre d’une personne.
user_link
: pour accéder à l’URL de profil Facebook pour un autre utilisateur de l’app.
Cette version n’est pas obsolète.
Seules des valeurs non nulles seront renvoyées pour les indicateurs de répartition de Insights de Pages.
Les indicateurs d’interaction des Pages et des publications de Page, y compris metric
utilisé avec le champ de l’indicateur stories
désormais appelé activity
.
Les indicateurs d’interaction des consommations des publication de Page, y compris metric
utilisé avec le champ de l’indicateur post_consumption*
désormais appelé post_clicks*
.
GET /{page-id}/insights/{metric}
: les indicateurs suivants seront supprimées dans 90 jours :
page_story_adds
page_story_adds_by_age_gender_unique
page_story_adds_by_city_unique
page_story_adds_by_country_unique
page_views
page_views_unique
page_views_login
page_views_login_unique
GET /{post-id}/insights/{metric}
: les indicateurs suivants seront supprimées dans 90 jours :
post_story_adds_by_action_type
post_story_adds_by_action_type_unique
post_story_adds_unique
post_story_adds
post_fan_reach
post_interests_impressions
post_interests_impressions_unique
post_interests_consumptions
post_interests_consumptions_unique
post_interests_consumptions_by_type
post_interests_consumptions_by_type_unique
post_interests_action_by_type
post_interests_action_by_type_unique
/photos
: le paramètre type
pour l’arête /photos
(disponible sur plusieurs nœuds) ne prend plus en charge uploaded
comme valeur pour les opérations GET
(GET /object/photos?type=uploaded
).GET /user
: le champ third_party_id
est obsolète. Les apps utilisant d’anciennes versions de l’API peuvent accéder à ce champ jusqu’au 30 juillet 2018. Les apps installées par l’utilisateur à compter du 1er mai 2018 ne peuvent pas accéder à ce champ, quelle que soit la version de l’API utilisée.Publiée le 1er mai 2018 | Disponible jusqu’au 1er février 2019 | Publication de blog
bid_strategy
Nous avons introduit le nouveau champ bid_strategy
pour {account-id}/adsets
, ce qui vous permet de sélectionner une stratégie d’enchère pour les publicités en fonction de vos objectifs commerciaux. Chaque stratégie présente des avantages et des inconvénients. Options possibles :
LOWEST_COST
: obtenez le plus de résultats en fonction du budget de votre ensemble de publicités et de votre optimization_goal
de diffusion. Facebook effectue automatiquement des enchères supplémentaires si nécessaire afin de dépenser votre budget. Vous pouvez fournir un maximum pour votre enchère ou ne fournir aucune limite avec cette option.
TARGET_COST
: fournit des coûts moyens stables pour vos publicités à mesure que vous augmentez le budget de votre ensemble de publicités.
Pour en savoir plus, consultez Achat de publicités et optimisation, Stratégie d’enchère.
Nouvelle API pour la création de publicités de collection : dans le passé, Facebook créait un canevas en arrière-plan chaque fois que vous créiez une publicité de collection. Cela limitait votre accès au canevas sous-jacent : vous ne pouviez pas l’utiliser pour recibler des audiences avec des audiences d’interaction de canevas. Désormais, lorsque vous créez une publicité de collection à partir d’ensembles de produits, vous devez créer également explicitement un canevas en fournissant les éléments corrects. Lorsque vous utilisez ce canevas dans une publicité de collection, Facebook génère automatiquement la publicité de collection. Consultez la rubrique Publicités de collections à partir d’un ensemble de produits pour en savoir plus.
Invalidation de la colonne de droite : nous invalidons les publicités qui ciblent uniquement la position Facebook, right_hand_column
avec des objectifs non valides pour right_hand_column
sur {ad_account_id}/adsets
. Nous ne prenons désormais en charge le placement à droite que pour les formats publicitaires compatibles avec les objectifs suivants : Trafic, Conversions et Ventes sur catalogue produits.
is_autobid
et is_average_price_pacing
sont abandonnés à la fois dans GET
et POST
dans la version 3.0 et les versions ultérieures.
Syntaxe des règles modifiées pour les audiences personnalisées : nous avons mis à jour la structure des règles utilisées pour créer des audiences personnalisées de sites web, des audiences personnalisées d’apps mobiles, des audiences personnalisées d’interactions de Page, des audiences d’interactions de publicités à formulaire, des audiences d’interactions de canevas et des audiences personnalisées hors ligne. Cela vous permet de créer des règles basées sur un comportement global, des règles provenant de différentes sources d’événements et d’exclure des règles. Voir :
Accès au catalogue produits : pour accéder aux éléments du catalogue, vous devez spécifier le secteur de catalogue adéquat. Si votre demande ne correspond pas au secteur adéquat votre catalogue, un message d’erreur apparaît. Par exemple, si vous disposez d’un catalogue de e-commerce, vous devez y accéder avec le point de terminaison /products
correspondant, tel que GET {catalog_id}/products
, GET {product_feed_id}/products
ou GET {product_set_id}/products
. Vous ne pouvez pas accéder au catalogue avec des points de terminaison pour d’autres secteurs tels que GET {catalog_id}/autos
, GET {product_feed_id}/hotels
ou GET {product_set_id}/flights
.
Chaîne vide dans les tags de modèle : nous n’autorisons plus les chaînes vides comme paramètres pour les publicités dynamiques, les options de tag de modèle. Par exemple, si vous transmettez une chaîne vide à {{trip.checkin_date date_format:}}
, vous obtenez un message d’erreur. Pour en savoir plus, consultez la rubrique Publicités dynamiques, Gestion des publicités.
Délais d’expiration d’Insights : si nous nous attendons à l’expiration d’une demande API Insights avant la fin, nous renvoyons un message d’erreur avec le code d’erreur 100
et le sous-code 1504033
. Nous estimons cela en fonction de la taille de la demande et de la progression du traitement par rapport aux délais d’expiration. Si vous obtenez cette erreur, vous devez effectuer une demande asynchrone de l’API Insights pour ces données. Consultez la section Tâches asynchrones de l’API Insights.
Valeurs négatives dans les données d’événement : si vous publiez des données d’événement dans {data_set_id}/events
avec une valeur négative, le traitement échoue. Le champ data
de POST /{data_set_id-id}/events
est concerné.
Insights sur l’optimisation du budget de campagne : adset_budget_value
renvoie désormais using campaign budget
lorsque votre campagne publicitaire utilise l’optimisation du budget de campagne. Ceci affecte :
GET {adaccount-id}/insights
,
GET {campaign-id}/insights
,
GET {adset-id}/insights
,
GET {ad-id}/insights
,
POST {adaccount-id}/insights
,
POST {campaign-id}/insights
,
POST {adset-id}/insights
,
POST {ad-id}/insights
.
Tri par défaut pour le pixel : si vous appelez l’arête GET {account_id}/adspixel
sur un compte business ou un compte publicitaire, nous renvoyons les résultats, triés par défaut, par nom de pixel et non plus par heure du dernier déclenchement de pixel.
Nouveau nom du champ de statistiques de pixel : nous avons renommé le champ timestamp
en start_time
sur l’arête des statistiques de pixel. Cela représente l’heure de début lorsque nous commençons à agréger les données horaires sur les déclenchements de pixels. Nous le renvoyons désormais au format ISO 8601 et incluons le décalage du fuseau horaire. Cela corrige un problème dans lequel nous renvoyions des horodatages Unix non valides. Les points de terminaison suivants sont concernés : GET {ads-pixel-id}/stats
.
Abandon du point de terminaison POST {pixel-id}/shared_agencies
. Veuillez utiliser l’interface utilisateur de Business Manager pour partager le pixel publicitaire avec les agences.
kpi_custom_conversion_id
, kpi_type
et kpi_results
de /{ad_campaign_id}
et /ad_account_ID/campaigns
.POST {ad-id}/
,
POST {adset-id}/
,
POST act_{ad-account-id}
,
POST act_{ad-account-id}/ads
,
POST act_{ad-account-id}/adsets
Abandon du champ zipbytes
de POST act_{ad-account-id}/adimages
et suppression de la possibilité d’importer des fichiers ZIP à cette arête. Veuillez utiliser une image avec les extensions : jpg
, jpeg
, gif
, bmp
, png
, tiff
ou tif
.
Abandon de la méthode actuelle de création de publicités de collection qui utilise un appel d’API avec toutes les ressources requises en tant que paramètres. Au lieu de cela, vous devez d’abord créer un canevas, puis utiliser le lien du canevas pour créer une publicité de collection. Cela vous permet d’accéder à l’objet canevas sous-jacent afin de pouvoir, par exemple, recibler des audiences. Consultez la section Publicités de collection.
Abandon du format publicitaire Carrousel pour les publicités avec l’objectif Interaction avec les publications de Page. Cette combinaison n’est plus valide. Consultez la section Validation, objectifs et contenus publicitaires.
is_autobid
et is_average_price_pacing
des points de terminaison : POST {ad-account-id}/adsets
et POST {adset-id}
. Utilisez plutôt le nouveau champ bid_strategy
pour spécifier une stratégie d’enchère particulière pour l’ensemble de publicités. Pour en savoir plus, consultez la section Enchères et optimisation.Abandon des champs sous delivery_estimate
pour les publicités et les comptes publicitaires. Les résultats ne répondaient pas aux besoins des annonceurs. De plus, de nombreux annonceurs ont des objectifs commerciaux qui peuvent ne pas être mieux atteints que par le montant de l’enchère suggéré par Facebook. Les champs et paramètres obsolètes incluent :
Champ bid_estimate
Paramètre currency
Paramètre daily_budget
Paramètre optimize_for
Nous vous recommandons d’utiliser la valeur commerciale intrinsèque que vous obtenez des publicités Facebook et d’enchérir sur cette base. Si vous ne connaissez pas encore cette valeur, nous vous suggérons d’utiliser l’enchère automatique. Pour en savoir plus, reportez-vous aux Pages d’aide sur les publicités, Enchères et à la rubrique Achat de publicités et optimisation.
Abandon du résultat renvoyé par le champ curve_budget_reach
sur GET /{rf-prediction-id}
. Nous renvoyons désormais la carte et déconseillons l’utilisation de la valeur de retour de la chaîne sérialisée JSON. Ceci affecte : GET /{rf-prediction-id}
.
Abandon de l’arête GET /{ad-account-id}/ratecard
.
Abandon de plusieurs champs liés à la facturation sur /ad_accounts
. Par exemple :
next_bill_date
active_billing_date_preference
pending_billing_date_preference
active_asl_schedule
salesforce_invoice_group_id
transactions
adspaymentcycle
show_checkout_experience
pixel_id
et external_event_source
sur GET /customaudience
.Abandon de matched_unique_users
sur OFFLINE_EVENT_SET_ID
renvoyé par GET /{data-set-id}
et GET /{data-set-upload-id}
. Consultez la documentation API Offline Conversions.
Abandon de l’arête attributed_events
et du champ attribute_stats
sur GET /{data_set_id} API
. Utilisez l’API GET /{data_set_id}/stats
pour obtenir les statistiques des événements attribués.
Abandon du champ matched_unique_users
sur OFFLINE_EVENT_SET_ID
renvoyé par GET /{data-set-id}
et GET /{data-set-upload-id}
.
Abandon de valeurs de retour par défaut pour GET {data_set_upload_id}
. Ces champs par défaut ne sont plus renvoyés : first_upload_time
, last_upload_time
, api_calls
, valid_entries
, matched_entries
, duplicate_entries
, event_time_min
, event_time_max
, event_stats
et matched_unique_users
.
Abandon de valeurs de retour par défaut pour GET {data_set_id}/stats
. Cela ne renvoie désormais que les statistiques de comptage par défaut. Pour indiquer quelles statistiques renvoyer, utilisez le paramètre fields
ou le paramètre summary
pour les statistiques cumulatives telles que average_upload_delay
.
Abandon de valeurs de retour par défaut pour GET {data_set_id}
. Ces champs par défaut ne sont plus renvoyés : attribute_stats
, duplicate_entries
, event_stats
, event_time_max
, event_time_min
, matched_entries
, matched_unique_users
, usage
, valid_entries
.
Abandon de l’arête GET {data-set-upload-id}/stats
. Utilisez le champ valid_entries
ou le champ matched_entries
de GET {data-set-upload-id}
à la place.
Abandon de canvas_component_avg_pct_view
de l’API Insights.