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

في ما يلي يمكنك الاطّلاع على التغييرات التي تم إجراؤها في كل إصدار من 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 لتقديم ملاحظات أكثر دقة حول حالات الفشل أثناء نقل الأحداث.

‫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.

  يمكنك الاطّلاع على مزيد من المعلومات عن إرسال أحداث "إحصاءات Google"‏ (purchase) وكيفية ربط مَعلمات الأحداث وخصائص المستخدمين في "إحصاءات 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

‫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

‫25-06-2025، الإصدار 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 عضو على الأقل.