Version 3.0

API Marketing

Publiée le 1er mai 2018 | Disponible jusqu’au 1er février 2019 | Publication de blog

• Nouvelles fonctionnalités
• Modifications importantes
• Dépréciations
• Dépréciations immédiates

Nouvelles fonctionnalités

Stratégie d’enchère la moins chère, champ 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.

Publicités de collection, Création

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.

Modifications importantes

Gestion des publicités

• 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.

Audience et ciblage publicitaire

• 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 :

  • Audiences personnalisées à partir de votre site web, règles d’audience,

  • Audiences personnalisées à partir de votre app mobile, règles d’audience,

  • Audiences personnalisées associées aux interactions de Page,

  • Audiences associées aux interactions pour les publicités à formulaire,

  • Audiences associées aux interactions pour Canvas et

  • Audiences personnalisées créées à partir de conversions hors ligne.

Publicités dynamiques

• 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.

Insights et mesure 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.

Dépréciations

Business Manager

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.

Gestion des publicités

• Abandon de kpi_custom_conversion_id, kpi_type et kpi_results de /{ad_campaign_id} et /ad_account_ID/campaigns.

• Abandon de l’indicateur « redownload » des points de terminaison suivants afin de simplifier l’API :

  • POST {ad-id}/,

  • POST {adset-id}/,

  • POST act_{ad-account-id},

  • POST act_{ad-account-id}/ads,

  • POST act_{ad-account-id}/adsets

  Vous pouvez toujours lire ces informations avec le paramètre « fields ».

• 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.

Achat de publicités et enchères

• Abandon des champs 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

• Abandon des champs pixel_id et external_event_source sur GET /customaudience.

Insights et mesure des publicités

• 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.