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

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

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

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