REST Resource: firstPartyAndPartnerAudiences

משאב: FirstPartyAndPartnerAudience

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

ייצוג ב-JSON 
{
  "name": string,
  "firstPartyAndPartnerAudienceId": string,
  "displayName": string,
  "description": string,
  "firstPartyAndPartnerAudienceType": enum (FirstPartyAndPartnerAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string
}
שדות
name

string

פלט בלבד. שם המשאב של הקהל מאינטראקציה ישירה (First-Party) ושל הקהל של השותף.
firstPartyAndPartnerAudienceId

string (int64 format)

מזהה. המזהה הייחודי של הקהל מאינטראקציה ישירה (First-Party) ושל הקהל של השותף. מוקצה על ידי המערכת.
displayName

string

אופציונלי. השם המוצג של הקהל מאינטראקציה ישירה (First-Party) ושל קהל השותפים.
description

string

אופציונלי. תיאור הקהל שהמשתמש סיפק.

רלוונטי רק לקהלים מאינטראקציה ישירה (First-Party).
firstPartyAndPartnerAudienceType

enum (FirstPartyAndPartnerAudienceType)

פלט בלבד. אם הקהל הוא קהל מאינטראקציה ישירה או קהל של שותפים.
audienceType

enum (AudienceType)

לא ניתן לשינוי. סוג הקהל.
audienceSource

enum (AudienceSource)

פלט בלבד. המקור של הקהל.
membershipDurationDays

string (int64 format)

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

רלוונטי רק לקהלים מאינטראקציה ישירה (First-Party).

השדה הזה הוא שדה חובה אם משתמשים באחד מהערכים הבאים של audienceType:

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

פלט בלבד. גודל הקהל המשוער ברשת המדיה.

אם הגודל קטן מ-1,000, המספר יוסתר ויוחזר הערך 0 מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות.

מוחזר רק בבקשת GET.
activeDisplayAudienceSize

string (int64 format)

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

אם הגודל קטן מ-1,000, המספר יוסתר ויוחזר הערך 0 מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות.

מוחזר רק בבקשת GET.
youtubeAudienceSize

string (int64 format)

פלט בלבד. גודל הקהל המשוער ברשת YouTube.

אם הגודל קטן מ-1,000, המספר יוסתר ויוחזר הערך 0 מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות.

רלוונטי רק לקהלים מאינטראקציה ישירה (First-Party).

מוחזר רק בבקשת GET.
gmailAudienceSize

string (int64 format)

פלט בלבד. גודל הקהל המשוער ברשת Gmail.

אם הגודל קטן מ-1,000, המספר יוסתר ויוחזר הערך 0 מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות.

רלוונטי רק לקהלים מאינטראקציה ישירה (First-Party).

מוחזר רק בבקשת GET.
displayMobileAppAudienceSize

string (int64 format)

פלט בלבד. גודל קהל היעד המשוער באפליקציות לנייד ברשת המדיה.

אם הגודל קטן מ-1,000, המספר יוסתר ויוחזר הערך 0 מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות.

רלוונטי רק לקהלים מאינטראקציה ישירה (First-Party).

מוחזר רק בבקשת GET.
displayMobileWebAudienceSize

string (int64 format)

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

אם הגודל קטן מ-1,000, המספר יוסתר ויוחזר הערך 0 מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות.

רלוונטי רק לקהלים מאינטראקציה ישירה (First-Party).

מוחזר רק בבקשת GET.
displayDesktopAudienceSize

string (int64 format)

פלט בלבד. גודל הקהל המשוער במחשבים ברשת המדיה.

אם הגודל קטן מ-1,000, המספר יוסתר ויוחזר הערך 0 מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות.

רלוונטי רק לקהלים מאינטראקציה ישירה (First-Party).

מוחזר רק בבקשת GET.
appId

string

אופציונלי. הפרמטר appId תואם לסוג של הפרמטרים mobileDeviceIds שמועלים.

רלוונטי רק ל-audienceType CUSTOMER_MATCH_DEVICE_ID

FirstPartyAndPartnerAudienceType

סוגים אפשריים של משאב קהל מאינטראקציה ישירה וקהל של שותף.

טיפוסים בני מנייה (enum)
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED ערך ברירת המחדל כשהסוג לא צוין או לא ידוע.
TYPE_FIRST_PARTY קהל שנוצר באמצעות נתוני לקוחות.
TYPE_PARTNER קהל שמסופק על ידי ספקי נתונים של צד שלישי.

AudienceType

סוגי קהלים אפשריים.

טיפוסים בני מנייה (enum)
AUDIENCE_TYPE_UNSPECIFIED ערך ברירת המחדל כשהסוג לא צוין או לא ידוע.
CUSTOMER_MATCH_CONTACT_INFO הקהל נוצר על ידי התאמת לקוחות לפרטים ידועים ליצירת קשר.
CUSTOMER_MATCH_DEVICE_ID הקהל נוצר על ידי התאמת לקוחות למזהי מכשירים ניידים ידועים.
CUSTOMER_MATCH_USER_ID הקהל נוצר על ידי התאמת לקוחות למזהי משתמשים ידועים.
ACTIVITY_BASED

הוצא משימוש: הקהל נוצר על סמך פעילות בקמפיין.
FREQUENCY_CAP

הוצא משימוש: הקהל נוצר על סמך החרגה של מספר החשיפות שהוצגו לו.
TAG_BASED הקהל נוצר על סמך משתנים מותאמים אישית שמצורפים לפיקסל.
YOUTUBE_USERS הקהל נוצר על סמך אינטראקציות קודמות עם סרטונים, מודעות YouTube או ערוץ YouTube.
THIRD_PARTY הקהל קיבל רישיון לשימוש מצד שלישי.
COMMERCE קהל ששותפים מסחריים מספקים תמורת תשלום.
LINEAR קהל לתוכן של טלוויזיה לינארית.
AGENCY קהל שסופק על ידי סוכנות.

AudienceSource

מקורות נתונים אפשריים ליצירת קהלים.

טיפוסים בני מנייה (enum)
AUDIENCE_SOURCE_UNSPECIFIED ערך ברירת המחדל כשמקור הנתונים ליצירת קהלים לא צוין או לא ידוע.
DISPLAY_VIDEO_360 מקור: Display & Video 360.
CAMPAIGN_MANAGER מקור: Campaign Manager 360.
AD_MANAGER מקור: Google Ad Manager.
SEARCH_ADS_360 מקורו ב-Search Ads 360.
YOUTUBE מקור הסרטון: YouTube.
ADS_DATA_HUB מקור: Ads Data Hub.

Methods

get

 מקבל קהל מאינטראקציה ישירה או קהל של שותף.

list

 מציגה קהלים מאינטראקציה ישירה וקהלים של שותפים.