วิดีโอ: ดูการบรรยายเรื่องแนวทางปฏิบัติแนะนำจากเวิร์กช็อปปี 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 เป็นสิ่งสำคัญในการสร้างการจัดการข้อผิดพลาดที่มีประสิทธิภาพ ประเภทข้อผิดพลาดที่พบบ่อยที่สุดบางส่วน ได้แก่
- ข้อผิดพลาดในการตรวจสอบสิทธิ์
- ข้อผิดพลาดที่ลองใหม่ได้
- ข้อผิดพลาดในการตรวจสอบความถูกต้อง
- ข้อผิดพลาดเกี่ยวกับการซิงค์
โปรดดูรายละเอียดเพิ่มเติมในประเภทข้อผิดพลาดและข้อผิดพลาดที่พบบ่อย
การซิงค์แบ็กเอนด์
หากผู้ใช้แอปมีสิทธิ์เข้าถึงบัญชี Google Ads ด้วยตนเอง ผู้ใช้อาจทำการเปลี่ยนแปลงที่แอปไม่ทราบ ซึ่งทําให้ฐานข้อมูลในเครื่องของแอปไม่ซิงค์ ตามที่ระบุไว้ในคู่มือประเภทข้อผิดพลาด คุณสามารถแก้ไขข้อผิดพลาดเกี่ยวกับการซิงค์ในเชิงรุกได้เมื่อเกิดข้อผิดพลาดขึ้น แต่ก็สามารถพยายามป้องกันเชิงรุกได้เช่นกัน กลยุทธ์เชิงรุกอย่างหนึ่งคือการเรียกใช้การซิงค์ทุกคืนในบัญชีทั้งหมด ดึงข้อมูลออบเจ็กต์ Google Ads ในบัญชี และเปรียบเทียบกับฐานข้อมูลในเครื่อง
บันทึกข้อผิดพลาด
ข้อผิดพลาดทั้งหมดควรได้รับการบันทึกเพื่อให้แก้ไขข้อบกพร่องและตรวจสอบได้ง่ายขึ้น อย่างน้อยที่สุด ให้บันทึกรหัสคำขอ การดำเนินการที่ทำให้เกิดข้อผิดพลาด และตัวข้อผิดพลาดเอง ข้อมูลอื่นๆ ที่ควรบันทึก ได้แก่ รหัสลูกค้า, บริการ API, เวลาในการตอบสนองของคำขอไป-กลับ, จำนวนการลองใหม่ ตลอดจนคำขอและการตอบกลับข้อมูลดิบ
ติดตามเทรนด์
อย่าลืมตรวจสอบแนวโน้มในข้อผิดพลาด API เพื่อให้ตรวจจับและแก้ไขปัญหาเกี่ยวกับแอปของคุณได้ ลองสร้างโซลูชันของคุณเองหรือใช้เครื่องมือเชิงพาณิชย์อย่างใดอย่างหนึ่งที่มีให้บริการซึ่งสามารถใช้บันทึกของคุณเพื่อสร้างแดชบอร์ดแบบอินเทอร์แอกทีฟและส่งการแจ้งเตือนอัตโนมัติ
การพัฒนา
ใช้บัญชีทดสอบ
บัญชีทดสอบคือบัญชี Google Ads ที่ไม่แสดงโฆษณาจริง คุณสามารถใช้บัญชีทดสอบเพื่อทดสอบกับ Google Ads API และทดสอบว่าการเชื่อมต่อของแอป ตรรกะการจัดการแคมเปญ หรือการประมวลผลอื่นๆ ทำงานตามที่คาดไว้หรือไม่ โทเค็นของนักพัฒนาไม่จำเป็นต้องได้รับการอนุมัติให้ใช้ในบัญชีทดสอบ คุณจึงเริ่มพัฒนาด้วย Google Ads API ได้ทันทีหลังจากที่ขอโทเค็นของนักพัฒนาซอฟต์แวร์ แม้ว่าแอปจะได้รับการตรวจสอบแล้วก็ตาม