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