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

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

‫۲۰۲۶/۱۱/۰۴ نسخه ۱.۹

• پشتیبانی برای ارسال تبدیل‌های تماس Google Ads اضافه شد.

  • فیلد call_info به Event اضافه شد. از فیلد start_timestamp CallInfo برای مشخص کردن زمان شروع تماس تلفنی که منجر به تبدیل شده است استفاده کنید.

  برای شروع، راهنمای ارسال تبدیل‌های تماس را بررسی کنید، یا با نحوه ارتقا دادن از Google Ads API آشنا شوید.

• فیلد record_indices به ErrorCount و WarningCount اضافه شد تا سوابق موجود در درخواست جذب که هرکدام دارای خطا یا هشدار پردازش بودند شناسایی شوند. برای جزئیات مربوط به نحوه استفاده از این فیلد، بررسی سوابق تحت‌تأثیر را ببینید.

• فیلد lead_id به AdIdentifiers اضافه شد تا از ارسال شناسه تولیدشده توسط Google که هنگام ارسال فرم مشتری بالقوه توسط کاربر صادر می‌شود پشتیبانی کند.

• دلیل‌های خطای ENCRYPTION_NOT_SUPPORTED، DUPLICATE_ELEMENTS، UNSUPPORTED_BASELINE_LOCATION، CONVERSION_PRECEDES_CALL، INVALID_AD_IDENTIFIER_FOR_ACCOUNT، CONVERSION_ACTION_TOO_RECENTLY_CREATED، REQUEST_TOO_OLD، و INVALID_DATE به ErrorReason enum اضافه شد.

• دلیل‌های خطای PROCESSING_ERROR_REASON_DESTINATION_TOO_RECENTLY_CREATED، PROCESSING_ERROR_REASON_TOO_RECENT_CALL، PROCESSING_ERROR_REASON_EXPIRED_CALL، و PROCESSING_ERROR_REASON_INVALID_CALL به ProcessingErrorReason enum اضافه شد.

• دلیل‌های هشدار PROCESSING_WARNING_REASON_CUSTOM_VARIABLE_NOT_ENABLED و PROCESSING_WARNING_REASON_CUSTOM_VARIABLE_NOT_PREDEFINED به ProcessingWarningReason enum اضافه شد.

• دلیل هشدار WARNING_REASON_INVALID_NUMBER_FORMAT به شمارشی WarningReason اضافه شد.

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

• روش 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 به enum 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 استفاده کنید.

• پشتیبانی از مشخص کردن 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 مدیریت می‌شوند فقط درصورتی واجدشرایط هدف‌یابی هستند که حداقل ۱٬۰۰۰ عضو داشته باشند.