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

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

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

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

วิธีตรวจสอบว่าแอปทำงานอย่างต่อเนื่อง

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

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

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

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

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

คุณสามารถเพิ่มประสิทธิภาพแอปได้โดยเรียกใช้การดำเนินการแบบเป็นกลุ่มและส่งออบเจ็กต์แบบเบาบาง (หากเหมาะสม)

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

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

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

ส่งออบเจ็กต์แบบเบาบาง

เมื่อส่งออบเจ็กต์ไปยัง API จะต้องแปลงค่าออบเจ็กต์กลับเป็นรูปแบบเดิม ตรวจสอบ และจัดเก็บในฐานข้อมูล การส่งออบเจ็กต์แบบเต็มเมื่อคุณต้องการอัปเดตเพียงไม่กี่ช่องอาจส่งผลให้มีเวลาในการประมวลผลเพิ่มขึ้นและประสิทธิภาพลดลง 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 ได้ทันทีหลังจากขอโทเค็นของนักพัฒนาแอป ก่อนที่แอปจะได้รับการตรวจสอบ