Bien démarrer avec C# avec l’API Bing Ads

Article
10/24/2024

Pour commencer à développer des applications API Bing Ads avec un langage .NET, vous pouvez commencer avec les exemples fournis ou suivre l’une des procédures pas à pas d’application pour une application web ou de bureau . Les exemples ont été développés avec le sdk .NET Bing Ads et Visual Studio Community. Votre configuration personnalisée peut varier.

Vous aurez besoin d’informations d’identification utilisateur ayant accès à Microsoft Advertising en production ou en bac à sable. Pour l’environnement de production, vous aurez besoin d’un jeton de développeur de production. Tous les clients de bac à sable peuvent utiliser le jeton de développeur de bac à sable universel, c’est-à-dire BBD37VB98. Pour plus d’informations, consultez Prise en main de l’API et du bac à sable Bing Ads.

Pour vous authentifier via OAuth, vous devez également inscrire une application et obtenir l’identificateur client correspondant. Vous devez également prendre note de la clé secrète client et de l’URI de redirection si vous développez une application web. Pour plus d’informations sur l’inscription d’une application en production et sur le flux d’octroi du code d’autorisation, consultez Authentification avec OAuth et Authentification avec les KITS de développement logiciel (SDK). Bien qu’en production, vous devez utiliser votre propre ID d’application (également nommé ID client), tous les clients Microsoft Advertising peuvent utiliser l’ID client public « Exemple d’application tutoriel » dans le bac à sable, c’est-à-dire 00001111-aaaa-2222-bbbb-3333cccc4444. Pour plus d’informations, consultez Bac à sable.

Installer le kit de développement logiciel (SDK)

Installez le kit de développement logiciel (SDK) .NET Bing Ads via NuGet, via l’interface utilisateur Gérer les packages NuGet ou via la console du Gestionnaire de package. Pour plus d’informations sur l’installation de NuGet, consultez https://docs.nuget.org.

Remarque

Le sdk .NET Bing Ads prend en charge .NET Standard 2.0. Vous pouvez choisir parmi différentes plateformes, par exemple .NET Core ou .NET Framework 4.6.1. Les exemples d’API Bing Ads sont développés via Visual Studio Community 2017 et ciblent .NET Framework 4.7.1. .NET Standard 2.0 et Bing Ads SDK .NET ne prennent pas en charge les versions .NET Framework antérieures à 4.6.1. Pour plus d’informations sur .NET Standard et sa relation avec d’autres frameworks .NET, reportez-vous à cet article sur .NET Standard.

Console du Gestionnaire de package NuGet

Cliquez sur Outils ->Gestionnaire de package NuGet ->Console du Gestionnaire de package.
Choisissez le projet par défaut dans lequel vous souhaitez installer le Kit de développement logiciel (SDK), puis dans la ligne de commande de la console, tapez Install-Package Microsoft.BingAds.SDK.
Si vous n’avez pas encore de références à System.ServiceModel.Primitives 4.4.1, System.ServiceModel.Http 4.4.1 et System.ServiceModel.ConfigurationManager 4.4.1, tapez Install-Package System.ServiceModel.Primitives -Version 4.4.1, Install-Package System.ServiceModel.Http -Version 4.4.1et Install-Package System.Configuration.ConfigurationManager -Version 4.4.1.

Procédures pas à pas

Une fois que vous avez installé l’Bing Ads sdk .NET, vous pouvez parcourir les exemples de code d’API Bing Ads en C# ou suivre l’une des procédures pas à pas pour une application web ou de bureau .

Personnalisation du client HTTP

Vous pouvez personnaliser le client HTTP utilisé par Bing Ads SDK .NET pour modifier certains paramètres standard tels que le délai d’expiration HTTP, la configuration du proxy ou d’autres paramètres.

Pour ce faire, vous pouvez créer une classe personnalisée héritée de HttpClientProvider et définir GlobalSettings.HttpClientProvider sur un instance de cette classe avant d’effectuer des appels de service. Par exemple :

class MyHttpClientProvider : HttpClientProvider 
{ 
    protected override void ConfigureHttpClient(HttpClient httpClient, Type serviceType, ApiEnvironment apiEnvironment) 
    { 
        // override default timeout 
        httpClient.Timeout = TimeSpan.FromMinutes(5); 
    } 
} 

GlobalSettings.HttpClientProvider = new MyHttpClientProvider();

Journalisation des appels de service

À partir de Bing Ads SDK .NET 13.0.20, pour activer la journalisation des messages de demande et de réponse, vous pouvez définir la BINGADS_ConsoleLoggerMinLevel variable d’environnement sur Verbose:

Environment.SetEnvironmentVariable("BINGADS_ConsoleLoggerMinLevel", "Verbose");

Vous pouvez également activer la même journalisation à l’aide de la BingAdsEventListener classe :

BingAdsEventListener.CreateConsoleLogger(EventLevel.Verbose).KeepActive();

Vous pouvez également créer un BingAdsEventListener instance pour fournir une implémentation d’enregistreur d’événements personnalisée. Par exemple :

new BingAdsEventListener(EventLevel.Verbose, bingAdsEvent => MyLogger.LogVerbose(bingAdsEvent.GetDescription())).KeepActive();

Voir aussi

Bibliothèques clientes d’API Bing Ads
Exemples de code d’API Bing Ads
Adresses du service web de l’API Bing Ads
Gestion des erreurs et des exceptions de service
Bac à sable

Partager via