Foire aux questions

Le forum Microsoft Q&A est accessible à la communauté des développeurs pour poser des questions et y répondre sur les API Bing Ads et les scripts Microsoft Advertising. Microsoft surveille les forums et répond aux questions auxquelles la communauté n’a pas encore répondu.

Si l’enquête implique des informations personnelles ou de compte sensibles, ou si vous ne trouvez pas les informations dont vous avez besoin pour résoudre votre problème via Microsoft Q&R, contactez le support Microsoft Advertising. Pour résoudre le problème efficacement, fournissez le support avec les détails demandés dans Engagement de support.

Les notes de publication et le Guide de migration sont d’excellentes ressources pour commencer.

Vous pouvez vous inscrire à la newsletter mensuelle via l’onglet Actualités du portail des développeurs, et c’est également là que les dernières annonces de blog sont agrégées.

Pour commencer, vous devez vous inscrire pour obtenir un compte Microsoft Advertising , puis obtenir votre jeton de développeur via l’onglet Compte du portail des développeurs.

Vous pouvez développer des applications API Bing Ads avec n’importe quel langage de programmation prenant en charge les services web. Les Kits de développement logiciel (SDK) de l’API Bing Ads améliorent l’expérience de développement d’applications API Bing Ads avec les langages .NET, Java, PHP et Python. Chaque SDK inclut un proxy vers tous les services web de l’API Bing Ads et extrait les détails de bas niveau de l’authentification avec OAuth. Vous pouvez utiliser les interfaces BulkServiceManager et ReportingServiceManager de haut niveau pour abstraitr et exécuter des opérations dans les services Bulk et Reporting Services de bas niveau.

Nous avons entendu des demandes de kits SDK supplémentaires, par exemple Perl et Ruby, bien qu’il n’y ait pas de plan pour ajouter de la prise en charge à court terme.

En plus des exemples de code , vous trouverez des extraits de code dans de nombreux guides techniques, par exemple, le guide de prise en main . Vous pouvez utiliser le sélecteur de langage en haut ou à droite de ces pages pour afficher des exemples en CSharp, Java, Php ou Python. Lorsque vous choisissez une langue, le paramètre est conservé lorsque vous naviguez dans d’autres pages. Le sélecteur de langue inclut uniquement les langues qui ont des exemples pour cette page spécifique, et la valeur par défaut est C# si la langue que vous avez définie précédemment n’est pas disponible pour la page à laquelle vous avez accédé.

Le service en bloc est recommandé, en particulier si vous devez ajouter ou mettre à jour des annonces et des mots clés dans plusieurs groupes d’annonces ou campagnes dans un compte. Certaines fonctionnalités ne sont pas disponibles dans Bulk, par exemple AddUetTags, GetBMCStoresByCustomerId, GetGeoLocationsFileUrl et GetMediaMetaDataByAccountId. Pour ces fonctionnalités, vous devez bien sûr utiliser le service Gestion des campagnes.

Le service Reporting prend en charge la plupart des types de rapports que vous pouvez trouver dans l’application web Microsoft Advertising. Veillez à case activée les guides Attributs de rapport et statistiques de performances etpériodes de conservation des données de rapport pour plus d’informations sur la disponibilité.

Lorsqu’un utilisateur clique sur une annonce, le système peut prendre jusqu’à deux heures pour traiter le clic (3 heures pour les conversions) et le rendre disponible pour la création de rapports. Lorsque toutes les données de la journée précédente ont été traitées et mises à disposition pour la création de rapports, cet état est appelé Livres fermés. Pour plus d’informations sur le moment où les livres sont fermés pour la création de rapports, consultez Fuseaux horaires dans la création de rapports.

Vous devez mettre à jour votre application pour utiliser la nouvelle msads.manage étendue via le point de terminaison Plateforme d'identités Microsoft. Tous les développeurs d’applications doivent prendre des mesures pour utiliser la nouvelle étendue.

Vous devez inviter un utilisateur à donner son consentement via la nouvelle msads.manage étendue et le point de terminaison Plateforme d'identités Microsoft.

Si vous avez un ID d’application plus ancien (alias ID client) au format hexadécimal, par exemple 0000000012345A67, vous devez inscrire une nouvelle application. Les ID d’application Plateforme d'identités Microsoft valides sont mis en forme en tant que GUID avec des tirets, par exemple ab01c23d-4e56-7f8a-90bc-1d23efabc45d. Si vous ne voyez pas d’application existante dans le Portail Azure - inscriptions d'applications, cela indique que vous devez la remplacer par une nouvelle application.

Oui. Vous devez inviter un utilisateur à donner son consentement via la nouvelle msads.manage étendue et le point de terminaison Plateforme d'identités Microsoft.

Lorsque vous invitez un utilisateur à donner son consentement (à l’aide du locataire commun) avec le point de terminaison Plateforme d'identités Microsoft, l’expérience de connexion de l’utilisateur varie en fonction de l’identité sous-jacente derrière ses informations d’identification.

• Une personne qui n’a qu’une identité MSA est redirigée vers la page de connexion MSA.
• Une personne qui n’a qu’une identité Azure AD est redirigée vers la page de connexion de son organisation.
• Une personne dont les informations d’identification sont valides dans les domaines MSA et Azure AD rencontre une page de levée d’ambiguïté qui lui demande de choisir entre son identité personnelle et son identité professionnelle ou scolaire. Cette ambiguïté sera toujours présente tant que cet utilisateur a deux identités liées à la même adresse e-mail. L’utilisateur peut cesser de voir cela en modifiant l’adresse e-mail de son compte Microsoft personnel. Pour plus d’informations, consultez https://cloudblogs.microsoft.com/enterprisemobility/2016/09/15/cleaning-up-the-azure-ad-and-microsoft-account-overlap/.

Si l’utilisateur n’a plus d’identité msa compte personnel, l’API Bing Ads n’accepte plus son jeton d’accès existant. De même, le jeton d’actualisation ne peut plus être utilisé pour demander un nouveau jeton d’accès. Vous devez donc demander à nouveau le consentement de l’utilisateur pour que votre application gère ses comptes Microsoft Advertising. Vous devez ignorer le jeton d’actualisation précédent.

Non. Les comptes professionnels ou scolaires sont pris en charge uniquement en production.

Pour gérer par programmation un compte Microsoft Advertising, vous devez donner votre consentement au moins une fois via le flux de consentement de l’application web. Pour une authentification répétée ou à long terme, vous devez suivre le flux d’octroi du code d’autorisation pour obtenir un jeton d’accès et un jeton d’actualisation. Par la suite, vous pouvez utiliser le dernier jeton d’actualisation pour demander de nouveaux jetons d’accès et d’actualisation sans aucune autre interaction de l’utilisateur. Vous devrez peut-être demander à nouveau le consentement de l’utilisateur, par exemple, si l’utilisateur a subi la récupération de compte, modifié son mot de passe ou supprimé des autorisations pour que votre application s’authentifie en son nom.

Le jeton d’accès expire généralement après une heure, même si vous devez toujours case activée l’heure d’expiration chaque fois que vous demandez un nouveau jeton.

Les jetons d’actualisation sont, et seront toujours, complètement opaques pour votre application. Ils sont de longue durée, par exemple, 90 jours pour les clients publics, mais l’application ne doit pas être écrite pour s’attendre à ce qu’un jeton d’actualisation dure pendant une période quelconque. Les jetons d’actualisation peuvent être invalidés à tout moment, et la seule façon pour une application de savoir si un jeton d’actualisation est valide consiste à tenter de l’utiliser en effectuant une demande de jeton. Même si vous actualisez continuellement le jeton sur le même appareil avec le jeton d’actualisation le plus récent, vous devez vous attendre à recommencer et à demander le consentement de l’utilisateur si, par exemple, vous avez déconnecté l’utilisateur, si l’utilisateur Microsoft Advertising a changé son mot de passe, a supprimé un appareil de sa liste d’appareils approuvés ou supprimé les autorisations permettant à votre application de s’authentifier en son nom. À tout moment, sans avertissement préalable, Microsoft peut déterminer que le consentement de l’utilisateur doit à nouveau être accordé. Il est recommandé de toujours stocker en toute sécurité le dernier jeton d’actualisation chaque fois que vous demandez de nouveaux jetons d’accès et d’actualisation.

Le jeton d’accès représente les informations d’identification de l’utilisateur qui a accès à un ou plusieurs comptes Microsoft Advertising. L’ID d’application (également client_id) identifie votre application pour chaque utilisateur Microsoft Advertising qui accorde son consentement. Le jeton développeur donne à votre application l’autorisation d’utiliser l’API Bing Ads.

Bing Ads est désormais Microsoft Advertising. Notre nouveau nom reflète la façon dont nous développons nos solutions publicitaires pour vous aider à atteindre plus de clients. Il n’est pas prévu de renommer les versions actuelles de l’API. Le tableau ci-dessous répertorie les noms qui ont ou n’ont pas changé. Pour plus d’informations, consultez l’annonce de la marque.