ملاحظات حول الإصدار

يمكنك هنا الاطّلاع على التغييرات التي تم إجراؤها في كل إصدار من Data Manager API.

‫2025-11-05 الإصدار 1.4

  • تمّت إضافة إمكانية إرسال أحداث purchase في "إحصاءات Google" كمصدر بيانات إضافي لإحالاتك الناجحة التي تتضمّن علامات، وذلك بهدف زيادة إشارات التفاعل مع الإعلانات وتعزيز بياناتك وأدائك العام.

    • تمت إضافة GOOGLE_ANALYTICS_PROPERTY إلى تعداد AccountType.
    • تمت إضافة حقول متعددة إلى Event:
      • event_name
      • client_id
      • user_id
      • additional_event_parameters
    • تمت إضافة additional_user_properties إلى UserProperties.

    يمكنك الاطّلاع على مزيد من المعلومات عن إرسال أحداث purchase في "إحصاءات Google" وكيفية ربط مَعلمات أحداث وخصائص مستخدمي "إحصاءات Google" بمكافئاتها في واجهة برمجة التطبيقات الخاصة بأداة "إدارة بيانات إعلانات Google" في دليل الأحداث.

  • تمت إضافة AwsWrappedKeyInfo لإتاحة استخدام مفاتيح التشفير من خدمة إدارة المفاتيح من Amazon.

  • تمت إضافة قيم 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

‫06-10-2025 الإصدار 1.3

  • أصبحت واجهة برمجة التطبيقات "إدارة بيانات إعلانات Google" متاحة الآن لجميع المستخدمين.

    لا يزال بإمكان الحسابات المدرَجة في قائمة السماح فقط إرسال الإحالات الناجحة باستخدام مصادر بيانات متعددة لتعزيز الأداء وقوة البيانات. املأ النموذج إذا كنت مهتمًا بإضافة حسابك.

    يُرجى ملء نموذج إبداء الاهتمام بالانضمام إلى شركاء البيانات.

  • تمت إضافة طريقة RetrieveRequestStatus من أجل استرداد معلومات التشخيص لطلبات استيعاب الأحداث وشرائح الجمهور.

  • تم إيقاف الحقل product الخاص بـ ProductAccount والقيمة Product في التعداد نهائيًا. استخدِم الحقل account_type وقائمة التعداد الجديدة AccountType بدلاً من ذلك.

  • أضفنا إمكانية تحديد destination لكل AudienceMember في IngestAudienceMembersRequest. استخدِم هذه الميزة لإرسال بيانات الجمهور إلى وجهات متعدّدة ومختلفة في طلب واحد.

  • تصبح شرائح الجمهور التي يتمّ استيعابها باستخدام واجهة برمجة التطبيقات مؤهَّلة للاستهداف بعد أن تضمّ 100 مستخدم على الأقل. في السابق، كان الحد الأدنى لعدد الأعضاء ألف عضو.

  • أصبح transaction_id الخاص بـ Event اختياريًا الآن عند إرسال الإحالات الناجحة غير الإلكترونية أو الإحالات الناجحة المحسّنة للعملاء المحتملين. لا يزال transaction_id مطلوبًا عند إرسال الإحالات الناجحة غير الإلكترونية كمصدر بيانات إضافي لتعزيز الأداء وقوة البيانات.

‫2025-08-06 الإصدار 1.2

  • تمّت إضافة إمكانية إرسال الإحالات الناجحة غير الإلكترونية والإحالات الناجحة المحسّنة للعملاء المحتملين إلى وجهات "إعلانات Google" باستخدام طريقة IngestEvents. راجِع دليل التشفير المعدَّل لمعرفة كيفية ضبط التشفير لهذه الإحالات الناجحة.
  • تمت إضافة القيم APP وIN_STORE وPHONE وOTHER إلى تعداد 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 الإصدار 1.1

  • تمت إضافة الطريقة IngestEvents إلى IngestionService. استخدِم IngestEvents كمصدر بيانات إضافي لإحالاتك الناجحة التي يتم تتبّعها باستخدام العلامة، وذلك لزيادة إشارات التفاعل مع الإعلانات إلى أقصى حد وتعزيز بياناتك وأدائك العام.

‫2025-04-02 الإصدار 1.0