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

اینجا می‌توانید ببینید که در هر نسخه از رابط برنامه‌نویسی کاربردی (API) مدیریت داده چه تغییراتی ایجاد شده است.

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

  • پشتیبانی برای ارسال تبدیل‌های فروش فروشگاه گوگل ادز با استفاده از IngestEventsRequest اضافه شد. برای استفاده از این ویژگی، حساب گوگل ادز شما باید شرایط لازم را داشته باشد.
    • فیلد 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 را می‌پذیرد)
    • برای شروع، راهنماهای زیر را بررسی کنید:
  • پشتیبانی از ارسال هر رویداد وب یا برنامه‌ای به گوگل آنالیتیکس که یک رویداد رزرو شده نباشد، اضافه شد.
  • پشتیبانی از ارسال هر رویدادی با شناسه تراکنش به جریان‌های داده وب و برنامه به عنوان منبع داده اضافی برای تگ شما یا پیاده‌سازی‌های SDK گوگل آنالیتیکس برای فایربیس (GA4F) اضافه شده است.
    • این ویژگی محدود به ویژگی‌های گوگل آنالیتیکس در یک فهرست مجاز است؛ اگر علاقه‌مند به افزودن ویژگی خود به فهرست مجاز هستید، این فرم را پر کنید .
  • فیلد coupon_codes به CartData اضافه شد تا تمام کدهای تخفیف اعمال شده به سبد خرید برای رویدادهای ارسال شده به Google Ads و Google Analytics ردیابی شوند.
    • برای موارد استفاده از کوپن تخفیف در گوگل ادز، از نوع تبدیل OFFLINE_PROMOTION_REDEMPTION استفاده کنید.
  • یک محدوده‌ی جدید OAuth، https://www.googleapis.com/auth/datamanager.partnerlink ، برای روش‌های مربوط به ایجاد، جستجو و حذف لینک‌های همکار اضافه شد.
  • مقادیر جدیدی به شمارشگر ErrorReason اضافه شد تا از اعتبارسنجی دقیق برای فروش فروشگاه و دریافت رویداد Google Analytics پشتیبانی کند.
  • فیلدهای youtube_members_count و gmail_members_count به منبع SizeInfo اضافه شد.

۲۰۲۶-۰۳-۲۶

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

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

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

۲۰۲۶-۰۲-۱۰

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

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

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

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

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

    برای اطلاعات بیشتر در مورد ارسال رویدادهای purchase گوگل آنالیتیکس و نحوه نگاشت پارامترهای رویداد گوگل آنالیتیکس و ویژگی‌های کاربر به معادل‌های API مدیریت داده آنها، به راهنمای رویدادها مراجعه کنید.

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

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

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

  • رابط برنامه‌نویسی کاربردی (API) مدیریت داده اکنون به طور کلی برای همه کاربران در دسترس است.

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

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

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

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

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

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

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

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

  • پشتیبانی از ارسال تبدیل‌های آفلاین و تبدیل‌های بهبود یافته برای سرنخ‌ها به مقاصد گوگل ادز با استفاده از روش 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

‏2025-06-25 نسخه ۱.۱

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

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