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

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

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

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

מה זה Select URL API?

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

בתרשים שלמעלה, אפשר להטמיע את האתר shoes.example באתרים אחרים של בעלי תוכן דיגיטלי כמו news.example, ועדיין לגשת לאותם נתונים באמצעות Select URL with Shared Storage כדי לבחור את התוכן המתאים להטמעה.

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

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

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

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

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

לדוגמה:

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

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

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

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

השימוש באפשרות 'בחירת כתובת 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 שמוגדרת כברירת מחדל.

• תקציבים לטווח קצר: תקציבים לטווח קצר הם מגבלות נוספות על בסיס טעינה לכל דף, עד לאכיפה מלאה של fenced frames וכל עוד דיווח ברמת האירוע זמין. יש תקציב של 6 ביטים לכל אתר שקורא ל-API, לכל טעינת דף שמגביל את כמות הנתונים שאתר יחיד שקורא ל-API יכול להעביר באמצעות 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

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

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

‫Select URL API עם Shared Storage מאפשר לכם לפתח את תרחישי השימוש האלה באמצעות גישה לאותו אחסון באתרים שונים ברמה העליונה.

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

אפשר להתנסות בשימוש ב-Select URL באמצעות הדמו של Shared Storage.

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

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

סטטוס ה-API

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

השתתפות ושיתוף משוב

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

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

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