עדכונים ב-Data Manager API: השיטה RemoveAllAudienceMembers, אזהרות לגבי שדות הטמעה, נתוני כתובות מורחבים

יום חמישי, 30 ביולי 2026

הגרסה האחרונה של Data Manager API כוללת תכונות שמפשטות את ניהול הקהלים, משפרות את תהליכי הטמעת הנתונים באמצעות אזהרות ברמת השדה ומאפשרות להשתמש בפרטים מפורטים יותר שהמשתמשים סיפקו ב-Google Analytics.

הסרת כל המשתמשים מקהל היעד

משתמשים ב-method החדש RemoveAllAudienceMembers כדי להסיר את כל החברים מרשימות משתמשים ספציפיות בפעולה אחת. הפרמטר האופציונלי removeAsOfTime מאפשר לטרגט רק את החברים שנוספו לפני חותמת זמן ספציפית.

האפשרות הזו שימושית במיוחד כשצריך לבצע רענון מלא (או "להחליף את הכול") של נתוני הקהל, כי היא מאפשרת לנקות את הרשימה הקיימת ולאכלס אותה בקבוצה חדשה של משתמשים.

אזהרות לגבי שדות הטמעה

התגובות להטמעת נתונים ב-Data Manager API כוללות עכשיו אזהרות מפורטות ברמת השדה לגבי בעיות אימות בשדות אופציונליים. אם ה-API מזהה בעיות אימות בשדות אופציונליים, בקשת ההטמעה תצליח ושאר נתוני ההטמעה עדיין יעובדו. אם יהיו שגיאות אימות בשדות חובה, הבקשה כולה תיכשל בהתאם למודל הכישלון המהיר.

אם אחד מהשדות האופציונליים שאתם מספקים לא תקין, התגובה מ-IngestEventsRequest או מ-IngestAudienceMembersRequest כוללת שדה field_warnings עם רשימה של אובייקטים מסוג FieldWarning. כל אזהרה כוללת סיבה ספציפית (WarningReason), הודעה תיאורית ואת מיקום השדה בבקשה שבה אירעה הבעיה.

נתוני כתובת נוספים לאירועים ב-Google Analytics

עכשיו אפשר לספק פרטים נוספים על כתובת המשתמש כשמטמיעים אירועים ביעדים של Google Analytics. בנוסף לשדות given_name,‏ family_name,‏ region_code ו-postal_code, המשאב AddressInfo תומך עכשיו גם בשדות הבאים:

  • address_line (כתובת)
  • city
  • administrative_area (מדינה או מחוז)

בנוסף, עכשיו אתם יכולים להשתמש בשדה הקיים של פרטים שהמשתמשים מספקים (user_data) כדי לעמוד בדרישה לגבי מזהים של אירועים ממספר מקורות שנשלחים למקורות לנתוני האתר. כך יש לכם אפשרות נוספת כשאין לכם את ad_identifiers.gclid, user_id או client_id לאירוע עם כמה מקורות.

איך מתחילים

פיתוח מהיר יותר בעזרת מיומנויות של סוכני AI: לאחרונה השקנו מיומנויות חדשות של סוכני Data Manager API כדי לעזור לכם לזרז את תהליכי השילוב. במאגר של Google Skills ב-GitHub תוכלו למצוא מיומנויות חדשות שיעזרו לכם לקבל הנחיות מדויקות ויעילות יותר ישירות בסביבת התכנות בעזרת AI.

אם יש לכם שאלות או שאתם רוצים לדון בפוסט הזה, אתם יכולים לפנות אלינו בשרת ה-Discord‏ "Google Advertising and Measurement Community". אם נתקלתם בבעיה או שאתם צריכים עזרה עם ה-API, אתם יכולים גם לפנות אלינו דרך דף התמיכה.

אם אתם רוצים להצטרף כשותפי נתונים, אתם יכולים למלא את טופס ההתעניינות להצטרפות כשותף.

תמונת דיוקן של המחבר ‫– לינדזי וולטה, בשם צוות Data Manager API

תוויות: analytics, data-manager-api