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 جداگانه برای هر شناسه تا حداکثر تعداد شناسه اضافه کنید.
بهینه سازی درخواست ها
برای کاهش احتمال تجاوز از محدودیت‌های درخواست روزانه، تا حد امکان در هر درخواست، موارد را تا سقف هر درخواست دسته‌بندی کنید.
به عنوان مثال، اگر می‌خواهید 10000 مخاطب را به یک مخاطب اضافه کنید، همه 10000 عضو در لیست audience_members را در یک IngestAudienceMembersRequest اضافه کنید. جمع کردن همه 10000 عضو در یک درخواست بسیار کارآمدتر از ارسال یک درخواست جداگانه برای افزودن هر مخاطب است.
ارسال درخواست های همزمان
برای کاهش زمان کلی لازم برای دریافت داده‌ها، درخواست‌های همزمان را به IngestionService ارسال کنید. توصیه می کنیم حداکثر 10 درخواست را به طور همزمان ارسال کنید تا احتمال تجاوز از محدودیت در دقیقه کاهش یابد.
شما می توانید درخواست های همزمان ارسال کنید حتی اگر درخواست ها destinations مشابهی داشته باشند.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[],[],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`."]]
