אב של Authorized Buyers בזמן אמת

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

מומלץ גם לעיין בקובץ אב של RTB של Authorized Buyers שעליו מבוסס המדריך הזה.

אובייקט BidRequest

זוהי ההודעה שבה Google משתמשת כדי לבקש הצעות מחיר. BidRequest כולל את משבצת המודעה מחשיפה אחת.

בקטע הזה מפורט מידע שאנחנו יודעים על המשתמש.

מידע על דף האינטרנט או האפליקציה לנייד שמהם הגיעה החשיפה.
מאפיין נדרש/אופציונלי Type פרטי ההטמעה
id חובה בייטים מזהה בקשה ייחודי שנוצר על ידי Google. האורך הוא 16 בייטים.
ip אופציונלי בייטים 3 הבייטים הראשונים של כתובת ה-IP בסדר הבייטים של הרשת ב-IPv4 או 6 הבייטים הראשונים ב-IPv6. שימו לב שהמספר והמיקום של הבייטים הכלולים בכתובות IPv6 עשויים להשתנות בהמשך.
user_data_treatment חזרה טיפוסים בני מנייה (enum) כשמגדירים את user_data_care, הנתונים בקובץ ה-cookie/מזהה של המשתמש נמחקים מהבקשה ולא נשלחים מתוך נכסי היתרונות המרכזיים. השדות המושפעים הם:
  • מזהה משתמש google_user_id
  • מתארח_data_data
  • mobile.encoded_Advertising_id
  • mobile.encrypt_hashed_idfa
  • session_id

TAG_FOR_CHILD_DIRECTED_TREATMENT = 0 – יש לטפל בבקשה הנוכחית כמותאמת לילדים לפי חוק הגנת הפרטיות של ילדים באינטרנט. למידע נוסף יש לעיין במאמר הזה.

google_user_id אופציונלי מחרוזת מזהה Google של המשתמש, כפי שמתואר בתיעוד של שירות ההתאמה של קובצי ה-cookie. השדה הזה הוא גרסה מרופדת-בטוחה בקידוד web64 של מזהה קובץ cookie בינארי. פרטים נוספים לגבי הקידוד מופיעים בקטע קידוד בתקן Base 64 עם כתובת URL ושל אלפבית בטוח של שם קובץ ב-RFC 3548. השדה הזה זהה למזהה Google שהוחזר על ידי שירות ההתאמה של קובצי ה-cookie.
cookie_version אופציונלי int32 מספר הגרסה של google_user_id. לפעמים אנחנו עשויים לשנות את המיפוי מקובץ cookie לgoogle_user_id. במקרה הזה, מספר הגרסאות יוגדל.
cookie_age_seconds אופציונלי int32 הזמן בשניות מאז יצירת google_user_id. ייתכן שאפשר יהיה לחשב את המספר הזה.
hosted_match_data אופציונלי בייטים התאמת הנתונים שמאוחסנים עבור google_user_id באמצעות שירות ההתאמה של קובצי cookie. אם קיימת התאמה, השדה הזה מכיל את הנתונים המפוענחים שהועברו בפרמטר google_hm.
session_id אופציונלי מחרוזת מייצגת סשן של משתמש לטווח קצר במכשירי CTV/OTT, עם משך ביקור מקסימלי של 6 שעות. השימוש ב-session_id לעולם אינו מותר להתאמה אישית של מודעות. יש להשתמש ב-session_id רק עבור מכסת תדירות, החרגות תחרותיות או למטרות קשורות.
user_agent אופציונלי מחרוזת מחרוזת המזהה את הדפדפן ואת סוג המכשיר שממנו נשלחה הבקשה. יכול להיות שחלק מהנתונים יצונזרו או יוחלפו.
privacy_treatments אופציונלי טיפולים בנושא פרטיות טיפולים לשמירה על פרטיות. כדי להגן על פרטיות המשתמשים, חלק מהשדות בבקשה להצעת מחיר יכולים להיות מובנים או מושחרים. בהודעה הזו מפורט מידע על טיפולי הפרטיות שחלים על הזדמנויות להצגת מודעות דרך הבקשה הזו.
user_agent_data אופציונלי סוכן משתמש מידע על סוכן משתמש.
publisher_country אופציונלי מחרוזת המדינה בכתובת לחיוב של בעל התוכן הדיגיטלי. המדינה הזו עשויה להיות שונה מהמדינה שבה המשתמש זוהה ב-geo_criteria_id או מהמדינה המארחת של האתר. הרשימה המלאה של קודי המדינות מופיעה במסמכי התיעוד של קודי המדינות.
host_publisher_id אופציונלי מחרוזת המזהה של המוציא לאור המארח. אם השדה מאוכלס, סימן שבעל האפליקציה המארח השתתף בחלוקת הכנסות ושאפשר להשתמש במזהה כדי לאשר את הקובץ ads.txt.
inventorypartnerdomain אופציונלי מחרוזת הדומיין של השותף (של האתר או של בעלי האפליקציה) שבבעלותו חלק ממלאי שטחי הפרסום באתר או באפליקציה. קובץ ads.txt או קובץ app-ads.txt של השותף יתארח כאן. מידע נוסף זמין בכתובת http://iabtechlab.com/wp-content/uploads/2021/03/ctv-app-ads-explainer-guide.pdf
geo_criteria_id אופציונלי int32 המיקום של משתמש הקצה. המערכת משתמשת בקבוצת משנה של הקודים שנעשה בהם שימוש ב-Google Ads API. בטבלה geo-table.csv במסמכי התיעוד הטכני מופיעה רשימה של מזהים. השדה geo_criteria_id מחליף את השדות הבאים: מדינה, אזור, עיר ומטרופולין שהוצאו משימוש.
geo אופציונלי מיקום גיאוגרפי המיקום הגיאוגרפי המשוער של המשתמש. כל פרטי המיקום נגזרים מהמיקום הגיאוגרפי של כתובות ה-IP. השדות של קווי הרוחב/אורך יכולים להיות מיקום הפניה (למשל, מרכז) בהתאם למיקום הגיאוגרפי שהתקבל מכתובת ה-IP וגם מהשדות האחרים (לדוגמה עיר) והדיוק הוא הרדיוס של מעגל עם האזור המשוער. המיקום והדיוק שלו ימוזגו לפי הצורך כדי להגן על פרטיות המשתמשים.
postal_code
postal_code_prefix 		אופציונלי מחרוזת זוהה מיקוד מהסוג המתאים למדינה של משתמש הקצה (לדוגמה, מיקוד אם המדינה היא "US"). השדה postal_code_prefix מוגדר כשהדיוק נמוך מדי, ולכן לא ניתן לרמוז על קוד מלא. אחרת, השדה postal_code מוגדר.
encrypted_hyperlocal_set אופציונלי בייטים אותות היפר-מקומיים מוצפנים.
hyperlocal_set אופציונלי HyperlocalSet גרסה לא מוצפנת של encrypted_hyperlocal_set. השדה הזה מוגדר רק כשמשתמשים בחיבור SSL.
timezone_offset אופציונלי int32 הסטייה של זמן המשתמש מ-GMT בדקות. לדוגמה, הערך GMT+10 הוא timezone_offset = 600.
user_list חזרה רשימת משתמשים
publisher_id אופציונלי מחרוזת המזהה של בעל התוכן הדיגיטלי, כפי שמוגדר בסיומת של קוד בעל האפליקציה של קוד נכס האינטרנט. לדוגמה, "pub-123" הוא קוד בעל האתר של קוד נכס האינטרנט "ca-pub-123" (קוד ca הוא התחילית הספציפית למוצר של נכס האינטרנט).
seller_network_id אופציונלי int32 מזהה הרשת של אתר המכירה. כדי לקבל רשימה של מזהים, יש לעיין בקובץ sellers-network-ids.txt במסמכי התיעוד הטכני. האפשרות הזו מוגדרת רק אם האתר לא אנונימי ובעל התוכן הדיגיטלי מאפשר טירגוט לאתר.
partner_id אופציונלי קבוע 64 המזהה של השותף שמספק את המלאי הזה. האפשרות הזו מוגדרת רק כש-seller_network_id מוגדר גם, ופרטי שותף נוספים מעבר ל-seller_network_id זמינים גם הם. הערך של partner_id הוא חסר משמעות, מלבד הצגת מזהה יציב.
url אופציונלי מחרוזת כתובת ה-URL של הדף שהוסר עם הפרמטרים. התהליך מתחיל תמיד בפרוטוקול (http או https).
is_semi_transparent_request אופציונלי בוליאני מציין שהבקשה משתמשת במיתוג שקוף למחצה - כלומר, רק גרסה חתוכה של כתובת ה-URL תסופק. ההחלטה הזו התקבלה על ידי בעל התוכן הדיגיטלי, בכתובת //support.google.com/admanager/answer/4584891.
detected_language חזרה מחרוזת שפות שהמשתמשים זוהו, על סמך השפה של דף האינטרנט, הגדרות הדפדפן ואותות נוספים. הצו שרירותי. הקודים הם באורך של 2 או 5 תווים והם מתועדים בטבלת קודי השפות.
detected_vertical חזרה ענף הערה: הערכים בשדה הזה מצונזרים עכשיו. רשימה לא מסודרת של ענפי תוכן שזוהו. כדי לקבל רשימה של מזהים, יש לעיין בקובץ publisher-verticals.txt במסמכי התיעוד הטכני.
detected_content_label חזרה int32 הערה: הערכים בשדה הזה מצונזרים עכשיו. רשימה של תוויות תוכן שזוהו. כדי לקבל רשימה של מזהים, יש לעיין בקובץ content-labels.txt במסמכי התיעוד הטכני.
google_query_id אופציונלי מחרוזת זהו מזהה ייחודי לשאילתה הכוללת. אם יש כמה תוספי יתרונות מרכזיים של שאילתה מסוימת, כל בקשות היתרונות המרכזיים לשאילתה הזו יכללו את אותו google_query_id.
auction_type אופציונלי טיפוסים בני מנייה (enum) סוג המכרז שיופעל עבור השאילתה הזו. ברירת מחדל = SECOND_PRICE.

UNKNOWN_AUCTION_TYPE = 0
FIRST_PRICE = 1
SECOND_PRICE = 2
FIXED_PRICE = 3

device אופציונלי מכשיר
key_value חזרה KeyValue
mobile אופציונלי בנייד
video אופציונלי וידאו
publisher_settings_list_id אופציונלי קבוע 64 מזהה הרשימה של הגדרות בעל האתר שרלוונטי לדף הזה. לפרטים נוספים, אפשר לעיין במדריך לבעלי אתרים ב-RTB.
publisher_type אופציונלי טיפוסים בני מנייה (enum) סוג בעל התוכן הדיגיטלי של מלאי שטחי הפרסום שבו המודעה תוצג. בכל בקשה, המלאי של בעל התוכן הדיגיטלי יכול להיות בבעלות ובהפעלה (O&O) על ידי בעל התוכן הדיגיטלי או בסטטוס לא ידוע. ברירת מחדל = UNKNOWN_PUBLISHER_TYPE.

UNKNOWN_PUBLISHER_TYPE = 0
PUBLISHER_OWNED_AND_OPERATED = 1
PUBLISHER_REPRESENTED = 2
page_visibility אופציונלי טיפוסים בני מנייה (enum) מצב החשיפה של דף האינטרנט שמכיל את מיקומי המודעות. למידע נוסף: www.w3.org/TR/page-visible/.

VISIBILITY_STATE_UNKNOWN = 0
VISIBILITY_STATE_VISIBLE = 1; הדף גלוי לפחות באופן חלקי. לדוגמה, בכרטיסייה בחזית של חלון ללא מינימום.
VISIBILITY_STATE_HIDDEN = 2; הדף לא גלוי למשתמשים בכלל. לדוגמה, כשהדף נמצא בכרטיסייה של דפדפן ברקע או בחלון ממוזער.

adslot חזרה משבצת מודעה
bid_response_feedback חזרה הצעת משוב
response_deadline_ms אופציונלי int32 מציינת כמה זמן Google תמתין לתשובה, באלפיות השנייה, עבור הבקשה הזו להצעת מחיר. אם המדיניות לא מוגדרת, מגישי הצעות המחיר צריכים להשתמש בברירת המחדל של תאריך היעד.
is_test אופציונלי בוליאני אם כן, מדובר בבקשת בדיקה. התוצאות לא יוצגו למשתמשים ולא נחייב אותך על תשובה, גם אם היא תזכה במכרז. עדיין כדאי לבצע עיבוד רגיל, כי הבקשה עשויה לשמש להערכת זמני האחזור או לבדיקות אחרות. במהלך הבדיקה הראשונית עם תנועת הגולשים ב-Google, כל התגובות שלך יסוננו מהמכרז, אם האפשרות הזו מקבלת את הערך True או False.
is_ping אופציונלי בוליאני אם הערך הוא True, הבקשה הזו נועדה למדוד את זמן האחזור של הרשת. מומלץ להחזיר הצעת מחיר ריקה עם ערך של שגיאת event_time_ms בלבד, במהירות האפשרית, בלי להפעיל לוגיקת בידינג.
is_predicted_to_be_ignored אופציונלי בוליאני אם מתקיים הערך, מודל היתרונות המרכזיים לא צפוי להגיש הצעת מחיר על הבקשה הזו. אנחנו שולחים אחוז דגימה של בקשות כאלה כדי שנוכל לעדכן באופן אוטומטי את המודל כשדפוסי הבידינג משתנים.
supply_chain אופציונלי SupplyChain

אובייקט UserAgent

מידע על סוכן משתמש. שדה זה יאוכלס במידע על סוכן המשתמש, שחולץ מהכותרת User-Agent או מכותרות Sec-CH-UA.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
browser אופציונלי BrandVersion מזהה את הדפדפן.
platform אופציונלי BrandVersion מזהה את הפלטפורמה.
mobile אופציונלי בוליאני הערך הוא True אם הנציג מעדיף תוכן מותאם לניידים. לקבלת מידע ספציפי על המכשיר, עיין בשדה BidRequest.device . הערך עשוי להיות שונה מהשדה הזה (לדוגמה, דפדפן של טלפון נייד יכול לבקש 'אתר למחשב').
architecture אופציונלי מחרוזת ארכיטקטורת המכשיר, לדוגמה, "x86" או "arm".
bitness אופציונלי מחרוזת קצב העברת הנתונים של המכשיר, לדוגמה, "64" עבור ארכיטקטורת 64 סיביות.
model אופציונלי מחרוזת דגם המכשיר.

אובייקט הטיפול בפרטיות

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

הורה
מאפיין נדרש/אופציונלי Type פרטי ההטמעה
non_personalized_ads_reason אופציונלי טיפוסים בני NonPersonalizedAdsReason

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

UNKNOWN = 0; הסיבה לא ידועה.

PUBLISHER_DECLARED_NPA = 1; בעל התוכן הדיגיטלי הצהיר שהבקשה הזו צריכה להציג מודעות ללא התאמה אישית ללא קשר לאותות אחרים.

RESTRICT_DATA_PROCESSING= 2; בעל האפליקציה ביקש עיבוד נתונים מוגבל בבקשה הזו.

USER_OPT_OUT = 3; המשתמש ביטל את ההסכמה להתאמה אישית של מודעות.

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

אובייקט BrandVersion

הורה

שפע של (מותג, גרסה) של הדפדפן או הפלטפורמה.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
brand אופציונלי מחרוזת מזהה מותג, למשל "Chrome" או "Windows".
version חזרה מחרוזת גרסה, מפוצלת ברכיבים לפי הצורך, לדוגמה, {"85", "1"} = v85.1.

אובייקט גיאוגרפי

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

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
lat אופציונלי כפולה
lon אופציונלי כפולה קו אורך מ-180.0 עד +180.0, שבו הנקודה השלילית היא מערב.
country אופציונלי מחרוזת מדינה באמצעות ISO-3166-1 Alpha-3.
region אופציונלי מחרוזת קוד אזור באמצעות ISO-3166-2; קוד מדינה בן 2 אותיות אם הוא בארה"ב.
metro אופציונלי מחרוזת קוד מטרופולין של Google; דומה, אך לא מדויק, DMAs של Nielsen.
city אופציונלי מחרוזת עיר שמשתמשת בקוד של האומות המאוחדות למיקומים של תחבורה ומסחר. אפשר ללחוץ על מדינה ברשימת המדינות כדי לראות קודי עיר.
zip אופציונלי מחרוזת מיקוד.
accuracy אופציונלי int32 דיוק המיקום המשוער במטרים.
utcoffset אופציונלי int32 זמן מקומי כמספר +/- דקות מ-UTC.

אובייקט HyperlocalSet

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
hyperlocal חזרה היפר-מקומית כרגע השדה הזה מכיל פוליגון היפר-מקומי אחד לכל היותר.
center_point אופציונלי Hyperlocal.Point המרכז הגיאומטרי המשוער של אזור גבול וירטואלי. הוא מחושב אך ורק על סמך הצורה הגיאומטרית של אזור הגבולות הווירטואליים, ובשום אופן לא מציין את המיקום בפועל של המכשיר הנייד באזור הגבולות הווירטואליים. אם מצוינים מספר פוליגונים היפר-מקומיים למעלה, Center_point הוא המרכז הגיאומטרי של כל הפוליגונים ההיפר-מקומיים.

אובייקט היפר-מקומי

הורה

מידע משוער על המיקום הגיאוגרפי המשוער על סמך כתובת ה-IP של המכשיר שממנו נשלחה הבקשה להצגת מודעה.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
corners חזרה נקודה המכשיר יכול להיות בכל שלב במצולע הגבולות הווירטואליים המוגדר על ידי רשימת פינות. נכון לעכשיו, הפוליגון הוא מקבילית מקבילה עם 4 פינות.
אובייקט
הורה

מיקום על פני השטח של כדור הארץ.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
latitude אופציונלי מספר ממשי (float) קו הרוחב של המיקום.
longitude אופציונלי מספר ממשי (float) קו האורך של המיקום.

אובייקט של רשימת משתמשים

השדה הזה לא מאוכלס כברירת מחדל. אנחנו ממליצים למגישי הצעות המחיר לשמור ולשמור את המזהים ברשימה באמצעות google_user_id או hosted_match_data כמפתחות.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
id אופציונלי int64 המזהה של רשימת המשתמשים.
age_seconds אופציונלי int32 משך הזמן בשניות מאז שהמשתמש נוסף לרשימה.

אובייקט אנכי

אחת או יותר מהקטגוריות בדף זוהו על ידי Google.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
id חובה int32 המזהה האנכי. כדי לקבל רשימה של מזהים, יש לעיין בקובץ Publisher-verticals.txt במסמכים הטכניים.
weight חובה מספר ממשי (float) המשקל לתחום הזה, בטווח (0.0, 1.0]. לענפים רלוונטיים יותר יש משקל גבוה יותר.

אובייקט המכשיר

מידע על המכשיר.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
device_type אופציונלי טיפוסים בני מנייה (enum) סוג המכשיר שבו תוצג המודעה. ברירת מחדל = UNKNOWN_DEVICE.

UNKNOWN_DEVICE = 0
HIGHEND_PHONE = 1
TABLET = 2
PERSONAL_COMPUTER = 3 - מחשבים שולחניים או מחשבים ניידים.
CONNECTED_TV = 4 – טלוויזיות מחוברות (טלוויזיות חכמות) ומכשירים מחוברים (כמו Roku ו-Apple TV).
GAME_CONSOLE = 5

platform אופציונלי מחרוזת הפלטפורמה של המכשיר. דוגמאות: Android, iPhone, דקל.
brand אופציונלי מחרוזת המותג של המכשיר, לדוגמה, Nokia, Samsung.
model אופציונלי מחרוזת דגם המכשיר, לדוגמה, N70, Galaxy.
os_version אופציונלי גרסה גרסת מערכת ההפעלה, לדוגמה 2 ל-Android 2.1 או 3.3 ל-iOS 3.3.1.
carrier_id אופציונלי int64 מזהה ייחודי של ספק הסלולר אם המכשיר מחובר לאינטרנט דרך ספק (ולא דרך Wi-Fi). כדי למצוא את שם הספק והמדינה ממזהה הספק, אפשר לעיין בטבלה של ספקי הסלולר.
screen_width אופציונלי int32 הרוחב של מסך המכשיר בפיקסלים.
screen_height אופציונלי int32 גובה מסך המכשיר בפיקסלים.
screen_pixel_ratio_millis אופציונלי int32 משמש למכשירים עם צפיפות גבוהה (לדוגמה, תצוגות של רשתית ב-iOS). ערך שאינו ברירת המחדל מציין כי גודל המסך הנומרי (עם פיקסלים כיחידה) לא מתאר את מספר הפיקסלים בפועל במסך. לדוגמה, הרוחב והגובה המספריים עשויים להיות 320x640 למסך שיש בו בפועל 640x1280 פיקסלים, ולכן המידות של screen_width=320, screen_height=640 ו-screen_pixel_ratio_millis=2000 יהיו זהות פי שניים מאשר בכל המידות.

ברירת מחדל = 0.
screen_orientation אופציונלי טיפוסים בני מנייה (enum) כיוון המסך של המכשיר אחרי שליחת הבקשה להצגת מודעה. ברירת מחדל = UNKNOWN_ORIENTATION.

UNKNOWN_ORIENTATION = 0
PORTRAIT = 1
LANDSCAPE = 2

hardware_version אופציונלי מחרוזת דגם מכשיר iOS של Apple; לדוגמה, "iphone 5s", "iphone 6+", "ipad 4".
limit_ad_tracking אופציונלי בוליאני "הגבל מעקב מודעות" הוא אות שנתמך באופן מסחרי על סמך מערכת ההפעלה או הגדרות המכשיר, כאשר false מציין שהמעקב אינו מוגבל ו-true מציין שהמעקב חייב להיות מוגבל על פי הנחיות מסחריות.

האות הזה משקף את ההחלטות של המשתמשים בפלטפורמות, כולל שקיפות מעקב אחר אפליקציות ב-iOS. למידע נוסף, ראו הנחיות ל-LMt ולמעקב אחר אפליקציות ומזהה פרסום ב-Android.
app_tracking_authorization_status אופציונלי טיפוסים בני מנייה (enum) השדה הזה מאוכלס רק במכשירי iOS. מציין את סטטוס ההרשאה למעקב אחר אפליקציות. הערך הזה מאוחזר מ-ATTrackingManager ומסופק כפי שהוא. למידע נוסף על סטטוס ההרשאה למעקב אחר אפליקציות ב-iOS, ניתן לקרוא את המאמר הזה.

NOT_DETERMINED = 0
RESTRICTED = 1
DENIED = 2
AUTHORIZED = 3

אובייקט OsVersion

הורה

מכיל את גרסת מערכת ההפעלה של הפלטפורמה. לדוגמה, ב-Android 2, major=2, min=0. ל-iPhone 3.3.1, large=3 ו-min=3.

מאפיין נדרש/אופציונלי Type
major
minor
micro 		אופציונלי int32

אובייקט KeyValue

מאפיינים נוספים של ערך מפתח. לא בשימוש כרגע.

מאפיין נדרש/אופציונלי Type
key
value 		אופציונלי מחרוזת

אובייקט לנייד

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

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
is_app אופציונלי בוליאני אם כן, הבקשה הזו מגיעה מאפליקציה לנייד. תמיד יהיה נכון כשמוגדר app_id.
app_id אופציונלי מחרוזת המזהה של האפליקציה לנייד כשמשתמש לשאילתת המודעה הזו הגיע מאפליקציה לנייד. אם הורדת את האפליקציה מחנות האפליקציות של Apple iTunes, מזהה החנות בחנות האפליקציות הוא 343200656. במכשירי Android, זהו שם החבילה המלא; לדוגמה, com.rovio.angrybirds. עבור מכשירי Windows, זהו מזהה האפליקציה. לדוגמה, f15abcde-f6gh-47i0-j3k8-37l93817mn3o.
is_interstitial_request אופציונלי בוליאני אם כן, זו בקשה להצגת מודעה במסך מלא לנייד.
app_category_ids חזרה int32 הערה: הערכים בשדה הזה מצונזרים עכשיו. השדה הזה מכיל את מזהי הקטגוריות שאליהן שייכת האפליקציה הנוכחית לנייד. השדה הזה יהיה ריק אם הערך is_app לא נכון. המיפוי בין אפליקציות לנייד וקטגוריות מוגדר על ידי חנות Google Play לאפליקציות ל-Android, או על ידי Apple iTunes Store לאפליקציות iOS. כדי לחפש את שם הקטגוריה ממזהה הקטגוריה, אפשר לעיין בטבלה קטגוריות של אפליקציות לנייד.
is_mobile_web_optimized אופציונלי בוליאני עבור בקשה באינטרנט לנייד, השדה הזה מציין אם הדף עבר אופטימיזציה לדפדפנים לנייד בטלפונים מתקדמים. ברירת מחדל = false.
is_app_open_ad אופציונלי בוליאני מציין אם בקשה להצעת מחיר לאפליקציה לנייד מיועדת למודעה בפתיחת אפליקציה. למידע נוסף, אפשר לעיין בהנחיות בנושא מודעות בפתיחת אפליקציה.
encrypted_advertising_id אופציונלי בייטים השדה הזה משמש למזהי פרסום:
  1. מכשירי iOS (נקראים 'מזהה לפרסום' או IDFA, כפי שמתואר במאמר הזה במרכז העזרה).
  2. מכשירי Android.
  3. מכשירי Roku.
  4. מכשירי Microsoft Xbox.
  5. מכשירי Amazon.

כאשר encrypted_advertising_id הוא IDFA, הטקסט הפשוט לאחר פענוח המידע מוצפן הוא ה-IDFA (U6ID בנפח 16 בייט) שמוחזר על ידי ה-[ASIdentifierManager advertisingIdentifier] של iOS. עבור encrypted_hashed_idfa, הטקסט הפשוט הוא גיבוב (15-בייט) של MD5 של ה-IDFA. רק אחד משני השדות יהיה זמין, בהתאם לגרסת ה-SDK שממנה נשלחה הבקשה. ערכות SDK מאוחרות יותר מספקות ערכים לא מגובבים.
encrypted_hashed_idfa אופציונלי בייטים יש לעיין גם בתיאור של encrypted_advertising_id.
advertising_id אופציונלי בייטים גרסה לא מוצפנת של encrypted_advertising_id. השדה הזה מוגדר רק כשמשתמשים בחיבור SSL. השדה הזה הוא UUID בגודל 16 בייט.
hashed_idfa אופציונלי בייטים גרסה לא מוצפנת של encrypted_hashed_idfa. השדה הזה מוגדר רק כשמשתמשים בחיבור SSL. שדה זה הוא קובץ MD6 בגודל 16 בייט.
app_name אופציונלי מחרוזת שמות של אפליקציות ל-Android מגיעים מחנות Google Play. את שמות האפליקציות לאפליקציות ל-iOS מספקים App Annie.
app_rating אופציונלי מספר ממשי (float) דירוג המשתמשים הממוצע לאפליקציה. הטווח של דירוגי המשתמשים הוא בין 1.0 ל-5.0. זמינות בשלב זה רק לאפליקציות בחנות Google Play.
installed_sdk אופציונלי InstalledSdk זיהוי של מידע ב-SDK שמותקן באפליקציה של בעל התוכן הדיגיטלי, ולגישה אליו. לרוב, מדובר ב-SDK של מגיש הצעות המחיר.
skadn אופציונלי SKAdNetworkRequest פרטי SKAdNetwork של בעל התוכן הדיגיטלי שתומכים בשיוך של התקנת אפליקציות ל-iOS 14 ואילך. ממשק ה-API של SKAdNetwork של Apple מסייע למפרסמים למדוד התקנות של אפליקציות שמקורן במודעות, על ידי שליחת דיווח חוזר על המרה (PostBack) לרשת המודעות לאחר התקנה מוצלחת. בעלי תוכן דיגיטלי יצטרכו להגדיר את רשתות המודעות הנתמכות ברשימת הנכסים של האפליקציה (Info.plist) כדי שאפשר יהיה לשייך התקנה להתקנה לחשיפה של המודעה. מידע נוסף זמין במאמר הזה.

אובייקט מותקנת של SDD

הורה

זיהוי של מידע ב-SDK שמותקן באפליקציה של בעל התוכן הדיגיטלי, והמידע הזה מופיע בו. לרוב, מדובר ב-SDK של מגיש הצעות המחיר.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
id אופציונלי מחרוזת מזהה עבור ה-SDK המותקן.
sdk_version אופציונלי גרסה גרסת ה-SDK המותקנת.
adapter_version אופציונלי גרסה גרסת המתאם שיוצרת קשר עם ה-SDK המותקן.
אובייקט גרסה
הורה

הגרסה הסמנטית של ה-SDK המותקן והמתאם שמקשר בין ה-SDK המותקן לבין ה-SDK של Google.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
major אופציונלי int32 ברירת מחדל = -1
minor אופציונלי int32 ברירת מחדל = -1
micro אופציונלי int32 ברירת מחדל = -1

אובייקט SKAdNetworkRequest

הורה

פרטי SKAdNetwork של בעל התוכן הדיגיטלי שנועדו לתמוך בשיוך של התקנת אפליקציות ל-iOS 14 ואילך. ה-SKAdNetwork API של Apple עוזר למפרסמים למדוד התקנות של אפליקציות שמקורן במודעות, על ידי שליחת דיווח חוזר על המרה לרשת המודעות לאחר התקנה מוצלחת. בעלי תוכן דיגיטלי יצטרכו להגדיר רשתות מודעות נתמכות ברשימת הנכסים של האפליקציה (Info.plist) כדי שאפשר יהיה לשייך התקנה להתקנה של המודעה. מידע נוסף זמין במאמר הזה.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
versions חזרה מחרוזת רשימה של כל גרסאות SKAdNetwork שנתמכות בבקשה, בהתאם לגרסת ה-OS ולגרסת ה-SDK.
sourceapp אופציונלי מחרוזת מזהה האפליקציה של בעל האפליקציה ב-App Store של Apple.
skadnetids חזרה מחרוזת רשומות SKAdNetworkIdentifier בקובץ ה-Info.plist של האפליקציה של בעל התוכן הדיגיטלי.
supported_fidelity_types חזרה טיפוסים בני מנייה (enum) רשימת הסוגים של האיכות הנתמכת, בהתאם לגרסת SKAdNetwork API שנתמכת על ידי מערכת ההפעלה וה-SDK, וגם נכסי מיקום מודעה.

VIEW_THROUGH_ADS = 0; ייחוס התקנות של אפליקציות בתוך 24 שעות לאחר צפייה במודעה במשך 3 שניות לפחות. נתמכת בגרסה 2.2 ואילך של SKAdnetwork. מידע נוסף זמין במאמר הזה.
STOREKIT_RENDERED_ADS = 1; מודל שיוך (Attribution) להתקנות של אפליקציה, שנוצר מדף המוצר של AppKit שמעובד ב-AppKit, בעקבות קליקים על מודעות. נתמכת בכל הגרסאות של SKAdNetwork. מידע נוסף זמין במאמר הזה.

skoverlay אופציונלי בוליאני מציין אם הבקשה תומכת ב-SKLayer של מודעות וידאו.

אובייקט וידאו

מידע על הסרטון אם מדובר בבקשה למודעה בתוך סרטון.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
placement אופציונלי טיפוסים בני מנייה (enum) תיאור המקום שבו מודעת הווידאו תופעל. ברירת מחדל = UNKNOWN_PLACEMENT.

UNKNOWN_PLACEMENT = 0.
INSTREAM = 1 – המשמעות של מודעת וידאו In-stream היא שהמודעה תוצג לפני תוכן וידאו אחר, במהלכו או אחריו. הדבר דומה לפרסומת מסורתית בטלוויזיה. תוכן הווידאו שהמשתמש צופה בו לא מופעל בזמן שהמודעה מופעלת.
INTERSTITIAL = 2 – מודעת מעברון פירושה שהמודעה מוצגת לפני תוכן שאינו וידאו (לדוגמה: מאמר חדשותי או משחק וידאו). המודעה מכסה את כל שטח המסך או את רובו, והמשתמש לא יכול להמשיך לתוכן עד שהמודעה מסתיימת או דילגת עליה.
IN_FEED = 3 – פורמט מודעת הווידאו בגוף הפיד הוא קריאייטיב וידאו שמוצג בפיד תוכן, בדרך כלל פיד של אפליקציה חברתית, רשימה של פריטי תוכן וכו' בזמן שהמשתמש גולל. הוא ממורכז ולא בצד.
AUDIO = 4 – אודיו הוא בקשה להצגת מודעה משידור אודיו. ההבדל בין המדד הזה לבין Instream הוא בלעדי לבקשות הווידאו.
IN_ARTICLE = 5 – פורמט הווידאו בגוף הכתבה הוא קריאייטיב וידאו שנטען ומופעל בין פסקאות של תוכן מערכתי כנגן וידאו עצמאי.

description_url אופציונלי מחרוזת כתובת ה-URL של הדף שבעלי התוכן הדיגיטלי מספקים ל-Google לצורך תיאור של תוכן הסרטון, תוך הסרת הפרמטרים.
is_embedded_offsite אופציונלי בוליאני אם True, הסרטון מוטמע בדף מחוץ לדומיין של בעל התוכן הדיגיטלי. כשהמדיניות הזו מוגדרת, description_url מפנה לתיאור של הסרטון (כפי שהוא תמיד פועל), והשדה url ב-BidRequest הוא הדף שבו מוטמע הסרטון. לדוגמה: בקשה להצגת מודעת וידאו In-stream בסרטון Vimeo שמשותפים ב-Facebook הוגדרה is_embedded_offsite. השדה url מיועד לדף Facebook ו-description_url מפנה לסרטון ב-Vimeo.
playback_method אופציונלי טיפוסים בני מנייה (enum) מתאר את אופן ההפעלה של מודעת הווידאו. שיטת ההפעלה מוגדרת כהפעלה אוטומטית, 'לחיצה להפעלה' או 'העברת עכבר' על סמך המדידה הטובה ביותר הזמינה. הנתונים האלה כוללים, למשל, את האינטראקציה האחרונה של המשתמש עם דף האינטרנט. כשמפעילים את התכונה 'הפעלה אוטומטית', המודעות יכולות לפעול כשהצליל מופעל או מושבת. מודעות מסוימות (לדוגמה, מודעות בגוף הפיד) מושתקות עד שהמשתמש מבצע אינטראקציה עם המודעה.

לחלופין, אם מודעה מופעלת בדרך כלל עם צליל מופעל, אבל המכשיר מושתק, הערך יוגדר כצליל כבוי. במכשירים שבהם לא ניתן לקבוע אם המכשיר מושתק (לדוגמה, במחשב), אנחנו מניחים שהצליל מופעל. ברירת מחדל = METHOD_UNKNOWN.

METHOD_UNKNOWN = 0
AUTO_PLAY_SOUND_ON = 1
AUTO_PLAY_SOUND_OFF = 2
CLICK_TO_PLAY = 3
MOUSE_OVER = 4
INITIATE_ON_ENTERING_VIEWPORT_SOUND_ON = 5
INITIATE_ON_ENTERING_VIEWPORT_SOUND_OFF = 6

is_clickable אופציונלי בוליאני האם מלאי שטחי הפרסום מאפשר ללחוץ על מודעת הווידאו כדי להעביר את המשתמש לאתר של מפרסם. בפלטפורמות מסוימות, ובפרט בטלוויזיות מחוברות, אין תמיכה בקליק על מודעות וידאו ולכן השדה הזה מוגדר כ-False.
videoad_start_delay אופציונלי int32 הזמן באלפיות השנייה מתחילת הסרטון שבו המודעה תוצג. 0 פירושו מודעה לפני סרטון, 1- (או מספר שלילי של 32 ביט) כלומר מודעה בסוף סרטון, ו-1 (או 32 ביט חיובי) פירושו מודעה באמצע סרטון. הערך חוקי רק אם הפרמטר הזה מוגדר. כשהמדיניות לא מוגדרת, מיקום התצוגה לא ידוע.
max_ad_duration אופציונלי int32 משך הזמן המקסימלי באלפיות שנייה של המודעה שצריך להחזיר. אם הערך לא הוגדר או שהערך שלו הוא <= 0, ניתן להגדיר משך זמן כלשהו.
min_ad_duration אופציונלי int32 משך הזמן המינימלי באלפיות השנייה של המודעה שצריך להחזיר. אם הערך לא הוגדר או שהערך שלו הוא <= 0, לא הוגדר משך זמן מינימלי.
max_ads_in_pod אופציונלי int32 מספר המודעות המקסימלי בכל סרטון. ערך שאינו אפס מציין שמיקום המודעה הנוכחי הוא חלון וידאו שיכול להציג בו מספר מודעות וידאו. המספר בפועל של מודעות הווידאו המוצגות יכול להיות קטן מהערך הזה או שווה לו, אך לא יכול להיות גבוה ממנו.
video_ad_skippable אופציונלי טיפוסים בני מנייה (enum) האם בעל התוכן הדיגיטלי מתיר/מחייב/חוסם מודעות וידאו שניתן לדלג עליהן? ברירת מחדל = ALLOW_SKIPPABLE.

ALLOW_SKIPPABLE = 0
REQUIRE_SKIPPABLE = 1
BLOCK_SKIPPABLE = 2

skippable_max_ad_duration אופציונלי int32 משך הזמן המקסימלי באלפיות שנייה של המודעה שצריך להחזיר, אם המודעה ניתנת לדילוג (בדרך כלל, משך הזמן המותר עבור מודעות שלא ניתן לדלג עליהן). אם המדיניות לא מוגדרת או מקבלת את הערך <= 0, אפשר להגדיר לה משך זמן מסוים.
protocols חזרה טיפוסים בני מנייה (enum) מגוון פרוטוקולים נתמכים של הצעות מחיר לווידאו פרוטוקולים נתמכים של סרטונים.

VAST_1_0 = 1
VAST_2_0 = 2
VAST_3_0 = 3
VAST_1_0_WRAPPER = 4
VAST_2_0_WRAPPER = 5
VAST_3_0_WRAPPER = 6
VAST_4_0 = 7
VAST_4_0_WRAPPER = 8
DAAST_1_0 = 9
DAAST_1_0_WRAPPER = 10

allowed_video_formats חזרה טיפוסים בני מנייה (enum) הפורמטים של קובצי הווידאו המותרים לבקשה הזו. התשובה צריכה לתמוך בלפחות אחת מהן. 

UNKNOWN_VIDEO_FORMAT = -1;
// Flash video files are accepted (FLV).
VIDEO_FLV = 0;
VIDEO_MP4 = 1;
// Valid VAST ads with at least one media file
// hosted on youtube.com.
YT_HOSTED = 2;
// Flash VPAID (SWF).
VPAID_FLASH = 3;
// JavaScript VPAID.
VPAID_JS = 4;
AUDIO_MP3 = 5;
AUDIO_OGG = 6;
// Requires both MP3 & OGG as Google does not know
// which codecs are installed on the player.
AUDIO_MP3_OGG = 7;
VIDEO_WEBM = 8;
VIDEO_MOV = 9;
VIDEO_3GPP = 10;
VIDEO_HLS = 11;
VIDEO_DASH = 12;
// Audio version of MP4.
AUDIO_MP4A = 13;
companion_slot חזרה מצב Companion מידע על מיקומי המודעות הנלווים שניתן להציג יחד עם הסרטון. זהו שדה חוזר, וברוב המקרים יהיה רק ערך אחד. אם אין מודעות נלוות זמינות, השדה הזה לא יוגדר.
end_cap_support אופציונלי טיפוסים בני מנייה (enum) תמיכה במכסת סגירה. כשהיא מופעלת, ניתן לבחור את המודעה הנלווית להצגה כמכסת סיום (כרטיס מידע) במשבצת הווידאו אחרי שמודעת הווידאו מסתיימת. אם מוחזרות כמה מודעות נלוות, IMA SDK בוחר את המודעה המתאימה ביותר לגודל המסך של המכשיר. מודעת סגירה לסרטון נתמכת רק במלאי שטחי הפרסום של מודעות וידאו לנייד. החל מאוגוסט 2015, אין תמיכה ב-END_CAP_FORBIDDEN וב-END_CAP_REQUIRED.

END_CAP_NOT_ENABLED = 0; – המודעה הנלווית לא תעובד כמודעת סגירה בסוף הסרטון.
END_CAP_OPTIONAL = 1; – מודעת סגירה לסרטון תוצג אם התגובה מכילה מודעת באנר נלווית כשירה, אבל לא חובה להוסיף מודעת באנר נלווית.
END_CAP_FORBIDDEN = 2; – התגובה עם מודעה נלווית מסוננת.
END_CAP_REQUIRED = 3; – התשובה ללא מודעה נלווית מסוננת.

content_attributes אופציונלי מאפייני תוכן מאפיינים של הסרטון שהמשתמש צופה בו ולא של מודעת הווידאו. השדות האלה מבוססים על הזמינות של המטא-נתונים של סרטון הווידאו של בעל התוכן הדיגיטלי, ויכול להיות שלא תמיד יאוכלסו.
DEPRECATED_inventory_type אופציונלי טיפוסים בני מנייה (enum) סוג המלאי שממנו נשלחת הבקשה. המדד הוצא משימוש, אבל ימשיך להופיע עד ינואר 2017. אפשר להשתמש בשדה המיקום כדי לבדוק אם מלאי שטחי הפרסום הוא מעברון או מודעת וידאו In-stream. יש להשתמש ב-Device.device_type כדי לקבוע אם הבקשה מגיעה ממכשיר נייד וב-Mobile.is_app כדי לקבוע אם הבקשה מגיעה מאפליקציה. WEB_VIDEO הוא INSTREAM מיקומים מדפדפני אינטרנט. GAMES מורכב מ-INTERSTITIAL מיקומים מאפליקציות ומדפדפני אינטרנט. MOBILE_INTERSTITIAL הוא INTERSTITIAL מיקומים מאפליקציות בלבד. מלאי שטחי הפרסום הזה מאפשר גם הצגה של מודעות ברשת המדיה. אפשר לדעת אם משבצת המודעה מאפשרת הצגת מודעות אם adslot.excluded_attributes לא מכיל 21 (CreativeType: Html)

MOBILE_APP_VIDEO הוא מיקום מודעה אחד (INSTREAM) באפליקציות בלבד.

WEB_VIDEO = 0
GAMES = 1
MOBILE_INTERSTITIAL = 2
MOBILE_APP_VIDEO = 3

is_livestream אופציונלי בוליאני כאן אפשר לראות אם הבקשה להצגת מודעה מוצגת בשידור חי של וידאו (0 = לא בשידור חי, 1 = בשידור חי). ברירת מחדל = false.

אובייקט במצב Companion

הורה

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

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
height חזרה int32 השדות האלה מייצגים את ערכי הרוחב והרוחב הזמינים במשבצת הזו. תמיד יהיו אותם ערכי גובה ורוחב זהים.
width חזרה int32 השדות האלה מייצגים את ערכי הרוחב והרוחב הזמינים במשבצת הזו. תמיד יהיו אותם ערכי גובה ורוחב זהים.
creative_format חזרה טיפוסים בני מנייה (enum) אלה הפורמטים של הקריאייטיבים המותרים במשבצת של המודעה הנלווית הזו.

IMAGE_CREATIVE = 0
FLASH_CREATIVE = 1
HTML_CREATIVE = 2

אובייקט ContentAttributes

הורה

מאפיינים של הסרטון שהמשתמש צופה בו ולא של מודעת הווידאו.

השדות האלה מבוססים על הזמינות של המטא-נתונים של סרטון הווידאו של בעל התוכן הדיגיטלי, וייתכן שהם לא תמיד יאוכלסו.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
duration_seconds אופציונלי int32 משך הסרטון בשניות.

אובייקט AdSlot

מידע על מיקומי המודעות בדף.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
id חובה int32 מזהה מיקום שהוקצה באופן שרירותי וייחודי לדף נתון, ובדרך כלל הוא מתחיל לספור מ-1. הנתון הזה משמש לזיהוי המשבצת שעליה יוגשו הצעות מחיר ב-BidResponse.
ad_block_key אופציונלי uint64 מזהה קבוע לשילוב של בעל אתר, מיקום מודעה ודף.
targetable_channel חזרה מחרוזת קבוצת ערוצים שמיקום המודעה הזה משויך אליהם. ערוץ הוא קבוצה של משבצות מודעות באתר. אפשר לטרגט לערוץ (למשל, הקטע 'ספורט' או 'כל הבאנרים המובילים') כדי לקבל שליטה מדויקת יותר על המיקומים שבהם המודעה מוצגת. שם הערוץ נמסר על ידי המוציא לאור.
width
height 		חזרה int32 במודעות מעברון לנייד (כולל אלה שעומדות בדרישות של מודעות וידאו), זוג הרוחב הראשון הוא גודל המסך (זהו גם גודל נגן הווידאו של מודעות וידאו מסוג VAST). ההתאמות הבאות מייצגות גדלים מומלצים של מודעות מעברון שתואמות להגבלות על גודל מודעות המעברון. לדוגמה: גודל המסך לא יכול להיות גדול מ-50% מהרוחב ו-40% מהגובה.
flexible_adslot_settings אופציונלי הגדרות גמישות של מודעות אם מיקום המודעה גמיש, הוא צריך לכלול הגדרות לגבי האופן שבו ניתן לשנות את מיקום המשבצת.
excluded_attribute חזרה int32 מזהי המאפיינים האסורים של המודעות שניתן להציג במשבצת זו. כדי לקבל רשימה של מזהים, יש לעיין בקובץ publisher-excludable-creative-attributes.txt במסמך התיעוד הטכני.
allowed_vendor_type חזרה int32 סוגי הספקים המורשים. ברשימת המזהים תוכלו לעיין בקובץ vendors.txt במסמכי התיעוד הטכני. השדה הזה לא רלוונטי לעסקאות עם שינויים מברירת המחדל של החסימה (מידע נוסף במאמר הזה במרכז העזרה).
consented_providers_settings אופציונלי הגדרות של ConsentrsProviders מידע על הספקים שבעלי התוכן הדיגיטלי דיווחו ל-Google שהמשתמשים שלהם באזור הכלכלי האירופי הסכימו לשימוש במידע האישי שלהם להתאמה אישית של מודעות. השדה הזה יאוכלס רק כש-regs_gdpr נכון.
regs_gdpr אופציונלי בוליאני השדה Authorized Buyers ממלא את השדה הזה רק על סמך האפשרות שהחשיפה תוצג למשתמש ב-EEA, על סמך מידע שזמין ל-Google. הוא לא נחשב להדרכה משפטית בנוגע ל-GDPR.
regs_lgpd אופציונלי בוליאני השדה הזה יוגדר כ-true כאשר, על סמך מידע שזמין ל-Google, החשיפה הזו תוצג למשתמש בברזיל. בכתובת https://storage.googleapis.com/adx-rtb-decionaries/lgpd-providers.csv מופיעה רשימה של ספקי טכנולוגיות הפרסום שמורשים להציג מודעות בבקשות ל-LGPD-enforced.

מידע נוסף על LGPD זמין במאמר הזה.

excluded_sensitive_category חזרה int32 הקטגוריות האסורות של המודעות הרגישות. כדי לקבל רשימה של מזהים, יש לעיין בקובץ ad-sensitive-categories.txt במסמך התיעוד הטכני. עליך לאכוף את ההחרגות האלה אם יש לך אפשרות לסווג מודעות בקטגוריות שברשימה. השדה הזה לא רלוונטי לעסקאות עם שינויים מברירת המחדל (מאמר זה במרכז העזרה).
allowed_restricted_category חזרה int32 הקטגוריות המותרות של מודעות מוגבלות במכרזים פרטיים ופתוחים. כדי לקבל רשימה של מזהים, יש לעיין בקובץ ad-restricted-categories.txt במסמך התיעוד הטכני. הצעות המחיר האלה חלות רק על הצעות מחיר פרטיות ופתוחות. אפשר לעיין בשדה allowed_restricted_category_for_deals כדי לראות את המבצעים המועדפים או את ההתחייבויות הפרוגרמטיות.
allowed_restricted_category_for_deals חזרה int32 הקטגוריות המותרות של מודעות מוגבלות עבור עסקאות מועדפות או הבטחות פרוגרמטיות. הקובץ ad-restricted-categories.txt במסמכי התיעוד הטכני מכיל רשימה של מזהים. ההנחות האלו חלות רק על עסקאות מועדפות או על אחריות פרוגרמטית. בשדה allowed_restricted_category אפשר לראות מכרזים פרטיים ופתוחים. במקרים מסוימים, מותר להשתמש בקטגוריות מוגבלות רק בעסקאות מועדפות או במודעות פרוגרמטיות, ולכן השדה הזה מפרט את כל הקטגוריות ב-allowed_restricted_category, ובנוסף קטגוריות מוגבלות שמותרות רק בדילים בלעדיים או בהתחייבויות פרוגרמטיות.
allowed_languages חזרה מחרוזת רשימת השפות היצירתיות שמותרות על ידי בעל התוכן הדיגיטלי. הסדר הוא שרירותי. הקודים הם באורך של 2 או 5 תווים, והם מתועדים בטבלת קודי השפות. אם המדיניות לא מוגדרת, כל השפות מותרות.
excluded_product_category חזרה int32 הקטגוריות האסורות של מוצרי המודעות. כדי לקבל רשימה של מזהים, יש לעיין בקובץ ad-product-categories.txt במסמכי התיעוד הטכני. עליך לאכוף את ההחרגות האלה אם יש לך אפשרות לסווג מודעות בקטגוריות הרשומות. השדה הזה לא רלוונטי לעסקאות עם שינויים מברירת המחדל של חסימה (כמו במאמר הזה במרכז העזרה).
excluded_creatives חזרה החרגת קריאייטיב קריאייטיבים שאסורים להופיע בחשיפה. אם תשלח הצעת מחיר עם אחד מהקריאייטיבים שברשימה, הצעת המחיר הזו תסונן לפני המכרז. צריך ליצור קשר עם מנהל החשבון כדי להפעיל את התכונה הזו.
only_deal_bids_accepted אופציונלי בוליאני האם מיקום המודעה כשיר רק להצעות מחיר. הצעות המחיר של המכרז הפתוח יסוננו כשהשדה הזה מוגדר כ-true. מגישי הצעות המחיר יכולים להגיש הצעות מחיר במכרז הפתוח או בעסקאות שבהן השדה הזה מוגדר כ-False.
matching_ad_data חזרה נתוני התאמה של מודעות מידע על הגדרות הטירגוט מראש שתואמות.
exchange_bidding אופציונלי בידינג פרמטרים שקשורים לבידינג בבורסה (בורסות של צד שלישי שמגישות הצעות מחיר בזמן אמת ב-Google Ad Manager). המדד הזה אף פעם לא מאוכלס בשיחות למגישי הצעות מחיר בזמן אמת של Authorized Buyers.
open_bidding אופציונלי OpenBidding הפרמטרים נשלחו בכל הבקשות מסוג Open Bidding.
ad_unit_mapping אופציונלי מיפוי יחידות מודעות מיפויים של יחידות מודעות שתואמים למיקום המודעה הנתון.
dfp_ad_unit_code אופציונלי מחרוזת קוד יחידת המודעות של Ad Manager. כרגע, האפשרות הזו מוגדרת רק לבקשות של Open Bidding.
slot_visibility אופציונלי טיפוסים בני מנייה (enum) מידע על החשיפה של המשבצת. ברירת מחדל = NO_DETECTION.

NO_DETECTION = 0
ABOVE_THE_FOLD = 1
BELOW_THE_FOLD = 2

viewability אופציונלי int32 אחוז הניראות של מיקום המודעה. זוהי הערכה של הסבירות משתמש הקצה יוכל לצפות במשבצת הזו על סמך נתונים היסטוריים וסביבתיים. הוא מתבטא כאחוז בטווח [0, 100]. ערך ברירת המחדל -1 מציין שלא ניתן היה להעריך את הניראות.
click_through_rate אופציונלי מספר ממשי (float) שיעור קליקים היסטורי עבור מודעות שמוצגות במשבצת המודעה. הערך מתבטא כשבר בטווח [0.0, 1.0]. ערך ברירת המחדל של -1.0 מציין שאין נתונים היסטוריים של שיעור קליקים זמינים. הערך הזה לא כולל נתונים שנצברו מ-Google Ads.
video_completion_rate אופציונלי מספר ממשי (float) שיעור ההשלמה ההיסטורי של מודעות הווידאו שהוצגו במיקום המודעה. הערך מתבטא כשבר בטווח [0.0, 1.0]. ערך ברירת המחדל של -1.0 מציין שאין נתונים היסטוריים על שיעור ההשלמה. השדה הזה חל רק על מלאי וידאו והוא לא כולל נתונים שנצברו מ-Google Ads.
iframing_state אופציונלי טיפוסים בני מנייה (enum) מצב iFraming של מיקום המודעה בדף האינטרנט שבו הוא נמצא. ברירת מחדל = UNKNOWN_IFRAME_STATE.

UNKNOWN_IFRAME_STATE = 0
NO_IFRAME = 1
SAME_DOMAIN_IFRAME = 2
CROSS_DOMAIN_IFRAME = 3

iframing_depth אופציונלי טיפוסים בני מנייה (enum) עומק iFrame של מיקום המודעה בדף האינטרנט שבו הוא נמצא. ההגדרה הנוכחית היא רק בקשות להצגת מודעות וידאו. ברירת מחדל = UNKNOWN_IFRAME_DEPTH.

UNKNOWN_IFRAME_DEPTH = 0
NOT_IN_IFRAME = 1
ONE_IFRAME = 2
MULTIPLE_IFRAME = 3

native_ad_template חזרה NativeAdTemplate מודעה מותאמת מורכבת מחלקים שעברו עיבוד על ידי בעל התוכן הדיגיטלי. בעל אתר עשוי לתמוך במספר תבניות ייחודיות של מודעות מותאמות. אם הבקשה מאפשרת שימוש גם במודעות באנר או בסרטונים, אפשר להשיב עם סוגים אחרים של מודעות על ידי הגדרת html_snippet או video_url במקום. אם קיימות רק תבניות מותאמות, עליך להגדיר את השדהnative_ad בכל תשובה שתשלח.
native_placement_type אופציונלי טיפוסים בני מנייה (enum) מתאר מיקום של משבצת מודעה מותאמת בהקשר.

PLACEMENT_UNKNOWN = 0
PLACEMENT_IN_FEED = 1 – בפיד של תוכן, לדוגמה, כפריט בפיד, ברשת, בפיד או בקרוסלה אורגניים.
PLACEMENT_ATOMIC_UNIT = 2 – ביחידה האטומית של התוכן, לדוגמה, בדף הכתבה או בדף התמונה היחידה.
PLACEMENT_OUTSIDE = 3 – מחוץ לתוכן המרכזי, לדוגמה, בקטע 'מודעות' בסרגל שבצד שמאל, בתור מיקום בסגנון מודעת באנר לצד התוכן, וכו'.
PLACEMENT_RECOMMENDATION = 4 - ווידג'ט של המלצה שמוצג בדרך כלל מתחת לתוכן המאמר.

mediation_status אופציונלי טיפוסים בני מנייה (enum) כאן אפשר לקבוע אם הבקשה להצגת מודעה הגיעה ישירות מבעל האפליקציה. ברירת מחדל = UNKNOWN.

UNKNOWN = 0
DIRECT_REQUEST = 1

auto_refresh אופציונלי רענון אוטומטי
sticky_settings אופציונלי הגדרות Sticky
non_browser_slot_source אופציונלי טיפוסים בני מנייה (enum) הצהרה של בעל התוכן הדיגיטלי על כך שמיקום המודעה בדף הזה עשוי להופיע במלאי שטחי פרסום שאינם של דפדפן, למשל באפליקציות למחשב. ברירת מחדל = UNDECLARED_SOURCE.

UNDECLARED_SOURCE = 0
DESKTOP_APP = 1

renderer אופציונלי טיפוסים בני מנייה (enum) מגדיר מי שולט בסביבה שממנה נשלחה הבקשה להצגת מודעה, ומעבד את המודעה. בפלטפורמות שבהן הקוד שנכתב על ידי Google יטפל במודעה בשדה הזה מוגדר ל-GOOGLE. כשהשדה הזה הוא PUBLISHER, בעל האפליקציה הציב קוד משלו במכשיר כדי לטפל בהפעלת המודעה. אין שינוי טכני באופן הטיפול בבקשה. אפשר להשתמש בשדה הזה כדי להבדיל בין סביבות שונות מסיבות שאינן טכניות. השדה הזה מוגדר רק לבקשות שמאפשרות מודעות וידאו מסוג VAST.

UNKNOWN_RENDERER = 0
GOOGLE = 1
PUBLISHER = 2

amp_ad_request_type אופציונלי טיפוסים בני מנייה (enum) האם הבקשה הזו מיועדת לדף AMP (AMP לנייד). דפי AMP ל-HTML נטענים מהר יותר על ידי הגבלת החלקים של HTML, CSS ו-JavaScript. כדי לקבל מידע נוסף על אופן העיבוד של מודעות AMP, אפשר לעיין במאמר בנושא מודעות AMP README. ברירת מחדל = NON_AMP_PAGE.

UNKNOWN_AMP = 0 – סטטוס ה-AMP לא ידוע. הבקשה יכולה להגיע מדף AMP או לא.
NON_AMP_PAGE = 1 – לא דף AMP. קובץ ה-HTML יכול להיות רגיל, סרטון VAST וכו'.
AMP_PAGE_LATE_REQUEST = 2 - בקשה שנטען מאוחרת מדף AMP ב-HTML. עיבוד המודעה יתעכב קצת, כך שהיא לא תשפיע לרעה על ביצועי הרינדור של הדף.

is_amp_page אופציונלי טיפוסים בני מנייה (enum) גם אם מדובר בדף AMP וגם אם לא.

UNKNOWN_AMP_PAGE = 0 – הסטטוס של דף ה-AMP לא ידוע.
DIALECT_HTML = 1 – זה לא דף AMP.
DIALECT_HTML_AMP = 2 – זהו דף AMP.
amp_ad_requirement_type אופציונלי טיפוסים בני מנייה (enum) סוגים אפשריים של דרישות למודעות AMP.

UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 0 – דרישות לגבי מודעות AMP לא ידועות.
AMP_AD_NOT_ALLOWED = 1 – אסור להציג מודעות AMP.
AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED = 2 – מותר להציג מודעות AMP או מודעות שאינן AMP, אבל מודעות AMP לא מוצגות מוקדם.
AMP_AD_ALLOWED_AND_EARLY_RENDERED = 3 – אפשר להציג מודעות AMP או מודעות שאינן AMP. מודעות AMP מוצגות קודם.
AMP_AD_REQUIRED = 4 – נדרשות מודעות AMP. בעל האתר עשוי לדחות מודעות שאינן AMP.
is_rewarded אופציונלי בוליאני האם המשתמש מקבל תגמול על צפייה במודעה. כשמדובר במודעות וידאו, הטמעות טיפוסיות מאפשרות למשתמשים לקרוא כתבה חדשותית נוספת בחינם, לקבל תוספת חיים במשחק או להשיג סשן מוזיקה ממומן ללא פרסומות. התגמול בדרך כלל מופץ אחרי שמודעת הווידאו מסתיימת.
allowed_ad_types חזרה טיפוסים בני מנייה (enum) סוגי מודעות אפשריים שמותרים בתגובת הצעת המחיר. allowed_ad_types תמיד מכיל ערך אחד או יותר. מיקומי מודעות מעברון יכולים גם לתמוך במודעות באנר. משבצת מודעה עם ALLOWED_AD_TYPE_NATIVE עשוי לתמוך בווידאו מקורי או לא, גם אם לא הוגדר ALLOWED_AD_TYPE_VIDEO. באופן דומה, משבצת מודעה ללא ALLOWED_AD_TYPE_NATIVE אינו תומך בסרטון מקורי, בין אם ALLOWED_AD_TYPE_VIDEO הוגדר או לא.

UNKNOWN_ALLOWED_AD_TYPE = -1
ALLOWED_AD_TYPE_BANNER = 0
ALLOWED_AD_TYPE_NATIVE = 1
ALLOWED_AD_TYPE_VIDEO = 2
ALLOWED_AD_TYPE_AUDIO = 3

session_depth אופציונלי int32 המספר הכולל של חשיפות שהוצגו למשתמש הזה (באתר או באפליקציה הספציפיים האלה) בסשן הגלישה הזה, ועוד 1. סשן מסתיים אחרי 30 דקות של חוסר פעילות. ערך ברירת המחדל של -1 מציין שלא ניתן להעריך את עומק הסשן.
publisher_settings_list_id חזרה קבוע 64 ההגדרות של בעלי התוכן הדיגיטלי מציינות את המזהים שחלים על המשבצת הזו. לפרטים נוספים, אפשר לעיין במדריך לבעלי אתרים ב-RTB.
secure_signals חזרה אות מאובטח האותות המאובטחים הועברו על ידי בעל התוכן הדיגיטלי.
api חזרה טיפוסים בני מנייה (enum) רשימת מסגרות API נתמכות עבור החשיפה הזו. אם ה-API לא מופיע במפורש, ההנחה היא שהוא לא נתמך. יכול להיות אחת מהאפשרויות הבאות:

UNKNOWN_FRAMEWORK = 0
MRAID_1 = 3 הגדרות של ממשק מודעות מדיה עשירה לנייד גרסה 1.0.
MRAID_2 = 5 הגדרות של ממשק מודעות מדיה עשירה לנייד גרסה 2.0.
MRAID_3 = 6 הגדרות של ממשק מודעות מדיה עשירה לנייד גרסה 3.0.
OMID_1 = 7 פתיחת ההגדרה של ממשק המדידה גרסה 1.0.

billable_event_rate_adjustment אופציונלי כפולה לגבי מודעות המוצגות באמצעות SDK מותאם אישית בלבד: המכפיל הוחל על הצעת המחיר במכרז. ההתאמה משקפת את הסבירות שהצעת המחיר שלך תניב אירוע לחיוב (לדוגמה, המודעה תוצג בהצלחה) אם היא זכתה במכרז, ביחס להסתברות שהצעות מחיר אחרות ייצרו אירוע לחיוב אם היא זכתה במכרז. ההתאמה הזו יכולה להיות גדולה או קטנה מ-1. זה משפיע על הדירוג הסופי במכרז בלבד, ובפרט, המכפיל הזה לא משפיע על התשלום. ברירת מחדל = 1.0.
omidpn אופציונלי מחרוזת מזהה השילוב של OM SDK. למידע נוסף, ניתן לעיין בייעוץ בנושא OpenRTB ל-Open Measurement SDK.
omidpv אופציונלי מחרוזת גרסה של שילוב ה-OM SDK. למידע נוסף, ניתן לעיין בייעוץ בנושא OpenRTB ל-Open Measurement SDK.
impression_expiration_seconds אופציונלי int32 פרק הזמן הצפוי שבו חשיפה יכולה להתרחש בשניות אחרי הצעת המחיר הזוכה. ניתן יהיה לחייב את החשיפה רק אם היא תוצג בזמן הזה. מידע נוסף על תפוגת חשיפות זמין במדריך הבא: https://developers.google.com/authorized-buyers/rtb/billing-event-guide
frequency_capping_scope חובה טיפוסים בני FrequencyCappingScope

תכונה ניסיונית עשויה להשתנות. למידע נוסף, אפשר לקרוא את המאמר הגדרת מכסות תדירות שמתארחות ב-Google להצעות מחיר ב-RTB . תיאור היקף האכיפה של מכסת תדירות בבקשה הזו. אפשר לציין את מכסות התדירות של הצעת המחיר בשדה BidResponse.ad.adslot.frequency_cap.

FREQUENCY_CAPPING_SCOPE_UNKNOWN = 0; ערך ברירת המחדל שאין להשתמש בו – יכול להיות שאי אפשר לקבוע באופן מהימן את היקף מכסת התדירות.

FREQUENCY_CAPPING_SCOPE_NONE = 1; מכסת תדירות שמבוססת על מפרטים של הצעות מחיר לא זמינה בבקשה הזו. לפני המכרז, המערכת תסנן הצעות מחיר עם מכסת תדירות לבקשה להצעת מחיר בלי זמינות של מכסת תדירות.

FREQUENCY_CAPPING_SCOPE_BROWSER = 2; האכיפה של מכסת התדירות זמינה במספר אתרים באותו דפדפן.

FREQUENCY_CAPPING_SCOPE_DEVICE = 3; אכיפת מכסת התדירות זמינה במספר אתרים במכשיר, למעט דפדפנים.

FREQUENCY_CAPPING_SCOPE_APP = 4; אכיפה של מכסת תדירות זמינה באפליקציה יחידה.

FREQUENCY_CAPPING_SCOPE_SITE = 5; האכיפה של מכסת התדירות זמינה באתר אחד.

excluded_app_ids חזרה מחרוזת חסימה של רשימת אפליקציות לפי מזהי האפליקציות שלהן שאינן תלויות בפלטפורמה. ב-Android, השמות האלה צריכים להיות בשם חבילה או חבילה (לדוגמה, com.foo.mygames). ב-iOS, מדובר במזהים מספריים.

אובייקט גמישAdSlotSettings

הורה

הגדרות לשינוי הגודל של המשבצת.

מאפיין נדרש/אופציונלי Type
max_width אופציונלי int32
max_height אופציונלי int32
min_width אופציונלי int32
min_height אופציונלי int32

אובייקט ההגדרות של ConsentedProvidersSettings

הורה

מידע על הספקים שעבורם בעל התוכן הדיגיטלי הודיע ל-Google שהמשתמשים ב-EEA הביעו הסכמה לשימוש במידע האישי שלהם לצורך התאמה אישית של מודעות. השדה הזה יאוכלס רק כאשר regs_gdpr מוגדר כ-TRUE.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
consented_providers חזרה int64 קבוצה של מזהים התואמים לספקי טכנולוגיות פרסום (ATP) שעבורם בעל התוכן הדיגיטלי ציין ל-Google שהמשתמשים שלו באזור הכלכלי האירופי העניקו הסכמה תקפה מבחינה משפטית לתנאים הבאים: 1) שימוש בקובצי cookie או באחסון מקומי אחר, היכן שהדבר נדרש על פי חוק, 2) איסוף ושיתוף של מידע אישי ושימוש בו לצורך התאמה אישית של מודעות על ידי ספק טכנולוגיית פרסום, בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי.

אם בעל אפליקציה משתמש בגרסה 2 של Transparency & Consent Framework ( TCF - מסגרת השקיפות וההסכמה) של IAB לניהול ההגדרות של הסכמת משתמשים, זו הקבוצה של ספקי טכנולוגיית הפרסום שהביעו הסכמה באמצעות המחרוזת בנושא הסכמה נוספת (אפשר לקרוא את המאמר הזה לקבלת פרטים על מצב ההסכמה הנוספת של Google). ATPs שמקבלים הסכמה באמצעות מחרוזת ההסכמה של TCF בגרסה 2 מוצגים בשדה ConsentedProvidersSettings.tcf_consent_string.

מיפוי של מזהה ATP לשם ATP פורסם ב-providers.csv.

tcf_consent_string אופציונלי מחרוזת המחרוזת של Web Transparency & Consent Framework ( TCF – מסגרת השקיפות וההסכמה) מגרסה 24 של IAB, עם קידוד אינטרנט בטוח, שאוחזרה מפלטפורמת IAB לניהול הסכמה (CMP) של בעל התוכן הדיגיטלי. מבנה המחרוזת מוגדר על ידי TCF גרסה 2 של IAB. השדה הזה יאוכלס אם בעל התוכן הדיגיטלי השתלב עם CMP עבור TCF גרסה 2, וש-CMP מציינת ש-GDPR חל על הבקשה הזו להצגת מודעה ומספק מחרוזת הסכמה חוקית. במאמר הזה מפורט מידע נוסף על השילוב של Google TCF בגרסה 2.

רשימת הספקים הגלובלית של IAB זמינה בכתובת vendor-list.consensu.org/v2/vendor-list.json כדי לקבל פרטים על הספקים שרשומים במחרוזת ההסכמה.

אובייקט מסוג excludedCreative

הורה

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

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
buyer_creative_id אופציונלי מחרוזת מזהה הקריאייטיב של הקונה של הקריאייטיב האסור.

אובייקט MatchAdData

הורה

מזהי החיוב שתואמים להגדרות המיקוד מראש שתואמות.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
billing_id חזרה int64 מזהי החיוב שתואמים להגדרות המיקוד מראש שתואמות.
minimum_cpm_micros אופציונלי int64 הערך המינימלי של העלות לאלף חשיפות, שאפשר להגיש עליו הצעות מחיר בלי סינון לפני המכרז. זה יכול להיות מינימום גלובלי, או מינימום שהגדיר בעל האתר. הערך מופיע במיליוניות של המטבע בחשבון.
direct_deal חזרה DirectDeal
אובייקט DirectDeal
הורה

מידע על מבצעים שתואמים למלאי הזה.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
direct_deal_id אופציונלי int64 מזהה שמזהה את העסקה.
fixed_cpm_micros אופציונלי int64 כדי להשתתף בעסקה, עליך להגיש הצעת מחיר בסך fixed_cpm_micros לפחות (במיליוניות של מטבע החשבון). אם זכית, נחייב אותך בסכום של fixed_cpm_micros. הכלל לא חל כאשר deal_type=PRIVATE_AUCTION. במכרזים פרטיים, יש להגיש fixed_cpm_micros לפחות. הצעת מחיר גבוהה יותר לאלף חשיפות מ-fixed_cpm_micros תגדיל את הסיכוי שלך לזכות ב-deal_type=PRIVATE_AUCTION, אבל לא תגדיל את הסיכוי שלך לזכות בסוגי עסקאות אחרים.
deal_type אופציונלי טיפוסים בני מנייה (enum) סוג העסקה. ברירת מחדל = UNKNOWN_DEAL_TYPE.

UNKNOWN_DEAL_TYPE = 0
PREFERRED_DEAL = 1
PRIVATE_AUCTION = 2
PROGRAMMATIC_GUARANTEED = 3 – לקבלת מידע נוסף, אפשר לעיין במאמר ההבדלים בין RTB לעסקאות פרוגרמטיות מובטחות במרכז העזרה.
AUCTION_PACKAGE = 4 – לקבלת מידע נוסף, אפשר לעיין במאמר בנושא חבילות של מכירה פומבית במרכז העזרה.
MARKETPLACE_PACKAGE = 5 – מזהה העסקה בחבילות של מלאי שטחי הפרסום שנאספו על ידי בעלי התוכן הדיגיטלי. מידע נוסף זמין במאמר חבילות Marketplace במרכז העזרה.

publisher_blocks_overridden אופציונלי בוליאני האם בעל התוכן הדיגיטלי פטר עסקה זו מחסימות מוגדרות. ההגדרה הזו לא מבטלת את המדיניות של Authorized Buyers או את ההחלטות של מרכז בקרת המודעות.
creative_source אופציונלי טיפוסים בני מנייה (enum) שדה ניסיוני. בכפוף לשינויים. טיפוסים בניהולך עם המארח של הקריאייטיב, שיאוכלס רק בעסקאות פרוגרמטיות מובטחות. כרגע, השדה הזה תמיד צריך להיות מוגדר לערך CREATIVE_SOURCE_ADVERTISER (ברירת מחדל) בלבד.

CREATIVE_SOURCE_UNKNOWN = 0
CREATIVE_SOURCE_ADVERTISER = 1 – הקריאייטיב מתארח אצל המפרסם, כלומר, מגיש הצעת המחיר נדרש לספק קריאייטיב בתגובה להצעת המחיר.
CREATIVE_SOURCE_PUBLISHER = 2 – הקריאייטיב מתארח אצל בעל התוכן הדיגיטלי, כך שמגיש הצעות המחיר לא צריך לכלול קריאייטיב בתגובה להצעת המחיר. מידע נוסף על נכסי קריאייטיב שמתארחים באתר החדשות זמין בכתובת https://support.google.com/admanager/answer/9243220. התכונה הזו לא נתמכת כרגע על ידי מגישי הצעות מחיר ב-RTB.

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

אובייקט Exchange Bidding

הורה

פרמטרים שקשורים לבורסות שמשתתפות ב-Open Bidding (בורסות של צד שלישי שמוגשות בהן הצעות מחיר בזמן אמת ב-Ad Manager). הנתונים האלה אף פעם לא מאוכלסים בקריאות למגישי הצעות מחיר בזמן אמת של Authorized Buyers.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
publisher_parameter חזרה מחרוזת מחרוזות UTF8 שמסופקות על ידי בעל התוכן הדיגיטלי כחלק מההגדרות התואמות של קבוצות תפוקה בממשק המשתמש של Ad Manager. הפורמט הוא שרירותי וצריך להסכים על ידי בעל התוכן הדיגיטלי ומגיש הצעות המחיר בהחלפה.
key_value חזרה KeyValue צמדי מפתח/ערך חוזרים שיישלחו מהמוציא לאור אל הבורסה.

אובייקט OpenOpen Bidding

הורה

הפרמטרים נשלחו בכל הבקשות מסוג Open Bidding.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
is_open_bidding אופציונלי בוליאני השדה הזה מוגדר כ-true אם בעל התוכן הדיגיטלי הגדיר קבוצת תפוקה או קבוצה לבחירת רשת שמטרגטת את משבצת המודעה הזו ואת מגיש הצעות המחיר הזה. אפשר להיכנס אל מרכז העזרה כדי לקרוא מידע על Open Bidding ועל ההשפעות שלו על תהליך הבידינג.

אובייקט AdUnitמיפוי

הורה

AdUnitמיפוי מאפשר לזהות יחידות מלאי של בעלי תוכן דיגיטלי במרחב השמות של מגיש הצעות המחיר. המיפויים מאוכלסים רק כשמגיש הצעות המחיר עובד ישירות עם בעל התוכן הדיגיטלי, ומספק את המיפוי ממרחב השמות של יחידת המודעות של Google אל מרחב השמות של מלאי הצעות המחיר. המיפוי של יחידות מודעות חל רק על בקשות שמשתמשות ב-SDK מותאם אישית. https://support.google.com/admanager/answer/9601810.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
Keyval אופציונלי מקש צמד מפתח/ערך המשמש לציון יחידת המלאי במרחב השמות של מגיש הצעות המחיר.
FormatType אופציונלי טיפוסים בני מנייה (enum) פורמטים אפשריים של יחידות מודעות המשמשים למיפוי. תואם למתאם שישמש ב-SDK.

ערכים אפשריים:

  • FORMAT_UNKNOWN = 0;
  • מציגים מודעות באנר לאפליקציות לאינטרנט או לנייד. לדוגמה, משבצת 320x50 לידרבורד. האיסור חל גם על מודעות וידאו Outstream.

    FORMAT_BANNER = 1;

  • מודעה במסך מלא שמוצגת בתוך אפליקציה לנייד.

    FORMAT_INTERSTITIAL = 2;

  • מודעות וידאו או מודעות לרשת המדיה בהתאמה אישית באפליקציות לאינטרנט או לנייד שמתאימות לחוויית המשתמש באתר או באפליקציה שבהן הן מוצגות.

    FORMAT_NATIVE = 3;

  • מודעות וידאו שמוצגות לפני שידור הווידאו, במהלכו או אחריו.

    FORMAT_VIDEO_VAST = 4;

  • מודעות וידאו לקידום אפליקציות לנייד שמאפשרות למשתמשים לצפות במודעה בתמורה לתגמול באפליקציה.

    FORMAT_REWARDED = 5;

  • מודעות מעברון שמאפשרות למשתמשים לצפות במודעה בתמורה לקבלת תגמול בתוך האפליקציה. לא נדרשת הסכמה. https://support.google.com/admanager/answer/7386053

    FORMAT_REWARDED_INTERSTITIAL = 6;

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

    FORMAT_APP_OPEN = 7;
אובייקט Keyval
הורה

אפשר לציין כמה צמדי מפתח/ערך כדי לתמוך במגישי הצעות מחיר שיחידת המלאי שלהם היא היררכית ויש להם מספר מזהים. צמדים של מפתח/ערך של יחידת המודעות שנבחרה צריכים להישלח חזרה בתגובה להצעת המחיר, כ-BidResponse.ad.sdk_rendered_ad.sdk_params. הפרטים האלה מועברים ל-SDK של מגיש הצעות המחיר.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
key אופציונלי מחרוזת המפתח הוא השם של מזהה יחידת המלאי של מגיש הצעות המחיר עבור ה-SDK.
value אופציונלי מחרוזת הערך של מזהה יחידת המלאי של מגיש הצעות המחיר בפורמט הנתון.

אובייקט NativeAdTemplate

הורה

מודעה מותאמת מורכבת מחלקים שעברו עיבוד על ידי בעל התוכן הדיגיטלי. בעל אתר יכול לתמוך במספר תבניות ייחודיות של מודעות מותאמות. אם הבקשה חלה גם על מודעות באנר או סרטונים, תוכלו להגיב במקום זאת לסוגים אחרים של מודעות: html_snippet, video_url או video_vast_xml. אם קיימות רק תבניות מותאמות, עליכם להגדיר את השדה native_ad בכל תגובה שתשלחו.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
required_fields אופציונלי int64 Bitbit מתאר אילו שדות חובה על ידי בעל התוכן הדיגיטלי. תשובות להצעות מחיר ללא ערך בשדות האלה יידחו. כתובות URL למעקב של קליקים וצפייה מחייבות תמיד גישה משתמעת.

enum Fields – מגדיר את הביטים ב-required_fields וב-recommended_fields. יש שדה אחד בכל שדה BidResponse.Ad.NativeAd.

HEADLINE = 0x1
BODY = 0x2
CALL_TO_ACTION = 0x4
ADVERTISER = 0x8
IMAGE = 0x10
LOGO = 0x20
APP_ICON = 0x40
STAR_RATING = 0x80
PRICE = 0x100
STORE = 0x200
VIDEO = 0x400

recommended_fields אופציונלי int64 טווח ביטים שמתאר את השדות שבעל האתר ממליץ עליהם. כל השדות המומלצים נתמכים, אבל לא כל השדות המומלצים נדרשים.

enum Fields – מגדיר את הביטים ב-required_fields וב-recommended_fields. יש שדה אחד בכל שדה BidResponse.Ad.NativeAd.

HEADLINE = 0x1
BODY = 0x2
CALL_TO_ACTION = 0x4
ADVERTISER = 0x8
IMAGE = 0x10
LOGO = 0x20
APP_ICON = 0x40
STAR_RATING = 0x80
PRICE = 0x100
STORE = 0x200
VIDEO = 0x400

headline_max_safe_length
body_max_safe_length
call_to_action_max_safe_length
advertiser_max_safe_length
price_max_safe_length 		אופציונלי int32 השדה max_safe_length מציין את המספר המקסימלי של תווי Unicode מובטחים שיוצגו ללא קיצור. מחרוזות ארוכות יותר יקוצרו על ידי בעל התוכן הדיגיטלי במהלך הרינדור.
image_width
image_height
logo_width
logo_height
app_icon_width
app_icon_height 		אופציונלי int32 הרוחב והגובה שמהם יש לחשב את יחס הגובה-רוחב הנדרש. אתם יכולים להוסיף תמונה גדולה יותר בתגובה. ייתכן שתמונות עם יחס גובה-רוחב שונות מאלה שבגובה וברוחב.
style_id אופציונלי int32 מזהה גלובלי ייחודי של הסגנון, ה-HTML ו-CSS שבהם מתבצע עיבוד של המודעה המותאמת.
style_layout_type אופציונלי טיפוסים בני מנייה (enum) סוג פריסת הסגנון לכל תבנית של מודעות מותאמות. ברירת מחדל = PIXEL.

PIXEL = 0
FLUID = 1

style_height
style_width 		אופציונלי int32 אם הערך של style_layout_type הוא PIXEL, הרוחב והגובה של כל המודעה המותאמת לאחר הרינדור. אם הערך בשדה style_layout_type הוא FLUID, ייתכן שהערכים style_height ו-style_width לא יאוכלסו.

רענון אוטומטי של האובייקט

הורה

הגדרות רענון אוטומטי.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
refresh_settings חזרה הגדרות רענון אוטומטי הגדרות הרענון האוטומטי של בעל התוכן הדיגיטלי במלאי הזה. המצב הזה חוזר על עצמו כי בעלי תוכן דיגיטלי עשויים לבצע מספר סוגים של רענון אוטומטי במלאי אחד של מודעות.
refresh_count אופציונלי int32 מספר הפעמים שמיקום המודעה הזה עבר רענון מאז הטעינה האחרונה של הדף.
אובייקט AutoRefreshSettings
הורה
מאפיין נדרש/אופציונלי Type פרטי ההטמעה
refresh_type אופציונלי טיפוסים בני מנייה (enum) סוג הרענון האוטומטי שהוצהר. ברירת מחדל = UNKNOWN_AUTO_REFRESH_TYPE.

UNKNOWN_AUTO_REFRESH_TYPE = 0
USER_ACTION = 1 – הרענון הופעל על ידי פעולה של המשתמש, כמו גלילה.
EVENT = 2 - שינוי תוכן שמבוסס על אירועים. לדוגמה, המודעות מתעדכנות כשהציון של משחק הכדורגל משתנה בדף.
TIME = 3 – רענון מבוסס זמן. מתבצע רענון של המודעות במרווחי זמן מוגדרים מראש, גם ללא פעילות משתמש.

min_refresh_interval_seconds אופציונלי int32 מרווח הרענון המינימלי. ההגדרה הזו תחול על כל סוגי הרענון.

אובייקט במיקום קבוע

הורה

ההגדרות האלה עוזרות בעל התוכן הדיגיטלי.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
vertical_stickiness אופציונלי טיפוסים בני מנייה (enum) האם משבצת המודעה הוא סרגל צד שנצמד למסך כשמשתמש גולל. ברירת מחדל = UNKNOWN_STICKINESS.

UNKNOWN_STICKINESS = 0
IS_STICKY = 1

top_horizontal_stickiness אופציונלי טיפוסים בני מנייה (enum) האם משבצת המודעה היא משבצת אופקית שנצמדת לחלק העליון של המסך כשהמשתמש גולל. ברירת מחדל = UNKNOWN_STICKINESS.

UNKNOWN_STICKINESS = 0
IS_STICKY = 1

bottom_horizontal_stickiness אופציונלי טיפוסים בני מנייה (enum) האם משבצת המודעה היא משבצת אופקית שנצמדת לתחתית המסך כשהמשתמש גולל. ברירת מחדל = UNKNOWN_STICKINESS.

UNKNOWN_STICKINESS = 0
IS_STICKY = 1

אובייקט SecureSignal

הורה

האותות המאובטחים הועברו על ידי בעל התוכן הדיגיטלי.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
data אופציונלי מחרוזת האות המאובטח.
source_js אופציונלי מקורות של JJ הוּצא משימוש. המידע הזה יוסר בפברואר 2023. במקומה, צריך להשתמש במדיניות BidRequest.adslot.secure_signals.source.
source אופציונלי מחרוזת מקור האות. מזהה של הספרייה או ה-SDK שהניבו את הנתונים האלה.
אובייקט SourceJs
הורה

הוּצא משימוש. המידע הזה יוסר בפברואר 2023. במקומה צריך להשתמש במדיניות BidRequest.adslot.secure_signals.source.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
id אופציונלי מחרוזת המזהה של ספריית JavaScript שיצרה את הנתונים האלה.

אובייקט BidResponsefeedback

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

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
request_id אופציונלי בייטים המזהה הייחודי מ-BidRequest.id
creative_index אופציונלי int32 האינדקס של ה-BidResponse_Ad אם היה יותר מאחד. האינדקס מתחיל באפס עבור הקריאייטיב הראשון.
creative_status_code אופציונלי int32 קוד הסטטוס של המודעה. כדי לקבל רשימה של מזהים, יש לעיין בקטע creative-status-codes.txt במסמכי התיעוד הטכני.
cpm_micros אופציונלי int64 אם הצעת המחיר ניצחה במכרז, זהו המחיר ששולם במטבע של החשבון שלך. אם הצעת המחיר השתתפה במכרז אבל הייתה גבוהה יותר מהצעת המחיר שלכם, מדובר בעלות לאלף חשיפות שאמורה להיות גבוהה כדי לזכות. הערך הזה לא מוגדר אם הצעת המחיר סוננה לפני המכרז, אם בעל התוכן הדיגיטלי או מגיש הצעות המחיר שזכו במכרז ביטל את ההסכמה לקבלת משוב על מחירים, או אם החשבון שלך ביטל את ההסכמה לשיתוף המחירים הזוכים עם מגישי הצעות מחיר אחרים. במכרזים במודל "מחיר ראשון", השדה BidRequest.bid_response_feedback[].minimum_bid_to_win גם מאוכלס.
minimum_bid_to_win אופציונלי int64 הערך המינימלי של הצעת המחיר הדרוש כדי לזכות במכרז, במיליוניות של מטבע החשבון. אם הצעת המחיר שלכם זכתה במכרז, זוהי הצעת המחיר השנייה בגובהה שלא סוננה (כולל מחיר המינימום). אם הצעת המחיר שלך לא זכתה במכרז, זוהי הצעת המחיר הזוכה. השדה הזה יאוכלס רק אם הצעת המחיר שלך השתתפו במכרז מחיר ראשון, ולא יאוכלס אם הצעת המחיר שלך סוננה לפני המכרז.
sampled_mediation_cpm_ahead_of_auction_winner אופציונלי int64 כשבעל תוכן דיגיטלי משתמש במכרז של בידינג בזמן אמת (RTB) ובתהליך בחירת הרשת (Mediation) ב-SDK שמבוסס על Waterfall על אותה שאילתה, הזוכה במכרז במכרז בזמן אמת צריך גם להתחרות ב-Waterfall של תהליך בחירת הרשת (שמבוצר לפי מחיר) כדי לזכות בחשיפה. אם הצעת המחיר השתתף במכרז ולא הייתה מפל מים, הערך של השדה הזה הוא 0. אם הצעת המחיר השתתף במכרז והייתה Waterfall, הערך של השדה הזה הוא מחיר שמייצג הצעת מחיר לדוגמה, מהרשתות הכשירות לבחירת רשת שגבוהות מזו של הזוכה במכרז, בשקלול לפי שיעור המילוי הצפוי. אפשר להשתמש בשדה הזה בשילוב עם המאפיין min_bid_to_win כדי לאמן מודלים של בידינג. העלות לאלף חשיפות נמצאת במיליוניות של המטבע בחשבון.
event_notification_token אופציונלי בייטים אסימון התראה של אירוע שנכלל בתגובת הצעת המחיר.
buyer_creative_id אופציונלי מחרוזת מזהה הקריאייטיב של הקונה שנכלל בתגובת הצעת המחיר.

אובייקט שרשרת האספקה

אובייקט של שרשרת אספקה מידע נוסף זמין במאמר הזה.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
complete אופציונלי בוליאני האפשרות מציינת אם השרשרת מכילה את כל הצמתים המעורבים בעסקה שמובילה בחזרה אל הבעלים של האתר, האפליקציה או אמצעי הגעה לאתר אחר של המלאי.
nodes חזרה SupplyChainNode מערך של אובייקטי SupplyChainNode לפי סדר השרשרת. בשרשרת אספקה מלאה, הצומת הראשון מייצג את מערכת הפרסום הראשונית ואת מזהה בית העסק שמעורבים בעסקה, למשל הבעלים של האתר, האפליקציה או אמצעי הגעה לאתר אחר. בשרשרת אספקה חלקית, היא מייצגת את הצומת הידוע הראשון. הצומת האחרון מייצג את הישות ששולחת את בקשת הצעת המחיר הזו.
version אופציונלי מחרוזת גרסה של המפרט של שרשרת האספקה בשימוש, בפורמט "major.minor". לדוגמה, בגרסה 1.0 של המפרט, משתמשים במחרוזת "1.0".

אובייקט SupplyChainNode

הורה
מאפיין נדרש/אופציונלי Type פרטי ההטמעה
advertising_system_identifier אופציונלי מחרוזת שם הדומיין הקנוני של מערכות SSP , Exchange , Header Wrapper וכו' שמגישי הצעות המחיר מתחברים אליו. הוא יכול להיות הדומיין התפעולי של המערכת, אם הוא שונה מדומיין ההורה ההורה, שנועד לסייע בחיפושי WHOIS ולחיפושי IP הפוכים כדי ליצור בעלות ברורה על המערכת שהוענקה גישה. הערך הזה צריך להיות זהה לזה שמשמש לזיהוי מוכרים בקובץ ads.txt, אם הוא קיים.
seller_identifier אופציונלי מחרוזת המזהה שמשויך לחשבון של אתר המכירה או המפיץ במערכת הפרסום. הערך צריך לכלול את אותו ערך שבו השתמשת בעסקאות, לדוגמה, "publisher_id" בפרוטוקול Google. מוגבלת ל-64 תווים.
handles_payment אופציונלי בוליאני האפשרות מציינת אם הצומת הזה יהיה מעורב בתהליך התשלום של מלאי שטחי הפרסום. כשהמדיניות מקבלת את הערך True, מערכת הפרסום בשדה Advertising_system_identifier משלמת לבית העסק בשדה sellers_identifier, האחראי על תשלום הצומת הקודם בשרשרת. אם היא מוגדרת כ-False, הצומת הזה לא יהיה מעורב בתהליך התשלום של המלאי.

אובייקט BidResponse

זוהי ההודעה שאתם מחזירים בתגובה ל-BidRequest. תוכלו לציין אפס מודעות או יותר. לכל מודעה עליכם לספק מיקום מודעה שבו ניתן להציג אותה. משבצת מודעה מזוהה על ידי AdSlot.id מה-BidRequest. אם אתם לא רוצים להגיש הצעות מחיר, עליכם לשלוח תגובה ללא מודעות ולהגדיר רק את processing_time_ms.

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
ad חזרה מודעה
debug_string אופציונלי מחרוזת אם הפרמטר is_test הוגדר ב-BidRequest, ניתן להחזיר בשדה הזה מידע על תוצאות ניפוי הבאגים כטקסט פשוט. אין להגדיר את השדה הזה בתנאים רגילים, או להגדיר אותו לערך ארוך מ-100 תווים. יש להשתמש בשדה הזה רק כשתופיע בקשה לעשות זאת, כדי לפתור בעיות ספציפיות.
processing_time_ms אופציונלי int32 הגדרת זמן ההמתנה באלפיות שנייה מהרגע שבו קיבלת את הבקשה ועד להחזרת התשובה.
no_bid_reason אופציונלי int32 סיבה אופציונלית שצוינה על ידי מגיש הצעת המחיר שבה לא מגישים הצעת מחיר. השדה הזה מקביל ל-BidResponse.nbr בפרוטוקול OpenRTB ומשתמש באותו מרחב שמות של קודי סיבות ללא הצעת מחיר. בכתובת developers.google.com/authorized-buyers/rtb/download/no-bid-reasons.txt מופיעה רשימה מלאה של קודי סיבות למניעת הצעות מחיר.

אובייקט מודעה

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
event_notification_token אופציונלי בייטים האסימון של האירוע נשלח אל Authorized Buyers על ידי מגישי הצעות מחיר כדי לפתור בעיות. Authorized Buyers יכללו את האסימון במשוב בזמן אמת בהצעת המחיר. התוכן של האסימון לא יתועד על ידי Authorized Buyers. Authorized Buyers תתעלם מכל אסימון באורך של יותר מ-128 בייטים.
buyer_creative_id אופציונלי מחרוזת מזהה ייחודי שבחרת עבור הקריאייטיב בתגובה הזו. השדה הזה חייב תמיד להיות מוגדר, מוגבל ל-64 בייטים לכל היותר וחייב להיות מחרוזת UTF8 חוקית. כל נכס buyer_creative_id שמשמש אותך חייב תמיד להיות משויך לאותו קריאייטיב. השדה הזה משמש לדיווח על סטטוסים של אישור כשיש בעיות. אין לציין את אותו מזהה עבור קריאייטיבים שונים, אחרת כל הקריאייטיבים יידחו אם תתגלה בעיה בקריאייטיב אחד. אין לציין מזהים שונים עבור אותו קריאייטיב בתגובות שונות, או שלא יוצגו נכסי קריאייטיב כי סטטוס האישור מוקצה על בסיס כל מזהה בנפרד.
html_snippet אופציונלי מחרוזת קטע ה-HTML שיוצב בדף האינטרנט כדי להציג את המודעה. יש להשתמש ב-BidResponse.Ad.AdSlot.billing_id כדי לציין לאיזה מזהה חיוב משויך קטע הקוד הזה.
video_url אופציונלי מחרוזת כתובת ה-URL לאחזור מודעת וידאו. כתובת ה-URL צריכה להחזיר תגובת XML שתואמת לתקן VAST 2.0 או 3.0. יש להשתמש ב-BidResponse.Ad.AdSlot.billing_id כדי לציין לאיזה מזהה חיוב לשייך את המודעה הזו. ניתן להגדיר רק אחד מהערכים: html_snippet, video_url, native_ad, sdk_rendered_ad, amp_ad_url או video_vast_xml. צריך להגדיר את השדה הזה רק אם הערך RequestRequest מיועד למודעת וידאו (BidRequest.video קיימת).
video_vast_xml אופציונלי מחרוזת מסמך ה-VA לפתוח. המסמך צריך להתאים לתקן VAST 2.0 או 3.0. משתמשים ב-BidResponse.Ad.AdSlot.billing_id כדי לציין לאיזה מזהה חיוב לשייך את המודעה הזו. יש להגדיר את השדה הזה רק אם הצעת המחיר היא למודעה במודעת וידאו והתגובה היא XML. יש להגדיר רק אחד html_snippet, video_url, native_ad, sdk_rendered_ad, amp_ad_url או video_vast_xml.
amp_ad_url אופציונלי מחרוזת כתובת ה-URL לאחזור מודעת AMPHTML. ניתן להגדיר רק אחת מהאפשרויות הבאות: html_snippet, video_url, native_ad, sdk_rendered_ad, amp_ad_url או video_vast_xml.
native_ad אופציונלי מודעה מותאמת התוכן של מודעה מותאמת. מודעות מותאמות מורכבות מאבני בניין מרובות, שמוצגות על ידי בעל התוכן הדיגיטלי.
click_through_url חזרה מחרוזת קבוצה של כתובות יעד של קטע הקוד. הנתונים כוללים את כתובות ה-URL שאליהן המשתמש יעבור אם הוא ילחץ על המודעה המוצגת, וכל כתובת URL שמוצגת במודעה המעובדת. אין לכלול קריאות ביניים לשרת המודעות שלא קשורות לדף הנחיתה הסופי. הנתונים האלה משמשים, בין היתר, לסינון אחרי כתובות URL שנחסמו על ידי בעלי התוכן הדיגיטלי. BidResponse שמחזיר קטע קוד או מודעת וידאו, אבל מצהיר כי click_through_url אינו נמחק. במודעות מותאמות, רק הערך הראשון משמש ככתובת ה-URL לקליקים, אבל כל הערכים כפופים לסיווג ולבדיקה. יש להגדיר את השדה הזה רק אם המדיניות html_snippet או video_url או native_ad מוגדרות. במודעות מותאמות, אם המדיניות NativeAd.click_link_url לא מוגדרת, הערך הראשון של הערך click_through_url משמש להפניית המשתמש לדף הנחיתה. במודעות מותאמות, מומלץ להשתמש בשדה click_link_url כדי להגדיר את היעד שאליו המשתמשים יגיעו בסופו של דבר. במקרה של דפי נחיתה דינמיים, צריך להשתמש בשדה הזה.
vendor_type חזרה int32 כל סוגי הספקים של המודעות שניתן להציג מקטע טקסט זה. בהצהרה הטכנית צריך להצהיר רק על מזהי ספקים שמופיעים בקובץ sellers.txt. אנחנו נבדוק אם הספקים שהצהרת עליהם נמצאים ברשימת allowed_vendor_type הבקשות שנשלחות ב-BidRequest.
attribute חזרה int32 כל המאפיינים של המודעות שאפשר להציג מקטע הקוד הזה. כדי לקבל רשימה של מזהים, יש לעיין ב-buyer-declarable-creative-attributes.txt במסמכי התיעוד הטכני. אנחנו נבדוק אם המאפיינים האלה לא מופיעים ברשימה של excluded_attribute ב-BidRequest.
category חזרה int32 כל הקטגוריות הרגישות של המודעות שעשויות להופיע מקטע זה. כדי לקבל רשימה של מזהים, יש לעיין בקטע ad-sensitive-categories.txt במסמכי התיעוד הטכני. אנחנו נבדוק אם אחת מהקטגוריות האלה לא הייתה כלולה ברשימה של excluded_sensitive_category ב-BidRequest.
restricted_category חזרה int32 כל הקטגוריות המוגבלות של המודעות שעשויות להופיע מקטע הטקסט הזה. כדי לקבל רשימה של מזהים, יש לעיין בקטע ad-restricted-categories.txt במסמכי התיעוד הטכני. אנחנו נבדוק אם הקטגוריות האלה מפורטות ברשימה allowed_restricted_category של השדה RequestRequest.
advertiser_name חזרה מחרוזת כל שמות המפרסמים של המודעה.
bidder_name אופציונלי מחרוזת למגישי הצעות מחיר בבורסות (בורסות צד שלישי שנותנים הצעות מחיר בזמן אמת ב-Ad Manager), השם של מגיש הצעת המחיר שהבורסה התקשרת כדי לספק את המודעה. זהו טקסט UTF8 שרירותי, אבל הוא צריך להספיק כדי לזהות את מגיש הצעת המחיר, וצריך להגדיר באופן עקבי את אותו ערך עבור אותו מגיש הצעת מחיר.
width
height 		אופציונלי int32 הרוחב והגובה בפיקסלים של המודעה. ההגדרה הזו לא אופציונלית. עם זאת, יש להגדיר אותם אם ל-bid BidRequest.AdSlot יש יותר מרוחב וגובה אחד או אם BidRequest.Mobile.is_interstitial_request הוא אמיתי.
agency_id אופציונלי int64 הסוכנות המשויכת למודעה הזו. כדי לקבל רשימה של מזהים, יש לעיין בקובץ agencies.txt במסמכי התיעוד הטכני. אם למודעה הזו לא משויכת סוכנות, יש להשתמש בערך NONE (agency_id: 1) במקום להשאיר את השדה הזה לא מוגדר.
adslot חזרה משבצת מודעה
impression_tracking_url חזרה מחרוזת כתובות ה-URL שאליהן יש לקרוא בעת עיבוד ההופעה. המאפיין הזה נתמך בכל סוגי המלאי ובכל הפורמטים.
click_tracking_url חזרה מחרוזת כתובות ה-URL שאליהן רוצים להתקשר כשהמשתמש לוחץ על המודעה. בשלב זה, האפשרות נתמכת רק במודעות מותאמות ובעסקאות פרוגרמטיות מובטחות בקריאייטיבים שמנוהלים על ידי בעל התוכן הדיגיטלי. במקרה המנוהל על ידי בעל התוכן הדיגיטלי, כלים למעקב אחר קליקים יישלחו לשרת של מגיש הצעות המחיר אל שרת. בכל מצב אחר, ההודעות יישלחו מהמכשיר של המשתמש. מידע נוסף על קריאייטיבים שמנוהלים על ידי בעל התוכן הדיגיטלי זמין במאמר נכסי קריאייטיב המנוהלים על ידי בעל התוכן הדיגיטלי.
ad_choices_destination_url אופציונלי מחרוזת קישור לדף העדפות המודעות. אפשרות זו נתמכת רק במודעות מותאמות. אם קיים סמל AdChoices רגיל, הוא נוסף לקריאייטיב המקורי ומקושר לכתובת ה-URL הזו.
impression_tracking_resource חזרה ResourceTrackingResource מקורות מידע שאפשר להפעיל אחרי שהחשיפה נוצרת. אפשרות זו נתמכת רק בפורמטים מותאמים ובבאנרים, וגם בסקריפטים שמופיעים באופן מפורש ברשימת ההיתרים.
sdk_rendered_ad אופציונלי SdkRenderedAd מודעה שתוצג על ידי SDK המוכרת לקונה. אפשר להשתמש באפשרות הזו רק כש-BidRequest כולל הודעת משנה של mobile.installed_sdk.
skadn אופציונלי SKAdNetworkResponse פרטי ה-SKAdNetwork של המפרסם שיתמכו בשיוך של התקנת אפליקציות ל-iOS 14 ואילך. ממשק ה-API של SKAdNetwork של Apple מסייע למפרסמים למדוד התקנות של אפליקציות שמקורן במודעות, על ידי שליחת דיווח חוזר על המרה (PostBack) לרשת המודעות לאחר התקנה מוצלחת. רשתות המודעות יצטרכו לשלוח את מזהה הרשת ואת פרטי המפרסם החתום כדי לאפשר שיוך של התקנה לחשיפה של המודעה. מידע נוסף זמין במאמר הזה.
advertised_app_id אופציונלי מחרוזת המזהה של האפליקציה שפורסמה (רק לקידום של אפליקציה). ב-Android, השם צריך להיות חבילה או שם חבילה, כמו com.foo.mygames ב-iOS, זהו מזהה מספרי. בנוסף לשדה הזה, צריך להגדיר את השדה app_promotion_type למטה כדי לנצל את היתרונות של תכונות ספציפיות לסוגים של קידום אפליקציות.
app_promotion_type אופציונלי טיפוסים בני מנייה (enum) סוג המבצע לקידום האפליקציה שתואם לאפליקציה שפורסמה שצוינה בשדה advertised_app_id שלמעלה. אם האפליקציה שפורסמה לא יצוין, המערכת תתעלם מהשדה הזה. הגדרת השדה advertised_app_id ללא השדה הזה תיחשב כאילו השדה הזה הוגדר כ-OTHER.

אובייקט NativeAd

הורה

התוכן של מודעה מותאמת. מודעות מותאמות מורכבות מאבני בניין מרובות, שמוצגות על ידי בעל התוכן הדיגיטלי. צריך להגדיר רק אחת מהאפשרויות הבאות: html_snippet, video_url, video_vast_xml או native_ad. השדה הזה מוגדר רק אם BidRequest מיועד למודעה מותאמת (BidRequest.adslot.native קיים).

מאפיין נדרש/אופציונלי Type פרטי ההטמעה
headline אופציונלי מחרוזת כותרת קצרה של המודעה.
body אופציונלי מחרוזת תיאור ארוך של המודעה.
call_to_action אופציונלי מחרוזת תווית על הלחצן שעליו המשתמש אמור ללחוץ.
advertiser אופציונלי מחרוזת שם המפרסם או נותן החסות שיוצג בקריאייטיב של המודעה.
image אופציונלי Image תמונה גדולה.
logo אופציונלי Image תמונה קטנה יותר ללוגו של המפרסם.
app_icon אופציונלי Image סמל האפליקציה במודעות להורדת אפליקציה.
video_url אופציונלי מחרוזת כתובת ה-URL לאחזור מודעת וידאו. כתובת ה-URL צריכה להחזיר תגובת XML שתואמת לתקן VAST 2.0. השדה הזה מוגדר רק אם BidRequest מיועד למודעות מותאמות ומוצגת בקשה לשדה וידאו.
star_rating אופציונלי כפולה דירוג האפליקציה בחנות האפליקציות. חייב להיות בטווח [0-5].
אופציונלי מחרוזת כתובת ה-URL שהדפדפן או ה-SDK ייטענו כשהמשתמש לוחץ על המודעה. זה יכול להיות דף הנחיתה באופן ישיר, או השלב הראשון בשרשרת של הפניות אוטומטיות, שבסופו של דבר מובילה אליה. בתאימות לאחור, אם המדיניות הזו לא מוגדרת, ייעשה שימוש ב-Ad.click_through_url הראשון. במודעות מותאמות, מומלץ להשתמש ב-click_link_url במקום ב-click_through_url.
click_tracking_url אופציונלי מחרוזת הוּצא משימוש. כתובת ה-URL למעקב של קליקים. הפינגים של ה-SDK לוחצים על כתובת ה-URL למעקב בשרשור ברקע. כשמטפלים בכתובת ה-URL, המערכת עוקבת אחר הפניות לכתובת אחרת מסוג HTTP 30x. ה-SDK מתעלם מתוכן התשובה. לכתובת URL זו אין השפעה על דף הנחיתה עבור המשתמש.
price אופציונלי מחרוזת המחיר של האפליקציה שמקדמים, כולל פרטי המטבע.
אובייקט תמונה
הורה
מאפיין נדרש/אופציונלי Type פרטי ההטמעה
url אופציונלי מחרוזת
width
height 		אופציונלי int32 הרוחב והגובה של התמונה מצוינים בפיקסלים. אפשר לספק תמונה גדולה יותר מהמותר, כל עוד יחס הגובה-רוחב נשמר.

אובייקט AdSlot

הורה
מאפיין נדרש/אופציונלי Type פרטי ההטמעה
id חובה int32 מזהה המיקום מתוך BidRequest שהמודעה עשויה להופיע בו.
max_cpm_micros חובה int64 העלות המקסימלית לאלף חשיפות שברצונך לחייב אם זכית במכרז עבור משבצת המודעה הזו, המבוטא במיליוניות המטבע של currency או מטבע ברירת המחדל לבידינג. לדוגמה, כדי להגיש הצעת מחיר לאלף חשיפות בסך 5.20 ש"ח, מגדירים את max_CPM_micros = 1290000. הצעות המחיר הזוכות יעוגלו כלפי מעלה ליחידות לחיוב. לדוגמה, בדולר ארה"ב, הצעות המחיר יעוגלו כלפי מעלה לכפולה הבאה של 10,000 מיקרו (סנטי).
min_cpm_micros אופציונלי int64 העלות המינימלית לאלף חשיפות שברצונך לגבות, אם זכית במכרז של משבצת המודעה הזו, במיליוניות השנייה של המטבע המוגדר כ-currency או ברירת המחדל לבידינג. האפשרות הזו עשויה לייצג מחיר שני אם בחרת ב-max_cpm_micros כגבוהה ביותר של כמה הצעות מחיר, או בצורה כלשהי של מחיר שמור אם ברצונך לשנות את מחיר ההזמנה שהוגדר על ידי בעל התוכן הדיגיטלי. הצעת המחיר חייבת להיות נמוכה מ-max_cpm_micros או שווה לה, אחרת המערכת תתעלם ממנה. השדה הזה הוא אופציונלי ולא צריך להגדיר אותו. השדה הזה לא רלוונטי כשמשיבים לבקשות להצעות מחיר כאשר המכרז של סוג המוצר הוא FIRST_PRICE.
billing_id אופציונלי int64 מזהה החיוב שאליו יש לשייך את החשיפה הזו. הערך צריך להיות בקבוצה של מזהי החיוב של המשבצת הזו שנשלחו ב-BidRequest.AdSlot.matching_ad_data.billing_id. צריך להגדיר את הערך הזה תמיד אם ל-RequestRequest יש יותר מ-BidRequest.AdSlot.matching_ad_data.billing_id אחד.
deal_id אופציונלי int64 מזהה העסקה שאתם רוצים לכלול בהצעת המחיר הזו. עליך להשאיר את הערך לא מוגדר או להגדיר את הערך ל-"1" אם יש מבצע, אבל ברצונך להתעלם מהמבצע ולהשתתף במכרז הפתוח.
exchange_deal_id אופציונלי מחרוזת למגישי הצעות מחיר בבורסות (בורסות של צד שלישי, שמגישות הצעות מחיר בזמן אמת ב-Ad Manager), מזהה העסקה ממרחב השמות של הבורסה שמשויך להצעת המחיר הזו ומדווח לבעלי התוכן הדיגיטלי. אפשר להשאיר את השדה לא מוגדר אם אין עסקה משויכת. זהו טקסט UTF8 שרירותי, והוא חייב להיות לכל היותר 64 בייט.
exchange_deal_type אופציונלי טיפוסים בני מנייה (enum) כאשר exchange_deal_id מוגדר, סוג המבצע. הנתון הזה מדווח לבעלי התוכן הדיגיטלי ומשפיע על אופן הטיפול בעסקה במכרז.

OPEN_AUCTION = 0
PRIVATE_AUCTION = 1
PREFERRED_DEAL = 2
EXCHANGE_AUCTION_PACKAGE = 3

buyer_reporting_id אופציונלי מחרוזת המוכר הצהיר על מזהה שישמש לפירוט העלויות ומדדי התנועה הלא חוקיים בדיווח השקיפות של IVT בכלי השאילתות. לתשומת ליבך, מזהים עם פחות מ-1,000 חשיפות לא ישמשו לפירוט המדדים. המערכת תתעלם ממזהים שאורכם עולה על 64 בייטים.
third_party_buyer_token אופציונלי מחרוזת אסימון המשמש לזיהוי פרטי קונה של צד שלישי אם בורסה של מגישי הצעות מחיר פתוחה היא מתווך. הערך מתקבל מהקונה של הצד השלישי, וצריך להעביר אותו ל-Google ללא שינוי בתגובה להצעת המחיר.
frequency_cap חזרה מכסת תדירות תכונה ניסיונית עשויה להשתנות. מידע נוסף על הניסוי בנושא מכסת תדירות תוך אכיפה זמין בכתובת github.com/google/ads-privacy/tree/master/experiments/frequency-capping.

כדי להפעיל בחשבון מכסת תדירות, צריך לפנות למנהל החשבון.

מציינת את מכסת התדירות שעליה יש להחיל את הצעת המחיר. מכסת החשיפות של כל משתמש היא ברמה שצוינה ב-Frequency_cap_id. הצעת מחיר לא תופיע במכרז אם חשיפה נוספת של המשתמש תפר את המכסות שצוינו. אפשר לציין כמה מכסות תדירות באותו הערך שלFrequency_cap_id.

אם מכסת התדירות לא תקינה, הצעת המחיר מסוננת לפני המכרז. במקרים שבהם המכסה לא תקינה:

  • function_cap_id ריק או ארוך מאוד
  • max_mpresses או time_range הם לא חיוביים
  • קיימות מכסות תדירות רבות להצעת מחיר יחידה
  • time_unit לא מוגדר

    חשוב לזכור שאם הצעת מחיר זהה עם אותה תדירות_cap_id משתמשת במשך זמן שונה (שמיוצג על ידי time_unit ו-time_range), חשיפות שנספרות אחרי מכסת התדירות הישנה לא ייספרו בספירה של המודעה החדשה ובהפך.

    • currency אופציונלי מחרוזת

    המטבע המשמש את max_cpm_micros ואת min_cpm_micros, עם קודי ISO 4217 אלפא. אם השדה הזה מאוכלס, המטבע שצוין יפרש את הצעת המחיר. אם לא תגדירו את האפשרות הזו, המערכת תשתמש במטבע ברירת המחדל לבידינג, שנקבע לפי סדר העדיפויות הבא:

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

    המטבע שמוגדר בחשבון הקונה מוגדר בעת יצירת החשבון. כדי לבדוק את המטבע, אפשר לפנות למנהל החשבון הטכני.
    אובייקט של מכסת תדירות
    הורה
    מאפיין נדרש/אופציונלי Type פרטי ההטמעה
    frequency_cap_id אופציונלי מחרוזת מזהה שיכול לייצג את התרחיש לדוגמה של מגיש הצעות המחיר עבור מכסת תדירות. לדוגמה, הוא יכול לייצג את הקמפיין, המודעה, הפריט וכו'. הוא לא יכול להכיל פרטים או מזהים של המשתמש הספציפי.
    time_unit אופציונלי טיפוסים בני מנייה (enum) יחידות הזמן שעבורן אפשר לאכוף את מכסות התדירות.

    UNKNOWN_TIME_UNIT = 0
    MINUTE = 1
    DAY = 2
    WEEK = 3
    MONTH = 4
    INDEFINITE = 5    : אם משתמשים ב-INDEFINITE, המערכת תתעלם מ-time_range. "הגדרה" פירושה שמכסת התדירות תחול למשך תקופה ארוכה (יותר מחודש), אבל לא בהכרח.

    time_range אופציונלי int32 משך חלון הזמן, ביחידות שהוגדרו על ידי time_unit, שעליהן חלה מכסת התדירות. לדוגמה, אם time_unit=Week ו- time_range=3, המכסה תחול על תקופה של שלושה שבועות. אם ה-time_unit=INDEFINITE לא יוצג, המערכת תתעלם ממנו.
    max_impressions אופציונלי int32 המספר המקסימלי של חשיפות שמותר להציג למשתמש עבור הערך המקסימלי של ה-Frequency_cap_id בחלון הזמן שמתואר ב-time_unit וב-time_range.

    אובייקט חשיפות למעקב אחר חשיפות

    הורה
    מאפיין נדרש/אופציונלי Type פרטי ההטמעה
    script_url אופציונלי מחרוזת כתובת ה-URL של משאב JavaScript. כתובות ה-URL לא יכולות להכיל תגי סקריפט. לדוגמה: "https://mycdn.com/tracker.js".
    context חזרה טיפוסים בני מנייה (enum) הקשר נוסף סופק לעיבוד.

    UNKNOWN_CONTEXT = 0
    OMID = 1

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

    אובייקט SdkRenderedAd

    הורה
    מאפיין נדרש/אופציונלי Type פרטי ההטמעה
    id אופציונלי מחרוזת המזהה של ה-SDK שיעבד את המודעה. הערך חייב להיות זהה לערך mobile.installed_sdk.id שנשלח בבקשה להצעת המחיר התואמת.
    rendering_data אופציונלי מחרוזת הנתונים שצריך להעביר ל-SDK כדי לעבד את המודעה. הנתונים האלה עמומים אצל בעל התוכן הדיגיטלי וב-Google.
    declared_ad אופציונלי אובייקט DelcaredAd הצהרה על נכסים שמצורפים למודעות לצורך תמיכה בקריאייטיב, בסריקה ובסיווג של מדיניות המודעות וחסימות של בעלי תוכן דיגיטלי במודעות שעובדות עם SDK מותאם אישית. אפשר להגדיר רק אחד מהערכים html_snippet, video_url, video_vast_xml או native_ad.
    הצהרת הצהרת מודעה

    הצהרה על נכסים שמצורפים למודעות לצורך תמיכה בקריאייטיב, בסריקה ובסיווג של מדיניות המודעות וחסימות של בעלי תוכן דיגיטלי במודעות שעובדות עם SDK מותאם אישית. אפשר להגדיר רק אחד מהערכים html_snippet, video_url, video_vast_xml או native_ad.

    הורה

    מאפיין נדרש/אופציונלי Type פרטי ההטמעה
    html_snippet אופציונלי מחרוזת נציג קטע ה-HTML של המודעה שמעובדת באמצעות SDK.
    video_url אופציונלי מחרוזת כתובת ה-URL של נכס ה-VAST שמוצג במודעה שמעובדת ב-SDK.
    video_vast_xml אופציונלי מחרוזת מסמך ה-VAST המשמש לעיבוד מודעה שעברה עיבוד מותאם אישית של SDK. המסמך צריך לעמוד בתקן VAST 2.0 או 3.0.
    native_ad אופציונלי NativeAd התוכן של מודעה מותאמת. מודעות מותאמות מורכבות מאבני בניין מרובות, שעוברות עיבוד על ידי SDK של הקונה.
    click_through_url אופציונלי מחרוזת דפי הנחיתה הסופיים של המודעה שמעובדת באמצעות SDK.

    אובייקט SKAdNetworkResponse

    הורה
    מאפיין נדרש/אופציונלי Type פרטי ההטמעה
    version אופציונלי מחרוזת גרסה של SKAdNetwork שנתמכת על ידי המפרסם. משמש גם לציון האופן שבו החתימה נוצרה על ידי המפרסם. צריכה להיות התאמה לאחת מהגרסאות של BidRequest.mobile.skad.versions.
    network אופציונלי מחרוזת מזהה רשת המודעות שבו נעשה שימוש בחתימה. הוא צריך להתאים לאחד מהפריטים ב-BidRequest.mobile.skad.skadnetids.
    campaign אופציונלי int64 מזהה הקמפיין תואם למפרט של Apple. משמש ב-SKAdNetwork 3.0 ומטה. בוצעה החלפה של שדה BidResponse.ad.skad.source_identifier ב-SKAdNetwork 4.0 ואילך.
    source_identifier אופציונלי int64 מספר שלם בן ארבע ספרות שמוגדר על ידי רשתות המודעות כדי לייצג את קמפיין המודעות. בשימוש ב-SKAdNetwork 4.0 ואילך ומחליף את השדה BidResponse.ad.skad.campaign.
    itunesitem אופציונלי מחרוזת מזהה האפליקציה של המפרסם בחנות האפליקציות של Apple.
    product_page_id אופציונלי מחרוזת המזהה של דף המוצר המותאם אישית שיוצג (ב-iOS 15 ואילך). אם לא צוין דף ברירת מחדל, יוצג דף מוצר המוגדר כברירת מחדל. במאמר הזה אפשר לקרוא פרטים נוספים על דפי מוצרים מותאמים אישית.
    fidelities חזרה אמינות גרסה 2.2 של SKAdNetwork API תומכת בכמה אפשרויות של הצגת מודעות, שצוינו באמצעות הפרמטר fidelity-type של החתימה של SKAdNetwork. הפעולה הזו כוללת פרמטרים שמשמשים ליצירת החתימה שתהיה שונה בכל סוג של איכות שנתמך. מידע נוסף זמין במאמר הזה.
    nonce אופציונלי מחרוזת UUID ייחודי באותיות קטנות שנוצר על ידי המפרסם כדי ליצור את החתימה. הערה: השדה הזה יוצא משימוש בשדה BidResponse.ad.skadn.fooelities.noence כדי לתמוך בסוגים רבים של מהימנות.
    sourceapp אופציונלי מחרוזת מזהה האפליקציה של בעל האפליקציה בחנות האפליקציות של Apple. הוא צריך להתאים למזהה שמופיע ב-BidRequest.mobile.skad.sourceapp.
    timestamp אופציונלי int64 זמן Unix באלפיות השנייה שבו נעשה שימוש בעת יצירת החתימה. הערה: השדה הזה יוצא משימוש בשדה BidResponse.ad.skadn.fooelities.timestamp כדי לתמוך בסוגים שונים של איכות.
    signature אופציונלי מחרוזת חתימת SKAdNetwork כפי שצוינה ב-Apple. הערה: השדה הזה יוצא משימוש עבור השדה BidResponse.ad.skadn.fooelities.signature כדי לתמוך בסוגים שונים של איכות.
    skoverlay אופציונלי אובייקט SKOverlay האפשרויות האלה מציינות איך להציג SKLayering עם המלצה על האפליקציה שפורסמה. האפשרות נתמכת ב-iOS 14 ואילך.
    אובייקט איכות
    הורה

    ממשק SKAdNetwork API החל מגרסה 2.2 תומך באפשרויות מרובות להצגת מודעות, שצוינו בפרמטר fidelity-type של חתימת SKAdNetwork. הוא כולל פרמטרים המשמשים ליצירת החתימה שתהיה שונה עבור כל סוג של איכות שנתמך. מידע נוסף זמין במאמר הזה.

    מאפיין נדרש/אופציונלי Type פרטי ההטמעה
    fidelity_type אופציונלי טיפוסים בני מנייה (enum) סוג האיכות של השיוך למעקב. ברירת מחדל = STOREKIT_RENDERED_ADS.

    VIEW_THROUGH_ADS = 0; ייחוס התקנות של אפליקציות בתוך 24 שעות לאחר צפייה במודעה במשך 3 שניות לפחות. נתמכת בגרסה 2.2 ואילך של SKAdnetwork. מידע נוסף זמין במאמר הזה.
    STOREKIT_RENDERED_ADS = 1; מודל שיוך (Attribution) להתקנות של אפליקציה, שנוצר מדף המוצר של AppKit שמעובד ב-AppKit, בעקבות קליקים על מודעות. נתמכת בכל הגרסאות של SKAdNetwork. מידע נוסף זמין במאמר הזה.

    nonce אופציונלי מחרוזת UUID ייחודי באותיות קטנות שנוצר על ידי המפרסם כדי ליצור את החתימה.
    timestamp אופציונלי int64 זמן Unix באלפיות השנייה שבו נעשה שימוש בעת יצירת החתימה.
    signature אופציונלי מחרוזת חתימת SKAdNetwork כפי שצוינה ב-Apple.
    שכבת SK הזו
    הורה
    מאפיין נדרש/אופציונלי Type פרטי ההטמעה
    delay_seconds אופציונלי int32 עיכוב של שניות ספורות לאחר תחילת הצגת המודעה לפני הצגת שכבת-העל. אם השדה הזה מוגדר לערך 0, שכבת-העל תוצג מיד אחרי שהמודעה תתחיל. אם השדה הזה לא מוגדר, שכבת-העל לא תוצג במודעה.
    endcard_delay_seconds אופציונלי int32 עיכוב של שניות לאחר הצגת כרטיס הסיום לפני הצגת שכבת-העל. (השדה הזה רלוונטי רק לנכסי קריאייטיב של מודעות וידאו מתגמלות או למודעות מעברון.) אם השדה הזה מוגדר לערך 0, שכבת-העל תוצג מיד אחרי הצגת כרטיס הסיום. אם השדה הזה לא מוגדר, שכבת-העל לא תוצג בכרטיס הקצה. אם מגדירים את delay וגם את endcard_delay_seconds, שכבת-העל תיסגר באופן אוטומטי כשהמודעה תסתיים, ואז תוצג שוב אחרי שכרטיס הסיום יוצג.
    dismissible אופציונלי בוליאני אם המשתמש יכול לסגור את שכבת-העל הזו. ברירת המחדל היא TRUE.