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

วิดีโอ: ดูการบรรยายเรื่องแนวทางปฏิบัติแนะนำจากเวิร์กช็อปปี 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 ได้ทันทีหลังจากที่ขอโทเค็นของนักพัฒนาซอฟต์แวร์ แม้ว่าแอปจะได้รับการตรวจสอบแล้วก็ตาม