שליחת אותות של Google Ad Manager דרך שרתי מודעות של צד שלישי

אם אתם משתמשים בשרת מודעות של צד שלישי עם הטמעת מודעות בצד השרת (SSAI) של Google Ad Manager, מערכת IMA תומכת במונטיזציה נוספת של מלאי שטחי הפרסום דרך Google Ad Manager. לשם כך, היא שולחת אל Ad Manager קוד מוצפן (nonce) דרך שרת המודעות של הצד השלישי. במדריך הזה נסביר איך לשלוח את האותות האלה באמצעות IMA SDK.

מונח מפתח: במדריך הזה, 'שרת מודעות של צד שלישי' הוא כל שרת מודעות שאינו Google Ad Manager.

במדריך הזה נעשה שימוש בתג מודעה לדוגמה: https://youradserver.com. צריך לעדכן את תג המודעות כך שיפעל עם שרתי המודעות בפועל.

דרישות מוקדמות

• IMA HTML5 SDK מגרסה 3.523.0 ואילך.

• מבצעים את ההוראות במדריך לתחילת העבודה.

1. הגדרת האפליקציה לשליחת צופן חד-פעמי (nonce) לשרתי DAI של Google

מגדירים את enableNonce לערך true כדי ש-IMA DAI SDK ישלח מחרוזת חד-פעמית (nonce) מוצפנת לשרתי DAI.

const streamRequest = new LiveStreamRequest();
streamRequest.enableNonce = true;

2. צריך לעדכן את תג המודעה באמצעות מאקרו כדי לאכלס את הצופן החד-פעמי (nonce)

מוסיפים את המאקרו [GOOGLE_INSTREAM_VIDEO_NONCE] לתג של שרת המודעות בממשק המשתמש של Ad Manager. כששרת DAI מאכלס את ההפסקות למודעות בכתובות ה-URL של שרת המודעות של צד שלישי, מערכת Ad Manager תאכלס את פקודת המאקרו באופן דינמי לפי הצופן המוצפן. התוצאה אמורה להיראות כמו תג המודעה לדוגמה הבא, שמשתמש במפתח שצריך להגדיר בשרת של הצד השלישי:

https://youradserver.com?ad_manager_nonce=[GOOGLE_INSTREAM_VIDEO_NONCE]

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

כדי לעדכן את התג של שרת המודעות ב-Ad Manager, עוברים אל וידאו > שידורים חיים ובוחרים שידור חי פעיל או יוצרים שידור חי חדש.

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

3. הגדרת הבקשה של שרת המודעות של הצד השלישי ל-Ad Manager

מגדירים את שרת המודעות של הצד השלישי כך שיכלול את הצופן החד-פעמי (nonce) בבקשת השרת ל-Ad Manager. דוגמה לתג מודעה שמוגדר בתוך שרת המודעות של הצד השלישי:

https://pubads.g.doubleclick.net/gampad/ads?givn=%%custom_key_for_google_nonce%%&iu=/21775744923/external/single_ad_samples&sz=640x480

מערכת Ad Manager מחפשת את givn= כדי לזהות את ערך ה-nonce. שרת המודעות של הצד השלישי צריך לתמוך במאקרו מסוים, כמו %%custom_key_for_google_nonce%%, ולהחליף אותו בפרמטר השאילתה צופן חד-פעמי (nonce) שסיפקתם בשלב הקודם. מידע נוסף על האופן שבו מבצעים את הפעולה הזו אמור להיות זמין במסמכי העזרה של שרת המודעות של הצד השלישי.

הערה: המדריך הזה משתמש בשתי פקודות מאקרו.

1. בקשות המודעות ששולחים לשרתי המודעות של הצד השלישי צריכות לכלול את המאקרו [GOOGLE_INSTREAM_VIDEO_NONCE]. תג המודעה הזה מאוחסן בממשק המשתמש של Ad Manager. חיפושים של IMA SDK (עם התאמה מדויקת לפי אותיות רישיות) ומחליפים את המאקרו הזה בקוד המוצפן.
2. המאקרו השני, %%custom_key_for_google_nonce%%, משמש את שרת המודעות של הצד השלישי כדי למלא את המזהה החד-פעמי המוצפן של הבקשה ל-Google Ad Manager. המאקרו הזה הוא דוגמה, ואפשר להגדיר אותו לכל מחרוזת ששרת המודעות של הצד השלישי מקבל.

זהו! עכשיו פרמטר ה-noce צריך להיות מופץ מ-IMA DAI SDK דרך שרת ה-DAI, אל שרת המודעות של הצד השלישי, ובחזרה אל Ad Manager. כך אפשר לשפר את המונטיזציה באמצעות Google Ad Manager.