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

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

הגדרת נקודת הקצה של התראות על חשיפות

כדי לקבל התראות על חשיפות, צריך ליצור נקודת קצה (endpoint) בפרוטוקול HTTP ולשתף את כתובת ה-URL שלה עם Google. אפשר להגדיר את כתובת ה-URL שאליה יישלחו התראות על חשיפות באחת מהדרכים הבאות:

  1. מגדירים את כתובת ה-URL של נקודת הקצה של ההתראה על חשיפה לכל קריאה של המלצה בזמן אמת.
    • אפשר להגדיר באופן דינמי את כתובת ה-URL שמשמשת להתראות על חשיפות לכל קריאה של Real-time Curation שמתקבלת, על ידי מילוי השדה SegmentResponse.burl.
    • כדי לקבל התראה על חשיפה של קריאה מסוימת ל-Real-time Curation, צריך להגדיר את השדה SegmentResponse.burl. אם השדה SegmentResponse.burl לא מאוכלס, לא תישלח התראה לגבי ההדגשה הזו, גם אם השדה SegmentResponse.burl הוגדר בהדגשות קודמות.
  2. הגדרת כתובת URL של נקודת קצה (endpoint) לקבלת התראות על חשיפות ברמת החשבון.
    • כדי להגדיר כתובת URL של נקודת קצה (endpoint) לקבלת הודעות על חשיפות ברמת החשבון, צריך לפנות למנהל החשבון. האפשרות הזו מתאימה במיוחד אם כתובת ה-URL של נקודת הקצה משתנה לעיתים רחוקות.
    • כל ההפניות של 'בחירת תוכן בזמן אמת' ישתמשו בכתובת ה-URL של ההתראה על חשיפה ברמת החשבון שהגדרתם לחשבון, אלא אם תבטלו את כתובת ה-URL ברמת החשבון על ידי הגדרת השדה SegmentResponse.burl להפניה ספציפית של 'בחירת תוכן בזמן אמת'.

ניתוח של התראת חשיפה

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

איך פקודות מאקרו מתרחבות

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

לדוגמה, אפשר להגדיר שכתובת ה-URL של נקודת הקצה של הודעת החשיפה תיראה כך:

https://testendpoint.com/impressions?segmentReqId=${SR_ID}&segmentIds=${SEGMENT_IDS}

כשמתקבלת התראה על חשיפה, פקודות המאקרו מוחלפות, וכתובת ה-URL נראית כך:

https://testendpoint.com/impressions?segmentReqId=8Mbl39sMOX5yg1NZgS35ET&segmentIds=test-ds-1|test-ds-2

מידע נוסף על פקודות מאקרו נתמכות

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

Macro תיאור
${SR_ID} מזהה מחרוזת ייחודי ששווה לערך של השדה SegmentRequest.segment_request_id בנכס היתרונות המרכזיים המתאים של 'בחירה בזמן אמת'. הכוונה היא לבקשה לפלח שהגבתם עליה עם מזהה אחד או יותר של פלחי נתונים שתרמו להצעת המחיר הזוכה.
${SEGMENT_IDS} רשימה של מזהים של פלחי נתונים מסוג מחרוזת שתרמו להצעת המחיר הזוכה. כל פריט ברשימה מופרד באמצעות התו '|'. לדוגמה, אפשר להרחיב את זה לרשימת ערכים כמו: "segmentId1|segmentId2|segmentId3" כל מזהה של פלח נתונים שמאכלס את הרשימה מתייחס למזהה המשאב של משאב curators.dataSegments תואם ב-Marketplace API.
${AUCTION_PRICE} מחרוזת שמייצגת את המחיר הזוכה במכרז. המחיר הוא העלות של חשיפה יחידה (CPI) במיקרו-דולר ארה"ב. לדוגמה, אם הצעת מחיר בבידינג בזמן אמת היא 5 $עלות לאלף חשיפות, מאקרו ${AUCTION_PRICE} יורחב ל-5,000 מיקרו-דולר עלות להמרה בהתראה על חשיפה של תוכן שנבחר בזמן אמת.
${DEAL_ID} המזהה של המבצע או החבילה שזכו במכרז. זו עסקה או חבילה שמטרגטת מזהה אחד או יותר של פלחים של נתונים שלכם, שאפשר לזהות באמצעות מאקרו ${SEGMENT_IDS}.
${BUYER_SEAT_ID} המזהה של מושב הקונה שזכה בחשיפה, כפי שצוין על ידי מגיש הצעות המחיר בהצעת המחיר הזוכה. לדוגמה, מושבים של קונים יכולים להיות סוכנויות או מפרסמים.

השלבים הבאים