- ייצוג JSON
- AudienceStatus
- AudienceDimension
- AgeDimension
- AgeSegment
- GenderDimension
- HouseholdIncomeDimension
- ParentalStatusDimension
- AudienceSegmentDimension
- AudienceSegment
- UserListSegment
- UserInterestSegment
- LifeEventSegment
- DetailedDemographicSegment
- CustomAudienceSegment
- AudienceExclusionDimension
- ExclusionSegment
- AudienceScope
קהל הוא אפשרות יעילה לטירגוט שמאפשרת ליצור חפיפה בין מאפייני פילוח שונים, כמו מידע דמוגרפי מפורט וקהלים עם תחום עניין משותף, כדי ליצור קהלים שמייצגים קטעים של פלחי היעד.
ייצוג JSON |
---|
{ "resourceName": string, "id": string, "status": enum ( |
שדות | |
---|---|
resourceName |
לא משתנה. שם המשאב של הקהל. שמות הקהלים מוצגים בתבנית הבאה:
|
id |
פלט בלבד. המזהה של הקהל. |
status |
פלט בלבד. הסטטוס של הקהל הזה. מציין אם הקהל הופעל או הוסר. |
description |
תיאור הקהל הזה. |
dimensions[] |
מאפיינים חיוביים שמציינים את הרכב הקהל. |
exclusionDimension |
מאפיין שלילי שמציין את הרכב הקהל. |
scope |
מגדיר את ההיקף שבו ניתן להשתמש בקהל הזה. כברירת מחדל, ההיקף הוא CUSTOMER. ניתן ליצור קהלים עם היקף של ASSET_GROUP לשימוש בלעדי של AssetGroup יחיד. ההיקף עשוי להשתנות מ-ASSET_GROUP ל-CUSTOMER, אבל לא מ-CUSTOMER ל-ASSET_GROUP. |
assetGroup |
לא משתנה. קבוצת הנכסים בהיקף של הקהל הזה. יש להגדיר אותו רק אם ההיקף הוא ASSET_GROUP. לא משתנה לאחר היצירה. אם קהל עם היקף מסוג ASSET_GROUP ישודרג להיקף CUSTOMER, השדה הזה יימחק באופן אוטומטי. |
name |
שם הקהל. הוא צריך להיות ייחודי בכל הקהלים בחשבון. הוא צריך להיות באורך מינימלי של 1 ובאורך מקסימלי של 255. חובה כשההיקף לא מוגדר או מוגדר כ-CUSTOMER. לא ניתן להגדיר או לעדכן כשההיקף הוא ASSET_GROUP. |
AudienceStatus
טיפוסים בני מנייה (enum) הכוללים סוגי סטטוס אפשריים של קהלים.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו. |
ENABLED |
סטטוס מופעל – הקהל מופעל ואפשר לטרגט אותו. |
REMOVED |
סטטוס הוסר – הקהל הוסר ולא ניתן להשתמש בו לטירגוט. |
AudienceDimension
מאפיין חיובי שמציין את הקהל של המשתמש.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד dimension . מאפיין שמציין משתמשים ששייכים לקהל. הערך של dimension יכול להיות רק אחת מהאפשרויות הבאות: |
|
age |
מאפיין שמציין משתמשים לפי הגיל שלהם. |
gender |
מאפיין שמציין משתמשים לפי המגדר שלהם. |
householdIncome |
מאפיין שמציין משתמשים לפי ההכנסה למשק בית שלהם. |
parentalStatus |
מאפיין שמציין משתמשים לפי סטטוס ההורה שלהם. |
audienceSegments |
מאפיין שמציין משתמשים לפי החברות שלהם בפלחים אחרים של קהל היעד. |
AgeDimension
מאפיין שמציין משתמשים לפי הגיל שלהם.
ייצוג JSON |
---|
{
"ageRanges": [
{
object ( |
שדות | |
---|---|
ageRanges[] |
טווח גילאים רציף שיש לכלול במאפיין. |
includeUndetermined |
הכללה של משתמשים שהגיל שלהם לא נקבע. |
AgeSegment
טווח גילאים קבוע.
ייצוג JSON |
---|
{ "minAge": integer, "maxAge": integer } |
שדות | |
---|---|
minAge |
הגיל המינימלי שצריך לכלול. יש לציין גיל מינימלי ולהיות לפחות 18. הערכים המותרים הם 18, 25, 35, 45, 55 ו-65. |
maxAge |
הגיל המקסימלי שאפשר לכלול. אין צורך לציין גיל מקסימלי. אם צוין, maxAge חייב להיות גדול מ-minAge, והערכים המותרים הם 24, 34, 44, 54 ו-64. |
GenderDimension
מאפיין שמציין משתמשים לפי המגדר שלהם.
ייצוג JSON |
---|
{
"genders": [
enum ( |
שדות | |
---|---|
genders[] |
הכללה של פלחים דמוגרפיים לפי מגדר. |
includeUndetermined |
יש לכלול משתמשים שהמגדר שלהם לא נקבע. |
HouseholdIncomeDimension
מאפיין שמציין משתמשים לפי ההכנסה למשק בית שלהם.
ייצוג JSON |
---|
{
"incomeRanges": [
enum ( |
שדות | |
---|---|
incomeRanges[] |
כולל פלחים דמוגרפיים של הכנסה למשק בית. |
includeUndetermined |
לכלול משתמשים שההכנסה למשק בית שלהם לא נקבעה. |
ParentalStatusDimension
מאפיין שמציין משתמשים לפי סטטוס ההורה שלהם.
ייצוג JSON |
---|
{
"parentalStatuses": [
enum ( |
שדות | |
---|---|
parentalStatuses[] |
נכללו פלחים דמוגרפיים של סטטוס הורה. |
includeUndetermined |
הכללה של משתמשים שסטטוס ההורה שלהם לא ידוע. |
AudienceSegmentDimension
מאפיין שמציין משתמשים לפי החברות שלהם בפלחים אחרים של קהל היעד.
ייצוג JSON |
---|
{
"segments": [
{
object ( |
שדות | |
---|---|
segments[] |
פלחים כלולים של קהל היעד. המערכת תכלול משתמשים אם הם שייכים לפלח אחד לפחות. |
AudienceSegment
פלח קהל חיובי.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד segment . פלח חיובי. הערך של segment יכול להיות רק אחת מהאפשרויות הבאות: |
|
userList |
פלח של רשימת משתמשים. |
userInterest |
פלח קהל עם תחום עניין משותף או פלח עם כוונת רכישה. |
lifeEvent |
פלח קהל מאירוע בשידור חי. |
detailedDemographic |
פלח דמוגרפי מפורט. |
customAudience |
פלח קהל בהתאמה אישית. |
UserListSegment
פלח של רשימת משתמשים. הסגירה של 'קהלים דומים' תתחיל במאי 2023. אפשרויות נוספות זמינות בכתובת https://ads-developers.googleblog.com/2022/11/announcing-deprecation-and-sunset-of.html.
ייצוג JSON |
---|
{ "userList": string } |
שדות | |
---|---|
userList |
המשאב של רשימת המשתמשים. |
UserInterestSegment
פלח תחומי עניין של משתמשים.
ייצוג JSON |
---|
{ "userInterestCategory": string } |
שדות | |
---|---|
userInterestCategory |
המשאב של תחומי העניין של המשתמשים. |
LifeEventSegment
פלח אירועים בשידור חי.
ייצוג JSON |
---|
{ "lifeEvent": string } |
שדות | |
---|---|
lifeEvent |
משאב האירוע המשמעותי בחיים. |
DetailedDemographicSegment
פלח דמוגרפי מפורט.
ייצוג JSON |
---|
{ "detailedDemographic": string } |
שדות | |
---|---|
detailedDemographic |
המידע הדמוגרפי המפורט. |
CustomAudienceSegment
פלח קהל בהתאמה אישית.
ייצוג JSON |
---|
{ "customAudience": string } |
שדות | |
---|---|
customAudience |
משאב הקהל המותאם אישית. |
AudienceExclusionDimension
מאפיין שלילי שמציין משתמשים שצריך להחריג מהקהל.
ייצוג JSON |
---|
{
"exclusions": [
{
object ( |
שדות | |
---|---|
exclusions[] |
פלח של קהל היעד שיוחרג. |
ExclusionSegment
פלח של קהל יעד שיוחרג מהקהל.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד segment . הפלח שלא ייכלל. הערך של segment יכול להיות רק אחת מהאפשרויות הבאות: |
|
userList |
פלח של רשימת משתמשים שלא ייכלל. |
AudienceScope
טיפוסים בני מנייה (enum) שמכילים ערכים אפשריים של היקף הקהל.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
ההיקף לא צוין. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. |
CUSTOMER |
הגדרת הקהל מתבצעת ברמת הלקוח. |
ASSET_GROUP |
היקף הקהל נכלל בקבוצת AssetGroup ספציפית. |