هنگام استفاده از Data Manager API، روال‌های مطلوب زیر را درنظر داشته باشید.
ارسال همه شناسه‌های کاربر
چه درحال ارسال اعضای مخاطب باشید چه رویدادها با UserData، تا جایی که ممکن است
user_identifiers اضافه کنید، ازجمله ارسال چند شناسه از
یک نوع.
برای مثال، اگر چند نشانی ایمیل برای یک کاربر دارید، برای هر نشانی ایمیل یک
UserIdentifier جداگانه اضافه کنید. به‌طور مشابه، اگر شناسه‌هایی از انواع مختلف برای یک کاربر دارید، مانند نشانی‌های ایمیل، شماره تلفن‌ها، و نشانی‌ها، برای هر شناسه یک UserIdentifier جداگانه اضافه کنید، تا حداکثر تعداد شناسه.
بهینه‌سازی درخواست‌ها
برای کاهش احتمال فراتر رفتن از محدودیت‌های درخواست روزانه، تا حد امکان موارد بیشتری را در هر درخواست دسته‌بندی کنید، تا محدودیت‌های هر درخواست.
برای مثال، اگر می‌خواهید ۱۰٬۰۰۰ عضو مخاطب به مخاطبی اضافه کنید، همه ۱۰٬۰۰۰ عضو را در فهرست audience_members در یک IngestAudienceMembersRequest اضافه کنید. دسته‌بندی کردن همه ۱۰٬۰۰۰ عضو در یک درخواست واحد کارآمدتر از ارسال درخواست جداگانه برای افزودن هر عضو مخاطب است.
ارسال درخواست‌های هم‌زمان
برای کاهش زمان کلی موردنیاز برای جذب داده‌ها، درخواست‌های هم‌زمان به IngestionService ارسال کنید. توصیه می‌کنیم حداکثر ۱۰ درخواست را به‌طور هم‌زمان ارسال کنید تا احتمال فراتر رفتن از محدودیت درخواست در دقیقه کاهش یابد.
می‌توانید درخواست‌های هم‌زمان ارسال کنید، حتی اگر درخواست‌ها دارای
destinations یکسان باشند.
از validateOnly برای بررسی خطاهای «شکست سریع» استفاده کنید
درخواست‌ها را با validateOnly تنظیم‌شده روی true ارسال کنید تا
خطاهای سریع را بگیرید. Data Manager API همان بررسی‌های اعتبارسنجی را اجرا می‌کند
که درخواست معمولی اجرا می‌کند، اما هیچ داده‌ای را دریافت یا حذف نمی‌کند.
موفقیت‌آمیز بودن درخواست فقط اعتبارسنجی تضمین نمی‌کند که درطول پردازش هیچ خطایی رخ نخواهد داد، بنابراین پس‌از ارسال درخواست عادی، همچنان عیب‌یابی را بررسی کنید.
بررسی تشخیص خرابی
request_id را از هرکدام از
IngestAudienceMembersResponse یا
IngestEventsResponse ضبط و جمع‌آوری کنید و از شناسه‌های درخواست برای
بررسی عیب‌یابی استفاده کنید.
نظارت و هشدار درباره سهمیه‌ها
برای جلوگیری از رد شدن غیرمنتظره درخواست، هشدارها و پایش سهمیه را در کنسول Google Cloud راه‌اندازی کنید. پایش مصرف سهمیه به شما کمک می‌کند الگوهای مصرف را ردیابی کنید و دسته‌بندی درخواست‌ها را قبل‌از اینکه برنامه‌تان به محدودیت‌های روزانه یا دقیقه‌ای برسد بهینه کنید.
استقرار در تولید
هنگام انتقال از آزمایش محلی به بارهای کاری تولید، از اعتبارنامه‌های پیش‌فرض برنامه با حساب سرویس پیوست‌شده یا Workload Identity Federation برای اصالت‌سنجی غیرتعاملی و ایمن استفاده کنید.
برای جزئیات مربوط به پیکربندی اصالت‌سنجی برای محیط‌های تولید مختلف، استقرار در تولید را ببینید.