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