به‌روزرسانی‌های Data Manager API: روش RemoveAllAudienceMembers، هشدارهای فیلد دریافت، داده‌های نشانی گسترش‌یافته

پنجشنبه، ۳۰ ژوئیه ۲۰۲۶

جدیدترین نسخه Data Manager API ویژگی‌هایی را معرفی می‌کند که مدیریت مخاطب را ساده‌تر می‌کند، گردش‌های کاری دریافت را با هشدارهای سطح فیلد بهبود می‌بخشد، و داده‌های ارائه‌شده توسط کاربر را برای Google Analytics دقیق‌تر می‌کند.

برداشتن همه اعضای مخاطب

از روش جدید RemoveAllAudienceMembers برای پاک کردن همه اعضا از فهرست‌های کاربر مشخص‌شده در یک عملیات واحد استفاده کنید. پارامتر اختیاری removeAsOfTime به شما امکان می‌دهد فقط آن دسته از اعضایی را هدف قرار دهید که قبل‌از مُهر زمان خاصی اضافه شده‌اند.

این ویژگی به‌ویژه زمانی مفید است که نیاز به بازآوری کامل (یا «جایگزینی همه») داده‌های مخاطبان خود دارید، که به شما امکان می‌دهد فهرست موجود را پاک کنید و آن را با مجموعه جدیدی از کاربران پر کنید.

هشدارهای فیلد انتقال داده

پاسخ‌های دریافت Data Manager API اکنون شامل هشدارهای دقیق در سطح فیلد برای مشکلات اعتبارسنجی در فیلدهای اختیاری است. اگر میانای برنامه‌سازی کاربردی (API) مشکلات اعتبارسنجی در فیلدهای اختیاری را شناسایی کند، درخواست جذب شما موفقیت‌آمیز خواهد بود و بقیه داده‌های جذب شما همچنان پردازش خواهند شد. عدم اعتبارسنجی فیلدهای الزامی همچنان باعث رد شدن کل درخواست طبق مدل رد شدن سریع خواهد شد.

اگر هر فیلد اختیاری که ارائه می‌دهید نامعتبر باشد، پاسخ از IngestEventsRequest یا IngestAudienceMembersRequest شامل یک فیلد field_warnings با فهرستی از اشیاء FieldWarning است. هر هشدار دلیل خاصی (WarningReason)، پیام توصیفی، و مکان فیلد در درخواست را که مشکل در آن رخ داده است ارائه می‌دهد.

داده‌های نشانی اضافی برای رویدادهای Google Analytics

اکنون می‌توانید هنگام انتقال رویدادها به مقصدهای Google Analytics، اطلاعات بیشتری درباره نشانی کاربر ارائه دهید. همراه با فیلدهای given_name، family_name، region_code، و postal_code، منبع AddressInfo اکنون از موارد زیر پشتیبانی می‌کند:

  • address_line (نشانی خیابان)
  • city
  • administrative_area (ایالت یا استان)

همچنین، اکنون می‌توانید از فیلد موجود داده‌های ارائه‌شده توسط کاربر (user_data) برای برآورده کردن الزامات شناسه‌ها برای رویدادهای چندمنبعی ارسال‌شده به جریان‌های داده‌های وب استفاده کنید. این ویژگی گزینه دیگری دراختیارتان قرار می‌دهد وقتی که ad_identifiers.gclid، user_id، یا client_id را برای رویداد چندمنبعی ندارید.

شروع‌به‌کار

ساخت سریع‌تر با مهارت‌های عامل هوشواره‌ای: اخیراً مهارت‌های جدیدی برای عامل Data Manager API معرفی کرده‌ایم تا به شما کمک کنیم ادغام‌هایتان را سریع‌تر انجام دهید. مهارت‌های جدید را در مخزن GitHub «مهارت‌های Google» کاوش کنید تا راهنمایی‌های دقیق‌تر و کارآمدتری را مستقیماً در محیط کدنویسی با کمک هوش مصنوعی خود دریافت کنید.

اگر سؤالی دارید یا می‌خواهید درباره این پست بحث کنید، لطفاً ازطریق سرور Discord «انجمن تبلیغات و سنجش Google» با ما تماس بگیرید. اگر مشکلی دارید یا برای API به راهنمایی نیاز دارید، می‌توانید ازطریق صفحه پشتیبانی با ما تماس بگیرید.

اگر به تبدیل شدن به شریک داده علاقه‌مند هستید، لطفاً فرم علاقه‌مندی شریک را تکمیل کنید.

پرتره نویسنده - Lindsey Volta، ازطرف تیم Data Manager API

برچسب‌ها: analytics، data-manager-api