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

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

‫2026-07-30 الإصدار 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 لإتاحة تتبُّع كميات الإحالات الناجحة.

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

• تمت إضافة الحقل 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 لتقديم ملاحظات أكثر تفصيلاً بشأن حالات الفشل أثناء استيعاب الأحداث.

‫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"
    • إرسال الأحداث
• تمّت إضافة إمكانية إرسال أيّ حدث على الموقع الإلكتروني أو التطبيق إلى "إحصاءات 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.

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

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

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

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

• تمت إضافة INVALID_MERCHANT_ID إلى التعداد ErrorReason.

‫2026-02-17 الإصدار 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" إلى القائمة المسموح بها.

‫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‏ (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

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

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