Audience

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

ייצוג JSON 
{
  "resourceName": string,
  "id": string,
  "status": enum (AudienceStatus),
  "name": string,
  "description": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "exclusionDimension": {
    object (AudienceExclusionDimension)
  }
}
שדות
resourceName

string

לא משתנה. שם המשאב של הקהל. שמות הקהלים מוצגים בתבנית הבאה:

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

פלט בלבד. המזהה של הקהל.
status

enum (AudienceStatus)

פלט בלבד. הסטטוס של הקהל הזה. מציין אם הקהל הופעל או הוסר.
name

string

חובה. שם הקהל. הקישור צריך להיות ייחודי בכל הקהלים. הוא צריך להיות באורך מינימלי של 1 ובאורך מקסימלי של 255.
description

string

תיאור הקהל הזה.
dimensions[]

object (AudienceDimension)

מאפיינים חיוביים שמציינים את הרכב הקהל.
exclusionDimension

object (AudienceExclusionDimension)

מאפיין שלילי שמציין את הרכב הקהל.

AudienceStatus

טיפוסים בני מנייה (enum) הכוללים סוגי סטטוס אפשריים של קהלים.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ENABLED סטטוס מופעל – הקהל מופעל ואפשר לטרגט אותו.
REMOVED סטטוס הוסר – הקהל הוסר ולא ניתן להשתמש בו לטירגוט.

AudienceDimension

מאפיין חיובי שמציין את הקהל של המשתמש.

ייצוג JSON 
{

  // Union field dimension can be only one of the following:
  "age": {
    object (AgeDimension)
  },
  "gender": {
    object (GenderDimension)
  },
  "householdIncome": {
    object (HouseholdIncomeDimension)
  },
  "parentalStatus": {
    object (ParentalStatusDimension)
  },
  "audienceSegments": {
    object (AudienceSegmentDimension)
  }
  // End of list of possible types for union field dimension.
}
שדות
שדה איחוד dimension. מאפיין שמציין משתמשים ששייכים לקהל. הערך של dimension יכול להיות רק אחת מהאפשרויות הבאות:
age

object (AgeDimension)

מאפיין שמציין משתמשים לפי הגיל שלהם.
gender

object (GenderDimension)

מאפיין שמציין משתמשים לפי המגדר שלהם.
householdIncome

object (HouseholdIncomeDimension)

מאפיין שמציין משתמשים לפי ההכנסה למשק בית שלהם.
parentalStatus

object (ParentalStatusDimension)

מאפיין שמציין משתמשים לפי סטטוס ההורה שלהם.
audienceSegments

object (AudienceSegmentDimension)

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

AgeDimension

מאפיין שמציין משתמשים לפי הגיל שלהם.

ייצוג JSON 
{
  "ageRanges": [
    {
      object (AgeSegment)
    }
  ],
  "includeUndetermined": boolean
}
שדות
ageRanges[]

object (AgeSegment)

טווח גילאים רציף שיש לכלול במאפיין.
includeUndetermined

boolean

הכללה של משתמשים שהגיל שלהם לא נקבע.

AgeSegment

טווח גילאים קבוע.

ייצוג JSON 
{
  "minAge": integer,
  "maxAge": integer
}
שדות
minAge

integer

הגיל המינימלי שצריך לכלול. יש לציין גיל מינימלי ולהיות לפחות 18. הערכים המותרים הם 18, 25, 35, 45, 55 ו-65.
maxAge

integer

הגיל המקסימלי שאפשר לכלול. אין צורך לציין גיל מקסימלי. אם צוין, maxAge חייב להיות גדול מ-minAge, והערכים המותרים הם 24, 34, 44, 54 ו-64.

GenderDimension

מאפיין שמציין משתמשים לפי המגדר שלהם.

ייצוג JSON 
{
  "genders": [
    enum (GenderType)
  ],
  "includeUndetermined": boolean
}
שדות
genders[]

enum (GenderType)

הכללה של פלחים דמוגרפיים לפי מגדר.
includeUndetermined

boolean

יש לכלול משתמשים שהמגדר שלהם לא נקבע.

HouseholdIncomeDimension

מאפיין שמציין משתמשים לפי ההכנסה למשק בית שלהם.

ייצוג JSON 
{
  "incomeRanges": [
    enum (IncomeRangeType)
  ],
  "includeUndetermined": boolean
}
שדות
incomeRanges[]

enum (IncomeRangeType)

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

boolean

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

ParentalStatusDimension

מאפיין שמציין משתמשים לפי סטטוס ההורה שלהם.

ייצוג JSON 
{
  "parentalStatuses": [
    enum (ParentalStatusType)
  ],
  "includeUndetermined": boolean
}
שדות
parentalStatuses[]

enum (ParentalStatusType)

נכללו פלחים דמוגרפיים של סטטוס הורה.
includeUndetermined

boolean

הכללה של משתמשים שסטטוס ההורה שלהם לא ידוע.

AudienceSegmentDimension

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

ייצוג JSON 
{
  "segments": [
    {
      object (AudienceSegment)
    }
  ]
}
שדות
segments[]

object (AudienceSegment)

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

AudienceSegment

פלח קהל חיובי.

ייצוג JSON 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  },
  "userInterest": {
    object (UserInterestSegment)
  },
  "lifeEvent": {
    object (LifeEventSegment)
  },
  "detailedDemographic": {
    object (DetailedDemographicSegment)
  },
  "customAudience": {
    object (CustomAudienceSegment)
  }
  // End of list of possible types for union field segment.
}
שדות
שדה איחוד segment. פלח חיובי. הערך של segment יכול להיות רק אחת מהאפשרויות הבאות:
userList

object (UserListSegment)

פלח של רשימת משתמשים.
userInterest

object (UserInterestSegment)

פלח קהל עם תחום עניין משותף או פלח עם כוונת רכישה.
lifeEvent

object (LifeEventSegment)

פלח קהל מאירוע בשידור חי.
detailedDemographic

object (DetailedDemographicSegment)

פלח דמוגרפי מפורט.
customAudience

object (CustomAudienceSegment)

פלח קהל בהתאמה אישית.

UserListSegment

פלח של רשימת משתמשים. הסגירה של 'קהלים דומים' תתחיל במאי 2023. אפשרויות נוספות זמינות בכתובת https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html.

ייצוג JSON 
{
  "userList": string
}
שדות
userList

string

המשאב של רשימת המשתמשים.

UserInterestSegment

פלח תחומי עניין של משתמשים.

ייצוג JSON 
{
  "userInterestCategory": string
}
שדות
userInterestCategory

string

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

LifeEventSegment

פלח אירועים בשידור חי.

ייצוג JSON 
{
  "lifeEvent": string
}
שדות
lifeEvent

string

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

DetailedDemographicSegment

פלח דמוגרפי מפורט.

ייצוג JSON 
{
  "detailedDemographic": string
}
שדות
detailedDemographic

string

המידע הדמוגרפי המפורט.

CustomAudienceSegment

פלח קהל בהתאמה אישית.

ייצוג JSON 
{
  "customAudience": string
}
שדות
customAudience

string

משאב הקהל המותאם אישית.

AudienceExclusionDimension

מאפיין שלילי שמציין משתמשים שצריך להחריג מהקהל.

ייצוג JSON 
{
  "exclusions": [
    {
      object (ExclusionSegment)
    }
  ]
}
שדות
exclusions[]

object (ExclusionSegment)

פלח של קהל היעד שיוחרג.

ExclusionSegment

פלח של קהל יעד שיוחרג מהקהל.

ייצוג JSON 
{

  // Union field segment can be only one of the following:
  "userList": {
    object (UserListSegment)
  }
  // End of list of possible types for union field segment.
}
שדות
שדה איחוד segment. הפלח שלא ייכלל. הערך של segment יכול להיות רק אחת מהאפשרויות הבאות:
userList

object (UserListSegment)

פלח של רשימת משתמשים שלא ייכלל.