שיטות מומלצות

כשמשתמשים ב-Data Manager API, חשוב לזכור את השיטות המומלצות הבאות.

שליחת כל מזהי המשתמשים

כששולחים חברים בקהל או אירועים עם UserData, חשוב לכלול כמה שיותר user_identifiers, כולל שליחה של כמה מזהים מאותו סוג.

לדוגמה, אם יש למשתמש כמה כתובות אימייל, צריך לכלול תג UserIdentifier נפרד לכל כתובת אימייל. באופן דומה, אם יש לכם מזהים מסוגים שונים של משתמש, כמו כתובות אימייל, מספרי טלפון וכתובות, מוסיפים תג UserIdentifier נפרד לכל מזהה, עד המספר המקסימלי של מזהים.

אופטימיזציה של בקשות

כדי להקטין את הסיכוי לחריגה מהמגבלות היומיות על מספר הבקשות, כדאי לאגד כמה שיותר פריטים בכל בקשה, עד המגבלות לכל בקשה.

לדוגמה, אם רוצים להוסיף 10,000 חברים לקהל, צריך להוסיף את כל 10,000 החברים בaudience_members הרשימה בIngestAudienceMembersRequest אחת. יותר יעיל לקבץ את כל 10,000 משתמשים מקהל היעד בבקשה אחת מאשר לשלוח בקשה נפרדת להוספה של כל משתמש מקהל היעד.

שליחת בקשות בו-זמנית

כדי לקצר את הזמן הכולל שנדרש להטמעת נתונים, אפשר לשלוח בקשות בו-זמניות אל IngestionService. מומלץ לשלוח עד 10 בקשות בו-זמנית כדי להקטין את הסיכוי לחרוג ממגבלת הבקשות לדקה.

אפשר לשלוח בקשות בו-זמנית גם אם הבקשות כוללות את אותו destinations.

שימוש ב-validateOnly כדי לבדוק אם יש שגיאות שגורמות לכשל מהיר

שולחים בקשות עם הערך true של validateOnly כדי לזהות שגיאות של כשל מהיר. ‫Data Manager API מריץ את אותם בדיקות אימות כמו בקשה רגילה, אבל לא מטמיע או מסיר נתונים.

בקשה שכוללת רק אימות ולא ייצוא לא מבטיחה שלא יהיו שגיאות במהלך העיבוד, לכן חשוב להמשיך לבדוק את האבחון אחרי ששולחים בקשה רגילה.

בדיקת דוח האבחון

מצלמים ואוספים את request_id מכל IngestAudienceMembersResponse או IngestEventsResponse, ומשתמשים במזהי הבקשות כדי לבדוק את האבחון.

מעקב אחרי מכסות וקבלת התראות

כדי למנוע דחייה לא צפויה של בקשות, מומלץ להגדיר התראות על הגעה למכסה ומעקב במסוף Google Cloud. מעקב אחרי השימוש במכסות עוזר לכם לעקוב אחרי דפוסי הצריכה ולבצע אופטימיזציה של אצווה של בקשות לפני שהאפליקציה מגיעה למגבלות יומיות או למגבלות לדקה.

פריסה בסביבת הייצור

כשעוברים מבדיקות מקומיות לעומסי עבודה בייצור, מומלץ להשתמש בApplication Default Credentials עם חשבון שירות מצורף או באיחוד שירותי אימות הזהות של עומסי עבודה כדי לבצע אימות לא אינטראקטיבי ומאובטח.

פרטים על הגדרת אימות בסביבות ייצור שונות זמינים במאמר פריסה לייצור.