The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
ملاحظات حول الإصدار
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك هنا التعرّف على التغييرات التي تم إجراؤها في كل إصدار من Data Manager API.
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_LEADSDESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONSDESTINATION_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 لإدارة أعضاء شرائح الجمهور باستخدام أنواع البيانات التالية:
- لا تكون شرائح الجمهور المُدارة باستخدام Data Manager API مؤهَّلة للاستهداف إلا إذا كانت تتضمّن 1,000 عضو على الأقل.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-08 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-08 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Release notes\n\nHere's where you can learn what's changed in each Data Manager API release.\n\n2025-08-06 v1.2\n---------------\n\n- Added support for [sending offline\n conversions and enhanced conversions for leads](/data-manager/api/get-started/quickstart/send-events) to Google Ads destinations using the [`IngestEvents`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#ingestionservice) method. See the [updated encryption guide](/data-manager/api/get-started/encryption) for how to configure encryption for these conversions.\n- Added `APP`, `IN_STORE`, `PHONE`, and `OTHER` values to the [`EventSource`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#eventsource) enum. An `event_source` is required for offline conversions and enhanced conversions for leads.\n- Added the `user_properties` field to [`Event`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#event). Set this field to a [`UserProperties`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#userproperties) object to add [advertiser-assessed\n information](//support.google.com/google-ads/answer/14007601) about a user when the event occurred.\n- Added a `destination_references` repeated field to [`CustomVariable`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#customvariable). Use this field to apply a custom variable value to only a subset of the destinations for an `Event`.\n- Added the following errors for offline conversions and enhanced conversions for leads:\n - `DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS`\n - `DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS`\n - `DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED`\n\n2025-06-25 v1.1\n---------------\n\n- Added the [`IngestEvents`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#ingestionservice) method to the `IngestionService`. [Use\n IngestEvents](/data-manager/api/get-started/quickstart/send-events) as an additional data source for your tag conversions, to maximize ad interaction signals and strengthen your data and overall performance.\n\n2025-04-02 v1.0\n---------------\n\n- First release of the Data Manager API, with support for sending audience data to [Google Ads](//ads.google.com/) and [Display \\& Video\n 360](//marketingplatform.google.com/about/display-video-360/).\n- Added support for [gRPC](/data-manager/api/reference/rpc/google.ads.datamanager.v1) and [REST](/data-manager/api/reference/rest).\n- Added the [IngestionService](/data-manager/api/reference/rpc/google.ads.datamanager.v1#ingestionservice) with `IngestAudienceMembers` and `RemoveAudienceMembers` methods for managing audience members using the following data types:\n - [Contact information](/data-manager/api/reference/rpc/google.ads.datamanager.v1#useridentifier)\n - [Mobile IDs](/data-manager/api/reference/rpc/google.ads.datamanager.v1#mobiledata)\n - [PAIR IDs](/data-manager/api/reference/rpc/google.ads.datamanager.v1#pairdata)\n- Audiences managed using the Data Manager API are only eligible for targeting if they have at least 1,000 members."]]
