Erste Schritte bei der Verwendung von C# mit Bing Ads-API

Artikel
10/24/2024

Um mit der Entwicklung Bing Ads API-Anwendungen mit einer .NET-Sprache zu beginnen, können Sie mit den bereitgestellten Beispielen beginnen oder eine der exemplarischen Vorgehensweisen für eine Web - oder Desktopanwendung befolgen. Die Beispiele wurden mit dem Bing Ads .NET SDK und Visual Studio Community entwickelt. Ihre benutzerdefinierte Konfiguration kann variieren.

Sie benötigen Benutzeranmeldeinformationen mit Zugriff auf Microsoft Advertising entweder in der Produktion oder sandbox. Für die Produktionsumgebung benötigen Sie ein Produktionsentwicklertoken. Alle Sandboxclients können das universelle Sandbox-Entwicklertoken verwenden, d. h. BBD37VB98. Weitere Informationen finden Sie unter Erste Schritte mit der Bing Ads-API und Sandbox.

Für die Authentifizierung über OAuth müssen Sie auch eine Anwendung registrieren und den entsprechenden Clientbezeichner abrufen. Sie müssen auch den geheimen Clientschlüssel und den Umleitungs-URI notieren, wenn Sie eine Webanwendung entwickeln. Weitere Informationen zum Registrieren einer Anwendung in der Produktion und zum Autorisierungscode-Genehmigungsflow finden Sie unter Authentifizierung mit OAuth und Authentifizierung mit den SDKs. Obwohl Sie in der Produktion Ihre eigene Anwendungs-ID (als Client-ID bezeichnet) verwenden müssen, können alle Microsoft Advertising-Kunden die öffentliche Client-ID "Tutorial-Beispiel-App" in der Sandbox verwenden, d. h. 00001111-aaaa-2222-bbbb-3333cccc4444. Weitere Informationen finden Sie unter Sandbox.

Das SDK installieren

Installieren Sie das Bing Ads .NET SDK über NuGet, entweder über die Benutzeroberfläche NuGet-Pakete verwalten oder über die Paket-Manager-Konsole. Informationen zum Installieren von NuGet finden Sie unter https://docs.nuget.org.

Hinweis

Das Bing Ads .NET SDK unterstützt .NET Standard 2.0. Sie können aus einer Vielzahl von Plattformen wählen, z. B. .NET Core oder .NET Framework 4.6.1. Die Bing Ads API-Beispiele werden über Visual Studio Community 2017 entwickelt und zielen auf .NET Framework 4.7.1 ab. .NET Standard 2.0 und Bing Ads .NET SDK unterstützen .NET Framework Versionen niedriger als 4.6.1 nicht. Weitere Informationen zu .NET Standard und seiner Beziehung zu anderen .NET Frameworks finden Sie in diesem Artikel auf .NET Standard.

NuGet-Paket-Manager-Konsole

Klicken Sie auf Extras ->NuGet-Paket-Manager ->Paket-Manager-Konsole.
Wählen Sie das Standardprojekt aus, in dem das SDK installiert werden soll, und geben Sie dann in der Konsolenbefehlszeile ein Install-Package Microsoft.BingAds.SDK.
Wenn Sie noch keine Verweise auf System.ServiceModel.Primitives 4.4.1, System.ServiceModel.Http 4.4.1 und System.ServiceModel.ConfigurationManager 4.4.1 haben, geben Sie , Install-Package System.ServiceModel.Http -Version 4.4.1und Install-Package System.Configuration.ConfigurationManager -Version 4.4.1einInstall-Package System.ServiceModel.Primitives -Version 4.4.1.

Vorgehensweisen

Nachdem Sie das Bing Ads .NET SDK installiert haben, können Sie entweder die Bing Ads API-Codebeispiele in C# durchsuchen oder eine der exemplarischen Vorgehensweisen der Anwendung für eine Web- oder Desktopanwendung befolgen.

Anpassen des HTTP-Clients

Möglicherweise möchten Sie den http-Client anpassen, der von Bing Ads .NET SDK verwendet wird, um einige Standardparameter wie HTTP-Timeout, Proxykonfiguration oder andere Einstellungen zu ändern.

Dazu können Sie eine benutzerdefinierte Klasse erstellen, die von HttpClientProvider geerbt und auf eine instance dieser Klasse festgelegt GlobalSettings.HttpClientProvider wird, bevor Sie Dienstaufrufe ausführen. Zum Beispiel:

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();

Protokollierungsdienstaufrufe

Ab Bing Ads .NET SDK 13.0.20 können Sie die Umgebungsvariable auf festlegen, um die BINGADS_ConsoleLoggerMinLevel Protokollierung von Anforderungs- und Antwortnachrichten zu Verboseaktivieren:

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

Sie können dieselbe Protokollierung auch mithilfe der BingAdsEventListener -Klasse aktivieren:

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

Sie können auch eine neue BingAdsEventListener instance erstellen, um eine benutzerdefinierte Protokollierungsimplementierung bereitzustellen. Zum Beispiel:

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

Siehe auch

Bing Ads API-Clientbibliotheken
Bing Ads-API-Codebeispiele
Bing Ads-API-Webdienstadressen
Behandeln von Dienstfehlern und -ausnahmen
Sandbox

Freigeben über