The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
أفضل الممارسات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ضَع في اعتبارك أفضل الممارسات التالية عند استخدام Data Manager API.
إرسال جميع معرّفات المستخدمين
سواء كنت ترسل أفرادًا من الجمهور أو أحداثًا باستخدام UserData، أدرِج أكبر عدد ممكن من
user_identifiers، بما في ذلك إرسال معرّفات متعددة من
النوع نفسه.
على سبيل المثال، إذا كان لديك عناوين بريد إلكتروني متعددة لمستخدم معيّن، أدرِج UserIdentifier منفصلاً لكل عنوان بريد إلكتروني. وبالمثل، إذا كانت لديك معرّفات
بأنواع مختلفة لمستخدم معيّن، مثل عناوين البريد الإلكتروني وأرقام الهواتف
والعناوين، أضِف UserIdentifier منفصلاً لكل معرّف، حتى الحد الأقصى لعدد المعرّفات.
تحسين الطلبات
لتقليل احتمالية تجاوز الحدود القصوى للطلبات اليومية، يمكنك تجميع أكبر عدد ممكن من
العناصر في كل طلب، بما يصل إلى الحدود القصوى المفروضة على كل طلب.
على سبيل المثال، إذا كنت تريد إضافة 10,000 عضو من الجمهور إلى شريحة جمهور، أضِف كل
10,000 عضو في قائمة audience_members في
IngestAudienceMembersRequest واحد. إنّ تجميع جميع الأعضاء البالغ عددهم 10,000 عضو
في طلب واحد هو أكثر فعالية بكثير من إرسال طلب منفصل لإضافة
كل عضو من الجمهور.
إرسال طلبات متزامنة
لتقليل الوقت الإجمالي المطلوب لتحميل البيانات، أرسِل طلبات متزامنة
إلى IngestionService. ننصحك بإرسال ما يصل إلى 10
طلبات في الوقت نفسه لتقليل احتمالية تجاوز الحدّ الأقصى للطلبات في
الدقيقة.
يمكنك إرسال طلبات متزامنة حتى إذا كانت الطلبات تتضمّن
destinations نفسه.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Best practices\n\nKeep the following best practices in mind when using the Data Manager API.\n\nSend all user identifiers\n-------------------------\n\nWhether sending audience members or events with [`UserData`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#userdata), include as many\n`user_identifiers` as possible, including sending multiple identifiers of the\nsame type.\n\nFor example, if you have multiple email addresses for a user, include a separate\n[`UserIdentifier`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#useridentifier) for each email address. Similarly, if you have identifiers of\ndifferent types for a user, such as email addresses, phone numbers, and\naddresses, add a separate `UserIdentifier` for each identifier, up to the\n[maximum identifier count](/data-manager/api/limits#request_limits).\n\nOptimize requests\n-----------------\n\nTo reduce the likelihood of exceeding daily request limits, batch as many\nitems as possible in each request, up to the [per-request\nlimits](/data-manager/api/limits#request_limits).\n\nFor example, if you want to add 10,000 audience members to an audience, add all\n10,000 members in the `audience_members` list in one\n[`IngestAudienceMembersRequest`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#ingestaudiencemembersrequest). Batching all 10,000 members\nin a single request is far more efficient than sending a separate request to add\neach audience member.\n\nSend concurrent requests\n------------------------\n\nTo reduce the overall time required to ingest data, send concurrent requests\nto the [`IngestionService`](/data-manager/api/reference/rpc/google.ads.datamanager.v1#ingestionservice). We recommend sending up to 10\nrequests concurrently to reduce the likelihood of exceeding the [requests per\nminute limit](/data-manager/api/limits#project_limits).\n\nYou can send concurrent requests even if the requests have the same\n`destinations`."]]
