מידע על המפרט של 'המלצות בזמן אמת'
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
Google שולחת SegmentRequest על סמך בקשות להצגת מודעות שתואמות למלאי שטחי הפרסום המטורגט שלכם לשילוב שלכם עם Real-time Curation. אובייקט SegmentRequest מספק אותות הקשריים או אותות לזיהוי קהלים שבהם אפשר להשתמש כדי לזהות אילו מהפלחים שלכם רלוונטיים למלאי שטחי הפרסום הנתון ב-SegmentResponse.
התכונה 'המלצות בזמן אמת' תומכת באובייקטים SegmentRequest ו-SegmentResponse שנשלחים בפורמט JSON.
המדריך הזה הוא מקור מידע על פרוטוקול האוצרות בזמן אמת, שיכול לעזור לכם ליצור את השילוב.
האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. תיאור של האתר. השדה site מאוכלס אם התוכן שנתמך על ידי מודעות הוא אתר ולא אפליקציה שאינה מבוססת על דפדפן.
האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. רוחב בפיקסלים בלתי תלויים במכשיר (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.
האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. המיקום של המכשיר של המשתמש.
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
מחרוזת
האפשרות הזו זמינה רק לשותפים שיוצרים אוספים בהקשר. עיר באמצעות קוד האו "ם למיקומי מסחר ותובלה.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2026-09-23 (שעון UTC)."],[],[]]