Introducción al uso de C# con Bing Ads API

Artículo
05/01/2024

Para empezar a desarrollar aplicaciones de API de Bing Ads con un lenguaje .NET, puede empezar con los ejemplos proporcionados o seguir uno de los tutoriales de aplicación para una aplicación web o de escritorio . Los ejemplos se han desarrollado con el SDK de .NET de Bing Ads y Visual Studio Community. La configuración personalizada puede variar.

Necesitará credenciales de usuario con acceso a Microsoft Advertising en producción o espacio aislado. Para el entorno de producción, necesitará un token de desarrollador de producción. Todos los clientes de espacio aislado pueden usar el token de desarrollador de espacio aislado universal, es decir, BBD37VB98. Para obtener más información, consulte Introducción a la API y el espacio aislado de Bing Ads.

Para autenticarse a través de OAuth, también debe registrar una aplicación y obtener el identificador de cliente correspondiente. También debe tomar nota del secreto de cliente y el URI de redirección si está desarrollando una aplicación web. Para obtener más información sobre cómo registrar una aplicación en producción y el flujo de concesión de código de autorización, consulte Autenticación con OAuth y Autenticación con los SDK. Aunque en producción debe usar su propio identificador de aplicación (por ejemplo, el identificador de cliente), todos los clientes de Microsoft Advertising pueden usar el identificador de cliente público "Aplicación de ejemplo de tutorial" en el espacio aislado, es decir, 4c0b021c-00c3-4508-838f-d3127e8167ff. Para obtener más información, consulte Espacio aislado.

Instalar el SDK

Instale el SDK de .NET de Bing Ads a través de NuGet, ya sea a través de la interfaz de usuario Administrar paquetes NuGet o a través de la consola del Administrador de paquetes. Para obtener información sobre cómo instalar NuGet, vea https://docs.nuget.org.

Nota:

El SDK de .NET de Bing Ads admite .NET Standard 2.0. Puede elegir entre varias plataformas, como .NET Core o .NET Framework 4.6.1. Los ejemplos de API de Bing Ads se desarrollan a través de Visual Studio Community 2017 y tienen como destino .NET Framework 4.7.1. El SDK de .NET Standard 2.0 y Bing Ads para .NET no admite versiones de .NET Framework inferiores a la 4.6.1. Para obtener más información sobre .NET Standard y cómo se relaciona con otros marcos de .NET, consulte este artículo sobre .NET Standard.

Consola del Administrador de paquetes NuGet

Haga clic en Herramientas ->Administrador de paquetes NuGet ->Consola del Administrador de paquetes.
Elija el proyecto predeterminado donde desea instalar el SDK y, a continuación, en la línea de comandos de la consola, escriba Install-Package Microsoft.BingAds.SDK.
Si aún no tiene referencias a System.ServiceModel.Primitives 4.4.1, System.ServiceModel.Http 4.4.1 y System.ServiceModel.ConfigurationManager 4.4.1, escriba Install-Package System.ServiceModel.Primitives -Version 4.4.1, Install-Package System.ServiceModel.Http -Version 4.4.1y Install-Package System.Configuration.ConfigurationManager -Version 4.4.1.

Tutoriales

Una vez instalado el SDK de .NET de Bing Ads, puede examinar los ejemplos de código de api de Bing Ads en C# o seguir uno de los tutoriales de aplicación para una aplicación web o de escritorio .

Personalización del cliente HTTP

Es posible que quiera personalizar el cliente HTTP que usa el SDK de .NET de Bing Ads para cambiar algunos parámetros estándar, como el tiempo de espera HTTP, la configuración de proxy u otra configuración.

Para ello, puede crear una clase personalizada heredada de HttpClientProvider y establecerse en GlobalSettings.HttpClientProvider una instancia de esa clase antes de realizar llamadas de servicio. Por ejemplo:

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

Registro de llamadas de servicio

A partir del SDK de .NET de Bing Ads 13.0.20, para habilitar los mensajes de solicitud y respuesta de registro, puede establecer la variable de BINGADS_ConsoleLoggerMinLevel entorno en Verbose:

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

También puede habilitar el mismo registro mediante la BingAdsEventListener clase :

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

También puede crear una nueva BingAdsEventListener instancia para proporcionar una implementación de registrador personalizada. Por ejemplo:

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

Consulta también

Bibliotecas de cliente de api de Bing Ads
Ejemplos de código de api de Bing Ads
Direcciones del servicio web de la API de Bing Ads
Control de errores y excepciones del servicio
Espacio aislado

Compartir a través de