- משאב: FirstAndThirdPartyAudience
- FirstAndThirdPartyAudienceType
- AudienceType
- AudienceSource
- ContactInfoList
- ContactInfo
- MobileDeviceIdList
- שיטות
משאב: FirstAndThirdPartyAudience
מתאר רשימת חברים בקהל של צד ראשון או מצד שלישי המשמשת לטירגוט. קהלים מאינטראקציה ישירה נוצרים באמצעות שימוש בנתוני לקוח. קהלים של צד שלישי מסופקים על ידי ספקי נתונים של צד שלישי ורק ללקוחות יש רישיון להשתמש בהם.
ייצוג JSON |
---|
{ "name": string, "firstAndThirdPartyAudienceId": string, "displayName": string, "description": string, "firstAndThirdPartyAudienceType": enum ( |
שדות | |
---|---|
name |
פלט בלבד. שם המשאב של הקהל מהצד הראשון ומהצד השלישי. |
firstAndThirdPartyAudienceId |
פלט בלבד. המזהה הייחודי של הקהל מהצד הראשון ומהצד השלישי. הוקצה על ידי המערכת. |
displayName |
השם המוצג של הקהל מהצד הראשון ומהצד השלישי. |
description |
תיאור הקהל שסופק על ידי המשתמש. רלוונטי רק לקהלים מאינטראקציה ישירה. |
firstAndThirdPartyAudienceType |
אם הקהל הוא קהל של צד ראשון או מצד שלישי. |
audienceType |
סוג הקהל. |
audienceSource |
פלט בלבד. מקור הקהל. |
membershipDurationDays |
משך הזמן בימים שבהם רשומה נשארת בקהל אחרי אירוע הזכאות. אם לקהל אין תאריך תפוגה, מגדירים את הערך בשדה הזה ל-10,000. אחרת, הערך המוגדר חייב להיות גדול מ-0 וקטן או שווה ל-540. רלוונטי רק לקהלים מאינטראקציה ישירה. השדה הזה נדרש אם נעשה שימוש באחד מהשדות
|
displayAudienceSize |
פלט בלבד. הגודל המשוער של הקהל עבור רשת המדיה. אם הגודל קטן מ-1,000, המספר יוסתר ויוחזר הערך 0 מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות. הוחזר רק בבקשת GET. |
activeDisplayAudienceSize |
פלט בלבד. הגודל המשוער של הקהל ברשת המדיה בחודש האחרון. אם הגודל קטן מ-1,000, המספר יוסתר ויוחזר הערך 0 מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות. הוחזר רק בבקשת GET. |
youtubeAudienceSize |
פלט בלבד. גודל הקהל המשוער עבור רשת YouTube. אם הגודל קטן מ-1,000, המספר יוסתר ויוחזר הערך 0 מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות. רלוונטי רק לקהלים מאינטראקציה ישירה. הוחזר רק בבקשת GET. |
gmailAudienceSize |
פלט בלבד. גודל הקהל המשוער עבור רשת Gmail. אם הגודל קטן מ-1,000, המספר יוסתר ויוחזר הערך 0 מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות. רלוונטי רק לקהלים מאינטראקציה ישירה. הוחזר רק בבקשת GET. |
displayMobileAppAudienceSize |
פלט בלבד. הגודל המשוער של הקהל באפליקציות לנייד ברשת המדיה. אם הגודל קטן מ-1,000, המספר יוסתר ויוחזר הערך 0 מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות. רלוונטי רק לקהלים מאינטראקציה ישירה. הוחזר רק בבקשת GET. |
displayMobileWebAudienceSize |
פלט בלבד. הגודל המשוער של הקהל באינטרנט לנייד ברשת המדיה. אם הגודל קטן מ-1,000, המספר יוסתר ויוחזר הערך 0 מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות. רלוונטי רק לקהלים מאינטראקציה ישירה. הוחזר רק בבקשת GET. |
displayDesktopAudienceSize |
פלט בלבד. הגודל המשוער של הקהל במחשבים ברשת המדיה. אם הגודל קטן מ-1,000, המספר יוסתר ויוחזר הערך 0 מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות. רלוונטי רק לקהלים מאינטראקציה ישירה. הוחזר רק בבקשת GET. |
appId |
ה-appId תואם לסוג של mobileDeviceIds שמועלים. רלוונטי רק ל |
שדה איחוד members . החברים הראשונים בקהל 'התאמה ללקוחות'. הערך של members יכול להיות רק אחת מהאפשרויות הבאות: |
|
contactInfoList |
קלט בלבד. רשימה של פרטים ליצירת קשר, כדי להגדיר את החברים הראשונים בקהל. רלוונטי רק ל |
mobileDeviceIdList |
קלט בלבד. רשימה של מזהי מכשירים ניידים שישמשו להגדרה של החברים הראשונים בקהל. רלוונטי רק ל |
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 ( |
שדות | |
---|---|
contactInfos[] |
רשימה של אובייקטים מסוג ContactInfo שמגדירים חברים בקהל של 'התאמה ללקוחות'. גודל החברים לאחר פיצול פריטי contactInfo לא יכול להיות גדול מ-500,000. |
ContactInfo
פרטים ליצירת קשר בנוגע להגדרה של חבר בקהל בהתאמה ללקוחות
ייצוג JSON |
---|
{ "hashedEmails": [ string ], "hashedPhoneNumbers": [ string ], "zipCodes": [ string ], "hashedFirstName": string, "hashedLastName": string, "countryCode": string } |
שדות | |
---|---|
hashedEmails[] |
רשימה של כתובות אימייל שעברו גיבוב (hash) לפי האלגוריתם SHA256. לפני הגיבוב (hashing), הסירו את כל הרווחים הלבן וודאו שכל התווים במחרוזת יהיו אותיות קטנות. |
hashedPhoneNumbers[] |
רשימה של מספרי הטלפון המגובבים (hashed) באלגוריתם SHA256 של המנוי. כדי לבצע גיבוב (hashing), כל מספרי הטלפון צריכים להיות בפורמט של פורמט E.164 ולכלול את קוד החיוג של המדינה. |
zipCodes[] |
רשימת המיקודים של חבר הקבוצה. צריך להגדיר אותה גם עם השדות הבאים: |
hashedFirstName |
השם הפרטי של המנוי שעבר גיבוב (hash) לפי האלגוריתם SHA256. לפני הגיבוב (hashing), הסירו את כל הרווחים הלבן וודאו שכל התווים במחרוזת יהיו אותיות קטנות. צריך להגדיר אותה גם עם השדות הבאים: |
hashedLastName |
שם המשפחה של המנוי עבר גיבוב (hash) לפי האלגוריתם SHA256. לפני הגיבוב (hashing), הסירו את כל הרווחים הלבן וודאו שכל התווים במחרוזת יהיו אותיות קטנות. צריך להגדיר אותה גם עם השדות הבאים: |
countryCode |
קוד המדינה של המנוי. צריך להגדיר אותה גם עם השדות הבאים: |
MobileDeviceIdList
הודעת ראפ לרשימת מזהים של מכשירים ניידים שמגדירים חברים בקהל של 'התאמה ללקוחות'.
ייצוג JSON |
---|
{ "mobileDeviceIds": [ string ] } |
שדות | |
---|---|
mobileDeviceIds[] |
רשימה של מזהי מכשירים ניידים שמגדירים חברים בקהל של 'התאמה ללקוחות'. הגודל של mobileDeviceIds לא יכול להיות גדול מ-500,000. |
שיטות |
|
---|---|
|
יוצר FirstAndThirdPartyAudience. |
|
עדכון רשימת החברים בקהל 'התאמה ללקוחות'. |
|
מניב קהל מאינטראקציה ישירה ומצד שלישי. |
|
רשימת קהלים של צד ראשון וצד שלישי. |
|
עדכון של FirstAndThirdPartyAudience קיים. |