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

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