הגדרת ניתוב בקשות למודעות דרך התשתית של המפרסם

התכונה "ניתוב בקשות למודעות דרך התשתית של המפרסם" מאפשרת לשחזר את כתובת ה-IP הגלויה של המשתמש על ידי ניתוב בקשה דרך הרשת להעברת תוכן (CDN) או תשתית האינטרנט שלכם אל שרתי המודעות של Google.

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

רשת ה-CDN מקבלת את כתובת ה-IP של הלקוח של המשתמש, ללא אנונימיזציה, בכל הבקשות הנכנסות לדומיין. התכונה הזו מספקת את היתרונות הבאים:

  • אין שינויים בקוד בצד הלקוח: אתם לא צריכים לערוך את קוד ה-JavaScript או להעביר פרמטרים באופן ידני. ‫Google Publisher Tag ‏(GPT) קורא את הנתיב שהוגדר בהגדרות של Google Ad Manager ומפעיל את בקשת השחזור באופן אסינכרוני.
  • פחות תקורה: הבקשה קלה, נשמרת במטמון באופן מקומי לכל סשן של צפייה בדף ופועלת באופן אסינכרוני לצד הגדרות של מיקומי מודעות בדף.
  • מטען ייעודי (payload) מוצפן: כברירת מחדל, התכונה הזו מחזירה את כתובת ה-IP של המשתמש כמטען ייעודי מוצפן.

בדף הזה מוסבר איך להגדיר את ניתוב הבקשות למודעות דרך התשתית של המפרסם ל-CDN המועדף עליכם.

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

לפני שמגדירים את ה-CDN, צריך לבצע את הפעולות הבאות:

  • מציינים נתיב להצגת מודעות בחשבון Ad Manager, לדוגמה, /adserver/. כדי לציין את הנתיב, פועלים לפי השלבים שמפורטים בקטע שיטה 1: ניתוב בקשות למודעות דרך התשתית של המפרסם.
    • חשוב לוודא שנתיב הצגת המודעות הוא ייחודי, ושהתנועה שאתם שולחים לא משתמשת בנתיב הזה.
  • להגדיר את הפריטים הבאים:
    • מארח או מקור היעד: securepubads.g.doubleclick.net
    • נתיב היעד: /pagead/fpm
    • ‫Protocol: ‏HTTPS עם יציאת ברירת המחדל 443.
    • כותרות: מגדירים את הכותרת כ-Host: securepubads.g.doubleclick.net.
    • שמירה במטמון: מגדירים את ה-CDN כך שיעקוף את השמירה במטמון של נתיב. לדוגמה, מגדירים את כללי המדיניות של השמירה במטמון כך שיעקפו את המטמון או את הכותרת Cache-Control: no-store.
  • אם אתם משתמשים ב-CDN של Cloudflare, אתם צריכים להיות מנויים ברמת Enterprise של Cloudflare כדי ליצור כלל מקור.

הגדרת ה-CDN

מגדירים את ה-CDN או את שרת ה-Proxy ההפוך כך שיעבירו בקשות שתואמות לנתיב שהגדרתם לשרתי המודעות של Google. בוחרים את ה-CDN המועדף:

Cloudflare

  1. יוצרים כלל במרכז הבקרה עם הערכים הבאים:

    • ביטוי סינון בהתאמה אישית: מוסיפים את הביטוי הבא:
      • שדה: URI Path
      • מפעיל: starts with
      • ערך: הנתיב שלכם, לדוגמה, /adserver/.
    • Host Header Override: בוחרים באפשרות Rewrite to ומוסיפים את המארח המטורגט securepubads.g.doubleclick.net.
    • שינוי ידני של DNS: בוחרים באפשרות שינוי ידני אל ומוסיפים את המארח המטורגט securepubads.g.doubleclick.net.

  2. יוצרים כלל לשכתוב כתובות URL במרכז הבקרה עם הערכים הבאים:

    • ביטוי סינון בהתאמה אישית: מוסיפים את הביטוי הבא:
      • שדה: URI Path
      • מפעיל: starts with
      • ערך: הנתיב שלכם, לדוגמה, /adserver/.
    • ‫Path: בוחרים באפשרות Rewrite to > Static > ומוסיפים את נתיב היעד /pagead/fpm.
    • ‫Query: בוחרים באפשרות Preserve.

Amazon CloudFront

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

    • דומיין המקור: securepubads.g.doubleclick.net
    • Protocol: ‏ HTTPS

  2. פועלים לפי ההוראות במאמר יצירת פונקציות ומוסיפים את הדוגמה הבאה:

    function handler(event) {
    var request = event.request;
    request.uri = '/pagead/fpm';
    return request;
}

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

    לוחצים על Save changes, עוברים לכרטיסייה Publish ולוחצים על Publish function.

  3. פועלים לפי ההוראות במאמר Update a distribution in the console עם הערכים הבאים:

    • תבנית הנתיב: הנתיב שלכם, לדוגמה, /adserver/*.
    • מקור וקבוצות מקור: המארח המטורגט, securepubads.g.doubleclick.net.
    • מדיניות המטמון: בוחרים באפשרות CachingDisabled.
    • מדיניות בקשת המקור: בוחרים באפשרות AllViewerExceptHostHeader.
    • שיוכי פונקציות:
      • ‫Viewer request: בוחרים באפשרות CloudFront Function ומוסיפים את שם הפונקציה.

Fastly

  1. פועלים לפי ההוראות בקטע הוספת מארח עם הערכים הבאים:

    • כתובת: המארח המטורגט, securepubads.g.doubleclick.net
    • יציאה: יציאת ברירת המחדל, 443.
    • להפעיל TLS?: כן
      • שם המארח של האישור: securepubads.g.doubleclick.net
        • בוחרים באפשרות התאמה בין שם המארח של SNI לשם האישור.
      • שם המארח של SNI: securepubads.g.doubleclick.net
      • המארח החלופי: securepubads.g.doubleclick.net

  2. פועלים לפי ההוראות במאמר יצירת קטעי קוד של VCL, לפי הדוגמה הבאה:

    if (req.url ~ "^PATH") {
    set req.backend = F_NAME;
    set req.http.Host = "securepubads.g.doubleclick.net";
    set req.url = regsub(req.url, "^PATH", "/pagead/fpm");
    return(pass);
}

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫NAME: שם המארח, לדוגמה Google_GAM_FPM_Backend.
    • ‫PATH: הנתיב שלכם, לדוגמה: /adserver/.

Google Cloud

  1. מבצעים את השלבים שבקטע יצירת קבוצת נקודות הקצה ברשת ונקודת הקצה באינטרנט עם הערכים הבאים:

    • סוג קבוצת נקודות הקצה ברשת: בוחרים באפשרות קבוצת נקודות קצה ברשת באינטרנט (גלובלית).
    • יציאת ברירת המחדל: 443
    • New network endpoint: בוחרים באפשרות שם דומיין שמוגדר במלואו (FQDN) and port.
    • FQDN: מוסיפים את המארח המטורגט, securepubads.g.doubleclick.net.

  2. יוצרים את השירות הגלובלי לקצה העורפי ומגדירים כותרות של בקשות בהתאמה אישית עם הערכים הבאים:

    • ‫Backend type: בוחרים באפשרות Internet network endpoint group.
    • Protocol: בוחרים באפשרות HTTPS.
      • שם הכותרת: Host
      • ערך הכותרת: מוסיפים את המארח המטורגט, securepubads.g.doubleclick.net.

  3. מבצעים את השלבים שמפורטים במאמר הגדרת מפות URL.

  4. בכללי ניתוב, מאתרים את הכלל של המארח בסביבת הייצור שתואם לתת-הדומיין.

    מעדכנים את ההתאמות לנתיבים באמצעות ההגדרה routeRules:

    name: NAME
defaultService: projects/PROJECT_ID/global/backendServices/DEFAULT_BACKEND
routeRules:
  - priority: 1
    matchRules:
      - prefixMatch: PATH
    service: projects/PROJECT_ID/global/backendServices/BACKEND_NAME
    routeAction:
      urlRewrite:
        pathPrefixRewrite: /pagead/fpm

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫BACKEND_NAME: השם של שירות הקצה העורפי שיצרתם בשלב 2, לדוגמה gam-fpm-backend-service.
    • ‫DEFAULT_BACKEND: שירות ברירת המחדל לקצה העורפי שמארח את האתר.
      • אם האתר שלכם מתארח ב-Cloud Storage, החליפו את backendServices בפרמטר backendBuckets בנתיב המשאב של השדה defaultService.
    • ‫NAME: השם של כלי ההתאמה לפי נתיב, לדוגמה gam-fpm-matcher.
    • ‫PATH: הנתיב שלכם, לדוגמה: /adserver/.
    • PROJECT_ID: מזהה הפרויקט.

מבצעים בדיקות של ההטמעה.

כדי לוודא ששרת ה-Proxy של ה-CDN מעביר את הבקשה ואת כתובת ה-IP, מריצים בדיקה באמצעות הפקודה curl:

curl -i https://example.comPATH

מחליפים את PATH בנתיב שלכם, לדוגמה, /adserver/.

אם הפעולה בוצעה בהצלחה, הפלט הבא יתקבל:

  • סטטוס HTTP‏: 200 OK
  • תוכן התגובה: מטען ייעודי (payload) משרתי בק-אנד של Google שמכיל אסימון IP מוצפן כברירת מחדל.

פתרון בעיות בהטמעה

בקטע הזה מפורטים תהליכי עבודה לפתרון בעיות בהטמעה של "ניתוב בקשות למודעות דרך התשתית של המפרסם" ב-CDN.

בטבלה הבאה מפורטות בעיות, סיבות ופתרונות לפתרון בעיות:

בעיה סיבה פתרון
קיבלתם את קוד הסטטוס 404 או 502 של HTTP מה-CDN השכתוב של הנתיב לא פעיל או שהכותרת Host חסרה. צריך לוודא שמפות השכתוב לנתיב היעד /pagead/fpm והכותרת Host מוחלפות במארח היעד, securepubads.g.doubleclick.net.
כתובת ה-IP לא מתעדכנת בבקשות להצגת מודעות. השמירה במטמון מופעלת בשרת ה-proxy של ה-CDN חשוב להגדיר את מדיניות המטמון בנתיב למדיניות CachingDisabled או לכותרת Cache-Control: no-store. כל לקוח חייב להגיע לשירות לקצה העורפי כדי להעריך את כתובת ה-IP הספציפית שלו.
כשל בלחיצת יד בפרוטוקול SSL או TLS חוסר התאמה של SNI בחיבור למקור בקצה העורפי צריך לוודא שהגדרת את ה-CDN כך שישלח את המארח המטורגט securepubads.g.doubleclick.net בתוסף TLS SNI.
הפרמטר ips חסר בבקשה להצגת מודעה. הנתיב ב-Ad Manager לא תואם לנתיב ב-CDN מוודאים שהנתיב שהוזן בדף הגדרות גלובליות בממשק המשתמש של Ad Manager תואם לנתיב שהוגדר ב-CDN. פרטים נוספים זמינים במאמר העברת כתובת IP לא מוסתרת שסופקה על ידי בעל התוכן הדיגיטלי (בטא).