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

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

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

SegmentRequest

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

הופעות

מאפיין	סוג	תיאור
id	מחרוזת	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. מזהה ייחודי של החשיפה הזו בהקשר של בקשת הפלח. הערך מתחיל ב-1 ועולה עד n עבור n חשיפות.
banner	באנר	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. השדה הזה יאוכלס אם החשיפה מוצעת כהזדמנות לחשיפה של מודעת באנר.
video	סרטון	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. השדה הזה יאוכלס אם החשיפה מוצעת כהזדמנות לחשיפה של מודעת וידאו.
ext	ImpExt	השדה הזה מאוכלס בתוספים לאובייקט Imp.

מודעת באנר

מאפיין	סוג	תיאור
w	int	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. הרוחב בפיקסלים בלתי תלויים במכשיר (DIPS).
h	int	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. הגובה בפיקסלים בלתי תלויים במכשיר (DIPS).
pos	int	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. מיקום מודעה בדף. מידע נוסף על מיקומי מודעות אפשריים זמין במאמר רשימה: מיקומי מודעות ב-AdCOM 1.0.

וידאו

מאפיין	סוג	תיאור
w	int	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. רוחב נגן הווידאו בפיקסלים עצמאיים ממכשיר (DIP).
h	int	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. הגובה של נגן הווידאו בפיקסלים עצמאיים ממכשיר (DIP).
pos	int	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. מיקום מודעה בדף. מידע נוסף על מיקומי מודעות אפשריים זמין במאמר רשימה: מיקומי מודעות ב-AdCOM 1.0.

ImpExt

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

אתר

מאפיין	סוג	תיאור
page	מחרוזת	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. כתובת ה-URL של הדף שבו מוצגת החשיפה.
mobile	int	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. הערך הזה מציין אם האתר תוכנת כך שיבצע אופטימיזציה של הפריסה כשהוא מוצג בניידים. 0 = לא, 1 = כן.

אפליקציה

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

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

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

משתמש

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

EID

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

UID

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

מכשיר

מאפיין	סוג	תיאור
geo	מיקום גיאוגרפי	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. המיקום של המכשיר של המשתמש.
devicetype	int	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. הסוג הכללי של המכשיר. מידע נוסף על סוגי מכשירים אפשריים זמין במאמר רשימה: סוגי מכשירים ב-AdCOM 1.0.
os	מחרוזת	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. מערכת ההפעלה של המכשיר (למשל, iOS).
make	מחרוזת	האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. יצרן המכשיר (למשל, Apple).

Geo

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

SegmentResponse

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

Segment

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