REST Resource: properties.recurringAudienceLists

משאב: RecurringAudienceList

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

ייצוג ב-JSON 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
שדות
name

string

פלט בלבד. מזהה. שם המשאב של רשימת הקהלים החוזרת שהוקצה במהלך היצירה. שם המשאב הזה מזהה את ה-RecurringAudienceList הזה.

פורמט: properties/{property}/recurringAudienceLists/{recurringAudienceList}
audience

string

חובה. השם של משאב הקהל. שם המשאב הזה מזהה את הקהל שמופיע ברשימה, והוא משותף בין ממשקי ה-API של Analytics לנתונים ולאדמין.

פורמט: properties/{property}/audiences/{audience}
audienceDisplayName

string

פלט בלבד. השם המוצג התיאורי של הקהל הזה. לדוגמה, 'קונים'.
dimensions[]

object (AudienceDimension)

חובה. המאפיינים שביקשת ומוצגים בתגובה של רשימת הקהלים.
audienceLists[]

string

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

הרשימה הזו ממוינת כך שרשימת הקהלים שנוצרה לאחרונה מופיעה ראשונה.
activeDaysRemaining

integer

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

ברירת המחדל של בקשה ליצירת רשימת קהלים קבועה בנכסי Analytics 360 היא 180 יום, והיא יכולה להיות למשך 365 יום לכל היותר. ברירת המחדל לבקשות לגבי נכסי Analytics רגילים היא 14 ימים, והמשך המקסימלי הוא 30 ימים.

הערך המינימלי המותר במהלך היצירה הוא 1. בקשות שמחריגות מהמגבלה המקסימלית שלהן יכופו למגבלה המקסימלית.
webhookNotification

object (WebhookNotification)

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

שתי בקשות POST יישלחו בכל פעם שרשימת חברים בקהל קבועה יוצרת רשימת חברים בקהל. התהליך הזה מתבצע פעם ביום עד שיהיו 0 ימים פעילים שנותרו ברשימה של קהל קבוע. הבקשה הראשונה תישלח עם רשימה חדשה של חברים בקהל שנוצרה, במצב 'יצירה'. הבקשה השנייה תישלח אחרי השלמת היצירה של רשימת הקהלים (בסטטוס 'פעיל' או 'נכשל').

Methods

create

 יצירת רשימת קהל קבועה.

get

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

list

 רשימה של כל רשימות הקהלים הקבועות של נכס.