יצירה של ייצוא קהלים

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

תוכלו לייצא את הקהלים שלכם, כולל תמונת מצב של המשתמשים שלהם, באמצעות Data API.

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

סקירה כללית

כדי ליצור ייצוא קהלים ולשליחת שאילתות לגביו, צריך לשלוח את הבקשות הבאות ל-Data API:

  1. קוראים לaudienceExports.create. כדי ליצור ייצוא קהלים.
  2. קוראים לaudienceExports.query. משמשת לאחזור המשתמשים בקהל.

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

צריך לבחור ישות לדיווח

לכל ה-methods של Data API נדרש הנכס ב-Google Analytics ש יצוין בנתיב בקשה של כתובת URL, של properties/GA_PROPERTY_ID. לדוגמה:

  POST  https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/audienceExports

הדוח נוצר על סמך נתוני האירועים ב-Google Analytics שנאספים במסגרת בנכס Google Analytics שצוין.

אם אתם משתמשים באחת מספריות הלקוח של Data API, לא צריכים לשנות את נתיב כתובת ה-URL של הבקשה. רוב לקוחות ה-API מספקים property שמצפה למחרוזת בצורה properties/GA_PROPERTY_ID. צפייה מדריך למתחילים כדי לראות דוגמאות לשימוש ספריות לקוח.

יצירה של ייצוא קהלים

כדי ליצור ייצוא קהלים, מפעילים את השיטה audienceExports.create עם AudienceExport שבבקשה שלכם. הפרמטרים הבאים נדרשים:

  • שם חוקי של קהל בaudience בפורמט properties/{propertyId}/audiences/{audienceId}. אפשר להשתמש audiences.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"
  }
}

אפשר להשתמש ברכיב name כדי לשלוח שאילתה על המשתמשים מייצוא הקהלים.

שליחת שאילתה על מצב המוכנות של ייצוא הקהלים

ייצוא הקהלים עשוי להימשך כמה דקות. audienceExports.create שיחה.

כדי לבדוק את מצב המוכנות של ייצוא קהלים, שולחים אל audienceExports.get.

צריך להשתמש בשם של ייצוא הקהל מתשובה מסוג 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.query ומציינים את name של ייצוא הקהל בבקשה.

הנה בקשה לדוגמה:

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