یادداشت‌های انتشار

در اینجا می‌توانید با تغییرات هر نسخه Data Manager API آشنا شوید.

‫۲۰۲۶/۰۷/۳۰ نسخه ۱.۸

• روش RemoveAllAudienceMembers به IngestionService اضافه شد تا همه اعضای مخاطب برای فهرست‌های کاربر مشخص‌شده برداشته یا جایگزین شوند.
  • برای شروع، راهنمای برداشتن همه اعضا از مخاطبان را برای ادغام خاص خود مرور کنید. برای مثال، راهنماهای «مطابقت مشتری» را برای Google Ads یا Display & Video 360 ببینید.
• پشتیبانی برای برگرداندن هشدارهای تفصیلی درطول جذب رویداد و مخاطب اضافه شد.
  • فیلد field_warnings به IngestEventsResponse و IngestAudienceMembersResponse اضافه شد که حاوی فهرستی از اشیاء FieldWarning است.
  • منبع FieldWarning اضافه شد که حاوی reason (WarningReason)، description، و مسیر field است.
  • WarningReason enum را برای تعریف دلایل هشدارها اضافه کردیم، مانند فعال نبودن متغیرهای سفارشی یا نبودن شناسه‌های فروشنده در داده‌های سبد خرید.
• پشتیبانی از ارسال فیلدهای نشانی بیشتر برای دریافت رویداد Google Analytics اضافه شد.
  • فیلدهای address_line، city، و administrative_area به AddressInfo (استفاده‌شده در UserData) اضافه شد.
• دلایل خطای INVALID_REMOVE_AS_OF_TIME و REQUIRED_PREREQUISITE_LINK_MISSING به شمارشگر ErrorReason اضافه شد.

‫۲۰۲۶/۰۵/۲۸ نسخه ۱.۷

• پشتیبانی از ارسال رویدادهای تبدیل آفلاین به محصولات Google Marketing Platform، ازجمله Campaign Manager 360،‏ Search Ads 360، و Display & Video 360، بااستفاده از IngestEventsRequest اضافه شد.

  • FLOODLIGHT_CONFIG به شمارش AccountType اضافه شد تا از مقصدهای Floodlight پشتیبانی شود.
  • فیلدهای dclid، impression_id، match_id، و encrypted_user_ids به AdIdentifiers اضافه شد.
  • فیلد conversion_count به منبع Event اضافه شد تا از پیگیری تعداد تبدیل‌ها پشتیبانی شود.

  برای شروع، راهنمای ارسال رویداد را بررسی کنید یا با نحوه ارتقا دادن از Campaign Manager 360 API آشنا شوید.

• فیلد composite_data به منبع AudienceMember اضافه شد که شیء CompositeData را می‌پذیرد و به شما امکان می‌دهد چندین نوع شناسه را ترکیب کنید، مانند UserData و IpData. برای اطلاعات بیشتر، به داده‌های ترکیبی مراجعه کنید.

  • وضعیت‌های جدید IngestCompositeDataStatus و RemoveCompositeDataStatus که شامل عیب‌یابی (record_count و data_type_counts) برای درخواست‌های عضو مخاطب است که از CompositeData استفاده می‌کنند، اضافه شد.

• پشتیبانی از دریافت نشانی‌های IP برای «مطابقت مشتری» Google Ads با ارسال IpData در داده‌های ترکیبی اضافه شد.

• دلایل خطای جدید FIELD_VALUE_TOO_SHORT، TOO_FEW_ELEMENTS، BASELINE_LOCATION_AUTO_DETECTION_FAILED، و INSIGHTS_MISSING_FOR_DIMENSION به ErrorReason enum اضافه شد.

• مقادیر عیب‌یابی جدیدی به ProcessingErrorReason اضافه شد تا بازخورد دقیق‌تری برای خرابی‌ها درطول دریافت رویداد ارائه شود.

‫۲۰۲۶/۰۵/۰۷ نسخه ۱.۶

• پشتیبانی از ارسال تبدیل‌های فروش فروشگاه Google Ads بااستفاده از IngestEventsRequest اضافه شد. برای استفاده از این ویژگی، حساب Google Ads شما باید شرایط صلاحیت خاصی را داشته باشد.
  • فیلد event_location به Event اضافه شد که از ارائه store_id. فیزیکی پشتیبانی می‌کند
  • فیلد third_party_user_data به Event اضافه شد تا داده‌های جذب‌شده بتوانند به‌طور صریح به‌عنوان متعلق به شخص ثالث پرچم‌گذاری شوند.
    • پر کردن این فیلد فقط برای شرکای داده مجاز است.
  • فیلدهای زیر به منبع Item اضافه شد:
    • merchant_id
    • merchant_feed_label
    • merchant_feed_language_code
    • conversion_value
    • custom_variables (فهرستی از اشیاء ItemCustomVariable را می‌پذیرد)
  • برای شروع، راهنماهای زیر را بررسی کنید:
    • ارتقا دادن از Google Ads
    • ارسال رویدادها
• پشتیبانی از ارسال هر رویداد وب یا برنامه به Google Analytics که رویداد رزروشده نباشد اضافه شد.
  • فیلد app_instance_id به منبع Event اضافه شد.
  • فیلدهایی به DeviceInfo اضافه شد تا فراداده‌های مربوط به دستگاه کاربر را ارائه دهد.
  • فیلد mobile_device_id به AdIdentifiers اضافه شد.
  • فیلد event_location به Event اضافه شد تا فیلدهایی مثل city، subdivision_code، region_code، subcontinent_code، و continent_code را ضبط کند.
  • برای شروع، راهنماهای زیر را بررسی کنید:
    • ارسال رویدادهای توصیه‌شده و سفارشی
    • ارتقا دادن از Measurement Protocol
    • مرجع رویدادهای توصیه‌شده
• پشتیبانی برای ارسال هر رویداد با شناسه تراکنش به هر دو جریان داده‌های وب و برنامه به‌عنوان منبع داده اضافی برای پیاده‌سازی‌های برچسب یا کیت توسعه نرم‌افزار Google Analytics for Firebase (GA4F) اضافه شد.
  • این ویژگی محدود به دارایی‌های Google Analytics در فهرست مجاز است؛ اگر مایلید دارایی‌تان را به فهرست مجاز اضافه کنید، این فرم را تکمیل کنید.
• فیلد coupon_codes به CartData اضافه شد تا همه کدهای تخفیف اعمال‌شده به سبد خرید برای رویدادهای ارسال‌شده به Google Ads و Google Analytics ردیابی شود.
  • برای موارد استفاده از پس‌خرید کوپن در Google Ads، از نوع تبدیل OFFLINE_PROMOTION_REDEMPTION استفاده کنید.
• دامنه OAuth جدیدی، https://www.googleapis.com/auth/datamanager.partnerlink، برای روش‌های مربوط به ایجاد، جستجو، و حذف پیوندهای شریک اضافه شد.
• مقادیر جدیدی به شمارشگر ErrorReason اضافه شد تا از اعتبارسنجی دقیق برای فروش‌های فروشگاه و دریافت رویداد Google Analytics پشتیبانی شود.
• فیلدهای youtube_members_count و gmail_members_count به منبع SizeInfo اضافه شد.

2026-03-26

• EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED به شمارش ErrorReason اضافه شد.

  برای رعایت «مقررات تبلیغات سیاسی اتحادیه اروپا» (EU PAR)،‏ Google از همه مشتریان می‌خواهد خوداظهاری کنند که آیا آگهی‌هایشان طبق «مقررات تبلیغات سیاسی اتحادیه اروپا» سیاسی محسوب می‌شود یا نه. با تعریف آگهی سیاسی اتحادیه اروپا و محدودیت‌های Google برای آگهی‌های سیاسی در اتحادیه اروپا آشنا شوید.

  از ۱ آوریل ۲۰۲۶، ممکن است عملیات زیر در حساب‌هایی که فاقد این اظهارنامه هستند محدود شود یا با خطای EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED ناموفق شود.

  • UserListService (create، update، و delete)
  • ‫IngestionService (ingestAudienceMembers)

  برای برطرف کردن این خطا، آگهی‌دهندگان باید اظهارنامه اجباری را در واسط کاربر Google Ads ارائه دهند. درباره نحوه تأیید کردن برای حسابتان بیشتر بدانید.

• INVALID_MERCHANT_ID به شمارش ErrorReason اضافه شد.

‫۲۰۲۶/۰۲/۱۷ نسخه ۱.۵

‫Data Manager API اکنون از کل گردش کار سرتاسری برای مدیریت مخاطبان، ازجمله ایجاد، دریافت، و بازیابی مخاطبان پشتیبانی می‌کند.

• منبع UserList و UserListService اضافه شد تا امکان ایجاد، بازیابی، به‌روزرسانی، و حذف فهرست‌های کاربر فراهم شود.
  • برای راهنمایی گام‌به‌گام درباره نحوه ایجاد، پر کردن، و تأیید مخاطبان «مطابقت مشتری» بااستفاده از Data Manager API، راهنماهای Google Ads یا Display & Video 360 را بررسی کنید.
  • برای اطلاع از مراحل انتقال، به راهنماهای ارتقای Google Ads یا Display & Video 360 مراجعه کنید.
• پشتیبانی از ارسال شناسه کاربر ازطریق جذب عضو مخاطب اضافه شد، که امکان استفاده از آن را با مطابقت مشتری در Google Ads فراهم می‌کند.
  • UserIdData به AudienceMember اضافه شد.
  • IngestUserIdDataStatus و RemoveUserIdDataStatus به وضعیت‌های برگردانده‌شده توسط روش RetrieveRequestStatus اضافه شد. از این فیلدها برای بازیابی اطلاعات عیب‌یابی درباره جذب و حذف شناسه کاربر استفاده کنید.
• منبع PartnerLink و PartnerLinkService برای ایجاد و مدیریت پیوندها بین حساب‌های تبلیغ‌کننده و شریک داده اضافه شد.
  • برای شروع، راهنماهای پیوندهای شریک را بررسی کنید.

2026-02-10

ارسال تبدیل‌ها با چندین منبع داده برای تقویت عملکرد و غنای داده اکنون به‌طور کلی برای همه حساب‌های Google Ads دردسترس است.

این ویژگی هنوز فقط برای دارایی‌های Google Analytics در فهرست مجاز دردسترس است. اگر مایلید دارایی Google Analytics خود را به فهرست مجاز اضافه کنید، فرم را تکمیل کنید.

‫۲۰۲۵-۱۱-۰۵ نسخه ۱.۴

• پشتیبانی از ارسال رویدادهای Google Analytics purchase به‌عنوان منبع داده اضافی برای تبدیل‌های برچسب شما اضافه شد تا سیگنال‌های تعامل با آگهی بیشینه شود و داده‌ها و عملکرد کلی شما تقویت شود.

  • ‫GOOGLE_ANALYTICS_PROPERTY به شمارش AccountType اضافه شد.
  • چند فیلد به Event اضافه شد:
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • additional_user_properties به UserProperties اضافه شد.

  درباره ارسال رویدادهای Google Analytics purchase و نحوه نگاشت پارامترهای رویداد Google Analytics و ویژگی‌های کاربر به معادل‌های Data Manager API آن‌ها در راهنمای رویدادها بیشتر بخوانید.

• AwsWrappedKeyInfo برای پشتیبانی از استفاده از کلیدهای رمزگذاری از AWS Key Management Service اضافه شد.

• مقادیر enum زیر به ErrorReason اضافه شد:

  • EVENT_TIME_INVALID
  • FIELD_VALUE_TOO_LONG
  • INVALID_EVENT_NAME
  • INVALID_PROPERTY_TYPE
  • INVALID_REQUEST_ID
  • INVALID_STREAM_TYPE
  • LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
  • MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
  • NOT_ALLOWLISTED
  • OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
  • RESERVED_NAME_USED
  • TOO_MANY_ELEMENTS
  • UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
  • UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

‫۲۰۲۵/۱۰/۰۶ نسخه ۱.۳

• ‫Data Manager API اکنون به‌طور عمومی برای همه کاربران دردسترس است.

  ارسال تبدیل‌ها با چندین منبع داده برای تقویت عملکرد و غنای داده هنوز فقط برای حساب‌های موجود در فهرست مجاز دردسترس است. اگر مایلید حسابتان را اضافه کنید، فرم را تکمیل کنید.

  فرم علاقه‌مندی شریک را تکمیل کنید تا علاقه‌مندی خود را برای تبدیل شدن به شریک داده ابراز کنید.

• روش RetrieveRequestStatus برای بازیابی اطلاعات عیب‌یابی برای درخواست‌های جذب مخاطب و رویداد اضافه شد.

• فیلد product از ProductAccount و شمارش Product منسوخ شده‌اند. به‌جای آن از فیلد account_type و AccountType enum جدید استفاده کنید.

• پشتیبانی از مشخص کردن destination برای هر AudienceMember در IngestAudienceMembersRequest اضافه شد. از این ویژگی برای ارسال داده‌های مخاطب به چندین مقصد متمایز در یک درخواست واحد استفاده کنید.

• مخاطبان واردشده با API اکنون واجدشرایط هدف‌یابی هستند، به‌شرطی که حداقل ۱۰۰ عضو داشته باشند. قبلاً، آستانه عضویت هزار عضو بود.

• transaction_id Event اکنون هنگام ارسال تبدیل‌های آفلاین یا تبدیل‌های بهبودیافته برای مشتریان بالقوه اختیاری است. transaction_id همچنان هنگام ارسال تبدیل‌های آفلاین به‌عنوان منبع داده اضافی برای تقویت عملکرد و غنای داده لازم است.

‫۲۰۲۵-۰۸-۰۶ نسخه ۱.۲

• پشتیبانی از ارسال تبدیل‌های آفلاین و تبدیل‌های بهبودیافته برای مشتریان بالقوه به مقصدهای Google Ads بااستفاده از روش IngestEvents اضافه شد. برای نحوه پیکربندی رمزگذاری برای این تبدیل‌ها، راهنمای رمزگذاری به‌روزشده را ببینید.
• مقادیر APP، IN_STORE، PHONE، و OTHER به EventSource enum اضافه شد. event_source برای تبدیل‌های آفلاین و تبدیل‌های بهبودیافته برای مشتریان بالقوه لازم است.
• فیلد user_properties به Event اضافه شد. این فیلد را روی شیء UserProperties تنظیم کنید تا اطلاعات ارزیابی‌شده توسط آگهی‌دهنده درباره کاربر در زمان وقوع رویداد اضافه شود.
• فیلد تکراری destination_references به CustomVariable اضافه شد. از این فیلد برای اعمال مقدار متغیر سفارشی فقط به زیرمجموعه‌ای از مقصدهای Event استفاده کنید.
• خطاهای زیر برای تبدیل‌های آفلاین و تبدیل‌های بهبودیافته برای مشتریان بالقوه اضافه شد:
  • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
  • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
  • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

‫۲۰۲۵/۰۶/۲۵ نسخه ۱.۱

• روش IngestEvents به IngestionService اضافه شد. از IngestEvents به‌عنوان منبع داده اضافی برای تبدیل‌های برچسبتان استفاده کنید تا نشان‌های تعامل با آگهی را به حداکثر برسانید و داده‌ها و عملکرد کلی‌تان را تقویت کنید.

‫۲۰۲۵/۰۴/۰۲ نسخه ۱.۰

• اولین نسخه Data Manager API، با پشتیبانی از ارسال داده‌های مخاطب به Google Ads و Display & Video 360.
• پشتیبانی از gRPC و REST اضافه شد.
• IngestionService با روش‌های IngestAudienceMembers و RemoveAudienceMembers برای مدیریت اعضای مخاطب بااستفاده از انواع داده‌های زیر اضافه شد:
  • اطلاعات تماس
  • مدارک شناسایی دیجیتالی
  • شناسه‌های PAIR
• مخاطبانی که بااستفاده از Data Manager API مدیریت می‌شوند فقط درصورتی واجدشرایط هدف‌یابی هستند که حداقل ۱٬۰۰۰ عضو داشته باشند.