แก้ไข

แชร์ผ่าน


คําถามที่ถามบ่อย

บทความนี้ประกอบด้วยคําตอบของคําถามที่ถามบ่อยบางส่วนเกี่ยวกับ 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 ของโรงแรม