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