Bing Ads API'si ile C# Kullanmaya Başlama

Makale
05/01/2024

Bing Ads API uygulamalarını .NET diliyle geliştirmeye başlamak için , sağlanan örneklerle başlayabilir veya Web veya Masaüstü uygulaması için uygulama kılavuzlarından birini izleyebilirsiniz. Örnekler Bing Ads .NET SDK ve Visual Studio Community ile geliştirilmiştir. Özel yapılandırmanız farklılık gösterebilir.

Üretim veya korumalı alanda Microsoft Advertising erişimine sahip kullanıcı kimlik bilgilerine ihtiyacınız olacaktır. Üretim ortamı için bir üretim geliştirici belirteci gerekir. Tüm korumalı alan istemcileri evrensel korumalı alan geliştirici belirtecini BBD37VB98 kullanabilir. Daha fazla bilgi için bkz. Bing Ads API'sini ve Korumalı Alanı Kullanmaya Başlama.

OAuth aracılığıyla kimlik doğrulaması yapmak için bir uygulamayı kaydetmeniz ve ilgili istemci tanımlayıcısını almanız gerekir. Ayrıca bir web uygulaması geliştiriyorsanız istemci gizli dizisini ve yeniden yönlendirme URI'sini de not almanız gerekir. Bir uygulamayı üretime kaydetme ve yetkilendirme kodu verme akışı hakkında daha fazla bilgi için bkz. OAuth ile Kimlik Doğrulaması ve SDK'larla Kimlik Doğrulaması. Üretimde kendi uygulama kimliğinizi (istemci kimliği) kullanmanız gerekse de, tüm Microsoft Advertising müşterileri korumalı alanda genel "Öğretici Örnek Uygulama" istemci kimliğini kullanabilir; örneğin, 4c0b021c-00c3-4508-838f-d3127e8167ff. Daha fazla bilgi için bkz. Korumalı Alan.

SDK'yi yükleme

Bing Ads .NET SDK'sını NuGet aracılığıyla, NuGet Paketlerini Yönet kullanıcı arabirimi aracılığıyla veya Paket Yöneticisi Konsolu aracılığıyla yükleyin. NuGet'i yükleme hakkında bilgi için bkz https://docs.nuget.org. .

Not

Bing Ads .NET SDK'sı .NET Standard 2.0'i destekler. .NET Core veya .NET Framework 4.6.1 gibi çeşitli platformlar arasından seçim yapabilirsiniz. Bing Ads API örnekleri, Visual Studio Community 2017 ve hedef .NET Framework 4.7.1 aracılığıyla geliştirilmiştir. .NET Standard 2.0 ve Bing Ads .NET SDK'sı 4.6.1'den düşük .NET Framework sürümlerini desteklemez. .NET Standard ve diğer .NET çerçeveleriyle ilişkisi hakkında daha fazla bilgi için .NET Standard ile ilgili bu makaleye bakın.

NuGet Paket Yöneticisi Konsolu

Araçlar ->NuGet Paket Yöneticisi ->Paket Yöneticisi Konsolu'nu tıklatın.
SDK'nın yüklenmesini istediğiniz varsayılan projeyi seçin ve konsol komut satırına yazın Install-Package Microsoft.BingAds.SDK.
System.ServiceModel.Primitives 4.4.1, System.ServiceModel.Http 4.4.1 ve System.ServiceModel.ConfigurationManager 4.4.1 başvurularınız yoksa, , Install-Package System.ServiceModel.Http -Version 4.4.1ve Install-Package System.Configuration.ConfigurationManager -Version 4.4.1yazın.Install-Package System.ServiceModel.Primitives -Version 4.4.1

Walkthroughs

Bing Ads .NET SDK'sını yükledikten sonra, C# dilindeki Bing Ads API Kod Örnekleri'ne göz atabilir veya Web veya Masaüstü uygulaması için uygulama kılavuzlarından birini izleyebilirsiniz.

HTTP istemcisini özelleştirme

HTTP zaman aşımı, ara sunucu yapılandırması veya diğer ayarlar gibi bazı standart parametreleri değiştirmek için Bing Ads .NET SDK'sı tarafından kullanılan HTTP istemcisini özelleştirmek isteyebilirsiniz.

Bunu yapmak için, hizmet çağrıları yapmadan önce öğesinden HttpClientProvider devralınan özel bir sınıf oluşturabilir ve bu sınıfın bir örneğine ayarlayabilirsiniz GlobalSettings.HttpClientProvider . Örneğin:

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

Hizmet çağrılarını günlüğe kaydetme

Günlük isteğini ve yanıt iletilerini etkinleştirmek için Bing Ads .NET SDK 13.0.20'den başlayarak ortam değişkenini BINGADS_ConsoleLoggerMinLevelVerboseolarak ayarlayabilirsiniz:

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

Sınıfını kullanarak BingAdsEventListener da aynı günlüğü etkinleştirebilirsiniz:

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

Özel günlükçü uygulaması sağlamak için yeni BingAdsEventListener bir örnek de oluşturabilirsiniz. Örneğin:

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

Ayrıca Bkz

Bing Ads API İstemci Kitaplıkları
Bing Ads API Kod Örnekleri
Bing Ads API Web Hizmeti Adresleri
Hizmet Hatalarını ve Özel Durumlarını İşleme
Sandbox

Aracılığıyla paylaş