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)

משך הזמן בימים שבו רשומה נשארת בקהל אחרי האירוע שעומד בדרישות. הערך שמוגדר חייב להיות גדול מ-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

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

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

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.
LICENSED סוג משנה של סוג קהל צד שלישי.

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.

ContactInfoList

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

ייצוג ב-JSON 
{
  "contactInfos": [
    {
      object (ContactInfo)
    }
  ],
  "consent": {
    object (Consent)
  }
}
שדות
contactInfos[]

object (ContactInfo)

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

object (Consent)

קלט בלבד. הגדרת ההסכמה למשתמשים ב-contactInfos.

אם לא מגדירים את השדה הזה, המשמעות היא שלא צוינה הסכמה.

אם השדות adUserData או adPersonalization מוגדרים לערך CONSENT_STATUS_DENIED, הבקשה תחזיר שגיאה.

ContactInfo

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

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

string

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

string

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

string

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

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

string

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

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

string

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

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

string

קוד המדינה של החבר.

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

ConsentStatus

סטטוס ההסכמה.

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

MobileDeviceIdList

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

ייצוג ב-JSON 
{
  "mobileDeviceIds": [
    string
  ],
  "consent": {
    object (Consent)
  }
}
שדות
mobileDeviceIds[]

string

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

object (Consent)

קלט בלבד. הגדרת ההסכמה למשתמשים ב-mobileDeviceIds.

אם לא מגדירים את השדה הזה, המשמעות היא שלא צוינה הסכמה.

אם השדות adUserData או adPersonalization מוגדרים לערך CONSENT_STATUS_DENIED, הבקשה תחזיר שגיאה.

Methods

create

 יוצר FirstAndThirdPartyAudience.

editCustomerMatchMembers

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

get

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

list

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

patch

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