Audience

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

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

string

בלתי משתנה. שם המשאב של הקהל. שמות הקהלים מופיעים בפורמט הבא:

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

string (int64 format)

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

enum (AudienceStatus)

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

string

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

object (AudienceDimension)

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

object (AudienceExclusionDimension)

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

enum (AudienceScope)

הגדרת ההיקף שבו ניתן להשתמש בקהל הזה. כברירת מחדל, ההיקף הוא CUSTOMER. ניתן ליצור קהלים עם היקף של ASSET_GROUP לשימוש בלעדי בקבוצת נכסים אחת. ההיקף עשוי להשתנות מ-ASSET_GROUP ל-CUSTOMER, אבל לא מ-CUSTOMER ל-ASSET_GROUP.
assetGroup

string

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

string

שם הקהל. המזהה צריך להיות ייחודי בכל הקהלים בחשבון. האורך המינימלי צריך להיות 1 והאורך המקסימלי הוא 255. חובה כשההיקף לא מוגדר או מוגדר כ-CUSTOMER. לא ניתן להגדיר או לעדכן כשההיקף הוא ASSET_GROUP.

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)

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

AudienceScope

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

טיפוסים בני מנייה (enums)
UNSPECIFIED ההיקף לא צוין.
UNKNOWN הערך שהתקבל לא ידוע בגרסה הזו.
CUSTOMER הגדרת הקהל מתבצעת ברמת הלקוח.
ASSET_GROUP היקף הקהל נכלל בקבוצת AssetGroup ספציפית.