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

يمكنك من هنا التعرّف على التغييرات التي تم إجراؤها في كل إصدار من 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.

  بهدف الامتثال لـ "لائحة الإعلانات السياسية عن الاتحاد الأوروبي"، تطلب 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 عضو على الأقل.