Sandbox โฆษณาของ Microsoft

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

หมายเหตุ

Sandbox อาจหยุดทํางานเพื่อการบํารุงรักษา โดยมีหรือไม่มีการแจ้งเตือนล่วงหน้า

ลงทะเบียนลูกค้าเริ่มต้น

สภาพแวดล้อม Sandbox และการผลิตใช้ข้อมูลประจําตัวที่แยกต่างหาก

ทําตามขั้นตอนเหล่านี้เพื่อรับลูกค้า Sandbox ใหม่ ถ้าคุณมีลูกค้า Sandbox อยู่แล้ว และต้องการเพิ่มผู้ใช้ใหม่ เช่น ด้วยข้อมูลประจําตัวของบัญชี Microsoft คุณสามารถข้ามไปยังขั้นตอน การเชิญผู้ใช้ ได้

  1. เปิดเบราว์เซอร์และนําทางไปยังหน้าลงทะเบียน Sandbox

  2. เลือกลงทะเบียนทันที

  3. เลือก สร้างบัญชี เพื่อสร้างบัญชี Microsoft (MSA)

  4. เลือกรับที่อยู่อีเมลใหม่

  5. ใส่ที่อยู่อีเมล MSA เซิร์ฟเวอร์อีเมลต้อง outlook.com (ตัวอย่างเช่น someone@outlook.com)

    สิ่งสำคัญ

    Sandbox สนับสนุน MSAs ที่สร้างขึ้นโดยใช้บัญชีผู้ใช้อีเมล outlook.com เท่านั้น นอกจากนี้ คุณไม่สามารถใช้บัญชีผู้ใช้อีเมลจากบริการอีเมลอื่นได้ (ตัวอย่างเช่น @contoso.com) แม้ว่าบัญชีจะเชื่อมโยงกับบัญชีผู้ใช้อีเมล outlook.com ก็ตาม

  6. เสร็จสิ้นโฟลว์งาน MSA โดยระบุส่วนที่เหลือของผู้ใช้และข้อมูลความปลอดภัยของคุณ จากนั้นคุณจะถูกนําไปยัง Microsoft Advertising เพื่อดําเนินการลงทะเบียนลูกค้าและบัญชี Sandbox ต่อ

  7. กรอกแบบฟอร์มสร้างบัญชี

  8. สําหรับ Go Live เลือกข้ามข้อมูลการชําระเงิน

ตัวเลือก: เชิญผู้ใช้เพิ่มเติม

เมื่อต้องการ รับรองความถูกต้องด้วย OAuth ใน Sandbox คุณต้องมีบัญชี Microsoft (MSA) ที่สร้างขึ้นด้วยบัญชีอีเมล outlook.com ถ้าลูกค้า Sandbox ของคุณยังไม่มีข้อมูลประจําตัวผู้ใช้ผ่านบัญชี Microsoft หรือลูกค้า Sandbox ของคุณถูกสร้างขึ้นด้วยบัญชีอีเมล outlook-int.com คุณจําเป็นต้องเชิญผู้ใช้ให้ทํางานบนบัญชี Sandbox ของคุณผ่านขั้นตอนต่อไปนี้

  1. ใน Sandbox โฆษณาของ Microsoft ให้เลือก การตั้งค่า

  2. เลือกการจัดการผู้ใช้

  3. เลือกเชิญผู้ใช้

  4. ใส่ที่อยู่อีเมลของผู้ใช้ที่จะเชิญ เซิร์ฟเวอร์อีเมลต้อง outlook.com (ตัวอย่างเช่น someone@outlook.com)

    สิ่งสำคัญ

    คุณสามารถส่งคําเชิญไปยังบัญชีอีเมล outlook.com เท่านั้น คุณไม่สามารถส่งการเชิญไปยังโดเมนอื่นแม้ว่าบัญชีจะเชื่อมโยงกับบัญชีอีเมล outlook.com ก็ตาม ถ้าคุณพยายามส่งคําเชิญไปยังโดเมนอื่น (ตัวอย่างเช่น someone@contoso.com), BingAds UI จะแสดงคําเชิญว่ารอดําเนินการอย่างไม่มีกําหนด (ไม่มีการส่งคําเชิญ)

  5. เลือกส่ง

Microsoft Advertising ส่งอีเมลเชิญให้ผู้ใช้ ถ้าคําเชิญไม่แสดงขึ้นในกล่องขาเข้า ให้ตรวจสอบโฟลเดอร์ อีเมลขยะ อาจใช้เวลาสองถึงสามนาทีในการรับคําเชิญ ขั้นตอนต่อไปนี้แสดงวิธีการยอมรับคําเชิญ

  1. เปิดอีเมลจาก Microsoft Advertising ด้วยบรรทัดชื่อเรื่อง คําเชิญให้โฆษณาของ Microsoft

  2. คัดลอกลิงก์แบบฝังตัวและเปิดในหน้าต่างโหมด InPrivate หรือเบราว์เซอร์อื่น

  3. เลือก สร้างบัญชี เพื่อสร้างบัญชี Microsoft (MSA)

  4. เลือกรับที่อยู่อีเมลใหม่

  5. ใส่ที่อยู่อีเมล MSA เซิร์ฟเวอร์อีเมลต้อง outlook.com (ตัวอย่างเช่น someone@outlook.com)

    สิ่งสำคัญ

    Sandbox สนับสนุน MSAs ที่สร้างขึ้นโดยใช้บัญชีผู้ใช้อีเมล outlook.com เท่านั้น นอกจากนี้ คุณไม่สามารถใช้บัญชีผู้ใช้อีเมลจากบริการอีเมลอื่นได้ (ตัวอย่างเช่น @contoso.com) แม้ว่าบัญชีจะเชื่อมโยงกับบัญชีผู้ใช้อีเมล outlook.com ก็ตาม

  6. เสร็จสิ้นโฟลว์งานโดยระบุส่วนที่เหลือของข้อมูลผู้ใช้ของคุณ

  7. ออกจาก Microsoft Advertising หลังจากเสร็จสิ้นกระบวนการ MSA

หมายเหตุ

กระบวนการลงทะเบียน MSA จะส่งกลับคุณไปยังส่วนติดต่อผู้ใช้ SI Microsoft Advertising (ads-int.microsoft.com) หลังจากเสร็จสิ้นกระบวนการ MSA ให้ลงชื่อออกจากอินเทอร์เฟซ SI จากนั้นลงชื่อเข้าใช้โดยใช้ที่อยู่อีเมล outlook.com ใหม่ของคุณที่https://sandbox.bingads.microsoft.com/

สภาพแวดล้อม Sandbox — การสนับสนุน Google OAuth

Sandbox โฆษณาของ Microsoft และสภาพแวดล้อมการผลิตใช้ข้อมูลประจําตัวแยกต่างหาก นอกเหนือจากบัญชี Microsoft คุณสามารถสร้างลูกค้า Sandbox และรับรองความถูกต้องผู้ใช้โดยใช้ Google OAuth 2.0 ได้แล้ว

ซึ่งช่วยให้นักพัฒนาและผู้ลงโฆษณาสามารถทดสอบ API โฆษณาของ Microsoft ใน Sandbox โดยใช้ข้อมูลประจําตัวของ Google โดยไม่ต้องใช้ outlook.com บัญชี Microsoft

Sign-Up ลูกค้าเริ่มต้น (Sandbox) — Google OAuth

คุณสามารถสร้างลูกค้า Sandbox ใหม่โดยใช้บัญชี Google ได้

ขั้นตอนในการสร้างลูกค้า Sandbox ใหม่ด้วย Google OAuth

  1. เปิดเบราว์เซอร์และนําทางไปยังหน้าลงทะเบียน Sandbox

  2. เลือกลงทะเบียนทันที

  3. เลือก ลงทะเบียนด้วย Google

  4. ดําเนินการขั้นตอนการรับรองความถูกต้อง Google OAuth ให้เสร็จสมบูรณ์:

    • ลงชื่อเข้าใช้ด้วยบัญชี Google
    • ตรวจทานและให้ความยินยอมเพื่ออนุญาตให้ Microsoft Advertising เข้าถึงบัญชีของคุณ
    • อนุมัติขอบเขตที่ร้องขอ (email, profile) ถ้าได้รับพร้อมท์

  5. หลังจากการรับรองความถูกต้องสําเร็จแล้ว คุณจะถูกเปลี่ยนเส้นทางกลับไปยัง Microsoft Advertising เพื่อดําเนินการสร้างลูกค้าแบบ Sandbox ต่อไป

  6. กรอกแบบฟอร์มสร้างบัญชี

    • สําหรับ Go Live เลือกข้ามข้อมูลการชําระเงิน

การยอมรับคําเชิญด้วย Google OAuth

ผู้ใช้ที่ได้รับเชิญสามารถยอมรับคําเชิญ Sandbox โดยใช้ Google OAuth ดังนี้:

  1. เปิดลิงก์คําเชิญ
  2. เลือกลงชื่อเข้าใช้ด้วย Google
  3. ดําเนินการขั้นตอนการรับรองความถูกต้อง Google OAuth ให้เสร็จสมบูรณ์
  4. หลังจากลงชื่อเข้าใช้สําเร็จ ผู้ใช้จะถูกเพิ่มไปยังบัญชี Sandbox

การสนับสนุน Sandbox ที่ได้รับการปรับปรุงนี้ช่วยให้ทีมสามารถทดสอบ API โฆษณาของ Microsoft กับผู้ใช้ที่รับรองความถูกต้องโดย Google ในขณะที่ยังคงรักษาลักษณะการทํางานของ API เดียวกันกับการผลิต

รับการเข้าถึง API

สภาพแวดล้อม Sandbox และการผลิตใช้ข้อมูลประจําตัวที่แยกต่างหาก

ตารางนี้รวมถึงจุดสิ้นสุด Sandbox เพิ่มเติม

คำอธิบาย ผลิต Sandbox
จุดสิ้นสุดสําหรับคําขอ OAuth login.microsoftonline.com login.microsoftonline.com
โดเมนสําหรับอีเมลที่ใช้เมื่อรับบัญชี Microsoft ที่อยู่อีเมลใดๆ outlook.com
จุดสิ้นสุดเพื่อเปลี่ยนรหัสผ่านบัญชี Microsoft account.live.com/password/change account.live.com/password/change

แม้ว่าในการผลิตคุณต้องใช้โทเค็นนักพัฒนาของคุณเอง แต่ลูกค้า Microsoft Advertising ทั้งหมดสามารถใช้โทเค็นนักพัฒนาสากลต่อไปนี้ใน Sandbox ได้

BBD37VB98

คุณต้องใช้ ID แอปพลิเคชันของคุณเองทั้งในการผลิตและ Sandbox (เช่น ID ไคลเอ็นต์)

ในตอนนี้คุณสามารถรับโทเค็นการเข้าถึงและรีเฟรชสําหรับผู้ใช้ Microsoft Advertising และเรียกใช้บริการแรกของคุณโดยใช้ Bing Ads API ดูคู่มือเริ่มต้นใช้งานด่วน

เคล็ดลับ

สําหรับรายละเอียดเกี่ยวกับวิธีการรับโทเค็นการเข้าถึงและรีเฟรชโดยใช้ SDK โฆษณา Bing โปรดดูการรับรองความถูกต้องด้วย SDK

รับการเข้าถึง API สําหรับ Google oAuth

สร้างบัญชี Google ที่https://accounts.google.com

แนวทางปฏิบัติที่ดีที่สุดสําหรับ Sandbox

ไม่ควรใช้ Sandbox ในความจุเดียวกันกับการผลิต

  • ตรวจสอบให้แน่ใจว่า เมื่อคุณปรับใช้แอปพลิเคชันของคุณไปยังสภาพแวดล้อมการผลิต คุณใช้ WSDLs การผลิตและข้อมูลประจําตัวการผลิตของคุณ
  • Sandbox มีรุ่นการเผยแพร่การผลิตปัจจุบัน และจะได้รับการอัปเดตด้วยตัวอย่างฟีเจอร์โดยมีหรือไม่มีการแจ้งเตือนล่วงหน้า
  • ความจุของ Sandbox น้อยกว่ากําลังการผลิตและคุณไม่ควรใช้เพื่อดําเนินการความเครียดหรือการทดสอบความจุ
  • โปรดอย่าใช้เธรดมากกว่าหนึ่งเธรด

Ad Insight Service

Sandbox สนับสนุนชุดคําหลักที่จํากัดสําหรับการทดสอบการดําเนินการบริการ Ad Insight คุณไม่ควรใช้ข้อมูลทดสอบเพื่ออนุมานหรือคาดหวังการประมาณที่คล้ายกันสําหรับคําสําคัญของคุณในการผลิต ข้อจํากัดบางอย่างจะอธิบายไว้ในตารางต่อไปนี้

เคล็ดลับ

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

การดําเนินการบริการ ข้อจํากัดของ Sandbox
GetBidLandscapeByKeywordIds ไม่สนับสนุน คุณสามารถเรียกใช้การดําเนินการด้วยตัวระบุคําสําคัญที่มีอยู่ แต่ไม่มีข้อมูลถูกส่งกลับ
GetEstimatedBidByKeywordIds ชุดคําสําคัญที่ จํากัด ได้รับการสนับสนุน: อากาศ, อัตโนมัติ, ข้อเสนอที่ดีที่สุด, การจอง, ข้อมูลรถยนต์, การดูแล, การจัดการของวัน, ส่วนลด, ความบันเทิง, การเงิน, เกม, รีวิวโรงแรม, เปรียบเทียบการประกันภัย, กีฬา, โรงแรม
GetEstimatedBidByKeywords ชุดคําสําคัญที่ จํากัด ได้รับการสนับสนุน: อากาศ, อัตโนมัติ, ข้อเสนอที่ดีที่สุด, การจอง, ข้อมูลรถยนต์, การดูแล, การจัดการของวัน, ส่วนลด, ความบันเทิง, การเงิน, เกม, รีวิวโรงแรม, เปรียบเทียบการประกันภัย, กีฬา, โรงแรม
GetEstimatedPositionByKeywordIds ชุดคําสําคัญที่ จํากัด ได้รับการสนับสนุน: อากาศ, อัตโนมัติ, ข้อเสนอที่ดีที่สุด, การจอง, ข้อมูลรถยนต์, การดูแล, การจัดการของวัน, ส่วนลด, ความบันเทิง, การเงิน, เกม, รีวิวโรงแรม, เปรียบเทียบการประกันภัย, กีฬา, โรงแรม

เพื่อเพิ่มโอกาสในการรับการประมาณ องค์ประกอบ MaxBid ควรมากกว่าหรือเท่ากับ 5 ดอลลาร์สหรัฐ หรือเทียบเท่าในสกุลเงินอื่น ๆ
GetEstimatedPositionByKeywords ชุดคําสําคัญที่ จํากัด ได้รับการสนับสนุน: อากาศ, อัตโนมัติ, ข้อเสนอที่ดีที่สุด, การจอง, ข้อมูลรถยนต์, การดูแล, การจัดการของวัน, ส่วนลด, ความบันเทิง, การเงิน, เกม, รีวิวโรงแรม, เปรียบเทียบการประกันภัย, กีฬา, โรงแรม

เพื่อเพิ่มโอกาสในการรับการประมาณ องค์ประกอบ MaxBid ควรมากกว่าหรือเท่ากับ 5 ดอลลาร์สหรัฐ หรือเทียบเท่าในสกุลเงินอื่น ๆ
GetHistoricalKeywordPerformance ชุดคําสําคัญที่ จํากัด ได้รับการสนับสนุน: อากาศ, อัตโนมัติ, ข้อเสนอที่ดีที่สุด, การจอง, ข้อมูลรถยนต์, การดูแล, การจัดการของวัน, ส่วนลด, ความบันเทิง, การเงิน, เกม, รีวิวโรงแรม, เปรียบเทียบการประกันภัย, กีฬา, โรงแรม

องค์ประกอบ MatchType และ AdPosition ต้องได้รับการตั้งค่าเป็นการรวม

องค์ประกอบ ของอุปกรณ์ ต้องได้รับการตั้งค่าเป็น คอมพิวเตอร์ หรือ ซ้าย nil
GetHistoricalSearchCount ชุดคําสําคัญที่ จํากัด ได้รับการสนับสนุน: อากาศ, อัตโนมัติ, ข้อเสนอที่ดีที่สุด, การจอง, ข้อมูลรถยนต์, การดูแล, การจัดการของวัน, ส่วนลด, ความบันเทิง, การเงิน, เกม, รีวิวโรงแรม, เปรียบเทียบการประกันภัย, กีฬา, โรงแรม

องค์ประกอบ EndMonthAndYear ต้องถูกตั้งค่าเป็นเดือนก่อนหน้า ตัวอย่างเช่น ถ้าวันที่ของวันนี้คือ 1 เมษายน 2020 เดือนสิ้นสุดควรเป็นเดือนมีนาคม 2020

องค์ประกอบ ของอุปกรณ์ ต้องได้รับการตั้งค่าเป็น คอมพิวเตอร์ หรือ ซ้าย nil
GetKeywordCategories ไม่ควรมีความแตกต่างใน Sandbox เทียบกับการผลิต
GetKeywordDemographics ชุดคําสําคัญที่ จํากัด ได้รับการสนับสนุน: อากาศ, อัตโนมัติ, ข้อเสนอที่ดีที่สุด, การจอง, ข้อมูลรถยนต์, การดูแล, การจัดการของวัน, ส่วนลด, ความบันเทิง, การเงิน, เกม, รีวิวโรงแรม, เปรียบเทียบการประกันภัย, กีฬา, โรงแรม

องค์ประกอบ ของอุปกรณ์ ต้องได้รับการตั้งค่าเป็น คอมพิวเตอร์ หรือ ซ้าย nil
GetKeywordIdeas ข้อมูลทดสอบ Sandbox จะถูกรีเฟรชทุก 3 เดือน ดังนั้นคุณจะต้องตั้งค่าช่วงวันที่ก่อนหน้า
GetKeywordLocations ชุดคําสําคัญที่ จํากัด ได้รับการสนับสนุน: อากาศ, อัตโนมัติ, ข้อเสนอที่ดีที่สุด, การจอง, ข้อมูลรถยนต์, การดูแล, การจัดการของวัน, ส่วนลด, ความบันเทิง, การเงิน, เกม, รีวิวโรงแรม, เปรียบเทียบการประกันภัย, กีฬา, โรงแรม

องค์ประกอบ ของอุปกรณ์ ต้องได้รับการตั้งค่าเป็น คอมพิวเตอร์ หรือ ซ้าย nil
SuggestKeywordsForUrl ไม่ควรมีความแตกต่างใน Sandbox เทียบกับการผลิต
SuggestKeywordsFromExistingKeywords ถ้า SuggestionType ถูกตั้งค่าเป็น 1 ไม่ควรมีความแตกต่างในลักษณะการทํางานเมื่อเทียบกับการผลิต

สําหรับค่าประเภทคําแนะนํา 2, 3 และ 4 ชุดคําสําคัญที่ จํากัด ได้รับการสนับสนุน: อากาศ, อัตโนมัติ, ข้อเสนอที่ดีที่สุด, การจอง, ข้อมูลรถ, การดูแล, การจัดการของวัน, ส่วนลด, ความบันเทิง, การเงิน, เกม, รีวิวโรงแรม, การเปรียบเทียบการประกันภัย, กีฬา, โรงแรม

บริการจํานวนมาก

ขีดจํากัดขนาดไฟล์สําหรับการอัปโหลดในการผลิตคือ 100MB หรือ 2.5 ล้านแถว สําหรับ Sandbox ขีดจํากัดคือ 20K แถว สําหรับข้อมูลเพิ่มเติม ดู ดาวน์โหลดและอัปโหลดเป็นกลุ่ม

บริการจัดการแคมเปญ

การสนับสนุนด้านบรรณาธิการ

Sandbox สนับสนุนบทวิจารณ์บรรณาธิการที่จํากัดและคําอุทธรณ์ คุณไม่สามารถรับเหตุผลสําหรับปัญหาด้านบรรณาธิการใน Sandbox ได้เช่นเดียวกับที่คุณสามารถทําได้ในการผลิต ตัวอย่างเช่น ผ่านการดําเนินการบริการ GetEditorialReasonsByIds

โฆษณาผลิตภัณฑ์

โฆษณาผลิตภัณฑ์ได้รับการสนับสนุนใน Sandbox ในสหรัฐอเมริกา เพื่อให้ได้รับการอนุมัติโดยอัตโนมัติ คุณต้องสร้างแค็ตตาล็อกและร้านค้า Microsoft Merchant Center ที่ลงท้ายด้วย "Sandbox" ดังนี้

  1. ในเว็บแอปพลิเคชัน Microsoft Advertising เลือกบนเครื่องมือ
  2. ภายใต้เครื่องมือการจัดการ เลือกบน Microsoft Merchant Center
  3. เลือก สร้างร้านค้า และใส่ชื่อร้านค้าที่ลงท้ายด้วย "Sandbox" (ไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก)
  4. เพิ่มข้อมูลร้านค้า เลือกโฆษณาสินค้าใต้การตั้งค่าแค็ตตาล็อก แล้วเลือกเสร็จสิ้น
  5. ในร้านค้าใหม่ของคุณ เลือกการจัดการแค็ตตาล็อก จากนั้นเลือกสร้างแค็ตตาล็อก
  6. เพิ่มชื่อแค็ตตาล็อกของคุณ เลือกอัปโหลดไฟล์ด้วยตนเองในภายหลังภายใต้ไฟล์ตัวดึงข้อมูลแค็ตตาล็อก และเลือกบันทึก

บริการเรียกเก็บเงินของลูกค้า

วิธีการชําระเงินไม่ได้รับการสนับสนุนใน Sandbox

บริการการรายงาน

เมื่อคุณสร้างคําสําคัญ ข้อมูลประสิทธิภาพการทดสอบควรถูกสร้างขึ้นภายในไม่กี่ชั่วโมง ข้อมูลมีไว้เพื่อทดสอบการสร้าง การเรียก และการแยกวิเคราะห์รายงานใน Sandbox คุณไม่ควรใช้ข้อมูลทดสอบเพื่ออนุมานหรือคาดหวังประสิทธิภาพที่คล้ายคลึงกันสําหรับคําหลักของคุณในการผลิต

ข้อมูลทดสอบจะถูกสร้างขึ้นสําหรับวันเดียวกันเมื่อมีการเพิ่มหรืออัปเดตเอนทิตี ตัวอย่างเช่น หากคุณเพิ่มคําหลักในวันนี้และดาวน์โหลดรายงานประสิทธิภาพของคําหลักสําหรับสัปดาห์ที่แล้ว จะไม่มีข้อมูลใด ๆ คุณจะต้องดึงรายงานที่มีวันนี้ในช่วงเวลารายงาน

รายงานต่อไปนี้สามารถส่งกลับข้อมูลประสิทธิภาพการทํางานใน Sandbox ได้ สามารถส่งรายงานประเภทอื่น ๆ ทั้งหมดได้สําเร็จ แม้ว่าบริการ Sandbox จะไม่ส่งกลับข้อมูลตัวอย่างใดๆ เช่น URL ดาวน์โหลดรายงานจะไม่ถูกตั้งค่าเมื่อคุณทําการสํารวจผลลัพธ์

  • Last updated on