แนวทางปฏิบัติแนะนำ

วิดีโอ: ดูแนวทางปฏิบัติแนะนำจากเวิร์กช็อปปี 2019

คู่มือนี้ครอบคลุมแนวทางปฏิบัติแนะนำที่คุณนำไปใช้เพิ่มประสิทธิภาพการทำงานของแอปได้

การบำรุงรักษาที่ดำเนินการอยู่

วิธีทำให้แอปทำงานแบบไม่ขาดตอน

  • อัปเดตอีเมลติดต่อของนักพัฒนาซอฟต์แวร์ในศูนย์ API อยู่เสมอ นี่คือชื่อแทนที่เราใช้ติดต่อคุณ หากเราติดต่อคุณเรื่องการปฏิบัติตามข้อกำหนดและเงื่อนไขของ API ไม่ได้ เราอาจเพิกถอนสิทธิ์เข้าถึง API โดยที่คุณไม่ทราบมาก่อน หลีกเลี่ยงการใช้อีเมลส่วนตัว ที่เชื่อมโยงกับบัญชีบุคคลธรรมดาหรือที่ไม่ได้ตรวจสอบ

  • หากต้องการทราบถึงปัญหาต่างๆ เช่น การเปลี่ยนแปลงผลิตภัณฑ์ ช่วงพักการบำรุงรักษา วันที่เลิกใช้งาน และอื่นๆ โปรดสมัครใช้บริการ

ฟอรัมนี้ได้รับการตรวจสอบจากทีม Google Ads API เป็นประจำ จึงเป็นที่ที่เหมาะจะโพสต์คำถามเกี่ยวกับ API

  • ดูแลให้แอปเป็นไปตามข้อกำหนดและเงื่อนไข (ข้อกำหนดและเงื่อนไข) ของ Google Ads API หากจำเป็น ทีมตรวจสอบการปฏิบัติตามข้อกำหนดและโทเค็นจะติดต่อคุณโดยใช้อีเมลติดต่อของคุณ หากมีข้อสงสัยหรือข้อกังวลเกี่ยวกับข้อกำหนดและเงื่อนไข คุณจะติดต่อทีมตรวจสอบได้โดยตอบกลับอีเมลที่ได้รับเมื่อตรวจสอบใบสมัครรับโทเค็นของนักพัฒนา

การเพิ่มประสิทธิภาพ

การทำงานเป็นแบตช์

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

ตัวอย่างเช่น สมมติว่าคุณเพิ่มคีย์เวิร์ด 50,000 คำลงในแคมเปญหนึ่งในกลุ่มโฆษณาหลายกลุ่ม แทนที่จะสร้างคำขอ 50,000 คำขอ โดยแต่ละรายการมีคีย์เวิร์ด 1 คำ ให้ส่งคำขอ 100 รายการ โดยแต่ละรายการมีคีย์เวิร์ด 500 คำ หรือแม้แต่คำขอ 10 รายการ โดยแต่ละรายการมีคีย์เวิร์ด 5,000 คำ มีการจํากัดจำนวนการดำเนินการที่อนุญาตในคำขอ คุณจึงอาจต้องปรับขนาดกลุ่มเพื่อให้ได้ประสิทธิภาพที่ดีที่สุด

ส่งวัตถุแบบกระจัดกระจาย

เมื่อมีการส่งออบเจ็กต์ไปยัง API จะต้องมีการดีซีเรียลไลซ์ ตรวจสอบ และจัดเก็บช่องไว้ในฐานข้อมูล การส่งออบเจ็กต์แบบเต็มเมื่อต้องการอัปเดตเพียง 2-3 ช่องอาจส่งผลให้ใช้เวลาในการประมวลผลนานขึ้นและประสิทธิภาพลดลง เพื่อลดปัญหานี้ Google Ads API รองรับการอัปเดตแบบกระจัดกระจาย ซึ่งช่วยให้คุณเติมข้อมูลเฉพาะช่องในออบเจ็กต์ที่จำเป็นต้องเปลี่ยนแปลงหรือที่จำเป็นได้ การอัปเดตบางส่วนจะเร็วขึ้นและมีโอกาสเกิดข้อผิดพลาดน้อยลง ช่องที่ไม่ได้อยู่ในupdate_mask (หรือที่เรียกว่า FieldMask) จะไม่มีการเปลี่ยนแปลง

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

การจัดการและข้อผิดพลาด

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

แยกแหล่งที่มาของคำขอ

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

สำหรับคำขอที่เริ่มโดยผู้ใช้ ข้อกังวลหลักของคุณควรมอบประสบการณ์ที่ดีให้แก่ผู้ใช้ ใช้ข้อผิดพลาดเฉพาะที่เกิดขึ้นเพื่อให้บริบทแก่ผู้ใช้มากที่สุดใน UI บอกขั้นตอนง่ายๆ ในการแก้ไขข้อผิดพลาด (ดูคำแนะนำด้านล่าง)

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

แยกความแตกต่างของประเภทข้อผิดพลาด

การรู้จักความแตกต่างระหว่างข้อผิดพลาดประเภทต่างๆ ใน Google Ads API เป็นสิ่งสำคัญในการสร้างการจัดการข้อผิดพลาดที่มีประสิทธิภาพ ประเภทข้อผิดพลาดที่พบบ่อยที่สุดบางส่วน ได้แก่

  1. ข้อผิดพลาดในการตรวจสอบสิทธิ์
  2. ข้อผิดพลาดที่ลองใหม่ได้
  3. ข้อผิดพลาดในการตรวจสอบความถูกต้อง
  4. ข้อผิดพลาดเกี่ยวกับการซิงค์

โปรดดูรายละเอียดเพิ่มเติมในประเภทข้อผิดพลาดและข้อผิดพลาดที่พบบ่อย

ซิงค์แบ็กเอนด์

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

บันทึกข้อผิดพลาด

ควรบันทึกข้อผิดพลาดทั้งหมดเพื่ออำนวยความสะดวกในการแก้ไขข้อบกพร่องและการตรวจสอบ ให้บันทึกรหัสคำขอ การดำเนินการที่ทำให้เกิดข้อผิดพลาด และข้อผิดพลาดนั้นๆ เป็นอย่างน้อย ข้อมูลอื่นๆ ที่ควรบันทึก ได้แก่ รหัสลูกค้า, บริการ API, เวลาในการตอบสนองของคำขอไป-กลับ, จำนวนการลองใหม่ รวมถึงคำขอและการตอบกลับดิบ

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

การพัฒนา

ใช้บัญชีทดสอบ

บัญชีทดสอบคือบัญชี Google Ads ที่ไม่ได้แสดงโฆษณาจริง คุณใช้บัญชีทดสอบเพื่อทดลองใช้ Google Ads API และทดสอบว่าการเชื่อมต่อของแอป ตรรกะการจัดการแคมเปญ หรือการประมวลผลอื่นๆ ทำงานได้ตามที่คาดไว้ โทเค็นของนักพัฒนาไม่จำเป็นต้องได้รับการอนุมัติให้ใช้ในบัญชีทดสอบ ดังนั้นคุณสามารถเริ่มต้นพัฒนาด้วย Google Ads API ได้ทันทีหลังจากที่ขอโทเค็นของนักพัฒนา แม้ว่าแอปจะได้รับการตรวจสอบแล้วก็ตาม