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

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

‫2026-05-28 الإصدار 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.

  يمكنك الاطّلاع على مزيد من المعلومات عن إرسال أحداث purchase في "إحصاءات Google" وكيفية ربط مَعلمات أحداث وخصائص مستخدمي "إحصاءات Google" بمكافئاتها في واجهة برمجة التطبيقات الخاصة بأداة "إدارة بيانات إعلانات Google" في دليل الأحداث.

• تمت إضافة 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 لإضافة معلومات 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 عضو على الأقل.