راه‌اندازی مسیر ارائه طرف اول

ویژگی «مسیر ارائه طرف اول» به شما امکان می‌دهد با مسیریابی درخواست ازطریق «شبکه توزیع محتوا» (CDN) یا زیرساخت وب به سرورهای آگهی Google، نشانی IP کاربر را بدون پوشش بازیابی کنید.

در درخواست‌های طرف سوم، ویژگی‌های مرورگر و سیستم‌عامل و پیکربندی‌های شبکه ممکن است نشانی‌های IP را پنهان کنند. این پنهان‌سازی ممکن است بر درآمد آگهی، هدف‌یابی جغرافیایی، و تشخیص ترافیک نامعتبر (IVT) شما تأثیر بگذارد.

CDN شما IP کارخواه پنهان‌نشده کاربر را در همه درخواست‌های ورودی به دامنه‌تان دریافت می‌کند. این ویژگی مزایای زیر را ارائه می‌دهد:

  • بدون تغییر کد سمت کارخواه: جاوا اسکریپت را ویرایش نمی‌کنید یا پارامترها را به‌صورت دستی ارسال نمی‌کنید. «برچسب ناشر Google» (GPT) مسیر پیکربندی‌شده را از تنظیمات Google Ad Manager شما می‌خواند و درخواست بازیابی را به‌صورت ناهمگام اجرا می‌کند.
  • سربار کمتر: درخواست سبک است، به‌ازای هر جلسه بازدید صفحه به‌طور محلی ذخیره می‌شود، و به‌صورت ناهمگام درکنار تعاریف جایگاه آگهی اجرا می‌شود.
  • بار داده رمزگذاری‌شده: به‌طور پیش‌فرض، این ویژگی نشانی IP کاربر را به‌عنوان بار داده رمزگذاری‌شده برمی‌گرداند.

این صفحه پیکربندی «مسیر ارائه شخص اول» را برای CDN ترجیحی شما پوشش می‌دهد.

پیش‌نیازها

قبل‌از پیکربندی CDN، کارهای زیر را انجام دهید:

  • مسیر ارائه‌ای را در حساب Ad Manager خود مشخص کنید، برای مثال، /adserver/. برای مشخص کردن مسیر، مراحل موجود در روش ۱: مسیر ارائه شخص اول را دنبال کنید.
    • مطمئن شوید که مسیر ارائه شما یکتا است و هیچ ترافیکی که ارسال می‌کنید از این مسیر استفاده نمی‌کند.
  • موارد زیر را داشته باشید یا تنظیم کنید:
    • میزبان یا مبدأ هدف: securepubads.g.doubleclick.net
    • مسیر هدف: /pagead/fpm
    • پروتکل: HTTPS با درگاه پیش‌فرض 443.
    • سرصفحه‌ها: سرصفحه را روی Host: securepubads.g.doubleclick.net تنظیم کنید.
    • ذخیره در حافظه نهان: CDN خود را پیکربندی کنید تا ذخیره در حافظه نهان را برای یک مسیر دور بزند، برای مثال، خط‌مشی‌های حافظه نهان را برای دور زدن حافظه نهان یا سرایند Cache-Control: no-store تنظیم کنید.
  • اگر CDN شما Cloudflare است، برای ایجاد قانون مبدأ باید سطح Cloudflare Enterprise داشته باشید.

پیکربندی CDN

CDN یا پراکسی معکوس خود را پیکربندی کنید تا درخواست‌های منطبق با مسیر پیکربندی‌شده شما را به سرورهای آگهی Google بازارسال کند. شبکه توزیع محتوای ترجیحی‌تان را انتخاب کنید:

Cloudflare

  1. قانونی در داشبورد با مقادیر زیر ایجاد کنید:

    • عبارت فیلتر سفارشی: موارد زیر را اضافه کنید:
      • فیلد: URI Path
      • اپراتور: starts with
      • مقدار: مسیر شما، برای مثال، /adserver/.
    • لغو سرصفحه میزبان: بازنویسی به را انتخاب کنید و میزبان هدف securepubads.g.doubleclick.net را اضافه کنید.
    • لغو ساناد: لغو به را انتخاب کنید و میزبان هدف را اضافه کنید securepubads.g.doubleclick.net.

  2. بازنویسی قانون نشانی وب را در داشبورد با مقادیر زیر ایجاد کنید:

    • عبارت فیلتر سفارشی: موارد زیر را اضافه کنید:
      • فیلد: URI Path
      • اپراتور: starts with
      • مقدار: مسیر شما، برای مثال، /adserver/.
    • مسیر: بازنویسی به > ایستا > را انتخاب کنید و مسیر هدف /pagead/fpm را اضافه کنید.
    • پرس‌وجو: حفظ کردن را انتخاب کنید.

Amazon CloudFront

  1. مراحل تنظیمات مبدأ را با مقادیر زیر دنبال کنید:

    • دامنه مبدأ: securepubads.g.doubleclick.net
    • پروتکل: HTTPS

  2. ایجاد توابع را دنبال کنید و مثال زیر را اضافه کنید:

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

    این مثال رویداد درخواست ورودی را می‌گیرد، URI را به مسیر هدف اختصاص می‌دهد، و درخواست را برمی‌گرداند.

    روی ذخیره تغییرات کلیک کنید، به برگه انتشار بروید، و روی انتشار تابع کلیک کنید.

  3. به‌روزرسانی توزیع در کنسول را با مقادیر زیر دنبال کنید:

    • الگوی مسیر: مسیر شما، برای مثال، /adserver/*.
    • مبدأ و گروه‌های مبدأ: میزبان هدف، securepubads.g.doubleclick.net.
    • خط‌مشی حافظه نهان: CachingDisabled را انتخاب کنید.
    • خط‌مشی درخواست مبدأ: AllViewerExceptHostHeader را انتخاب کنید.
    • انجمن‌های عملکرد:
      • درخواست بیننده: تابع CloudFront را انتخاب کنید و نام تابع خود را اضافه کنید.

Fastly

  1. افزودن میزبان را با مقادیر زیر دنبال کنید:

    • نشانی: میزبان هدف، securepubads.g.doubleclick.net
    • درگاه: درگاه پیش‌فرض، 443.
    • «امنیت لایه انتقال» فعال شود؟: بله
      • نام میزبان گواهینامه: 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. ایجاد NEG و نقطه پایانی اینترنت را با مقادیر زیر دنبال کنید:

    • نوع گروه نقطه پایانی شبکه: گروه نقطه پایانی شبکه اینترنت (جهانی) را انتخاب کنید
    • درگاه پیش‌فرض: 443
    • نقطه پایانی شبکه جدید: نام دامنه کاملاً واجدشرایط (FQDN) و درگاه را انتخاب کنید.
    • FQDN: میزبان هدف، securepubads.g.doubleclick.net، را اضافه کنید.

  2. سرویس زیرینه‌ای جهانی‌تان را ایجاد کنید و سرایندهای درخواست سفارشی را با مقادیر زیر پیکربندی کنید:

    • نوع پس‌زمینه: گروه نقطه پایانی شبکه اینترنت را انتخاب کنید.
    • پروتکل: HTTPS را انتخاب کنید.
      • نام سرایند: Host
      • مقدار سرایند: میزبان هدف، securepubads.g.doubleclick.net، را اضافه کنید.

  3. مراحل پیکربندی نقشه‌های نشانی وب را دنبال کنید.

  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: نام سرویس پشت‌صحنه‌ای که در مرحله ۲ ایجاد کردید، برای مثال، gam-fpm-backend-service.
    • DEFAULT_BACKEND: سرویس پسین پیش‌فرضی که وب‌سایت شما را میزبانی می‌کند.
      • اگر وب‌سایتتان را در Cloud Storage میزبانی می‌کنید، backendServices را با پارامتر backendBuckets در مسیر منبع فیلد defaultService جایگزین کنید.
    • NAME: نام تطبیق‌دهنده مسیر، برای مثال، gam-fpm-matcher.
    • PATH: مسیر شما، برای مثال، /adserver/.
    • ‫PROJECT_ID: شناسه پروژه شما.

آزمایش کردن پیاده‌سازی

برای تأیید اینکه CDN شما درخواست را پروکسی می‌کند و نشانی IP را ارسال می‌کند، بااستفاده از فرمان curl آزمایشی اجرا کنید:

curl -i https://example.comPATH

PATH را با مسیر خودتان جایگزین کنید، برای مثال، /adserver/.

اگر موفقیت‌آمیز باشد، خروجی زیر را دریافت می‌کنید:

  • وضعیت HTTP: 200 OK
  • محتوای پاسخ: بار داده‌ای از سرورهای زیرینه Google که به‌طور پیش‌فرض حاوی یک کد IP رمزگذاری‌شده است.

عیب‌یابی پیاده‌سازی

این بخش گردش‌های کاری را برای عیب‌یابی پیاده‌سازی «مسیر ارائه طرف اول» در CDN شما پوشش می‌دهد.

جدول زیر جزئیات مشکلات، دلایل، و راه‌حل‌های عیب‌یابی را نشان می‌دهد:

مشکل علت راه‌حل
وضعیت HTTP 404 یا 502 را از CDN خود دریافت می‌کنید بازنویسی مسیر فعال نیست یا سرایند Host وجود ندارد. بررسی کنید که بازنویسی شما به مسیر هدف /pagead/fpm نگاشت شده باشد و سرصفحه Host به میزبان هدف securepubads.g.doubleclick.net لغو شده باشد.
نشانی IP در درخواست‌های آگهی به‌روز نمی‌شود. ذخیره در حافظه نهان در پراکسی 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 ارائه‌شده توسط ناشر بدون پوشش (نسخه بتا) مراجعه کنید.