שקיפות הצעת מחיר עם אובייקט SupplyChain

האובייקט SupplyChain מאפשר לקונים ולמתווכים לראות את כל הצדדים שמוכרים או מפיצים את מלאי שטחי הפרסום. האובייקט פועל יחד עם הקבצים ads.txt / ‏app-ads.txt ו-sellers.json כדי ליצור שקיפות בסביבה העסקית של המודעות.

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

‫Google תיצור באופן אוטומטי את האובייקטים בבקשת OpenRTB או בפרוטוקול RTB של Google, במקרים הרלוונטיים.

איך פועל האובייקט SupplyChain

אובייקט ה-SupplyChain, שמכונה גם schain, הוא חלק מבקשה להצעת מחיר מסוג OpenRTB והוא מורכב מ"צמתים". כל צומת באובייקט schain מייצג ישות ספציפית שמשתתפת בבקשה להצעת המחיר, שכוללת את כל הישויות שמעורבות ישירות בתהליך של התשלום על מלאי שטחי הפרסום.

טיפ: כדי ש-Google תיצור אובייקט SupplyChain שלם ראשי ניהול של מלאי שטח הפרסום ב-MCM נדרשים לשתף את מזהה בית העסק (sid) של השותפים המשניים שלהם באמצעות Ad Manager או ה-API.

 

‫// אובייקט לדוגמה
‎ "schain": {
‎ ‎     "complete": 1,
‎ ‎     "nodes": [{
‎ ‎          ‎"asi":"google.com",
‎ ‎          ‎"sid":"pub-1234567891234567", ‎// Same seller_id for the publisher in sellers.json
‎ ‎          ‎"hp":1
‎ ‎     }],
‎ ‎     "ver":"1.0"
‎ ‎ }‎

מידע נוסף זמין במאמרי עזרה למפתחים בנושא OpenRTB ובמאמרי עזרה של IAB.

בהתאם לאופן שבו אתם עובדים עם קונים, האובייקט SupplyChain יכול להיראות אחרת.

בעלי תוכן דיגיטלי שמוכרים ישירות דרך Google

לבעלי תוכן דיגיטלי שמוכרים מלאי שטחי פרסום ישירות דרך Ad Manager‏, AdMob או AdSense, האובייקט schain מכיל רק צומת אחד של "google.com" עם ה-seller_id שמופיע ב-sellers.json.

בעלי תוכן דיגיטלי שמשתמשים ב-Open Bidding

לבעלי תוכן דיגיטלי שמשתמשים ב-Open Bidding כדי לעבוד עם פלטפורמות Exchange של צד שלישי יש שני צמתים באובייקט schain: צומת אחד בשביל google.com, עם ה-seller_id שמופיע ב-seller.json, וצומת אחד בשביל שותף התפוקה ב-Exchange.

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

מתווכים שלא מעורבים בתשלום

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

בעל תוכן דיגיטלי שנעזרים במתווכים לתשלום בשלב שלפני הבקשה ^(בטא) 

This feature is in Beta
Features in Beta phase might not be available in your network. Watch the release notes for when this feature becomes generally available.

בעלי תוכן דיגיטלי שנעזרים במתווכים לתשלום בשלב שלפני הבקשה מ-Google Ad Manager נדרשים להעביר את אובייקט SupplyChain בהתאם להנחיות IAB. אובייקט SupplyChain צריך להכיל רק מתווכים שמעורבים ישירות בזרימת התשלומים למלאי שטחי הפרסום. מתווכים כאלה עשויים לכלול טכנולוגיית שרת מודעות של צד שלישי שמשמשת את בעלי התוכן הדיגיטלי. אפשר לשלוח את אובייקטSupplyChain בבקשה להצגת מודעה באמצעות הפרמטר schain.

מידע נוסף על פרמטר schain

תיאור

The supply chain (schain) parameter accepts a variable value which should be serialized SupplyChain object. When this parameter is included, Google appends a node to any received schain objects prior to sending to buyers.

See the full IAB documentation for communicating SupplyChain information via a tag (rather than OpenRTB).

See requirements for schain to be parsed correctly

Based on the IAB documentation, the following defines the serialization for the SupplyChain object:

• {SupplyChainObject}!{SupplyChainNode array}. SupplyChainObject and SupplyChainNode properties are comma delimited such that optional fields can be omitted and comma separators for which can be optionally excluded.
• Each SupplyChainNode element is separated by a "!".
• If the value of any property contains characters that require URL encoding (for example "," or "!"), the value should be URL encoded before serialization.

Serialization order

SupplyChainObject properties are serialized in this order:

ver,complete

SupplyChainNode properties are serialized in this order:

asi,sid,hp,rid,name,domain,ext

Note: The contents of ext are exchange specific. Google Ad Manager does not parse this property.

Examples of how to serialize the SupplyChain object

Below are two examples of ways to serialize the above SupplyChain object:

Serialize with commas for empty optional fields

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

Serialize without commas for empty optional fields

1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

Learn more about the SupplyChain object.

Usage examples

schain=1.0,1!exchange1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1,,,,

If the value for asi were exchange,1, then the serialization with escaped characters would look like:

1.0,1!exchange%2C1,12345,1,bid-request-1,publisher1,publisher1.com!google.com,pub-12345678910,1

Requirements and recommendations

While this this parameter is not required to serve ads to any specific implementation or transaction type, it is required for publishers leveraging payment intermediaries upstream of the request to Google Ad Manager. This includes publishers who use third-party ad server technology.

 

הערה: צמתים נוספים שמצורפים לאובייקט SupplyChain צריכים להיות מיוצגים גם בקובץ ads.txt/app-ads.txt של בעלי התוכן הדיגיטלי, אחרת יכול להיות שהתנועה תיחשב אצל הקונים כלא מורשית.

בעלי אפליקציות שמשתמשים בכלי 'ניהול לקוחות מרובים'

הכלי ניהול לקוחות מרובים (MCM) מאפשר לבעלי אפליקציות לנהל את חשבונות הלקוחות שלהם ב-AdMob עם אותם אמצעי בקרה והרשאות גישה שיש לבעלי האפליקציות בחשבונות שלהם.

לבעלי אפליקציות ראשיים ולשותפים משניים שמשתמשים ב-MCM של AdMob, האובייקט schain יכלול צומת אחד עם מזהה בית העסק של השותף המשני, והרשת תסומן כ'הושלמה'. ב-MCM של AdMob, המונטיזציה מתרחשת בחשבון של השותף המשני. השותף המשני נחשב כבעל האפליקציה הסופי. הפרטים של בעל האפליקציה הראשי לא נכללים באובייקט schain.