רשימות קהלים חוזרות

במסמך הזה מתוארות רשימות קהלים חוזרות, של Google Analytics Data API v1. להיכרות עם תכונת הייצוא של רשימות קהלים: אפשר לעיין במדריך הבסיסי על ייצוא קהלים.

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

רשימות קהלים רגילות (חד-פעמיות) הן רשימות סטטיות של המשתמשים בקהל בזמן שהרשימה נוצרת.

יצירה של רשימת קהלים חדשה מדי יום

נדרש פרק זמן משתנה כדי לעבד את נתוני הקהל של יום אחד ולעדכן אותם מועדון החברים. אין דרך לוודא שהנתונים של רשימת החברים בקהל מעודכנים 24 שעות.

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

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

עריכת סקרים תקופתיים ברשימת החברים בקהל

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

יצירת רשימת קהלים חוזרת

כדי ליצור רשימה חוזרת של חברים בקהל, recurringAudienceLists.create באמצעות הפונקציה RecurringAudienceList בבקשה. הפרמטרים הבאים נדרשים:

• שם חוקי של הקהל בשדה audience בפורמט properties/{propertyId}/audiences/{audienceId}. אפשר להשתמש audiences.list של Google Analytics Admin API v1 כדי לקבל את הערך הזה. Audience.name השדה של התשובה audiences.list מכיל את שם הקהל.
• רשימה חוקית של מאפיינים dimensions השדה הזה. ניתן למצוא רשימת מאפיינים שנתמכים בשיטה הזו מסמכי תיעוד בנושא סכימת ייצוא קהלים. רק הנתונים של המאפיינים שצוינו בשדה הזה נכללים רשימת חברים בקהל.

דוגמה לבקשה חוזרת ליצירת רשימת חברים בקהל:

בקשת HTTP

POST https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists
{
  "audience": "properties/1234567/audiences/12345",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ]
}

תשובה של ה-method recurringAudienceLists.create מכילה את המחרוזת השם בשדה name (למשל properties/1234567/recurringAudienceLists/123), שניתן להשתמש בו ב: של השאילתות הבאות כדי לאחזר את המטא-נתונים של התצורה לרשימה החוזרת של החברים בקהל. בנוסף, המטא-נתונים של ההגדרה מכילים שמות משאבים למופעים של רשימות קהלים נוצר עבור רשימת החברים בקהל החוזרת הזו.

תגובת HTTP

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

מטא-נתונים של הגדרות הסקר

משתמשים ב recurringAudienceLists.get שיטה לאחזור מטא-נתונים של תצורה לגבי רשימת חברים בקהל. המטא-נתונים של ההגדרה מכילים שמות משאבים למופעים של רשימות קהלים נוצר עבור רשימת החברים בקהל החוזרת הזו.

לדוגמה:

בקשת HTTP

GET https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists/123

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

תגובת HTTP

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

אפשר להשתמש recurringAudienceLists.list כדי להציג רשימה של כל רשימות הקהלים החוזרות בנכס מסוים.

אפשר להשתמש בתגובה לפעולה מאתר אחר (webhook) כדי לקבל התראות אסינכרוניות לגבי רשימות קהלים חדשות

במקום לדגום מדי פעם את המטא-נתונים של התצורה לגבי מאפיין ספציפי רשימה חוזרת של חברים בקהל באמצעות recurringAudienceLists.get אפשר לקבל באופן אסינכרוני התראות על תגובה לפעולה מאתר אחר (webhook) כשקהל תהפוך לזמינה.

כדי להגדיר התראות של תגובה לפעולה מאתר אחר (webhook), צריך לציין webhookNotification בזמן יצירת רשימה חוזרת חדשה של חברים בקהל.

פועלים לפי המדריך של Async audience lists with webhooks למידע נוסף על השימוש בתגובה לפעולה מאתר אחר (webhook) ב-Google Analytics Data API v1.

אחזור משתמשים בייצוא קהלים

כדי לאחזר משתמשים בייצוא קהלים, צריך להפעיל את audienceExports.query ומציינים את השם של ייצוא הקהלים אוחזרו מהמטא-נתונים של ההגדרות שסופקו על ידי recurringAudienceLists.get או recurringAudienceLists.list.

בקשת 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
}