Introdução à Utilização de C# com a API de Anúncios do Bing

Artigo
05/01/2024

Para começar a desenvolver aplicações API de Anúncios do Bing com uma linguagem .NET, pode começar com os exemplos fornecidos ou seguir uma das instruções da aplicação para uma aplicação Web ou de Ambiente de Trabalho . Os exemplos foram desenvolvidos com o SDK .NET de Anúncios do Bing e Visual Studio Community. A configuração personalizada pode variar.

Precisará de credenciais de utilizador com acesso ao Microsoft Advertising em produção ou sandbox. Para o ambiente de produção, precisará de um token de programador de produção. Todos os clientes do sandbox podem utilizar o token de programador de sandbox universal, ou seja, BBD37VB98. Para obter mais informações, veja Introdução à API de Anúncios do Bing e ao Sandbox.

Para autenticar através do OAuth, também tem de registar uma aplicação e obter o identificador de cliente correspondente. Também tem de tomar nota do segredo do cliente e redirecionar o URI se estiver a desenvolver uma aplicação Web. Para obter mais detalhes sobre como registar uma aplicação na produção e o fluxo de concessão de código de autorização, veja Authentication with OAuth and Authentication With the SDKs (Autenticação com OAuth e Autenticação com os SDKs). Apesar de, em produção, ter de utilizar o seu próprio ID de aplicação (também conhecido como ID de cliente), todos os clientes do Microsoft Advertising podem utilizar o ID de cliente "Tutorial Sample App" público no sandbox, ou seja, 4c0b021c-00c3-4508-838f-d3127e8167ff. Para obter mais informações, consulte Sandbox.

Instalar o SDK

Instale o SDK .NET de Anúncios do Bing através do NuGet, através da interface de utilizador Gerir Pacotes NuGet ou através da Consola do Gestor de Pacotes. Para obter informações sobre como instalar o NuGet, consulte https://docs.nuget.org.

Nota

O SDK .NET de Anúncios do Bing suporta o .NET Standard 2.0. Pode escolher entre várias plataformas, por exemplo, .NET Core ou .NET Framework 4.6.1. Os exemplos da API de Anúncios do Bing são desenvolvidos através do Visual Studio Community 2017 e .NET Framework 4.7.1. O SDK .NET Standard 2.0 e Bing Ads .NET não suporta versões .NET Framework inferiores à 4.6.1. Para obter mais informações sobre o .NET Standard e como se relaciona com outras arquiteturas .NET, veja este artigo sobre .NET Standard.

Consola do Gestor de Pacotes NuGet

Clique em Ferramentas ->Gestor de Pacotes NuGet ->Consola do Gestor de Pacotes.
Escolha o projeto predefinido onde pretende instalar o SDK e, em seguida, na linha de comandos da consola, escreva Install-Package Microsoft.BingAds.SDK.
Se ainda não tiver referências a System.ServiceModel.Primitives 4.4.1, System.ServiceModel.Http 4.4.1 e System.ServiceModel.ConfigurationManager 4.4.1, escrevaInstall-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.

Instruções

Assim que tiver o SDK .NET de Anúncios do Bing instalado, pode procurar os Exemplos de Código da API de Anúncios do Bing em C# ou seguir uma das instruções da aplicação para uma aplicação Web ou de Ambiente de Trabalho .

Personalizar o cliente HTTP

Poderá querer personalizar o cliente HTTP utilizado pelo SDK .NET do Bing Ads para alterar alguns parâmetros padrão, como o tempo limite de HTTP, a configuração de proxy ou outras definições.

Para tal, pode criar uma classe personalizada herdada de HttpClientProvider e definida GlobalSettings.HttpClientProvider para uma instância dessa classe antes de efetuar chamadas de serviço. Por exemplo:

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

Chamadas do serviço de registo

A partir do SDK .NET 13.0.20 do Bing Ads, para ativar o pedido de registo e as mensagens de resposta, pode definir a variável de BINGADS_ConsoleLoggerMinLevel ambiente como Verbose:

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

Também pode ativar o mesmo registo com a BingAdsEventListener classe :

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

Também pode criar uma nova BingAdsEventListener instância para fornecer uma implementação de logger personalizada. Por exemplo:

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

Compartilhar via