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

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

‫30/07/2026 الإصدار 1.8

• أضفنا الطريقة RemoveAllAudienceMembers إلى IngestionService لإزالة جميع أعضاء شرائح الجمهور أو استبدالهم في قوائم المستخدمين المحدّدة.
  • للبدء، راجِع دليل إزالة جميع الأعضاء من شريحة جمهور لعملية التكامل المحدّدة. على سبيل المثال، اطّلِع على أدلة ميزة "مطابقة العملاء" في"إعلانات Google" أو"مساحة العرض والفيديو 360".
• أضفنا إمكانية عرض تحذيرات مفصّلة أثناء عملية استيعاب الأحداث وشرائح الجمهور.
  • أضفنا الحقل field_warnings إلى IngestEventsResponse و IngestAudienceMembersResponse الذي يحتوي على قائمة بعناصر FieldWarning.
  • أضفنا المرجع FieldWarning الذي يحتوي على reason (WarningReason ) وdescription ومسار field.
  • أضفنا WarningReason تعداد لتحديد أسباب التحذيرات، مثل عدم تفعيل المتغيّرات المخصّصة أو عدم توفّر أرقام تعريف التاجر في بيانات سلة التسوّق.
• أضفنا إمكانية إرسال حقول عناوين إضافية لاستيعاب الأحداث في "إحصاءات Google".
  • أضفنا الحقول address_line وcity وadministrative_area إلى AddressInfo (المستخدَمة في UserData).
• أضفنا أسباب الخطأ INVALID_REMOVE_AS_OF_TIME و REQUIRED_PREREQUISITE_LINK_MISSING إلى التعداد ErrorReason.

‫28/05/2026 الإصدار 1.7

• أضفنا إمكانية إرسال أحداث الإحالات الناجحة غير الإلكترونية إلى منتجات "منصّة Google للتسويق"، بما في ذلك "مدير الحملة 360" و"إعلانات شبكة البحث 360" و"مساحة العرض والفيديو 360"، باستخدام IngestEventsRequest.

  • أضفنا FLOODLIGHT_CONFIG إلى الـ AccountType تعداد لدعم وجهات Floodlight.
  • أضفنا الحقول dclid وimpression_id وmatch_id و encrypted_user_ids إلى AdIdentifiers.
  • أضفنا الحقل conversion_count إلى المرجع Event لدعم تتبُّع كميات الإحالات الناجحة.

  يمكنك الاطّلاع على دليل إرسال الأحداث للبدء، أو التعرّف على كيفية الترقية من Campaign Manager 360 API.

• أضفنا الحقل composite_data إلى المرجع AudienceMember الذي يقبل كائن CompositeData ويسمح لك بدمج أنواع متعدّدة من المعرّفات، مثل UserData و IpData. لمزيد من المعلومات، اطّلِع على مقالة البيانات المركّبة.

  • أضفنا الحالات الجديدة IngestCompositeDataStatus و RemoveCompositeDataStatus التي تتضمّن بيانات التشخيص (record_count و data_type_counts) لـ طلبات أعضاء شرائح الجمهور التي تستخدِم CompositeData.

• أضفنا إمكانية استيعاب عناوين IP لميزة " مطابقة العملاء" في "إعلانات Google" من خلال إرسال IpData في البيانات المركّبة.

• أضفنا أسباب الخطأ الجديدة FIELD_VALUE_TOO_SHORT وTOO_FEW_ELEMENTS و BASELINE_LOCATION_AUTO_DETECTION_FAILED و INSIGHTS_MISSING_FOR_DIMENSION إلى التعداد ErrorReason.

• أضفنا قيمًا جديدة للتشخيص إلى ProcessingErrorReason لتقديم ملاحظات أكثر تفصيلاً عن حالات الفشل أثناء استيعاب الأحداث.

‫07/05/2026 الإصدار 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"
    • إرسال الأحداث
• أضفنا إمكانية إرسال أيّ حدث على الويب أو التطبيق إلى "إحصاءات Google" إذا لم يكن حدثًا محجوزًا.
  • أضفنا الحقل app_instance_id إلى المرجع Event.
  • أضفنا حقولاً إلى DeviceInfo لتقديم بيانات وصفية عن جهاز المستخدِم.
  • أضفنا الحقل mobile_device_id إلى AdIdentifiers.
  • أضفنا الحقل event_location إلى Event لتسجيل حقول مثل city وsubdivision_code وregion_code و subcontinent_code وcontinent_code.
  • يمكنك الاطّلاع على الأدلة التالية للبدء:
    • إرسال الأحداث المقترَحة والمخصّصة
    • الترقية من Measurement Protocol
    • مرجع الأحداث المقترَحة
• أضفنا إمكانية إرسال أيّ حدث يتضمّن رقم تعريف معاملة إلى كلّ من مصادر بيانات الويب والتطبيق ك مصدر بيانات إضافي لعلامتك أو عمليات تنفيذ حزمة تطوير البرامج (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

• أضفنا EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED إلى تعداد ErrorReason.

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

  اعتبارًا من 1 أبريل 2026، قد يتم تقييد العمليات التالية على الحسابات التي لا تتضمّن هذا البيان أو قد تفشل هذه العمليات مع ظهور الخطأ EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED.

  • UserListService (create، update، و delete)
  • IngestionService (ingestAudienceMembers)

  لحلّ هذا الخطأ، على المعلِنين تقديم البيان الإلزامي في واجهة مستخدم "إعلانات Google". مزيد من المعلومات عن كيفية تأكيد البيان لحسابك.

• أضفنا INVALID_MERCHANT_ID إلى الـ ErrorReason تعداد.

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

تتيح واجهة Data Manager API الآن سير العمل الكامل لإدارة شرائح الجمهور، بما في ذلك إنشاء شرائح الجمهور واستيعابها واستردادها.

• أضفنا المرجع UserList و UserListService للسماح بإنشاء قوائم المستخدمين واستردادها وتعديلها وحذفها.
  • يمكنك الاطّلاع على أدلة إعلانات Google أو مساحة العرض والفيديو 360 للحصول على شرح تفصيلي حول كيفية إنشاء شرائح جمهور "مطابقة العملاء" وملؤها و التحقّق منها باستخدام Data Manager API.
  • يمكنك الاطّلاع على أدلة الترقية في إعلانات Google أو مساحة العرض والفيديو 360 لمعرفة خطوات نقل البيانات.
• أضفنا إمكانية إرسال رقم تعريف المستخدِم من خلال استيعاب أعضاء شرائح الجمهور، ما يتيح استخدامه مع ميزة "مطابقة العملاء" في "إعلانات Google".
  • أضفنا UserIdData إلى AudienceMember.
  • أضفنا IngestUserIdDataStatus و RemoveUserIdDataStatus إلى الحالات التي تعرضها الطريقة RetrieveRequestStatus. استخدِم هذه الحقول لاسترداد معلومات التشخيص حول استيعاب أرقام تعريف المستخدِمين وإزالتها.
• أضفنا المرجع PartnerLink و PartnerLinkService لإنشاء الروابط بين حسابات المعلِنين وشركاء البيانات وإدارتها.
  • يمكنك الاطّلاع على أدلة روابط الشركاء للبدء.

2026-02-10

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

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

‫05/11/2025 الإصدار 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" بما يعادلها في Data Manager API في دليل الأحداث.

• أضفنا AwsWrappedKeyInfo لدعم استخدام مفاتيح التشفير من AWS Key Management Service.

• أضفنا قيم تعداد الخيارات التالية إلى 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

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

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

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

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

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

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

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

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

‫06/08/2025 الإصدار 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

‫25/06/2025 الإصدار 1.1

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

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

• هذا هو الإصدار الأول من Data Manager API، وهو يتيح إرسال بيانات الجمهور إلى إعلانات Google ومساحة العرض والفيديو 360.
• أضفنا إمكانية استخدام gRPC و REST.
• أضفنا IngestionService مع IngestAudienceMembers و RemoveAudienceMembers لإدارة أعضاء شرائح الجمهور باستخدام أنواع البيانات التالية:
  • معلومات الاتصال
  • بيانات تعريف رقمية
  • أرقام تعريف ميزة "مطابقة هوية المعلِن والناشر" (PAIR)
• لا تكون شرائح الجمهور التي تتم إدارتها باستخدام Data Manager API مؤهّلة للاستهداف إلا إذا كانت تضم 1,000 عضو على الأقل.