Hãy lưu ý các phương pháp hay nhất sau đây khi sử dụng Data Manager API.
Gửi tất cả giá trị nhận dạng người dùng
Cho dù bạn gửi thành viên trong phân khúc đối tượng hay sự kiện bằng UserData, hãy thêm càng nhiều user_identifiers càng tốt, bao gồm cả việc gửi nhiều giá trị nhận dạng cùng loại.
Ví dụ: nếu bạn có nhiều địa chỉ email cho một người dùng, hãy thêm một thẻ UserIdentifier riêng biệt cho mỗi địa chỉ email. Tương tự, nếu bạn có giá trị nhận dạng thuộc nhiều loại cho một người dùng, chẳng hạn như địa chỉ email, số điện thoại và địa chỉ, hãy thêm một UserIdentifier riêng biệt cho mỗi giá trị nhận dạng, tối đa là số lượng giá trị nhận dạng tối đa.
Tối ưu hoá yêu cầu
Để giảm khả năng vượt quá hạn mức yêu cầu hằng ngày, hãy gộp nhiều mục nhất có thể vào mỗi yêu cầu, tối đa là hạn mức cho mỗi yêu cầu.
Ví dụ: nếu bạn muốn thêm 10.000 thành viên trong phân khúc đối tượng vào một đối tượng, hãy thêm tất cả 10.000 thành viên vào danh sách audience_members trong một IngestAudienceMembersRequest. Việc gộp tất cả 10.000 thành viên vào một yêu cầu duy nhất sẽ hiệu quả hơn so với việc gửi yêu cầu riêng để thêm từng thành viên trong phân khúc đối tượng.
Gửi yêu cầu đồng thời
Để giảm tổng thời gian cần thiết để nhập dữ liệu, hãy gửi các yêu cầu đồng thời đến IngestionService. Bạn nên gửi tối đa 10 yêu cầu cùng lúc để giảm khả năng vượt quá giới hạn số yêu cầu mỗi phút.
Bạn có thể gửi các yêu cầu đồng thời ngay cả khi các yêu cầu đó có cùng
destinations.
Sử dụng validateOnly để kiểm tra lỗi không thành công nhanh
Gửi yêu cầu có đặt validateOnly thành true để phát hiện lỗi không thực hiện được nhanh chóng. Data Manager API chạy các quy trình kiểm tra xác thực giống như một yêu cầu thông thường, nhưng không nhập hoặc xoá bất kỳ dữ liệu nào.
Yêu cầu chỉ xác thực thành công không đảm bảo rằng sẽ không có lỗi trong quá trình xử lý, vì vậy, hãy tiếp tục kiểm tra thông tin chẩn đoán sau khi bạn gửi yêu cầu thông thường.
Kiểm tra thông tin chẩn đoán
Ghi lại và thu thập request_id từ mỗi
IngestAudienceMembersResponse hoặc
IngestEventsResponse, đồng thời sử dụng mã yêu cầu để
kiểm tra thông tin chẩn đoán.
Giám sát và cảnh báo về hạn mức
Để tránh bị từ chối yêu cầu ngoài dự kiến, hãy thiết lập cảnh báo và giám sát hạn mức trong Google Cloud Console. Việc theo dõi mức sử dụng hạn mức giúp bạn theo dõi các kiểu sử dụng và tối ưu hoá việc phân lô yêu cầu trước khi ứng dụng của bạn đạt đến giới hạn hằng ngày hoặc hằng phút.
Triển khai lên kênh phát hành công khai
Khi chuyển từ thử nghiệm cục bộ sang khối lượng công việc thực tế, hãy sử dụng Thông tin xác thực mặc định của ứng dụng có tài khoản dịch vụ đính kèm hoặc Workload Identity Federation để xác thực một cách an toàn và không tương tác.
Để biết thông tin chi tiết về cách định cấu hình quy trình xác thực cho các môi trường thực tế khác nhau, hãy xem bài viết Triển khai lên môi trường thực tế.