קהלים ב-Google Analytics 4 מאפשרים לפלח את המשתמשים בדרכים בעלות משמעות לעסק. באמצעות קהלים אפשר לקבץ משתמשים באתר או באפליקציה על סמך מאפיינים משותפים.
באמצעות Google Analytics Data API v1 אפשר ליצור פעולות ייצוא של קהלים, שכוללות תמונת מצב של המשתמשים בקהל.
יצירה של ייצוא קהלים
Google Analytics Data API v1 משתמש בגישה אסינכרונית ליצירת ייצוא קהלים. קודם כול, צריך בקשה ל-method audienceExports.create כדי ליצור ייצוא קהלים של משתמשים. לאחר מכן, השיטה audienceExports.query משמשת כדי לאחזר את המשתמשים בקהל.
בנוסף, אפשר להשתמש ב-audienceExports.get כדי לאחזר את המטא-נתונים של ההגדרות של ייצוא קהלים ספציפי, וב-audienceExports.list כדי להציג רשימה של כל ייצוא הקהלים בנכס מסוים.
צריך לבחור ישות לדיווח
בכל השיטות של Data API v1 צריך לציין את מזהה נכס Google Analytics 4 בתוך נתיב הבקשה לכתובת URL, בפורמט properties/GA4_PROPERTY_ID. לדוגמה:
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/audienceExports
הדוח נוצר על סמך נתוני האירוע ב-Google Analytics שנאספים בנכס Google Analytics 4 שצוין.
אם אתם משתמשים באחת מספריות הלקוח של Data API, אין צורך לשנות את נתיב כתובת ה-URL של הבקשה באופן ידני.
רוב לקוחות ה-API מספקים פרמטר property שמצפה למחרוזת בפורמט properties/GA4_PROPERTY_ID.
במדריך למתחילים מוצגות דוגמאות לשימוש בספריות הלקוח.
בקשת יצירה של ייצוא קהלים
כדי ליצור ייצוא קהלים, צריך להפעיל את השיטה audienceExports.create באמצעות האובייקט AudienceExport שבבקשה. הפרמטרים הבאים נדרשים:
- שם קהל חוקי בשדה
audience, בפורמטproperties/{propertyId}/audiences/{audienceId}. כדי לקבל את הערך הזה, אפשר להשתמש ב-methodaudiences.listב-Google Analytics Admin API v1. השדהAudience.nameבתשובהaudiences.listמכיל את שם הקהל. - רשימה חוקית של מאפיינים בשדה
dimensions. במסמכי התיעוד של סכימת ייצוא קהלים מופיעה רשימת המאפיינים שנתמכים בשיטה הזו. רק הנתונים של המאפיינים המוזכרים בשדה הזה כלולים בייצוא קהלים.
בקשה לדוגמה ליצירת ייצוא קהלים:
בקשת HTTP
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports
{
"audience": "properties/1234567/audiences/12345",
"dimensions": [
{
"dimensionName": "deviceId"
}
]
}
התשובה שמבוצעת באמצעות השיטה audienceExports.create מכילה את השם של ייצוא הקהלים בשדה name (למשל properties/1234567/audienceExports/123). אפשר להשתמש בו בשאילתות הבאות כדי לאחזר את המשתמשים מייצוא הקהלים.
תגובת HTTP
{
"response": {
"@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceExport",
"name": "properties/1234567/audienceExports/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"state": "CREATING",
"beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}
}
שליחת שאילתה על מצב המוּכנוּת של ייצוא הקהלים
יכול להיות שיחלפו כמה דקות עד שייצוא הקהלים ייווצר אחרי השיחה audienceExports.create. אפשר לבדוק את מצב המוּכנוּת של ייצוא הקהלים באמצעות קריאה לשיטה audienceExports.get.
השתמשו בשם של ייצוא הקהלים (למשל, properties/1234567/audienceExports/123) שקיבלתם מתגובה audienceExports.create כדי לציין את ייצוא הקהלים.
דוגמה:
בקשת HTTP
GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123
סטטוס המוּכנוּת של ייצוא הקהלים מוחזר בשדה state של התשובה. אחרי שהיצירה של ייצוא הקהלים תסתיים, המצב שלו ישתנה מ-CREATING ל-ACTIVE.
תגובת HTTP
{
"name": "properties/1234567/audienceExports/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"state": "CREATING",
"beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}
אפשר לבדוק את המצב של כל ייצוא הקהלים על ידי קריאה לשיטה audienceExports.list.
אחזור משתמשים בייצוא קהלים
אחרי שיוצרים את ייצוא הקהלים באמצעות השיטה audienceExports.create, קוראים לשיטה audienceExports.query ומציינים את השם של ייצוא הקהלים (למשל properties/1234567/audienceExports/123).
בקשת HTTP
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query
אם ייצוא הקהלים מוכן, מוחזרת תשובה שמכילה את רשימת המשתמשים בקהל:
תגובת HTTP
{
"audienceExport": {
"name": "properties/1234567/audienceExports/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"state": "ACTIVE",
"beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
},
"audienceRows": [
{
"dimensionValues": [
{
"value": "1000276123.1681742376"
}
]
},
{
"dimensionValues": [
{
"value": "1000374452.1668627377"
}
]
},
{
"dimensionValues": [
{
"value": "1000391956.1652750758"
}
]
},
{
"dimensionValues": [
{
"value": "1000410539.1682018694"
}
]
},
{
"dimensionValues": [
{
"value": "1000703969.1666725875"
}
]
}
],
"rowCount": 5
}
ציפיות לנתונים של ייצוא קהלים
בקטע הבא מפורטות ציפיות לנתונים לגבי חברויות של משתמשים בייצוא קהלים.
עדכניות הנתונים
עדכניות הנתונים של ייצוא הקהלים מייצגת את משך הזמן שנדרש ל-Google Analytics לאסוף אירועים, לעבד אירועים ואז לעדכן את סטטוס החברות של משתמשים בקהלים. אם התהליך נמשך 24 שעות, עדכניות הנתונים של ייצוא הקהלים היא 24 שעות. מידע נוסף זמין במאמר עדכניות הנתונים.
לדוגמה, אם משתמש משלים את הרכישה הראשונה שלו, ולאחר מכן 7 שעות מאוחר יותר, אתם יוצרים ייצוא קהלים לקהל 'רוכשים', כמעט בטוח שהמשתמש לא יופיע עדיין בייצוא הקהלים של 'רוכשים'. 14 עד 38 שעות אחרי הרכישה הראשונה, סביר להניח שהמשתמש הזה יעבור לפעולות ייצוא חדשות של קהלים.
ייצוא קהלים הוא תמונות מצב
ייצוא קהלים הוא רשימה של המשתמשים בקהל שמתקבלת תמונת מצב עדכנית לאורך זמן. במקרה של רימרקטינג ב-Google Ads, מערכת Google Analytics מייצאת באופן אוטומטי ורציף משתמשים בקהלים אל Google Ads. לעומת זאת, כשייצוא קהלים נוצר באמצעות Data API v1, צריך ליצור ייצוא קהלים חדש כדי לראות את המשתמשים האחרונים בקהל הזה.
ייצוא הקהלים נוצר על סמך המינויים העדכניים ביותר של המשתמשים. עם זאת, בייצוא קהלים יכולה להיות עדכניות נתונים של 20 שעות לדוגמה, ומשמעות הדבר היא שייצוא הקהלים יתבסס על כל האירועים מ-20 השעות לפני הרגע הנוכחי.
נתוני המינוי העדכניים מתעדכנים פעם ביום, בדרך כלל במהלך שעות היום באזור הזמן של הנכס. כלומר, סביר להניח שייצוא קהלים לאותו הקהל בשעות 9:00 ו-11:00 יחזיר את אותם הנתונים, אבל ייצוא קהלים בשעה 15:00 עשוי להיות שונה בהתאם להכללת נתונים של יום נוסף.
התפוגה של ייצוא הקהלים
התוקף של ייצוא קהלים פג אחרי 72 שעות. בכל יום, משתמשים חדשים יכולים להיכנס לקהל ולצאת ממנו. כדי לקבל את תמונת המצב העדכנית של המשתמשים, צריך ליצור פעולות חדשות של ייצוא קהלים לכל יום.
המגבלות על המשתמשים בכלי לייצוא קהלים
כשהגודל של קהל או נכס חורג ממגבלת המשתמשים, ייצוא הקהלים מחזיר דגימות מייצגים של הקהל. המגבלות האלו תלויות בסוג הנכס (כלומר נכס רגיל או נכס 360) והן נאכפות בכל ייצוא קהלים בנפרד. משתמשים חוזרים הם משתמשים בקהל המבוקש, ומשתמשים שנחשבים כמשתמשים הם משתמשים שייתכן שהם חלק מהקהל או לא.
| סוג מגבלה | מגבלות בנכסים רגילים | מגבלות נכסים ב-Analytics 360 |
|---|---|---|
| מספר מקסימלי של משתמשים שחזרו | 2 מיליון | 200 מיליון |
| מספר מקסימלי של משתמשים שיש להם התעניינות ברכישה מהם | 10 מיליון | מיליארד |
עקביות של זהות המדווח
ההגדרה זיהוי של מי שמדווח קובעת איך מתבצע ביטול הכפילויות של המשתמשים בדוחות. הייצוא של קהלים לא משתנה בהתאם להגדרה של זהות המדווח. תהליכי ייצוא קהלים תמיד מזהים משתמשים לפי User-ID ואז מזהה המכשיר.
פירוש הדבר הוא שבדוחות על קהל מסוים יכולים להופיע יותר משתמשים ממה שמוצג ב'ייצוא קהלים'. לדוגמה, במקרה שהזיהוי של מי שמדווח הוא 'מבוסס מכשיר' ונאסף User ID, לא יתבצע ביטול כפילויות של משתמשים על סמך מזהה המשתמש, אבל בייצוא קהלים יבוטלו הכפילויות לפי מזהה המשתמש.
עקביות במילוי חוסרים (backfill)
כשיוצרים קהל ב-Google Analytics ומפעילים רימרקטינג ב-Google Ads, מערכת Google Analytics משלימה את החברים שנוספו לאחרונה לקהל הזה כדי למלא את החוסרים בקהל הזה ב-Google Ads. עם זאת, דוחות Google Analytics וייצוא קהלים לא כוללים את הנתונים החסרים שהושלמו לגבי החברים בקהל. צריך להיות מתועד אירוע של המשתמש הזה אחרי יצירת הקהל כדי שהמשתמש יוצג בקהל הזה בדוחות ובייצוא של קהלים.
לדוגמה, אם מתועד אירוע רכישה של המשתמש הזה ב-20 ביוני ואתם יוצרים קהל 'רוכשים' ב-21 ביוני, סביר להניח שתצטרכו להמתין עד 22 ביוני כדי שתהיה אפשרות לראות את המשתמש הזה בייצוא הקהלים החדש. עם זאת, המשתמש הזה יופיע בייצוא הקהלים רק אם תועד אירוע כלשהו של המשתמש ב-21 ביוני.