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

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

פורמט: 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 כדי לקבוע מתי רשימות קהלים חוזרות ייווצרו רשימות קהלים חדשות. תגובות לפעולה מאתר אחר (webhook) מאפשרות לשלוח התראה לשרתים שלכם להימנע מהצורך בסקרים.

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

שיטות

create

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

get

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

list

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