إعداد مسار العرض من الطرف الأول

تتيح لك ميزة "مسار العرض من الطرف الأول" استرداد عنوان IP الخاص بالمستخدم غير المحجوب من خلال توجيه طلب عبر شبكة توصيل المحتوى (CDN) أو البنية الأساسية للويب إلى خوادم إعلانات Google.

في الطلبات التابعة لجهات خارجية، قد تحجب ميزات المتصفّح ونظام التشغيل وإعدادات الشبكة عناوين IP. قد يؤثّر هذا الإخفاء في إيرادات الإعلانات والاستهداف الجغرافي ورصد الزيارات غير الصالحة.

تتلقّى شبكة توصيل المحتوى عنوان IP غير محجوب للمستخدم في جميع الطلبات الواردة إلى نطاقك. توفّر هذه الميزة المزايا التالية:

  • عدم إجراء تغييرات على الرمز من جهة العميل: لا يمكنك تعديل JavaScript أو تمرير المَعلمات يدويًا. تقرأ علامة "ناشر Google" ‏(GPT) المسار الذي تم ضبطه من إعدادات "مدير إعلانات Google" وتنفّذ طلب الاسترداد بشكل غير متزامن.
  • تقليل النفقات العامة: الطلب خفيف الوزن، ويتم تخزينه مؤقتًا على الجهاز لكل جلسة مشاهدة صفحة، ويتم تشغيله بشكل غير متزامن مع تعريفات الخانات الإعلانية.
  • حمولة مشفّرة: تعرض هذه الميزة تلقائيًا عنوان IP الخاص بالمستخدم كحمولة مشفّرة.

تتناول هذه الصفحة كيفية ضبط "مسار العرض من الطرف الأول" على شبكة توصيل المحتوى المفضّلة لديك.

المتطلبات الأساسية

قبل ضبط شبكة توصيل المحتوى، يُرجى اتّباع الخطوات التالية:

  • حدِّد مسار عرض في حسابك على "إدارة إعلانات Google"، على سبيل المثال، /adserver/. لتحديد المسار، اتّبِع الخطوات الواردة في الطريقة الأولى: مسار العرض من الطرف الأول.
    • تأكَّد من أنّ مسار العرض فريد، وأنّ أي زيارات ترسلها لا تستخدم هذا المسار.
  • أن يتوفّر لديك أو تضبط العناصر التالية:
    • المضيف أو المصدر المستهدَف: securepubads.g.doubleclick.net
    • المسار المستهدَف: /pagead/fpm
    • البروتوكول: HTTPS مع المنفذ التلقائي 443.
    • العناوين: اضبط العنوان على Host: securepubads.g.doubleclick.net.
    • التخزين المؤقت: اضبط شبكة توصيل المحتوى لتجاوز التخزين المؤقت لمسار معيّن، على سبيل المثال، اضبط سياسات التخزين المؤقت لتجاوز ذاكرة التخزين المؤقت أو العنوان Cache-Control: no-store.
  • إذا كانت شبكة توصيل المحتوى (CDN) هي Cloudflare، يجب أن تكون لديك خطة Cloudflare Enterprise لإنشاء قاعدة مصدر.

ضبط إعدادات شبكة توصيل المحتوى

اضبط شبكة توصيل المحتوى أو الخادم الوكيل العكسي لإعادة توجيه الطلبات التي تتطابق مع المسار الذي تم ضبطه إلى خوادم إعلانات Google. اختَر شبكة توصيل المحتوى المفضّلة لديك:

Cloudflare

  1. أنشئ قاعدة في لوحة البيانات بالقيم التالية:

    • تعبير الفلتر المخصّص: أضِف ما يلي:
      • الحقل: URI Path
      • المشغّل: starts with
      • القيمة: المسار، على سبيل المثال، /adserver/.
    • تجاوز عنوان المضيف: اختَر إعادة الكتابة إلى وأضِف المضيف المستهدف securepubads.g.doubleclick.net.
    • تجاهل نظام أسماء النطاقات: اختَر التجاهل إلى وأضِف المضيف المستهدَف securepubads.g.doubleclick.net.

  2. أنشئ قاعدة إعادة كتابة عنوان URL في لوحة البيانات باستخدام القيم التالية:

    • تعبير الفلتر المخصّص: أضِف ما يلي:
      • الحقل: 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.
    • سياسة ذاكرة التخزين المؤقت (Cache policy): اختَر CachingDisabled.
    • سياسة طلب المصدر (Origin request policy): اختَر AllViewerExceptHostHeader.
    • عمليات ربط الدوال:
      • طلب المشاهد (Viewer request): اختَر دالة CloudFront (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
    • نقطة نهاية الشبكة الجديدة: اختَر اسم النطاق المؤهَّل بالكامل (FQDN) والمنفذ.
    • FQDN: أضِف المضيف المستهدَف، securepubads.g.doubleclick.net.

  2. أنشئ خدمة الخلفية العامة واضبط عناوين الطلبات المخصّصة باستخدام القيم التالية:

    • نوع الخلفية: اختَر مجموعة نقاط نهاية الشبكة على الإنترنت.
    • البروتوكول: اختَر 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: رقم تعريف مشروعك

التحقق من نجاح العملية

للتأكّد من أنّ شبكة توصيل المحتوى (CDN) تنقل الطلب وعنوان IP، يمكنك إجراء اختبار باستخدام الأمر curl:

curl -i https://example.comPATH

استبدِل PATH بالمسار، على سبيل المثال، /adserver/.

في حال نجاح العملية، ستتلقّى الناتج التالي:

  • حالة HTTP‏: 200 OK
  • محتوى الردّ: حمولة من خوادم Google الخلفية تحتوي على رمز مميّز مشفّر لعنوان IP تلقائيًا.

تحديد المشاكل في عملية التنفيذ وحلّها

يتناول هذا القسم سير العمل لتحديد المشاكل وحلّها في تنفيذ "مسار العرض من الطرف الأول" في شبكة توصيل المحتوى.

يوضّح الجدول التالي المشاكل والأسباب والحلول لتحديد المشاكل وحلّها:

المشكلة السبب الحل
تلقّي حالة HTTP‏ 404 أو 502 من شبكة توصيل المحتوى (CDN) إعادة كتابة المسار غير مفعّلة أو أنّ عنوان Host غير متوفّر. يُرجى التحقّق من أنّ خرائط إعادة الكتابة تؤدي إلى المسار المستهدَف /pagead/fpm وأنّه تم إلغاء العنوان Host إلى المضيف المستهدَف securepubads.g.doubleclick.net.
لا يتم تعديل عنوان IP في طلبات عرض الإعلانات. تم تفعيل التخزين المؤقت على خادم وكيل شبكة توصيل المحتوى (CDN) تأكَّد من ضبط سياسة ذاكرة التخزين المؤقت على المسار على سياسة CachingDisabled أو عنوان Cache-Control: no-store. يجب أن يصل كل عميل إلى خدمة الخلفية لتقييم عنوان IP الخاص به.
تعذُّر تأكيد الاتصال عبر طبقة المقابس الآمنة (SSL) أو بروتوكول أمان طبقة النقل (TLS) عدم تطابق SNI في اتصال المصدر الخلفي تأكَّد من ضبط شبكة توصيل المحتوى لإرسال المضيف المستهدَف securepubads.g.doubleclick.net في إضافة SNI لبروتوكول أمان طبقة النقل (TLS).
عدم توفّر المَعلمة ips في طلب عرض الإعلان مسار "إدارة إعلانات Google" لا يتطابق مع مسار شبكة توصيل المحتوى (CDN) تحقَّق من أنّ المسار الذي تم إدخاله في صفحة الإعدادات العامة في واجهة مستخدم "إدارة إعلانات Google" يتطابق مع المسار الذي تم ضبطه على شبكة توصيل المحتوى (CDN). لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة تمرير عنوان IP غير مقنَّع يقدّمه الناشر (إصدار تجريبي).