แชร์ผ่าน

เริ่มต้นใช้งาน C# ด้วย Bing Ads API

  • บทความ

เมื่อต้องเริ่มต้นพัฒนาแอปพลิเคชัน Bing Ads API ด้วยภาษา .NET คุณสามารถเริ่มต้นด้วยตัวอย่างที่ให้มา หรือทําตามหนึ่งในคําแนะนําแอปพลิเคชันสําหรับแอปพลิเคชันบนเว็บหรือเดสก์ท็อป ตัวอย่างได้รับการพัฒนาด้วย Bing Ads .NET SDK และ Visual Studio Community การกําหนดค่าแบบกําหนดเองของคุณอาจแตกต่างกัน

คุณจะต้องมีข้อมูลประจําตัวผู้ใช้ที่มีสิทธิ์เข้าถึง Microsoft Advertising ทั้งในการผลิตหรือ Sandbox สําหรับสภาพแวดล้อมการผลิต คุณจะต้องมีโทเค็นนักพัฒนาผลิต ไคลเอ็นต์ Sandbox ทั้งหมดสามารถใช้โทเค็นนักพัฒนา Sandbox สากลได้ เช่น BBD37VB98 สําหรับข้อมูลเพิ่มเติม โปรดดูเริ่มต้นใช้งาน API โฆษณา Bing และ Sandbox

หากต้องการรับรองความถูกต้องผ่าน OAuth คุณต้องลงทะเบียนแอปพลิเคชันและรับตัวระบุไคลเอ็นต์ที่สอดคล้องกัน คุณยังต้องจดบันทึกข้อมูลลับของไคลเอ็นต์และเปลี่ยนเส้นทาง URI ถ้าคุณกําลังพัฒนาแอปพลิเคชันบนเว็บ สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับการลงทะเบียนแอปพลิเคชันในการผลิตและขั้นตอนการให้รหัสการให้สิทธิ์ โปรดดูการรับรองความถูกต้องด้วย OAuth และการรับรองความถูกต้องด้วย SDK แม้ว่าในการผลิตคุณต้องใช้ ID แอปพลิเคชันของคุณเอง (a.k.a. client ID) ลูกค้า Microsoft Advertising ทั้งหมดสามารถใช้ ID ไคลเอ็นต์ "แอปตัวอย่างบทช่วยสอน" สาธารณะใน Sandbox เช่น 4c0b021c-00c3-4508-838f-d3127e8167ff สําหรับข้อมูลเพิ่มเติม โปรดดู Sandbox

ติดตั้ง SDK

ติดตั้ง Bing Ads .NET SDK ผ่าน NuGet ผ่านส่วนติดต่อผู้ใช้ Manage NuGet Packages หรือผ่านคอนโซลตัวจัดการแพคเกจ สําหรับข้อมูลเกี่ยวกับการติดตั้ง NuGet ให้ดูที่https://docs.nuget.org

หมายเหตุ

โฆษณา Bing .NET SDK สนับสนุน .NET Standard 2.0 คุณสามารถเลือกได้จากหลากหลายแพลตฟอร์ม เช่น .NET Core หรือ .NET Framework 4.6.1 ตัวอย่าง API โฆษณา Bing ได้รับการพัฒนาผ่าน Visual Studio Community 2017 และเป้าหมาย.NET Framework 4.7.1 .NET Standard 2.0 และ Bing Ads .NET SDK ไม่สนับสนุนรุ่น.NET Framework ต่ํากว่า 4.6.1 สําหรับข้อมูลเพิ่มเติมเกี่ยวกับ .NET Standard และวิธีการที่เกี่ยวข้องกับ .NET frameworks อื่นๆ โปรดดูที่บทความนี้บน .NET Standard

NuGet Package Manager Console

  1. คลิกที่ เครื่องมือ ->ตัวจัดการแพคเกจ NuGet ->คอนโซลตัวจัดการแพคเกจ
  2. เลือกโครงการเริ่มต้นที่คุณต้องการติดตั้ง SDK จากนั้นภายในบรรทัดคําสั่งคอนโซล ให้พิมพ์Install-Package Microsoft.BingAds.SDK
  3. ถ้าคุณยังไม่มีการอ้างอิงไปยัง System.ServiceModel.Primitives 4.4.1, System.ServiceModel.Http 4.4.1 และ System.ServiceModel.ConfigurationManager 4.4.1 พิมพ์ Install-Package System.ServiceModel.Primitives -Version 4.4.1Install-Package System.ServiceModel.Http -Version 4.4.1และInstall-Package System.Configuration.ConfigurationManager -Version 4.4.1

การฝึกปฏิบัติ

เมื่อคุณติดตั้ง Bing Ads .NET SDK แล้ว คุณสามารถเรียกดูตัวอย่างโค้ด API ของโฆษณา Bing ใน C# หรือทําตามหนึ่งในคําแนะนําแอปพลิเคชันสําหรับเว็บหรือแอปพลิเคชันเดสก์ท็อป

การกําหนดไคลเอ็นต์ HTTP เอง

คุณอาจต้องการปรับแต่งไคลเอ็นต์ HTTP ที่ใช้โดย Bing Ads .NET SDK เพื่อเปลี่ยนพารามิเตอร์มาตรฐานบางอย่าง เช่น การหมดเวลา HTTP การกําหนดค่าพร็อกซี หรือการตั้งค่าอื่น ๆ

เมื่อต้องการทําเช่นนั้น คุณสามารถสร้างคลาสแบบกําหนดเองที่สืบทอดมา HttpClientProvider และตั้งค่า GlobalSettings.HttpClientProvider เป็นอินสแตนซ์ของคลาสนั้นก่อนที่จะเรียกใช้บริการได้ ตัวอย่างเช่น:

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

การบันทึกการเรียกบริการ

เริ่มต้นจาก Bing Ads .NET SDK 13.0.20 เพื่อเปิดใช้งานคําขอการบันทึกและข้อความตอบกลับ คุณสามารถตั้งค่า BINGADS_ConsoleLoggerMinLevel ตัวแปรสภาพแวดล้อมเป็น Verbose:

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

คุณยังสามารถเปิดใช้งานการบันทึกเดียวกันโดยใช้คลาส:BingAdsEventListener

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

คุณยังสามารถสร้างอินสแตนซ์ใหม่ BingAdsEventListener เพื่อให้มีการใช้งานตัวบันทึกแบบกําหนดเองได้ ตัวอย่างเช่น:

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

ดูเพิ่มเติม

ไลบรารีไคลเอ็นต์ Bing Ads API
ตัวอย่างรหัส API ของโฆษณา Bing
ที่อยู่ของบริการเว็บ API ของ Bing Ads
การจัดการข้อผิดพลาดและข้อยกเว้นของบริการ
Sandbox