REST Resource: properties.audiences

{
  "name": string,
  "displayName": string,
  "description": string,
  "membershipDurationDays": integer,
  "adsPersonalizationEnabled": boolean,
  "eventTrigger": {
    object (AudienceEventTrigger)
  },
  "exclusionDurationMode": enum (AudienceExclusionDurationMode),
  "filterClauses": [
    {
      object (AudienceFilterClause)
    }
  ],
  "createTime": string
}

string

פלט בלבד. שם המשאב של משאב הקהל הזה. פורמט: properties/{propertyId}/audiences/{audienceId}

string

חובה. השם המוצג של הקהל.

string

חובה. תיאור הקהל.

integer

חובה. בלתי ניתן לשינוי. משך הזמן שמשתמש צריך להישאר בקהל. אי אפשר להגדיר הארכה של יותר מ-540 ימים.

boolean

פלט בלבד. אם זהו קהל ללא התאמה אישית (NPA), הוא מוגדר באופן אוטומטי על ידי GA כ-FALSE אם הוא מוחרג מההתאמה האישית של המודעות.

object (AudienceEventTrigger)

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

enum (AudienceExclusionDurationMode)

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

object (AudienceFilterClause)

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

string (Timestamp format)

פלט בלבד. השעה שבה הקהל נוצר.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

{
  "eventName": string,
  "logCondition": enum (LogCondition)
}

string

חובה. שם האירוע שיירשם ביומן.

enum (LogCondition)

חובה. מתי לתעד את האירוע.

{
  "clauseType": enum (AudienceClauseType),

  // Union field filter can be only one of the following:
  "simpleFilter": {
    object (AudienceSimpleFilter)
  },
  "sequenceFilter": {
    object (AudienceSequenceFilter)
  }
  // End of list of possible types for union field filter.
}

enum (AudienceClauseType)

חובה. מציין אם מדובר בתנאי סינון להכללה או להחרגה.

object (AudienceSimpleFilter)

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

object (AudienceSequenceFilter)

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

{
  "scope": enum (AudienceFilterScope),
  "filterExpression": {
    object (AudienceFilterExpression)
  }
}

enum (AudienceFilterScope)

חובה. בלתי ניתן לשינוי. מציינת את ההיקף של המסנן הזה.

object (AudienceFilterExpression)

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

{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (AudienceFilterExpressionList)
  },
  "orGroup": {
    object (AudienceFilterExpressionList)
  },
  "notExpression": {
    object (AudienceFilterExpression)
  },
  "dimensionOrMetricFilter": {
    object (AudienceDimensionOrMetricFilter)
  },
  "eventFilter": {
    object (AudienceEventFilter)
  }
  // End of list of possible types for union field expr.
}

object (AudienceFilterExpressionList)

רשימת ביטויים שצריך לחבר ביניהם. הוא יכול להכיל רק של AudienceFilterExpressions עם orGroup. צריך להגדיר זאת עבור AudienceFilterExpression ברמה העליונה.

object (AudienceFilterExpressionList)

רשימת ביטויים שיש להם חיבור ל-OR. היא לא יכולה להכיל AudienceFilterExpressions עם andGroup או אוGroup.

object (AudienceFilterExpression)

ביטוי סינון שצריך לא לבצע (לדוגמה, היפוך, ביטוי). הוא יכול לכלול רק מאפייןCustomOrMetricFilter. לא ניתן להגדיר זאת ברמת AudienceFilterExpression ברמה העליונה.

object (AudienceDimensionOrMetricFilter)

מסנן לפי מאפיין או מדד יחיד. לא ניתן להגדיר זאת ברמת AudienceFilterExpression ברמה העליונה.

object (AudienceEventFilter)

יצירת מסנן שתואם לאירוע ספציפי. לא ניתן להגדיר זאת ברמת AudienceFilterExpression ברמה העליונה.

{
  "filterExpressions": [
    {
      object (AudienceFilterExpression)
    }
  ]
}

object (AudienceFilterExpression)

רשימה של ביטויי סינון קהלים.

{
  "fieldName": string,
  "atAnyPointInTime": boolean,
  "inAnyNDayPeriod": integer,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}

string

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

boolean

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

אפשר להגדיר זאת רק כשהיקף הקהל הוא ACROSS_ALL_SESSIONS.

integer

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

לדוגמה, אם מגדירים את הערך של יום אחד, תתבצע הערכה רק של הנתונים של היום הנוכחי. נקודת ההתייחסות היא היום הנוכחי שבו atAnyPointInTime לא מוגדר או כ-false.

אפשר להגדיר אותו רק אם היקף הקהל הוא ACROSS_ALL_SESSIONS ולא יכול לחרוג מ-60 ימים.

object (StringFilter)

מסנן למאפיין מסוג מחרוזת שתואם לדפוס מסוים.

object (InListFilter)

מסנן למאפיין מחרוזת שתואם לרשימה מסוימת של אפשרויות.

object (NumericFilter)

מסנן לערכים מספריים או לערכים של תאריך במאפיין או במדד.

object (BetweenFilter)

מסנן לערכים מספריים או לערכים של תאריכים בין ערכים מסוימים במאפיין או במדד.

{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}

enum (MatchType)

חובה. סוג ההתאמה של מסנן המחרוזות.

string

חובה. ערך המחרוזת שאליו יש להתאים.

boolean

זה שינוי אופציונלי. אם True, ההתאמה היא תלוית אותיות רישיות. אם הערך הוא False, ההתאמה לא תלוית אותיות רישיות (case-sensitive).

{
  "values": [
    string
  ],
  "caseSensitive": boolean
}

string

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

boolean

זה שינוי אופציונלי. אם True, ההתאמה היא תלוית אותיות רישיות. אם הערך הוא False, ההתאמה לא תלוית אותיות רישיות (case-sensitive).

{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}

enum (Operation)

חובה. הפעולה הוחלה על מסנן מספרי.

object (NumericValue)

חובה. הערך המספרי או התאריך שאליהם יש לבצע התאמה.

{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}

string (int64 format)

ערך של מספר שלם.

number

ערך כפול.

{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}

object (NumericValue)

חובה. מתחיל במספר הזה, כולל.

object (NumericValue)

חובה. מסתיים במספר הזה, כולל.

{
  "eventName": string,
  "eventParameterFilterExpression": {
    object (AudienceFilterExpression)
  }
}

string

חובה. בלתי ניתן לשינוי. שם האירוע להתאמה.

object (AudienceFilterExpression)

זה שינוי אופציונלי. אם צוין, המסנן הזה תואם לאירועים שתואמים גם לשם האירוע היחיד וגם לביטויי הסינון של הפרמטרים. אי אפשר להגדיר AudienceEventFilter בתוך ביטוי המסנן של הפרמטרים (לדוגמה, אין תמיכה במסנני אירועים בתצוגת עץ). הערך הזה צריך להיות יחיד ו-Group ofdimensionOrMetricFilter או notExpression; אין תמיכה במחרוזות AND של OR. כמו כן, אם המסנן כולל מסנן של 'eventCount', המערכת תתייחס רק למסנן הזה. המערכת תתעלם מכל המסננים האחרים.

{
  "scope": enum (AudienceFilterScope),
  "sequenceMaximumDuration": string,
  "sequenceSteps": [
    {
      object (AudienceSequenceStep)
    }
  ]
}

enum (AudienceFilterScope)

חובה. בלתי ניתן לשינוי. מציינת את ההיקף של המסנן הזה.

string (Duration format)

זה שינוי אופציונלי. מגדיר את תקופת הזמן שבה כל הרצף חייב להתרחש.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

object (AudienceSequenceStep)

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

{
  "scope": enum (AudienceFilterScope),
  "immediatelyFollows": boolean,
  "constraintDuration": string,
  "filterExpression": {
    object (AudienceFilterExpression)
  }
}

enum (AudienceFilterScope)

חובה. בלתי ניתן לשינוי. מציינת את ההיקף של השלב הזה.

boolean

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

string (Duration format)

זה שינוי אופציונלי. אחרי ההגדרה, השלב הזה צריך לעמוד במסגרת האילוץ משך הזמן של השלב הקודם (לדוגמה, t[i] - t[i-1] <= modelDuration). אם המדיניות לא מוגדרת, אין דרישה לגבי משך הזמן (למעשה, משך הזמן בלתי מוגבל). בשלב הראשון, המערכת מתעלמת ממנו.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'s'. לדוגמה: "3.5s".

object (AudienceFilterExpression)

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