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

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

Sie benötigen Benutzeranmeldeinformationen mit Zugriff auf Microsoft Advertising, entweder in der Produktion oder in der Sandbox. Für die Produktionsumgebung benötigen Sie einen Produktionsentwicklertoken. Alle Sandbox-Clients 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 außerdem eine Anwendung registrieren und die entsprechende Client-ID abrufen. Außerdem müssen Sie 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-Erteilungsfluss finden Sie unter Authentifizierung mit OAuth und Authentifizierung mit den SDKs. Obwohl Sie in der Produktion Ihre eigene Anwendungs-ID (auch als Client-ID bezeichnet) verwenden müssen, können alle Microsoft Advertising-Kunden die öffentliche Client-ID "Tutorial Sample 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.

NuGet-Paket-Manager-Konsole

1. Klicken Sie auf Extras -NuGet-Paket-Manager> -Paket-Manager-Konsole>.
2. 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.
3. 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.Primitives -Version 4.4.1, Install-Package System.ServiceModel.Http -Version 4.4.1, und Install-Package System.Configuration.ConfigurationManager -Version 4.4.1ein.

Vorgehensweisen

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

Anpassen des HTTP-Clients

Sie können den HTTP-Client anpassen, der vom Bing Ads .NET SDK verwendet wird, um einige Standardparameter wie HTTP-Timeout, Proxykonfiguration oder andere Einstellungen zu ändern.

Zu diesem Zweck können Sie eine benutzerdefinierte Klasse erstellen, die von HttpClientProvider einer Instance dieser Klasse geerbt und auf diese festgelegt GlobalSettings.HttpClientProvider ist, 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(); 

Protokollieren von Dienstaufrufen

Beginnend mit dem Bing Ads .NET SDK 13.0.20 können Sie die BINGADS_ConsoleLoggerMinLevel Umgebungsvariable auf Folgendes setzen, um die Protokollierung von Anforderungs- und Antwortmeldungen zu Verboseermöglichen:

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

Sie können die gleiche Protokollierung auch mit der BingAdsEventListener folgenden 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