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