แชร์ผ่าน

Sandbox โฆษณาของ Microsoft

  • บทความ

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

หมายเหตุ

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

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

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

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

  1. เปิดเบราว์เซอร์และนําทางไปยังhttps://sandbox.bingads.microsoft.com?simpsp=true

  2. คลิก ลงทะเบียนสําหรับการโฆษณาของ Microsoft หรือ ลงทะเบียนทันที

  3. เลือก สร้างที่อยู่อีเมลใหม่ เพื่อสร้าง MSA อย่าใช้ที่อยู่อีเมลที่มีอยู่

  4. คลิก ถัดไป

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

    สิ่งสำคัญ

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

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

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

  8. สําหรับ นําเข้า/สร้างแคมเปญ ให้คลิก ข้ามการสร้างการส่งเสริมการขาย

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

เชิญผู้ใช้เพิ่มเติม

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

  1. ใน Sandbox โฆษณาของ Microsoft ให้คลิกชื่อผู้ใช้ของคุณ (มุมบนขวา)

  2. คลิก บัญชีผู้ใช้ & การเรียกเก็บเงิน

  3. คลิก ผู้ใช้

  4. คลิก เชิญผู้ใช้

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

    สิ่งสำคัญ

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

  6. คลิก ส่ง

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

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

  2. คลิกลิงก์ที่ฝังตัว

  3. เลือก สร้างที่อยู่อีเมลใหม่ เพื่อสร้าง MSA อย่าใช้ที่อยู่อีเมลที่มีอยู่

  4. คลิก ถัดไป

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

    สิ่งสำคัญ

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

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

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

หมายเหตุ

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

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

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

สําหรับสภาพแวดล้อม Sandbox ให้แทนที่ https://login.microsoftonline.com/common ด้วยhttps://login.windows-ppe.net/consumers

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

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

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

BBD37VB98

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

4c0b021c-00c3-4508-838f-d3127e8167ff

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

เคล็ดลับ

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

แนวทางปฏิบัติที่ดีที่สุดสําหรับ 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 ดาวน์โหลดรายงานจะไม่ถูกตั้งค่าเมื่อคุณทําการสํารวจผลลัพธ์