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

‫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 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.

משתמש

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

EID

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

UID

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

מכשיר

מאפיין סוג תיאור
geo מיקום גיאוגרפי האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. המיקום של המכשיר של המשתמש.
devicetype int האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. הסוג הכללי של המכשיר. מידע נוסף על סוגי מכשירים אפשריים זמין במאמר רשימה: סוגי מכשירים ב-AdCOM 1.0.
os מחרוזת האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. מערכת ההפעלה של המכשיר (למשל, iOS).
make מחרוזת האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. יצרן המכשיר (למשל, Apple).
ifa מחרוזת מזהה הפרסום של המכשיר לא מוצפן (לא מגובב). בפרוטוקול של Google ליצירת אוסף בזמן אמת, זה בדרך כלל UUID באורך 36 תווים, כאשר מזהי Android הם באותיות קטנות ומזהי IDFA הם באותיות גדולות. במכשירי Samsung, אלה ערכים אלפאנומריים באורך 32 תווים.

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.