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

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

‫2026-05-07 الإصدار 1.6

  • تمت إضافة إمكانية إرسال الإحالات الناجحة للمبيعات في المتاجر على "إعلانات Google" باستخدام IngestEventsRequest. لاستخدام هذه الميزة، يجب أن يستوفي حسابك على "إعلانات Google" متطلبات الأهلية معيّنة.
    • تمت إضافة الحقل 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)
    • يمكنك الاطّلاع على الأدلة التالية للبدء:
  • تمّت إضافة إمكانية إرسال أيّ حدث على الموقع الإلكتروني أو التطبيق إلى "إحصاءات Google" لا يكون حدثًا محجوزًا.
  • أضفنا إمكانية إرسال أي حدث يتضمّن معرّف معاملة إلى كلّ من مصادر بيانات الويب ومصادر بيانات التطبيقات كمصدر بيانات إضافي لعلامتك أو حزمة تطوير البرامج (SDK) لأداة "إحصاءات Google لبرنامج Firebase"‏ (GA4F) عند التنفيذ.
    • تقتصر هذه الميزة على مواقع "إحصاءات Google" المدرَجة في قائمة السماح، لذا يُرجى ملء هذا النموذج إذا كنت مهتمًا بإضافة موقعك إلى قائمة السماح.
  • تمّت إضافة الحقل coupon_codes إلى CartData لتتبُّع جميع رموز القسائم المطبَّقة على سلّة التسوّق للأحداث التي يتم إرسالها إلى "إعلانات Google" و"إحصاءات Google".
    • بالنسبة إلى حالات استخدام استرداد القسائم في "إعلانات Google"، استخدِم نوع الإحالة الناجحة OFFLINE_PROMOTION_REDEMPTION.
  • تمت إضافة نطاق OAuth جديد، https://www.googleapis.com/auth/datamanager.partnerlink، للطرق المتعلّقة بإنشاء روابط شركاء والبحث عنها وحذفها.
  • تمت إضافة قيم جديدة إلى تعداد ErrorReason لدعم التحقّق التفصيلي من صحة بيانات مبيعات المتجر وعملية استيعاب الأحداث في "إحصاءات Google".
  • تمت إضافة الحقلَين youtube_members_count وgmail_members_count إلى المورد SizeInfo.

2026-03-26

‫2026-02-17 الإصدار 1.5

تتيح واجهة 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 لإضافة معلومات 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