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

در اینجا می‌توانید با تغییرات هر نسخه از 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 را به enum 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» آشنا شوید.

• فیلد 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 به enum ErrorReason اضافه شد.

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

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

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

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

• ‫INVALID_MERCHANT_ID به enum ErrorReason اضافه شد.

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

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

• منبع UserList و UserListService اضافه شد تا امکان ایجاد، بازیابی، به‌روزرسانی، و حذف فهرست‌های کاربر فراهم شود.
  • برای آشنایی با روند کامل ایجاد، تکمیل، و تأیید مخاطبان «مطابقت مشتری» بااستفاده از «میانای برنامه‌سازی کاربردی مدیر داده»، راهنمای 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 اضافه شد.

  درباره ارسال رویدادهای purchase در Google Analytics و نحوه تطبیق دادن پارامترهای رویداد و دارایی‌های کاربر Google Analytics با معادل‌های «میانای برنامه‌سازی کاربردی مدیر داده» در راهنمای رویدادها بیشتر بخوانید.

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

• مقادیر شمارشی زیر به 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

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

• «میانای برنامه‌سازی کاربردی مدیر داده» اکنون به‌طور کلی برای همه کاربران دردسترس است.

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

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

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

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

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

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

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

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

• پشتیبانی از ارسال تبدیل‌های آفلاین و تبدیل‌های بهبودیافته برای مشتریان بالقوه به مقصد Google Ads بااستفاده از روش IngestEvents اضافه شد. برای نحوه پیکربندی رمزگذاری برای این تبدیل‌ها، راهنمای رمزگذاری به‌روزرسانی‌شده را ببینید.
• مقادیر APP، IN_STORE، PHONE، و OTHER به enum EventSource اضافه شد. 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 به‌عنوان منبع داده اضافی برای تبدیل‌های برچسبتان استفاده کنید تا نشان‌های تعامل با آگهی را به حداکثر برسانید و داده‌ها و عملکرد کلی‌تان را تقویت کنید.

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

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