מידע על המפרט של 'המלצות בזמן אמת'

‫Google שולחת SegmentRequest על סמך בקשות להצגת מודעות שתואמות למלאי שטחי הפרסום המטורגט שלכם לשילוב שלכם עם Real-time Curation. אובייקט SegmentRequest מספק אותות לפי הקשר או אותות מאובטחים שבהם אפשר להשתמש כדי לזהות אילו מהפלחים שלכם רלוונטיים למלאי שטחי הפרסום הנתון ב-SegmentResponse. התכונה 'המלצות בזמן אמת' תומכת באובייקטים SegmentRequest ו-SegmentResponse שנשלחים בפורמט JSON.

המדריך הזה הוא הפניה לפרוטוקול של Real-time Curation שיכול לעזור לכם לבנות את האינטגרציה.

SegmentRequest

מאפיין	סוג	תיאור
site	אתר	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. תיאור של האתר. השדה site מאוכלס אם התוכן שנתמך על ידי מודעות הוא אתר ולא אפליקציה שאינה דפדפן.
app	קידום אפליקציות	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. תיאור של האפליקציה. השדה app מאוכלס אם התוכן שנתמך על ידי מודעות הוא אפליקציה שאינה דפדפן ולא אתר.
pub	בעל תוכן דיגיטלי	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. תיאור של המוציא לאור.
user	משתמש	תיאור של המשתמש שצופה בתוכן של בעל האתר ויזם את הבקשה לפלח.
device	מכשיר	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. תיאור של המכשיר של המשתמש.
segment_request_id	מחרוזת	מזהה ייחודי שמשמש לזיהוי בקשת הפלח בנפרד מכל שאר בקשות הפלח.

אתר

מאפיין	סוג	תיאור
page	מחרוזת	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. כתובת ה-URL של הדף שבו מוצגת החשיפה.

אפליקציה

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

בעל תוכן דיגיטלי

מאפיין	סוג	תיאור
id	מחרוזת	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. מזהה בעל האתר מוגדר על ידי הסיומת של קוד הנכס באינטרנט. לדוגמה, אם קוד הנכס באינטרנט של בעל תוכן דיגיטלי הוא ca-pub-123, המזהה שלו יהיה pub-123.

משתמש

מאפיין	סוג	תיאור
consent	מחרוזת	מחרוזת הסכמה בפורמט base64 שמתאימה לאינטרנט, של Transparency and Consent Framework (‏TCF – מסגרת השקיפות וההסכמה) של IAB גרסה 2, שאוחזרה מפלטפורמה לניהול הסכמה (CMP) של IAB של בעל התוכן הדיגיטלי. השדה consent מאוכלס אם בעל התוכן הדיגיטלי שילב פלטפורמת CMP עם TCF גרסה 2, ופלטפורמת ה-CMP הזו מציינת שהתקנות של GDPR חלות על הבקשה להצגת מודעה ומספקת מחרוזת תקינה של נתוני הסכמה. פרטים על הספקים שמופיעים במחרוזת ההסכמה זמינים ברשימת הספקים הגלובלית של IAB בכתובת vendor-list.consensu.org/v2/vendor-list.json.
eids	‫EID array	האפשרות הזו נתמכת רק בשביל שותפים באוסף אותות מאובטחים. מופעים של מזהים מורחבים. ב-Curation, השדה eids הוא נתונים שבעל התוכן הדיגיטלי מספק, כמו אותות מאובטחים.

EID

מאפיין	סוג	תיאור
source	מחרוזת	האפשרות הזו נתמכת רק בשביל שותפים באוסף אותות מאובטחים. ספק המקור או הטכנולוגיה שאחראי למערך הנתונים הכלול. מבוטא כדומיין ברמה העליונה.
uids	‫UID מערך	האפשרות הזו נתמכת רק בשביל שותפים באוסף אותות מאובטחים. מערך של אובייקטים של מזהי משתמש מהמקור הנתון.

UID

מאפיין	סוג	תיאור
id	מחרוזת	האפשרות הזו נתמכת רק בשביל שותפים באוסף אותות מאובטחים. המזהה. בניהול תוכן, השדה id הוא אות מאובטח. מידע נוסף על אותות מאובטחים זמין במאמר שיתוף אותות מאובטחים עם משתתפים בבידינג ועם שותפים לאוסף ב-Ad Manager.

מכשיר

מאפיין	סוג	תיאור
geo	מיקום גיאוגרפי	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. המיקום של המכשיר של המשתמש.

Geo

מאפיין	סוג	תיאור
country	מחרוזת	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. המדינה בפורמט ISO-3166-1 Alpha-3.
region	מחרוזת	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. קוד אזור לפי תקן ISO-3166-2; קוד מדינה בן 2 אותיות אם המדינה היא ארה"ב.
metro	מחרוזת	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. קוד המטרו של Google נמצא בקובץ geo-table.csv.

SegmentResponse

מאפיין	סוג	תיאור
segment	Segment array	תיאור של פלח.

Segment

מאפיין	סוג	תיאור
segment_id	מחרוזת	המזהה של הפלח. המזהה צריך להיות זהה לערך curatorDataSegmentId שמופיע בשם הפלח במשאב curators.dataSegments של Marketplace API.