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

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

‫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" بما يعادلها في 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

‫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 عضو على الأقل.