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