REST Resource: firstAndThirdPartyAudiences

משאב: FirstAndThirdPartyAudience

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

ייצוג JSON 
{
  "name": string,
  "firstAndThirdPartyAudienceId": string,
  "displayName": string,
  "description": string,
  "firstAndThirdPartyAudienceType": enum (FirstAndThirdPartyAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string,

  // Union field members can be only one of the following:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of list of possible types for union field members.
}
שדות
name

string

פלט בלבד. שם המשאב של הקהל מהצד הראשון ומהצד השלישי.
firstAndThirdPartyAudienceId

string (int64 format)

פלט בלבד. המזהה הייחודי של הקהל מהצד הראשון ומהצד השלישי. הוקצה על ידי המערכת.
displayName

string

השם המוצג של הקהל מהצד הראשון ומהצד השלישי.
description

string

תיאור הקהל שסופק על ידי המשתמש.

רלוונטי רק לקהלים מאינטראקציה ישירה.
firstAndThirdPartyAudienceType

enum (FirstAndThirdPartyAudienceType)

אם הקהל הוא קהל של צד ראשון או מצד שלישי.
audienceType

enum (AudienceType)

סוג הקהל.
audienceSource

enum (AudienceSource)

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

string (int64 format)

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

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

השדה הזה נדרש אם נעשה שימוש באחד מהשדות 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 מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות.

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

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

string (int64 format)

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

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

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

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

string (int64 format)

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

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

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

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

string (int64 format)

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

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

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

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

string (int64 format)

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

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

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

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

string

ה-appId תואם לסוג של mobileDeviceIds שמועלים.

רלוונטי רק לaudienceType CUSTOMER_MATCH_DEVICE_ID
שדה איחוד members. החברים הראשונים בקהל 'התאמה ללקוחות'. הערך של members יכול להיות רק אחת מהאפשרויות הבאות:
contactInfoList

object (ContactInfoList)

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

רלוונטי רק לaudienceType CUSTOMER_MATCH_CONTACT_INFO
mobileDeviceIdList

object (MobileDeviceIdList)

קלט בלבד. רשימה של מזהי מכשירים ניידים שישמשו להגדרה של החברים הראשונים בקהל.

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

FirstAndThirdPartyAudienceType

סוגים אפשריים של משאב קהל של צד ראשון וצד שלישי.

טיפוסים בני מנייה (enums)
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED ערך ברירת המחדל כשהסוג לא צוין או לא ידוע.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY קהל שנוצר באמצעות שימוש בנתוני לקוח.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY קהל שסופק על ידי ספקי נתונים של צד שלישי.

AudienceType

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

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

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

הקהל נוצר על סמך החרגה של מספר החשיפות שהוא קיבל.
TAG_BASED הקהל נוצר על סמך משתנים מותאמים אישית שמצורפים לפיקסל.
YOUTUBE_USERS הקהל נוצר על סמך אינטראקציות קודמות עם סרטונים, מודעות YouTube או ערוץ YouTube.
LICENSED סוג משנה של סוג קהל של צד שלישי.

AudienceSource

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

טיפוסים בני מנייה (enums)
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.

ContactInfoList

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

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

object (ContactInfo)

רשימה של אובייקטים מסוג ContactInfo שמגדירים חברים בקהל של 'התאמה ללקוחות'. גודל החברים לאחר פיצול פריטי contactInfo לא יכול להיות גדול מ-500,000.

ContactInfo

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

ייצוג JSON 
{
  "hashedEmails": [
    string
  ],
  "hashedPhoneNumbers": [
    string
  ],
  "zipCodes": [
    string
  ],
  "hashedFirstName": string,
  "hashedLastName": string,
  "countryCode": string
}
שדות
hashedEmails[]

string

רשימה של כתובות אימייל שעברו גיבוב (hash) לפי האלגוריתם SHA256. לפני הגיבוב (hashing), הסירו את כל הרווחים הלבן וודאו שכל התווים במחרוזת יהיו אותיות קטנות.
hashedPhoneNumbers[]

string

רשימה של מספרי הטלפון המגובבים (hashed) באלגוריתם SHA256 של המנוי. כדי לבצע גיבוב (hashing), כל מספרי הטלפון צריכים להיות בפורמט של פורמט E.164 ולכלול את קוד החיוג של המדינה.
zipCodes[]

string

רשימת המיקודים של חבר הקבוצה.

צריך להגדיר אותה גם עם השדות הבאים:
hashedFirstName

string

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

צריך להגדיר אותה גם עם השדות הבאים:
hashedLastName

string

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

צריך להגדיר אותה גם עם השדות הבאים:
countryCode

string

קוד המדינה של המנוי.

צריך להגדיר אותה גם עם השדות הבאים:

MobileDeviceIdList

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

ייצוג JSON 
{
  "mobileDeviceIds": [
    string
  ]
}
שדות
mobileDeviceIds[]

string

רשימה של מזהי מכשירים ניידים שמגדירים חברים בקהל של 'התאמה ללקוחות'. הגודל של mobileDeviceIds לא יכול להיות גדול מ-500,000.

שיטות

create

 יוצר FirstAndThirdPartyAudience.

editCustomerMatchMembers

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

get

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

list

 רשימת קהלים של צד ראשון וצד שלישי.

patch

 עדכון של FirstAndThirdPartyAudience קיים.