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