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

โปรดคำนึงถึงแนวทางปฏิบัติแนะนำต่อไปนี้เมื่อใช้ Data Manager API

ส่งตัวระบุผู้ใช้ทั้งหมด

ไม่ว่าจะส่งสมาชิกในกลุ่มเป้าหมายหรือเหตุการณ์ด้วย UserData ให้ใส่ user_identifiers ให้มากที่สุดเท่าที่จะเป็นไปได้ ซึ่งรวมถึงการส่งตัวระบุหลายรายการที่เป็นประเภทเดียวกัน

เช่น หากคุณมีอีเมลหลายรายการสำหรับผู้ใช้ ให้ใส่ UserIdentifier แยกกันสำหรับอีเมลแต่ละรายการ ในทำนองเดียวกัน หากคุณมีตัวระบุประเภทต่างๆ สำหรับผู้ใช้ เช่น อีเมล หมายเลขโทรศัพท์ และที่อยู่ ให้เพิ่ม UserIdentifier แยกต่างหากสำหรับตัวระบุแต่ละรายการ โดยไม่เกินจำนวนตัวระบุสูงสุด

คำขอเพิ่มประสิทธิภาพ

เพื่อลดโอกาสที่จะเกินขีดจำกัดคำขอรายวัน ให้รวมกลุ่มรายการให้มากที่สุดเท่าที่จะเป็นไปได้ในแต่ละคำขอ โดยไม่เกินขีดจำกัดต่อคำขอ

เช่น หากต้องการเพิ่มสมาชิกในกลุ่มเป้าหมาย 10,000 คนลงในกลุ่มเป้าหมาย ให้เพิ่มสมาชิกทั้ง 10,000 คนในรายการ audience_members ใน IngestAudienceMembersRequest รายการเดียว การรวมสมาชิกทั้ง 10,000 รายไว้ในคำขอเดียวจะมีประสิทธิภาพมากกว่าการส่งคำขอแยกต่างหากเพื่อเพิ่มสมาชิกในกลุ่มเป้าหมายแต่ละราย

ส่งคำขอหลายรายการพร้อมกัน

หากต้องการลดเวลาโดยรวมที่ต้องใช้ในการนำเข้าข้อมูล ให้ส่งคำขอหลายรายการพร้อมกันไปยัง IngestionService เราขอแนะนำให้ส่งคำขอพร้อมกันไม่เกิน 10 รายการเพื่อลดโอกาสที่จะเกินขีดจำกัดคำขอต่อนาที

คุณส่งคำขอหลายรายการพร้อมกันได้แม้ว่าคำขอจะมี destinations เดียวกันก็ตาม

ใช้ validateOnly เพื่อตรวจสอบข้อผิดพลาดที่ทำให้การตรวจสอบล้มเหลวอย่างรวดเร็ว

ส่งคำขอโดยตั้งค่า validateOnly เป็น true เพื่อตรวจจับข้อผิดพลาดที่ทำให้ไม่สามารถดำเนินการต่อได้ Data Manager API จะเรียกใช้การตรวจสอบความถูกต้องแบบเดียวกับคำขอปกติ แต่จะไม่นำเข้าหรือนำข้อมูลออก

คำขอแบบตรวจสอบความถูกต้องเท่านั้นที่สำเร็จไม่ได้รับประกันว่าจะไม่มีข้อผิดพลาดระหว่างการประมวลผล ดังนั้นโปรดตรวจสอบการวินิจฉัยต่อไปหลังจากส่งคำขอปกติ

ดูการวินิจฉัย

สำคัญ: ตรวจสอบการวินิจฉัยสำหรับคำขอส่งผ่านข้อมูลแต่ละรายการเพื่อระบุข้อผิดพลาดและคำเตือนจากการประมวลผลกลุ่มเป้าหมายหรือเหตุการณ์

บันทึกและรวบรวม request_id จากแต่ละ IngestAudienceMembersResponse หรือ IngestEventsResponse และใช้รหัสคำขอเพื่อตรวจสอบการวินิจฉัย

ตรวจสอบและแจ้งเตือนเกี่ยวกับโควต้า

หากต้องการหลีกเลี่ยงการปฏิเสธคำขอที่ไม่คาดคิด ให้ตั้งค่าการแจ้งเตือนและการตรวจสอบโควต้าในคอนโซล Google Cloud การตรวจสอบการใช้โควต้าช่วยให้คุณติดตามรูปแบบการใช้งานและเพิ่มประสิทธิภาพการจัดกลุ่มคำขอก่อนที่แอปพลิเคชันจะถึงขีดจำกัดรายวันหรือต่อนาที

ทำให้ใช้งานได้จริง

เมื่อเปลี่ยนจากการทดสอบในเครื่องไปเป็นภาระงานในเวอร์ชันที่ใช้งานจริง ให้ใช้ข้อมูลรับรองเริ่มต้นของแอปพลิเคชันกับบัญชีบริการที่แนบมาหรือ Workload Identity Federation เพื่อตรวจสอบสิทธิ์แบบไม่โต้ตอบและปลอดภัย

ดูรายละเอียดเกี่ยวกับการกำหนดค่าการตรวจสอบสิทธิ์สำหรับสภาพแวดล้อมฮาร์ดแวร์และซอฟต์แวร์ต่างๆ ได้ที่ทำให้ใช้งานได้จริง