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

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

ดูแลรักษาแอป

โปรดทำดังนี้เพื่อให้แอปทำงานได้อย่างต่อเนื่อง

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