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 (שעון UTC).
[[["התוכן קל להבנה","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 (שעון UTC)."],[],[],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`."]]
