כשמשתמשים ב-Data Manager API, חשוב לזכור את השיטות המומלצות הבאות.
שליחת כל מזהי המשתמשים
לא משנה אם אתם שולחים משתמשים מקהל היעד או אירועים באמצעות UserData, כדאי לכלול כמה שיותר user_identifiers, כולל שליחת כמה מזהים מאותו סוג.
לדוגמה, אם יש לכם כמה כתובות אימייל של משתמש, צריך לכלול UserIdentifier נפרד לכל כתובת אימייל. באופן דומה, אם יש לכם מזהים מסוגים שונים של משתמש, כמו כתובות אימייל, מספרי טלפון וכתובות, הוסיפו UserIdentifier נפרד לכל מזהה, עד מספר המזהים המקסימלי.
בקשות לאופטימיזציה
כדי להפחית את הסיכוי לחרוג ממגבלות הבקשות היומיות, כדאי לאסוף כמה שיותר פריטים בכל בקשה, עד למגבלות לכל בקשה.
לדוגמה, אם רוצים להוסיף 10,000 משתמשים מקהל היעד לקהל, צריך להוסיף את כל 10,000 משתמשים מקהל היעד לרשימה audience_members בIngestAudienceMembersRequest אחת. הרבה יותר יעיל לשלוח בקשה אחת עם כל 10,000 משתמשים מקהל היעד מאשר לשלוח בקשה נפרדת לכל משתמש מקהל היעד.
שליחת בקשות מקבילות
כדי לקצר את הזמן הכולל שנדרש להטמעת נתונים, שלחו בקשות מקבילות אל IngestionService. מומלץ לשלוח עד 10 בקשות בו-זמנית כדי להפחית את הסבירות לחריגה ממגבלת הבקשות לדקה.
אפשר לשלוח בקשות בו-זמנית גם אם יש להן אותו ערך של destinations.
אפשר להשתמש ב-validateOnly כדי לבדוק אם יש שגיאות של כשל מהיר
שולחים בקשות שבהן validateOnly מוגדר ל-true כדי לזהות שגיאות של כשל מהיר. Data Manager API מפעיל את אותן בדיקות אימות כמו בקשה רגילה, אבל לא מטמיע או מסיר נתונים.
בקשה מוצלחת לאימות בלבד לא מבטיחה שלא יהיו שגיאות במהלך העיבוד, לכן המשיכו לבדוק את האבחון אחרי שאתם שולחים בקשה רגילה.
בדיקת דוח האבחון
מתעדים ואוספים את הערך של request_id מכל IngestAudienceMembersResponse או IngestEventsResponse, ומשתמשים במזהי הבקשות כדי לבדוק את האבחון.
מעקב אחרי מכסות וקבלת התראות
כדי למנוע דחייה לא צפויה של בקשות, הגדירו התראות על הגעה למכסה ומעקב במסוף Google Cloud. מעקב אחרי השימוש במכסות עוזר לכם לזהות דפוסי צריכה ולשפר את אופן הטיפול בבקשות באצווה, לפני שהאפליקציה מגיעה למגבלות היומיות או למגבלות לדקה.
פריסה בסביבת הייצור
כשעוברים מבדיקות מקומיות לעומסי עבודה בסביבת הייצור, משתמשים בApplication Default Credentials עם חשבון שירות מצורף או עם איחוד זהויות של עומסי עבודה (WIF), כדי לבצע אימות באופן מאובטח וללא אינטראקציה.
לפרטים על הגדרת אימות לסביבות ייצור שונות, ראו פריסה בסביבת ייצור.