Introduzione all'uso di C# con l'API Bing Ads

Articolo
05/01/2024

Per iniziare a sviluppare applicazioni API Bing Ads con un linguaggio .NET, è possibile iniziare con gli esempi forniti o seguire una delle procedure dettagliate dell'applicazione per un'applicazione Web o desktop . Gli esempi sono stati sviluppati con Bing Ads .NET SDK e Visual Studio Community. La configurazione personalizzata può variare.

Saranno necessarie credenziali utente con accesso a Microsoft Advertising in ambiente di produzione o sandbox. Per l'ambiente di produzione è necessario un token per sviluppatori di produzione. Tutti i client sandbox possono usare il token per sviluppatori sandbox universale, ad esempio BBD37VB98. Per altre informazioni, vedere Introduzione all'API Bing Ads e alla sandbox.

Per eseguire l'autenticazione tramite OAuth, è anche necessario registrare un'applicazione e ottenere l'identificatore client corrispondente. È anche necessario prendere nota del segreto client e dell'URI di reindirizzamento se si sviluppa un'applicazione Web. Per altre informazioni sulla registrazione di un'applicazione nell'ambiente di produzione e sul flusso di concessione del codice di autorizzazione, vedere Autenticazione con OAuth e Autenticazione con gli SDK. Anche se nell'ambiente di produzione è necessario usare il proprio ID applicazione (ovvero l'ID client), tutti i clienti di Microsoft Advertising possono usare l'ID client "Tutorial Sample App" pubblico nella sandbox, ad esempio 4c0b021c-00c3-4508-838f-d3127e8167ff. Per altre informazioni, vedere Sandbox.

Installare l'SDK

Installare Bing Ads .NET SDK tramite NuGet, tramite l'interfaccia utente Gestisci pacchetti NuGet o tramite la console di Gestione pacchetti. Per informazioni sull'installazione di NuGet, vedere https://docs.nuget.org.

Nota

Bing Ads .NET SDK supporta .NET Standard 2.0. È possibile scegliere tra diverse piattaforme, ad esempio .NET Core o .NET Framework 4.6.1. Gli esempi di API Bing Ads vengono sviluppati tramite Visual Studio Community 2017 e destinati a .NET Framework 4.7.1. .NET Standard 2.0 e Bing Ads .NET SDK non supportano versioni di .NET Framework inferiori alla 4.6.1. Per altre informazioni su .NET Standard e su come è correlato ad altri framework .NET, vedere questo articolo su .NET Standard.

Console di Gestione pacchetti NuGet

Fare clic su Strumenti ->Gestione pacchetti NuGet ->Console di Gestione pacchetti.
Scegliere il progetto predefinito in cui si vuole installare l'SDK e quindi nella riga di comando della console digitare Install-Package Microsoft.BingAds.SDK.
Se non sono già presenti riferimenti a System.ServiceModel.Primitives 4.4.1, System.ServiceModel.Http 4.4.1 e System.ServiceModel.ConfigurationManager 4.4.1, digitare Install-Package System.ServiceModel.Primitives -Version 4.4.1, Install-Package System.ServiceModel.Http -Version 4.4.1e Install-Package System.Configuration.ConfigurationManager -Version 4.4.1.

Procedure dettagliate

Dopo aver installato Bing Ads .NET SDK, è possibile esplorare gli esempi di codice dell'API Bing Ads in C# o seguire una delle procedure dettagliate dell'applicazione per un'applicazione Web o desktop .

Personalizzazione del client HTTP

È possibile personalizzare il client HTTP usato da Bing Ads .NET SDK per modificare alcuni parametri standard, ad esempio timeout HTTP, configurazione proxy o altre impostazioni.

A tale scopo, è possibile creare una classe personalizzata ereditata da HttpClientProvider e impostarla su GlobalSettings.HttpClientProvider un'istanza di tale classe prima di effettuare chiamate al servizio. Ad esempio:

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

Registrazione delle chiamate al servizio

A partire da Bing Ads .NET SDK 13.0.20, per abilitare la registrazione dei messaggi di richiesta e risposta, è possibile impostare la BINGADS_ConsoleLoggerMinLevel variabile di ambiente su Verbose:

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

È anche possibile abilitare la stessa registrazione usando la BingAdsEventListener classe :

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

È anche possibile creare una nuova BingAdsEventListener istanza per fornire un'implementazione del logger personalizzata. Ad esempio:

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

Vedere anche

Librerie client dell'API Bing Ads
Esempi di codice API Bing Ads
Indirizzi del servizio Web dell'API Bing Ads
Gestione di errori ed eccezioni del servizio
Sandbox

Condividi tramite