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

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

2026-02-10

تتوفّر الآن بشكل عام لجميع حسابات "إعلانات Google" إمكانية إرسال الإحالات الناجحة باستخدام مصادر بيانات متعددة لتعزيز الأداء وقوة البيانات.

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

‫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

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

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

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

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

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