บทความนี้ประกอบด้วยคําตอบของคําถามที่ถามบ่อยบางส่วนเกี่ยวกับ Bing Ads API
ดูวิธีใช้
ฉันจะขอรับความช่วยเหลือได้จากที่ใด
ฟอรั่ม Microsoft Q&A มีให้สําหรับชุมชนนักพัฒนาเพื่อถามและตอบคําถามเกี่ยวกับ Bing Ads API และสคริปต์โฆษณาของ Microsoft Microsoft จะตรวจสอบฟอรั่มและตอบกลับคําถามที่ชุมชนยังไม่ได้ตอบ
สิ่งสำคัญ
หากต้องการตรวจสอบให้แน่ใจว่าเราเห็นคําถามของคุณ ให้แท็กด้วย "api โฆษณา"
หากการตรวจสอบเกี่ยวข้องกับบัญชีที่ละเอียดอ่อนหรือรายละเอียดส่วนบุคคลหรือหากคุณไม่พบข้อมูลที่คุณต้องการในการแก้ไขปัญหาของคุณผ่านทาง Microsoft Q&A โปรดติดต่อฝ่ายสนับสนุนโฆษณาของ Microsoft หากต้องการแก้ไขปัญหาอย่างมีประสิทธิภาพ โปรดให้การสนับสนุนพร้อมรายละเอียดที่ร้องขอในการสนับสนุนการมีส่วนร่วม
ฉันจะค้นหาข้อมูลเกี่ยวกับการเปลี่ยนแปลงได้อย่างไร
บันทึกย่อประจํารุ่นและคู่มือการย้ายข้อมูลเป็นแหล่งข้อมูลที่ยอดเยี่ยมในการเริ่มต้น
คุณสามารถลงทะเบียนเพื่อรับจดหมายข่าวรายเดือนผ่านทางแท็บ ข่าวสาร ของพอร์ทัลนักพัฒนา และนั่นคือจุดรวมการประกาศ บล็อก ล่าสุด
เริ่มต้นใช้งาน
ข้อกําหนดในการใช้ Bing Ads API มีอะไรบ้าง
เมื่อต้อง เริ่มต้นใช้งาน คุณจําเป็นต้องลงทะเบียนสําหรับบัญชี Microsoft Advertising และรับโทเค็นสําหรับนักพัฒนาของคุณที่แท็บ บัญชี ของพอร์ทัลนักพัฒนา
ภาษาการเขียนโปรแกรมและ SDK ใดที่ได้รับการสนับสนุน
คุณสามารถพัฒนาแอปพลิเคชัน BING ADS API ด้วยภาษาการเขียนโปรแกรมใด ๆ ที่สนับสนุนบริการเว็บ Bing Ads API Software Development Kits (SDK) ช่วยยกระดับประสบการณ์ในการพัฒนาแอปพลิเคชัน BING ADS API ด้วยภาษา .NET, Java, PHP และ Python SDK แต่ละรายการมีพร็อกซีสําหรับบริการเว็บ Bing Ads API ทั้งหมด และแสดงรายละเอียดการรับรองความถูกต้องในระดับต่ําด้วย OAuth คุณสามารถใช้อินเทอร์เฟซ BulkServiceManager และ ReportingServiceManager ระดับสูงเพื่อนามธรรมและดําเนินการในบริการกลุ่มและการรายงานในระดับต่ําได้
เราได้ยินคําขอสําหรับ SDK เพิ่มเติม เช่น Perl และ Ruby แม้ว่าจะไม่มีแผนที่จะเพิ่มการสนับสนุนในระยะใกล้
ฉันจะดูตัวอย่างโค้ดในภาษาการเขียนโปรแกรมต่างๆ ได้อย่างไร
นอกเหนือจากตัวอย่างโค้ดแล้ว คุณจะพบส่วนย่อยของโค้ดในคู่มือทางเทคนิคจํานวนมาก เช่น คู่มือเริ่มต้นใช้งาน คุณสามารถใช้ตัวเลือกภาษาที่ด้านบนหรือด้านขวาของหน้าเหล่านั้นเพื่อดูตัวอย่างใน CSharp, Java, Php หรือ Python ได้ เมื่อคุณเลือกภาษา การตั้งค่าจะยังคงอยู่เมื่อคุณนําทางไปยังหน้าอื่นๆ ตัวเลือกภาษาจะรวมเฉพาะภาษาที่มีตัวอย่างสําหรับหน้าที่ระบุเท่านั้น และจะใช้ค่าเริ่มต้นเป็น C# ถ้าภาษาที่คุณตั้งค่าไว้ก่อนหน้านี้ไม่พร้อมใช้งานสําหรับหน้าที่คุณนําทางไป
ความพร้อมใช้งานของฟีเจอร์
ฉันควรใช้ API การจัดการกลุ่มหรือแคมเปญหรือไม่
ขอแนะนําให้ ใช้บริการแบบกลุ่ม โดยเฉพาะเมื่อคุณต้องเพิ่มหรืออัปเดตโฆษณาและคีย์เวิร์ดในกลุ่มโฆษณาหรือแคมเปญหลายรายการในบัญชี ฟีเจอร์บางอย่างไม่พร้อมใช้งานใน Bulk เช่น AddUetTags, GetBMCStoresByCustomerId, GetGeoLocationsFileUrl และ GetMediaMetaDataByAccountId สําหรับฟีเจอร์เหล่านี้ คุณต้องใช้บริการการจัดการแคมเปญ
รายงานประสิทธิภาพการทํางานของ API ใดที่พร้อมใช้งานและข้อมูลของฉันจะพร้อมใช้งานเมื่อใด
บริการการรายงานสนับสนุน รายงานชนิด เดียวกันส่วนใหญ่ที่คุณสามารถค้นหาได้ในเว็บแอปพลิเคชัน Microsoft Advertising ตรวจสอบให้แน่ใจว่าได้ตรวจสอบ แอตทริบิวต์รายงานและสถิติประสิทธิภาพการทํางาน และคําแนะนํา ระยะเวลาการเก็บข้อมูลรายงาน สําหรับรายละเอียดความพร้อมใช้งาน
เมื่อผู้ใช้คลิกโฆษณา ระบบอาจใช้เวลาสูงสุดสองชั่วโมงในการดําเนินการคลิก (3 ชั่วโมงสําหรับ Conversion) และทําให้พร้อมใช้งานสําหรับการรายงาน เมื่อข้อมูลทั้งหมดสําหรับวันก่อนหน้าได้รับการประมวลผลและทําให้พร้อมใช้งานสําหรับการรายงานแล้ว สถานะนี้จะเรียกว่า ปิดหนังสือ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับเวลาที่หนังสือถูกปิดสําหรับการรายงาน ดูโซนเวลาในการรายงาน
OAuth
เมื่อไรที่จะต้องรับรองความถูกต้องโดยใช้หลายปัจจัยผ่าน API Bing Ads, API เนื้อหา และ API โฆษณาราคาโรงแรม?
สิ่งสำคัญ
ในเดือนมิถุนายน 2022 เราได้แนะนํา การรับรองความถูกต้องแบบหลายปัจจัย เป็นข้อกําหนดสําหรับ Bing Ads คุณอาจยังจําเป็นต้องทําการเปลี่ยนแปลงรหัสเพื่อให้สอดคล้องกับข้อกําหนดนี้ Microsoft Advertising จะดําเนินการตรวจสอบการบังคับใช้ทางเทคนิคในช่วงต้นเดือนตุลาคม
โพสต์ในบล็อกนี้จะ สรุปขั้นตอนที่คุณควรดําเนินการเพื่อให้แน่ใจว่าเป็นไปตามข้อกําหนด
สําหรับข้อมูลเพิ่มเติม โปรดดูคําแนะนําข้อกําหนดในการรับรองความถูกต้องแบบหลายปัจจัย
ฉันจําเป็นต้องทําการเปลี่ยนแปลงใด ๆ เพื่อให้สอดคล้องกับข้อกําหนดการรับรองความถูกต้องแบบหลายปัจจัยหรือไม่?
คุณต้องอัปเดตแอปพลิเคชันของคุณเพื่อใช้ขอบเขตใหม่msads.manage
ผ่านจุดสิ้นสุดแพลตฟอร์มข้อมูลประจำตัวของ Microsoft นักพัฒนาแอปพลิเคชันทั้งหมดต้องดําเนินการเพื่อใช้ขอบเขตใหม่
คุณต้องพร้อมท์ผู้ใช้เพื่อขอความยินยอมผ่านขอบเขตใหม่msads.manage
และจุดสิ้นสุดแพลตฟอร์มข้อมูลประจำตัวของ Microsoft
ฉันจําเป็นต้องลงทะเบียนแอปพลิเคชันใหม่เพื่อใช้ msads.manage หรือไม่
ถ้าคุณมี ID แอปพลิเคชันเก่า (หรือ ID ไคลเอ็นต์) ที่จัดรูปแบบเป็นค่าเลขฐานสิบหก เช่น 0000000012345A67 คุณต้องลงทะเบียนแอปพลิเคชันใหม่ รหัสแอปพลิเคชันแพลตฟอร์มข้อมูลประจำตัวของ Microsoft ที่ถูกต้องจะถูกจัดรูปแบบเป็น GUID ที่มีเส้นประ เช่น 00001111-aaaa-2222-bbbb-3333cccc4444 ถ้าคุณไม่เห็นแอปที่มีอยู่ใน พอร์ทัล Azure - การลงทะเบียนแอป นั่นเป็นข้อบ่งชี้ว่าคุณควรแทนที่ด้วยแอปใหม่
ผู้ใช้จําเป็นต้องให้ความยินยอมเมื่อฉันอัปเกรดเป็น msads.manage หรือไม่
ได้ คุณต้องพร้อมท์ผู้ใช้เพื่อขอความยินยอมผ่านขอบเขตใหม่msads.manage
และจุดสิ้นสุดแพลตฟอร์มข้อมูลประจำตัวของ Microsoft
ประสบการณ์ของผู้ใช้เมื่อได้รับพร้อมท์เพื่อขอความยินยอมผ่านจุดสิ้นสุดแพลตฟอร์มข้อมูลประจำตัวของ Microsoft คืออะไร
เมื่อคุณพร้อมท์ผู้ใช้เพื่อขอความยินยอม (โดยใช้ผู้เช่าทั่วไป) ที่มีจุดสิ้นสุดแพลตฟอร์มข้อมูลประจำตัวของ Microsoft ประสบการณ์การลงชื่อเข้าใช้ของผู้ใช้จะแตกต่างกันไปขึ้นอยู่กับข้อมูลประจําตัวพื้นฐานที่อยู่เบื้องหลังข้อมูลประจําตัวของพวกเขา
- บุคคลที่มีข้อมูลประจําตัว MSA เท่านั้นจะถูกนําไปยังหน้าลงชื่อเข้าใช้ MSA
- บุคคลที่มีข้อมูลประจําตัว Azure AD เท่านั้นจะถูกนําไปยังหน้าลงชื่อเข้าใช้ขององค์กร
- บุคคลที่ข้อมูลประจําตัวถูกต้องทั้งใน MSA และโดเมน Azure AD จะพบหน้าแก้ความกํากวมที่ขอให้พวกเขาเลือกระหว่างข้อมูลประจําตัวส่วนบุคคลและที่ทํางานหรือโรงเรียนของพวกเขา การแก้ความกํากวมนี้จะแสดงตราบใดที่ผู้ใช้รายนี้มีข้อมูลประจําตัวสองรายการที่เชื่อมโยงกับที่อยู่อีเมลเดียวกัน ผู้ใช้สามารถหยุดดูสิ่งนี้ได้โดยการเปลี่ยนที่อยู่อีเมลของบัญชี Microsoft ส่วนบุคคลของพวกเขา สําหรับข้อมูลเพิ่มเติม ให้ดูที่https://cloudblogs.microsoft.com/enterprisemobility/2016/09/15/cleaning-up-the-azure-ad-and-microsoft-account-overlap/
หมายเหตุ
คุณควรจัดการ รหัสข้อผิดพลาดในการดําเนินการ 122 ถึง 125 เพื่อช่วยให้ผู้ใช้แอปพลิเคชันของคุณเลือกข้อมูลประจําตัวที่ถูกต้อง เช่น ทํางานเทียบกับบัญชีส่วนบุคคล
เมื่อผู้ใช้สลับจากการใช้บัญชีส่วนบุคคลของพวกเขาไปยังบัญชีที่ทํางานหรือโรงเรียนของพวกเขาใน Microsoft Advertising จะเกิดอะไรขึ้นกับโทเค็นรีเฟรชของพวกเขา
ถ้าผู้ใช้ไม่มีข้อมูลประจําตัวของบัญชีส่วนบุคคล MSA แล้ว Bing Ads API จะไม่ยอมรับโทเค็นการเข้าถึงที่มีอยู่อีกต่อไป ในทํานองเดียวกัน โทเค็นรีเฟรชไม่สามารถใช้เพื่อร้องขอโทเค็นการเข้าถึงใหม่ได้ ดังนั้นคุณจะต้องขอความยินยอมจากผู้ใช้อีกครั้งสําหรับแอปพลิเคชันของคุณเพื่อจัดการบัญชี Microsoft Advertising ของพวกเขา คุณควรละทิ้งโทเค็นรีเฟรชก่อนหน้า
Sandbox สนับสนุนบัญชีที่ทํางานหรือบัญชีโรงเรียนหรือไม่
ไม่ บัญชีที่ทํางานหรือโรงเรียนได้รับการสนับสนุนในการผลิตเท่านั้น
ฉันต้องการเรียกใช้แอปพลิเคชันของฉันโดยไม่มีการโต้ตอบกับผู้ใช้ ฉันจะรับรองความถูกต้องโดยไม่ต้องได้รับพร้อมท์สําหรับสิทธิ์ในการใช้ข้อมูลประจําตัว Microsoft Advertising ได้อย่างไร?
หากต้องการจัดการบัญชี Microsoft Advertising ทางโปรแกรม คุณต้องให้ความยินยอมอย่างน้อยหนึ่งครั้งผ่านโฟลว์ความยินยอมของแอปพลิเคชันบนเว็บ สําหรับการรับรองความถูกต้องซ้ําหรือระยะยาว คุณควรทําตามรหัสการให้สิทธิ์สําหรับการรับโทเค็นการเข้าถึงและโทเค็นรีเฟรช หลังจากนั้นคุณสามารถใช้โทเค็นรีเฟรชล่าสุดเพื่อร้องขอโทเค็นการเข้าถึงและการรีเฟรชใหม่ได้โดยไม่ต้องมีการโต้ตอบกับผู้ใช้เพิ่มเติม คุณอาจจําเป็นต้องขอความยินยอมจากผู้ใช้อีกครั้ง ตัวอย่างเช่น ถ้าผู้ใช้ผ่านการกู้คืนบัญชี เปลี่ยนรหัสผ่านของพวกเขา หรือเอาสิทธิ์สําหรับแอปพลิเคชันของคุณออกเพื่อรับรองความถูกต้องในนามของพวกเขา
โทเค็นการเข้าถึงและการรีเฟรชจะหมดอายุเมื่อใด
โทเค็นการเข้าถึงโดยทั่วไปจะหมดอายุหลังจากหนึ่งชั่วโมง แม้ว่าคุณควรตรวจสอบวันหมดอายุทุกครั้งที่คุณร้องขอโทเค็นใหม่เสมอ
โทเค็นรีเฟรชจะเป็นค่าที่ทึบแสงอย่างสมบูรณ์สําหรับแอปพลิเคชันของคุณ ซึ่งมีอายุยาวนาน เช่น 90 วันสําหรับไคลเอ็นต์สาธารณะ แต่ไม่ควรเขียนแอปเพื่อคาดหวังว่าโทเค็นการรีเฟรชจะมีอายุการใช้งานตามช่วงเวลาใด โทเค็นการรีเฟรชสามารถถูกยกเลิกได้ตลอดเวลาและวิธีเดียวที่แอปจะทราบว่าโทเค็นรีเฟรชถูกต้องหรือไม่คือการพยายามแลกใช้โดยการร้องขอโทเค็น แม้ว่าคุณรีเฟรชโทเค็นบนอุปกรณ์เดียวกันอย่างต่อเนื่องด้วยโทเค็นรีเฟรชล่าสุดคุณควรจะเริ่มต้นอีกครั้งและขอความยินยอมจากผู้ใช้หากคุณลงชื่อออกแล้วผู้ใช้ Microsoft Advertising เปลี่ยนรหัสผ่านของพวกเขา ลบอุปกรณ์ออกจากรายการอุปกรณ์ที่เชื่อถือได้หรือลบสิทธิ์สําหรับแอปพลิเคชันของคุณเพื่อรับรองความถูกต้องในนามของพวกเขา ไม่ว่าเมื่อใดก็ตามโดยไม่มีคําเตือนล่วงหน้า Microsoft อาจพิจารณาว่าควรได้รับความยินยอมจากผู้ใช้อีกครั้ง แนวทางปฏิบัติที่ดีที่สุดคือคุณควรจัดเก็บโทเค็นรีเฟรชล่าสุดไว้อย่างปลอดภัยทุกครั้งที่คุณร้องขอโทเค็นการเข้าถึงและการรีเฟรชใหม่
เหตุใดฉันจึงต้องใช้โทเค็นการเข้าถึงและโทเค็นนักพัฒนา
โทเค็นการเข้าถึงแสดงข้อมูลประจําตัวผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising อย่างน้อยหนึ่งบัญชี ID แอปพลิเคชัน (a.k.a. client_id) ระบุแอปพลิเคชันของคุณสําหรับผู้ใช้ Microsoft Advertising แต่ละรายที่ให้ความยินยอม โทเค็นนักพัฒนาให้สิทธิ์แอปพลิเคชันของคุณในการใช้ Bing Ads API
ยี่ห้อ
API Bing Ads จะถูกสร้างใหม่พร้อมกับแพลตฟอร์มการโฆษณาของ Microsoft หรือไม่?
ขณะนี้ Bing Ads คือการโฆษณาของ Microsoft ชื่อใหม่ของเราสะท้อนให้เห็นว่าเรากําลังขยายโซลูชันการโฆษณาเพื่อช่วยให้คุณเข้าถึงลูกค้ามากขึ้นได้อย่างไร ไม่มีแผนที่จะเปลี่ยนชื่อเวอร์ชัน API ใด ๆ ในปัจจุบัน ตารางด้านล่างแสดงรายการชื่อที่อาจมีการเปลี่ยนแปลงหรือไม่มีการเปลี่ยนแปลง สําหรับข้อมูลเพิ่มเติม โปรดดูประกาศของแบรนด์
ชื่อก่อนหน้า | ชื่อปัจจุบัน |
---|---|
การแสดงตัวอย่างโฆษณาและเครื่องมือวินิจฉัย | การแสดงตัวอย่างโฆษณาและเครื่องมือวินิจฉัย |
Bing Ads | โฆษณา Microsoft |
ผู้เชี่ยวชาญที่ได้รับการรับรอง Bing Ads | ผู้เชี่ยวชาญที่ได้รับการรับรอง Bing Ads |
Bing Ads API | Bing Ads API |
แอป Bing Ads | แอปโฆษณาของ Microsoft |
API เนื้อหา Bing Ads | API เนื้อหา Bing Ads |
ตัวแก้ไข Bing Ads | ตัวแก้ไขโฆษณาของ Microsoft |
แฟน Bing Ads | Microsoft Advertising Fans |
ข่าวกรอง Bing Ads | Microsoft Advertising Intelligence |
คู่ค้า Bing Ads | Microsoft Advertising Partner |
สคริปต์ Bing Ads | Microsoft Advertising Scripts |
Bing Ads SDK | Bing Ads SDK |
บีง โฮเต็ล เซ็นเตอร์ | Microsoft Hotel Center |
ศูนย์การค้า Bing | Microsoft Merchant Center |
เครือข่าย Bing | เครือข่ายโฆษณาของ Microsoft |
การรวบรวมเครือข่าย Bing | ไซต์คู่ค้าโฆษณาของ Microsoft |
รางวัลของพันธมิตร Bing | รางวัลคู่ค้าโฆษณาของ Microsoft |
โปรแกรมพันธมิตรของ Bing | Microsoft Advertising Partner Program |
แคมเปญการช็อปปิ้งของ Bing | แคมเปญการช็อปปิ้งของ Microsoft |
Planner คําสําคัญ | Planner คําสําคัญ |
โฆษณาราคาโรงแรม | โฆษณาราคาโรงแรม |
API ของโรงแรม | API ของโรงแรม |