- משאב: FirstAndThirdPartyAudience
- FirstAndThirdPartyAudienceType
- AudienceType
- AudienceSource
- ContactInfoList
- ContactInfo
- הסכמה
- ConsentStatus
- MobileDeviceIdList
- שיטות
משאב: FirstAndThirdPartyAudience
תיאור של רשימת קהל מצד ראשון או שלישי שמשמש לטירגוט. קהלים מאינטראקציה ישירה נוצרים על סמך שימוש בנתוני לקוחות. קהלים של צד שלישי ניתנים על ידי ספקי נתונים של צד שלישי, וניתן להעניק רישיון לשימוש בהם רק ללקוחות.
ייצוג ב-JSON |
---|
{ "name": string, "firstAndThirdPartyAudienceId": string, "displayName": string, "description": string, "firstAndThirdPartyAudienceType": enum ( |
שדות | |
---|---|
name |
פלט בלבד. שם המשאב של קהל היעד מאינטראקציה ישירה (first-party) ושל קהל היעד מצד שלישי. |
firstAndThirdPartyAudienceId |
פלט בלבד. המזהה הייחודי של קהל היעד מאינטראקציה ישירה (first-party) ושל קהל היעד מצד שלישי. המערכת מקצה את השם. |
displayName |
שם התצוגה של קהל היעד מאינטראקציה ישירה (first-party) ושל קהל היעד מצד שלישי. |
description |
התיאור של הקהל שהמשתמש סיפק. האפשרות הזו רלוונטית רק לקהלים מאינטראקציה ישירה (First-Party). |
firstAndThirdPartyAudienceType |
האם הקהל הוא קהל מאינטראקציה ישירה (first-party) או קהל של צד שלישי. |
audienceType |
סוג הקהל. |
audienceSource |
פלט בלבד. המקור של הקהל. |
membershipDurationDays |
משך הזמן, בימים, שבו רשומה נשארת בקהל אחרי האירוע שעמד בדרישות. אם לקהל אין תאריך תפוגה, מגדירים את הערך בשדה הזה כ-10000. אחרת, הערך שהוגדר צריך להיות גדול מ-0 וקטן מ-540 או שווה לו. האפשרות הזו רלוונטית רק לקהלים מאינטראקציה ישירה (First-Party). השדה הזה נדרש אם משתמשים באחד מה-
|
displayAudienceSize |
פלט בלבד. גודל הקהל המשוער ברשת המדיה. אם הגודל קטן מ-1,000, המספר יהיה מוסתר והערך 0 יוחזר מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות. הנתון הזה מוחזר רק בבקשת GET. |
activeDisplayAudienceSize |
פלט בלבד. הגודל המשוער של הקהל ברשת המדיה בחודש האחרון. אם הגודל קטן מ-1,000, המספר יהיה מוסתר והערך 0 יוחזר מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות. הנתון הזה מוחזר רק בבקשת GET. |
youtubeAudienceSize |
פלט בלבד. גודל הקהל המשוער של רשת YouTube. אם הגודל קטן מ-1,000, המספר יהיה מוסתר והערך 0 יוחזר מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות. האפשרות הזו רלוונטית רק לקהלים מאינטראקציה ישירה (First-Party). הנתון הזה מוחזר רק בבקשת GET. |
gmailAudienceSize |
פלט בלבד. גודל הקהל המשוער ברשת Gmail. אם הגודל קטן מ-1,000, המספר יהיה מוסתר והערך 0 יוחזר מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות. האפשרות הזו רלוונטית רק לקהלים מאינטראקציה ישירה (First-Party). הנתון הזה מוחזר רק בבקשת GET. |
displayMobileAppAudienceSize |
פלט בלבד. גודל הקהל המשוער של האפליקציה לנייד ברשת המדיה. אם הגודל קטן מ-1,000, המספר יהיה מוסתר והערך 0 יוחזר מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות. האפשרות הזו רלוונטית רק לקהלים מאינטראקציה ישירה (First-Party). הנתון הזה מוחזר רק בבקשת GET. |
displayMobileWebAudienceSize |
פלט בלבד. גודל הקהל המשוער באינטרנט לנייד ברשת המדיה. אם הגודל קטן מ-1,000, המספר יהיה מוסתר והערך 0 יוחזר מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות. האפשרות הזו רלוונטית רק לקהלים מאינטראקציה ישירה (First-Party). הנתון הזה מוחזר רק בבקשת GET. |
displayDesktopAudienceSize |
פלט בלבד. גודל הקהל המשוער במחשבים ברשת המדיה. אם הגודל קטן מ-1,000, המספר יהיה מוסתר והערך 0 יוחזר מטעמי פרטיות. אחרת, המספר יעוגל לשתי ספרות משמעותיות. האפשרות הזו רלוונטית רק לקהלים מאינטראקציה ישירה (First-Party). הנתון הזה מוחזר רק בבקשת GET. |
appId |
השדה appId תואם לסוג של מזהי mobileDeviceId שמעלים. רלוונטי רק ל- |
שדה האיחוד members . החברים הראשונים בקהל 'התאמה ללקוחות'. הערך של members יכול להיות רק אחת מהאפשרויות הבאות: |
|
contactInfoList |
קלט בלבד. רשימה של פרטים ליצירת קשר כדי להגדיר את חברי הקהל הראשונים. רלוונטי רק ל- |
mobileDeviceIdList |
קלט בלבד. רשימה של מזהי מכשירים ניידים להגדרת חברי הקהל הראשוניים. רלוונטי רק ל- |
FirstAndThirdPartyAudienceType
סוגי המשאבים האפשריים של קהלים מאינטראקציה ישירה (first-party) ושל צד שלישי.
טיפוסים בני מנייה (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 |
הקהל נוצר על ידי התאמת לקוחות למזהי User ID ידועים. |
ACTIVITY_BASED |
הקהל נוצר על סמך פעילות הקמפיין. |
FREQUENCY_CAP |
הקהל נוצר על סמך החרגת מספר החשיפות שהוצגו לו. |
TAG_BASED |
הקהל נוצר על סמך משתנים מותאמים אישית שמצורפים ל-pixel. |
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
הודעת עטיפה לרשימת פרטים ליצירת קשר שמגדירה את חברי הקהל בהתאמה ללקוחות.
ייצוג ב-JSON |
---|
{ "contactInfos": [ { object ( |
שדות | |
---|---|
contactInfos[] |
רשימה של אובייקטים מסוג ContactInfo שמגדירים את חברי הקהל מסוג 'התאמה ללקוחות'. הגודל של רשימת המשתתפים אחרי חלוקת contactInfos לא יכול להיות גדול מ-500,000. |
consent |
קלט בלבד. הגדרת ההסכמה של המשתמשים ב- אם השדה הזה לא מוגדר, סימן שלא צוינה הסכמה. אם השדות |
ContactInfo
פרטים ליצירת קשר שמגדירים חבר בקהל של התאמה ללקוחות.
ייצוג ב-JSON |
---|
{ "hashedEmails": [ string ], "hashedPhoneNumbers": [ string ], "zipCodes": [ string ], "hashedFirstName": string, "hashedLastName": string, "countryCode": string } |
שדות | |
---|---|
hashedEmails[] |
רשימה של כתובות האימייל של המשתמש שעברו גיבוב (hash) באמצעות SHA256. לפני ביצוע הגיבוב, מסירים את כל הרווחים ומקפידים שהמחרוזת תהיה מורכבת רק מאותיות קטנות. |
hashedPhoneNumbers[] |
רשימה של מספרי הטלפון של המשתמש שעבר גיבוב (hash) באמצעות SHA256. לפני הגיבוב, כל מספרי הטלפון צריכים להיות בפורמט E.164 ולכלול את קידומת המדינה. |
zipCodes[] |
רשימה של אזורי המיקוד של המשתמש. צריך להגדיר גם את השדות הבאים: |
hashedFirstName |
השם הפרטי של המשתמש לאחר גיבוב SHA256. לפני ביצוע הגיבוב, מסירים את כל הרווחים ומקפידים שהמחרוזת תהיה מורכבת רק מאותיות קטנות. צריך להגדיר גם את השדות הבאים: |
hashedLastName |
שם המשפחה של המשתמש לאחר גיבוב SHA256. לפני ביצוע הגיבוב, מסירים את כל הרווחים ומקפידים שהמחרוזת תהיה מורכבת רק מאותיות קטנות. צריך להגדיר גם את השדות הבאים: |
countryCode |
קוד המדינה של המשתמש. צריך להגדיר גם את השדות הבאים: |
הסכמה
סטטוס ההסכמה מהמשתמש.
ייצוג ב-JSON |
---|
{ "adUserData": enum ( |
שדות | |
---|---|
adUserData |
מייצג הסכמה לאיסוף של נתוני משתמשים במודעות. |
adPersonalization |
מייצג הסכמה להתאמה אישית של מודעות. |
ConsentStatus
סטטוס ההסכמה.
טיפוסים בני מנייה (enum) | |
---|---|
CONSENT_STATUS_UNSPECIFIED |
ערך הטיפוס לא צוין או שהוא לא ידוע בגרסה הזו. |
CONSENT_STATUS_GRANTED |
ניתנת הסכמה. |
CONSENT_STATUS_DENIED |
ההסכמה נדחית. |
MobileDeviceIdList
הודעת עטיפה של רשימת מזהי מכשירים ניידים שמגדירה את חברי הקהל של התאמה ללקוחות.
ייצוג ב-JSON |
---|
{
"mobileDeviceIds": [
string
],
"consent": {
object ( |
שדות | |
---|---|
mobileDeviceIds[] |
רשימה של מזהי מכשירים ניידים שמגדירה את חברי הקהל של התאמה ללקוחות. הגודל של mobileDeviceIds לא יכול להיות גדול מ-500,000. |
consent |
קלט בלבד. הגדרת ההסכמה של המשתמשים ב- אם השדה הזה לא מוגדר, סימן שלא צוינה הסכמה. אם השדות |
Methods |
|
---|---|
|
הפונקציה יוצרת את הקהל FirstAndThirdPartyAudience. |
|
עדכון רשימת החברים של קהל בהתאמה ללקוחות. |
|
הפונקציה מקבלת קהל מאינטראקציה ישירה (first-party) וקהל מצד שלישי. |
|
רשימת קהלים מאינטראקציה ישירה (first-party) ושל צד שלישי. |
|
עדכון של קהל קיים מסוג FirstAndThirdPartyAudience. |