بهترین شیوه ها

هنگام استفاده از رابط برنامه‌نویسی کاربردی (API) مدیریت داده، نکات زیر را در نظر داشته باشید.

ارسال تمام شناسه‌های کاربر

چه بخواهید مخاطبان یا رویدادها را با UserData ارسال کنید، تا حد امکان user_identifiers در نظر بگیرید، از جمله ارسال چندین شناسه از یک نوع.

برای مثال، اگر چندین آدرس ایمیل برای یک کاربر دارید، برای هر آدرس ایمیل یک UserIdentifier جداگانه اضافه کنید. به طور مشابه، اگر شناسه‌هایی از انواع مختلف برای یک کاربر دارید، مانند آدرس‌های ایمیل، شماره تلفن و آدرس‌ها، برای هر شناسه یک UserIdentifier جداگانه اضافه کنید، تا حداکثر تعداد شناسه‌ها .

بهینه سازی درخواست ها

برای کاهش احتمال تجاوز از محدودیت‌های درخواست روزانه، تا حد امکان اقلام را در هر درخواست، تا سقف محدودیت‌های هر درخواست ، دسته‌بندی کنید.

برای مثال، اگر می‌خواهید ۱۰،۰۰۰ عضو مخاطب را به یک مخاطب اضافه کنید، تمام ۱۰،۰۰۰ عضو موجود در لیست audience_members را در یک IngestAudienceMembersRequest اضافه کنید. دسته‌بندی تمام ۱۰،۰۰۰ عضو در یک درخواست واحد، کارآمدتر از ارسال یک درخواست جداگانه برای اضافه کردن هر یک از اعضای مخاطب است.

ارسال درخواست‌های همزمان

برای کاهش زمان کلی مورد نیاز برای دریافت داده‌ها، درخواست‌های همزمان را به IngestionService ارسال کنید. توصیه می‌کنیم تا 10 درخواست همزمان ارسال کنید تا احتمال تجاوز از حد مجاز درخواست‌ها در هر دقیقه کاهش یابد.

شما می‌توانید درخواست‌های همزمان ارسال کنید، حتی اگر درخواست‌ها destinations یکسانی داشته باشند.

بررسی تشخیص

request_id را از هر IngestAudienceMembersResponse یا IngestEventsResponse ضبط و جمع‌آوری کنید و از شناسه‌های درخواست برای بررسی تشخیص استفاده کنید.

استقرار در محیط تولید

هنگام انتقال از تست محلی به بارهای کاری عملیاتی، از اعتبارنامه‌های پیش‌فرض برنامه (Application Default Credentials) به همراه یک حساب کاربری سرویس متصل یا فدراسیون هویت بار کاری (Workload Identity Federation) برای احراز هویت غیر تعاملی و ایمن استفاده کنید.

برای جزئیات بیشتر در مورد پیکربندی احراز هویت برای محیط‌های تولیدی مختلف، به بخش «استقرار در محیط تولیدی» مراجعه کنید.