סקירה כללית על כתובות URL נבחרות

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

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

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

מהו Select URL API?

באמצעות Select URL API אפשר לבחור מבין קבוצה של כתובות URL על סמך נתונים מאתרים שונים. ה-API מבוסס על אחסון משותף ומשתמש ב-SharedStorageWorklet כדי לקרוא את הנתונים הזמינים באתרים שונים ולבחור באחת מכתובות ה-URL שסופקו. כתובת ה-URL שנבחרה מוחזרת למבצע הקריאה באופן שמונע קריאה שלה, מלבד בתוך מסגרת מגודר. אפשר גם להציג את כתובת ה-URL ב-iframe עד לפחות שנת 2026.

בתרשים הקודם, אפשר להטמיע את האתר shoes.example באתרים אחרים של בעלי תוכן דיגיטלי, כמו news.example, ועדיין לגשת לאותו נתונים באמצעות האפשרות 'בחירת כתובת URL עם אחסון משותף' כדי לבחור את התוכן המתאים להטמעה.

איך פועלת האפשרות 'בחירת כתובת URL'

אפשר להשתמש ב-Select URL API כדי לבחור כתובת URL שרוצים להציג במסגרת מוקפת או ב-iframe באמצעות נתונים מאתרים שונים. שימוש ב-JavaScript לקריאה ולכתיבה של נתונים בין אתרים ב-Shared Storage, ולאחר מכן בחירת כתובת URL מתוך רשימה שסופקה על סמך הנתונים השמורים.

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

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

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

לדוגמה:

await sharedStorage.set('last-creative', 'globe');
await sharedStorage.set('click', 'true');

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

כדי לאחזר את המידע הזה, קוד ה-JavaScript פועל ב-SharedStorageWorklet, אבל הקוד לא יכול לקיים אינטראקציה עם רכיבים מחוץ ל-iframe או למסגרת המגודרת בדף ההורה, או לתקשר איתם.

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

השימוש ב-Select URL מאפשר לכם לקבל החלטות מושכלות על סמך נתונים מאתרים שונים, בלי לשתף פרטי משתמשים (כמו היסטוריית הדפדפן או פרטים אישיים אחרים) עם אתר ההטמעה או להעביר נתונים לשרתים שלכם.

תקציבים

כדי לצמצם את הסיכון לדליפת נתונים בין אתרים, ב-Select URL API נעשה שימוש במערכת תקציבים עם שילוב של תקציבים לטווח ארוך ולטווח קצר:

• תקציב לטווח ארוך: התקציב לטווח ארוך הוא 12 ביט לכל אתר מבצע קריאה, ליום כשמשתמשים ב-selectURL(). התקציב הזה מחויב רק אם המסגרת שמארחת את כתובת ה-URL שנבחרה מבצעת ניווט ברמה העליונה, והעלות מחושבת לפי log2(number of URLs). לכן, אם תספקו 8 כתובות URL לבחירה, העלות תהיה 3 ביט. התקציב הנותר לאותו יום מחושב לפי 12 - (sum of bits deducted in the last 24 hours). אם לא נותר מספיק תקציב, המערכת מחזירה את כתובת ה-URL שמוגדרת כברירת מחדל (כתובת ה-URL הראשונה ברשימה), ומתבצע רישום של ביט אחד ביומן אם מתבצעת ניווט לכתובת ה-URL שמוגדרת כברירת מחדל.

• תקציבים לטווח קצר: תקציבים לטווח קצר הם מגבלות נוספות לכל טעינת דף, עד שהמערכת תחיל את האכיפה המלאה של המסגרות המגודרות ועד שיהיו דיווחים ברמת האירוע. יש תקציב של 6 ביט לכל אתר מבצע קריאה, לכל טעינת דף שמגביל את כמות המידע שאתר מבצע קריאה יחיד יכול לדלוף באמצעות selectURL(). יש גם תקציב של 12 ביט בסך הכול לכל טעינת דף, שהוא מגבלה משולבת לכל האתרים שמבצעים קריאה בדף.

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

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

  const topProductUrls = [
    { url: 'https://ad.example/default-top-product.html' },
    { url: 'https://ad.example/experiment-top-product.html' }];
  const relatedProductUrls = [
    { url: 'https://ad.example/default-related-product.html' },
    { url: 'https://ad.example/experiment-related-product.html' }];
  
  // This is the first call to `selectURL()` with `savedQuery: 'control_or_experiment'`
  // on this page, so it will be charged to both per-page budgets.
  const topProductsConfig = await sharedStorage.selectURL(
    'productExperiment', topProductUrls, {
      savedQuery: 'control_or_experiment',
      keepAlive: true,
      resolveToConfig: true
  });
  document.getElementById('topProductsFencedFrame').config = topProductsConfig;
  
  // This next call with this savedQuery won't charge either of the per-page budgets.
  const relatedProductConfig = await sharedStorage.selectURL(
    'productExperiment', relatedProductUrls, {
      savedQuery: 'control_or_experiment',
      resolveToConfig: true
  });
  document.getElementById("relatedProductFencedFrame").config = relatedProductConfig;
  

תרחישים לדוגמה לשימוש ב-URL API

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

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

בעזרת Select URL API עם אחסון משותף תוכלו לפתח את התרחישים לדוגמה האלה, כי תהיה לכם גישה לאותו אחסון באתרים שונים ברמה העליונה.

התנסות בהדגמה

אתם יכולים להתנסות ב-Select URL באמצעות הדגמה של אחסון משותף.

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

אפשר גם לעיין בקוד של הדמו ב-GitHub.

סטטוס ה-API

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

יצירת מעורבות ושיתוף משוב

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

נשמח לשמוע את דעתכם על Select URL API.

• הצעה: בודקים את ההצעה המפורטת.
• דיון: תוכלו להצטרף לדיון המתמשך כדי לשאול שאלות ולשתף את התובנות שלכם.

אפשר להתעדכן

• רשימת תפוצה: תוכלו להירשם לרשימת התפוצה שלנו כדי לקבל את העדכונים וההודעות האחרונים לגבי ממשקי ה-API של Select URL ו-Shared Storage.

דרושה לך עזרה?

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