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