กล่องทราย Microsoft Advertising

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

หมายเหตุ

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

การลงทะเบียนลูกค้าครั้งแรก

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

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

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

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

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

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

  5. ใส่ที่อยู่อีเมล MSA The email server must be outlook.com (for example, ). someone@outlook.com

    สิ่งสำคัญ

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

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

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

  8. สําหรับเริ่มถ่ายทอดสด ให้เลือกข้ามข้อมูลการชําระเงิน

ทําหรือไม่ก็ได้: เชิญผู้ใช้เพิ่มเติม

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

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

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

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

  4. ใส่ที่อยู่อีเมลของผู้ใช้ที่จะเชิญ The email server must be outlook.com (for example, ). someone@outlook.com

    สิ่งสำคัญ

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

  5. เลือกส่ง

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

  1. เปิดอีเมลจาก Microsoft Advertising พร้อมบรรทัดหัวข้อ คําเชิญไปยัง Microsoft Advertising

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

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

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

  5. ใส่ที่อยู่อีเมล MSA The email server must be outlook.com (for example, ). someone@outlook.com

    สิ่งสำคัญ

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

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

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

หมายเหตุ

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

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

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

ซึ่งทําให้นักพัฒนาและผู้ลงโฆษณาสามารถทดสอบ Microsoft Advertising API ใน 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. กรอกข้อมูลในฟอร์ม สร้างบัญชี ให้สมบูรณ์

    • สําหรับเริ่มถ่ายทอดสด ให้เลือกข้ามข้อมูลการชําระเงิน

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

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

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

การสนับสนุน Sandbox ที่ได้รับการปรับปรุงนี้ช่วยให้ทีมสามารถทดสอบ Microsoft Advertising API กับผู้ใช้ที่ได้รับการรับรองความถูกต้องจาก 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 Ads โปรดดูการรับรองความถูกต้องด้วย SDK

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

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

แนวทางปฏิบัติของ Sandbox

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

  • Make sure that when you deploy your application to the production environment, you use the production WSDLs and your production credentials.
  • Sandbox มีรุ่นการผลิตปัจจุบัน และจะได้รับการอัปเดตด้วยการแสดงตัวอย่างฟีเจอร์โดยมีหรือไม่มีการแจ้งเตือนล่วงหน้า
  • ความจุของ Sandbox น้อยกว่าการผลิต และคุณไม่ควรใช้เพื่อทําการทดสอบความเครียดหรือความจุ
  • โปรดอย่าใช้เธรดมากกว่าหนึ่งเธรด

บริการ Ad Insight

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

เคล็ดลับ

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

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

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

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

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

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

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

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

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

องค์ประกอบ อุปกรณ์ ต้อง ตั้งค่าเป็นคอมพิวเตอร์ หรือปล่อยให้เป็นศูนย์
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