Bac à sable Microsoft Advertising
Microsoft Advertising fournit un environnement de bac à sable d’API dans lequel vous pouvez tester votre application avant de la déployer dans l’environnement de production. Les publicités que vous créez dans le bac à sable ne sont pas servies. Les services pris en charge dans le bac à sable varient selon la production. Pour obtenir les adresses de service web pour les services pris en charge, consultez Adresses du service web de l’API Bing Ads.
Remarque
Le bac à sable peut être arrêté pour maintenance, avec ou sans notification préalable.
Inscription initiale du client
Les environnements de bac à sable et de production utilisent des informations d’identification distinctes.
Suivez ces étapes pour obtenir un nouveau client de bac à sable. Si vous avez déjà un client de bac à sable et que vous souhaitez ajouter un nouvel utilisateur, par exemple, avec des informations d’identification de compte Microsoft, vous pouvez passer directement aux étapes d’invitation de l’utilisateur .
Ouvrez un navigateur et accédez à https://sandbox.bingads.microsoft.com?simpsp=true.
Cliquez sur S’inscrire à Microsoft Advertising ou S’inscrire maintenant.
Sélectionnez Créer une adresse e-mail pour créer un compte MSA. N’utilisez pas d’adresse e-mail existante.
Cliquez sur Suivant
Entrez une adresse e-mail MSA. Le serveur de messagerie doit être outlook-int.com (par exemple, someone@outlook-int.com).
Importante
Le bac à sable prend en charge les msa créés à l’aide d’un compte de messagerie outlook-int.com uniquement. Vous ne pouvez pas utiliser un compte de messagerie outlook.com. En outre, vous ne pouvez pas utiliser un compte de messagerie d’un autre service de messagerie (par exemple, @contoso.com) même si le compte est lié à un compte de messagerie outlook.com ou outlook-int.com.
Terminez le flux de travail MSA en spécifiant le reste de vos informations d’utilisateur et de sécurité. Vous êtes ensuite redirigé vers Microsoft Advertising pour poursuivre l’inscription du client et du compte de bac à sable.
Remplissez le formulaire Créer un compte
Pour Importer/créer une campagne, cliquez sur Ignorer la création de la campagne.
Pour Démarrer, cliquez sur Ignorer les informations de paiement.
Inviter d’autres utilisateurs
Pour vous authentifier auprès d’OAuth dans le bac à sable, vous avez besoin d’un compte Microsoft (MSA) de bac à sable. Si votre client de bac à sable ne dispose pas encore des informations d’identification de l’utilisateur via un compte Microsoft, vous devez inviter un utilisateur à travailler sur votre compte de bac à sable en procédant comme suit.
Dans le bac à sable Microsoft Advertising, cliquez sur votre nom d’utilisateur (coin supérieur droit)
Cliquez sur Comptes & facturation
Cliquez sur Utilisateurs.
Cliquez sur Inviter un utilisateur.
Entrez l’adresse e-mail de l’utilisateur à inviter. Le serveur de messagerie doit être outlook.com (par exemple, someone@outlook.com).
Importante
Vous pouvez envoyer des invitations à outlook.com comptes de messagerie uniquement. Vous ne pouvez pas envoyer d’invitations à un autre domaine, même si le compte est lié à un compte de messagerie outlook.com. Si vous essayez d’envoyer une invitation à un autre domaine (par exemple, someone@contoso.com), l’interface utilisateur BingAds affiche l’invitation comme étant en attente indéfiniment (l’invitation n’est jamais envoyée).
Cliquez sur Envoyer
Microsoft Advertising envoie une invitation par e-mail à l’utilisateur. Si l’invitation n’apparaît pas dans la boîte de réception, case activée le dossier Email indésirable. La réception de l’invitation peut prendre quelques minutes. Les étapes suivantes montrent comment accepter l’invitation.
Ouvrir l’e-mail à partir de Microsoft Advertising avec la ligne d’objet, Invitation à Microsoft Advertising
Cliquez sur le lien incorporé
Sélectionnez Créer une adresse e-mail pour créer un compte MSA. N’utilisez pas d’adresse e-mail existante.
Cliquez sur Suivant
Entrez une adresse e-mail MSA. Le serveur de messagerie doit être outlook-int.com (par exemple, someone@outlook-int.com).
Importante
Le bac à sable prend en charge les msa créés à l’aide d’un compte de messagerie outlook-int.com uniquement. Vous ne pouvez pas utiliser un compte de messagerie outlook.com. En outre, vous ne pouvez pas utiliser un compte de messagerie d’un autre service de messagerie (par exemple, @contoso.com) même si le compte est lié à un compte de messagerie outlook.com ou outlook-int.com.
Terminez le flux de travail en spécifiant le reste de vos informations utilisateur
Quittez Microsoft Advertising après avoir terminé le processus MSA.
Remarque
Le processus d’inscription MSA vous renvoie à l’interface utilisateur si Microsoft Advertising (ui.si.bingads.microsoft.com). Après avoir terminé le processus MSA, déconnectez-vous de l’interface SI, puis connectez-vous à l’aide de votre nouvelle adresse e-mail outlook-int.com à l’adresse https://secure.sandbox.bingads.microsoft.com/.
Obtenir l’accès à l’API
Les environnements de bac à sable et de production utilisent des informations d’identification distinctes.
Pour l’environnement de bac à sable, remplacez par https://login.microsoftonline.com/commonhttps://login.windows-ppe.net/consumers.
Ce tableau inclut des points de terminaison de bac à sable supplémentaires.
| Description | Production | Bac à sable |
|---|---|---|
| Point de terminaison pour les requêtes OAuth | login.microsoftonline.com | login.windows-ppe.net |
| Domaine pour le courrier électronique utilisé lors de l’obtention d’un compte Microsoft | N’importe quelle adresse e-mail | outlook-int.com |
| Point de terminaison pour modifier le mot de passe du compte Microsoft | account.live.com/password/change | account.live-int.com/password/change |
Bien qu’en production, vous deviez utiliser votre propre jeton de développeur, tous les clients Microsoft Advertising peuvent utiliser le jeton de développeur universel suivant dans le bac à sable.
BBD37VB98
Bien qu’en production, vous deviez utiliser votre propre ID d’application (également nom d’ID client), tous les clients Microsoft Advertising peuvent utiliser l’ID d’application public suivant dans le bac à sable. L’ID client « Exemple d’application tutoriel » est limité aux applications de bureau ou console et ne peut pas être utilisé avec une clé secrète client dans une application web.
4c0b021c-00c3-4508-838f-d3127e8167ff
Vous pouvez maintenant obtenir des jetons d’accès et d’actualisation pour votre utilisateur Microsoft Advertising et effectuer votre premier appel de service à l’aide de l’API Bing Ads. Consultez le guide de démarrage rapide .
Conseil
Pour plus d’informations sur la façon d’obtenir des jetons d’accès et d’actualisation à l’aide des Kits de développement logiciel (SDK) Bing Ads, consultez Authentification avec les KITS de développement logiciel (SDK).
Meilleures pratiques de bac à sable
Le bac à sable ne doit pas être utilisé dans la même capacité que la production.
- Assurez-vous que lorsque vous déployez votre application dans l’environnement de production, vous utilisez les WSDL de production et vos informations d’identification de production.
- Le bac à sable contient la version de production actuelle et sera mis à jour avec des aperçus des fonctionnalités avec ou sans notification préalable.
- La capacité du bac à sable est inférieure à celle de la production, et vous ne devez pas l’utiliser pour effectuer des tests de contrainte ou de capacité.
- N’utilisez pas plusieurs threads.
Ad Insight Service
Le bac à sable prend en charge un ensemble limité de mots clés pour tester les opérations du service Ad Insight. Vous ne devez pas utiliser les données de test pour déduire ou attendre des estimations similaires pour vos mots clés en production. Certaines des limitations sont décrites dans le tableau suivant.
Conseil
Utilisez le service Ad Insight en production au lieu du bac à sable. Le bac à sable offre uniquement un sous-ensemble des opérations de service de production, et les données d’insight sont en retard par rapport à la production. Les données d’opportunité de bac à sable sont actualisées et mises à jour chaque week-end, et sont disponibles d’ici lundi. Les données d’idée mot clé dans le bac à sable peuvent être en retard de production de plusieurs mois. Si une opération échoue en raison d’une plage de dates non valide, essayez de soumettre à nouveau la demande avec une plage de dates antérieure.
| Opération de service | Limitations du bac à sable |
|---|---|
| GetBidLandscapeByKeywordIds | Non prise en charge. Vous pouvez appeler l’opération avec des identificateurs mot clé existants, mais aucune donnée n’est retournée. |
| GetEstimatedBidByKeywordIds | Un ensemble limité de mots clés sont pris en charge : air, auto, meilleures offres, réservation, informations sur la voiture, soins, offre de la journée, remises, divertissement, finances, jeux, avis d’hôtel, comparaison d’assurance, sport, l’hôtel. |
| GetEstimatedBidByKeywords | Un ensemble limité de mots clés sont pris en charge : air, auto, meilleures offres, réservation, informations sur la voiture, soins, offre de la journée, remises, divertissement, finances, jeux, avis d’hôtel, comparaison d’assurance, sport, l’hôtel. |
| GetEstimatedPositionByKeywordIds | Un ensemble limité de mots clés sont pris en charge : air, auto, meilleures offres, réservation, informations sur la voiture, soins, offre de la journée, remises, divertissement, finances, jeux, avis d’hôtel, comparaison d’assurance, sport, l’hôtel. Pour augmenter les chances d’obtenir une estimation, l’élément MaxBid doit être supérieur ou égal à 5 dollars américains, ou l’équivalent dans d’autres devises. |
| GetEstimatedPositionByKeywords | Un ensemble limité de mots clés sont pris en charge : air, auto, meilleures offres, réservation, informations sur la voiture, soins, offre de la journée, remises, divertissement, finances, jeux, avis d’hôtel, comparaison d’assurance, sport, l’hôtel. Pour augmenter les chances d’obtenir une estimation, l’élément MaxBid doit être supérieur ou égal à 5 dollars américains, ou l’équivalent dans d’autres devises. |
| GetHistoricalKeywordPerformance | Un ensemble limité de mots clés sont pris en charge : air, auto, meilleures offres, réservation, informations sur la voiture, soins, offre de la journée, remises, divertissement, finances, jeux, avis d’hôtel, comparaison d’assurance, sport, l’hôtel. Les éléments MatchType et AdPosition doivent être définis sur Aggregate. L’élément Devices doit être défini sur Ordinateurs ou à gauche zéro. |
| GetHistoricalSearchCount | Un ensemble limité de mots clés sont pris en charge : air, auto, meilleures offres, réservation, informations sur la voiture, soins, offre de la journée, remises, divertissement, finances, jeux, avis d’hôtel, comparaison d’assurance, sport, l’hôtel. L’élément EndMonthAndYear doit être défini sur le mois précédent. Par exemple, si la date du jour est le 1er avril 2020, le mois de fin doit être mars 2020. L’élément Devices doit être défini sur Ordinateurs ou à gauche zéro. |
| GetKeywordCategories | Il ne doit pas y avoir de différence entre le bac à sable et la production. |
| GetKeywordDemographics | Un ensemble limité de mots clés sont pris en charge : air, auto, meilleures offres, réservation, informations sur la voiture, soins, offre de la journée, remises, divertissement, finances, jeux, avis d’hôtel, comparaison d’assurance, sport, l’hôtel. L’élément Devices doit être défini sur Ordinateurs ou à gauche zéro. |
| GetKeywordIdeas | Les données de test du bac à sable sont actualisées tous les 3 mois. Vous devez donc définir une plage de dater antérieure. |
| GetKeywordLocations | Un ensemble limité de mots clés sont pris en charge : air, auto, meilleures offres, réservation, informations sur la voiture, soins, offre de la journée, remises, divertissement, finances, jeux, avis d’hôtel, comparaison d’assurance, sport, l’hôtel. L’élément Devices doit être défini sur Ordinateurs ou à gauche zéro. |
| SuggestKeywordsForUrl | Il ne doit pas y avoir de différence entre le bac à sable et la production. |
| SuggestKeywordsFromExistingKeywords | Si SuggestionType est défini sur 1, il ne doit y avoir aucune différence de comportement par rapport à la production. Pour les valeurs de type de suggestion 2, 3 et 4, un ensemble limité de mots clés sont pris en charge : air, auto, meilleures offres, réservation, informations sur la voiture, soins, affaire du jour, remises, divertissement, finances, jeux, avis d’hôtel, comparaison d’assurance, sport, l’hôtel. |
Service en bloc
La limite de taille de fichier pour le chargement en production est de 100 Mo ou 2,5 millions de lignes. Pour le bac à sable, la limite est de 20 000 lignes. Pour plus d’informations, consultez Téléchargement et chargement en bloc.
Service de gestion des campagnes
Support éditorial
Le bac à sable prend en charge les révisions et les appels éditoriaux limités. Vous ne pouvez pas obtenir les raisons des problèmes éditoriaux dans le bac à sable comme vous le pourriez en production, par exemple via l’opération de service GetEditorialReasonsByIds .
Annonces de produits
Les annonces de produit sont prises en charge dans le bac à sable dans le États-Unis. Pour être approuvé automatiquement, vous devez créer un catalogue et un magasin Microsoft Merchant Center qui se termine par « bac à sable » comme suit.
Dans l’application web Microsoft Advertising, cliquez sur Outils.
Sous Outils de gestion, cliquez sur Microsoft Merchant Center.
Cliquez sur Créer un magasin, puis entrez un nom de magasin qui se termine par « bac à sable » (sans respect de la casse).
Ajoutez les informations de votre magasin, sélectionnez Annonces de produits sous Paramètres du catalogue, puis cliquez sur Terminer.
Dans votre nouveau magasin, cliquez sur Gestion des catalogues, puis sur Créer un catalogue.
Ajoutez le nom de votre catalogue, sélectionnez Charger manuellement le fichier ultérieurement sous Fichier de flux de catalogue, puis cliquez sur Enregistrer.
Service de facturation client
Les modes de paiement ne sont pas pris en charge dans le bac à sable.
Reporting Service
Lorsque vous créez un mot clé, les données de performances de test doivent être générées en quelques heures. Les données sont fournies pour tester la génération, la récupération et l’analyse des rapports dans le bac à sable. Vous ne devez pas utiliser les données de test pour déduire ou attendre des performances similaires pour vos mots clés en production.
Les données de test sont générées uniquement le jour où l’entité a été ajoutée ou mise à jour. Par exemple, si vous ajoutez un mot clé aujourd’hui et téléchargez un rapport de performances mot clé pour la semaine dernière, il n’y aura pas de données. Vous devrez extraire un rapport qui inclut aujourd’hui dans la période de temps du rapport.
Les rapports suivants peuvent retourner des données de performances dans le bac à sable. Tous les autres types de rapports peuvent être envoyés avec succès, bien que le service de bac à sable ne retourne aucun exemple de données, c’est-à-dire que l’URL de téléchargement du rapport n’est pas définie lorsque vous interrogez les résultats.