Thiết lập đường dẫn phân phối qua bên thứ nhất

Tính năng Đường dẫn phân phối qua bên thứ nhất cho phép bạn khôi phục địa chỉ IP không bị che giấu của người dùng bằng cách định tuyến yêu cầu thông qua Mạng phân phối nội dung (CDN) hoặc cơ sở hạ tầng web đến máy chủ quảng cáo do Google phân phát.

Đối với các yêu cầu của bên thứ ba, các tính năng của trình duyệt và hệ điều hành cũng như cấu hình mạng có thể che giấu địa chỉ IP. Việc che giấu này có thể ảnh hưởng đến doanh thu từ quảng cáo, tính năng nhắm mục tiêu theo vị trí địa lý và khả năng phát hiện lưu lượng truy cập không hợp lệ (IVT).

CDN của bạn nhận được IP ứng dụng khách chưa được che giấu của người dùng trên tất cả các yêu cầu gửi đến miền của bạn. Tính năng này mang lại những lợi ích sau:

  • Không thay đổi mã phía máy khách: Bạn không chỉnh sửa JavaScript hoặc truyền tham số theo cách thủ công. Thẻ nhà xuất bản của Google (GPT) đọc đường dẫn đã định cấu hình trong phần cài đặt Google Ad Manager và chạy yêu cầu khôi phục không đồng bộ.
  • Giảm mức hao tổn: Yêu cầu này gọn nhẹ, được lưu vào bộ nhớ đệm cục bộ cho mỗi phiên xem trang và chạy không đồng bộ cùng với các định nghĩa về vị trí quảng cáo.
  • Trọng tải đã mã hoá: Theo mặc định, tính năng này sẽ trả về địa chỉ IP của người dùng dưới dạng trọng tải đã mã hoá.

Trang này trình bày cách định cấu hình đường dẫn phân phối qua bên thứ nhất cho CDN mà bạn muốn.

Điều kiện tiên quyết

Trước khi định cấu hình CDN, hãy làm như sau:

  • Chỉ định đường dẫn phân phát trong tài khoản người quản lý Ad Manager, ví dụ: /adserver/. Để chỉ định đường dẫn, hãy làm theo các bước trong Phương thức 1: Đường dẫn phân phối qua bên thứ nhất.
    • Đảm bảo rằng đường dẫn phân phát của bạn là duy nhất và không có lưu lượng truy cập nào bạn gửi sử dụng đường dẫn này.
  • Có hoặc đặt các mục sau:
    • Máy chủ hoặc nguồn gốc mục tiêu: securepubads.g.doubleclick.net
    • Đường dẫn mục tiêu: /pagead/fpm
    • Giao thức: HTTPS với cổng mặc định 443.
    • Tiêu đề: Đặt tiêu đề là Host: securepubads.g.doubleclick.net.
    • Lưu vào bộ nhớ đệm: Định cấu hình CDN để bỏ qua việc lưu vào bộ nhớ đệm cho một tuyến, ví dụ: đặt chính sách bộ nhớ đệm để bỏ qua bộ nhớ đệm hoặc tiêu đề Cache-Control: no-store.
  • Nếu CDN của bạn là Cloudflare, thì bạn phải có cấp Cloudflare Enterprise để tạo quy tắc gốc.

Định cấu hình CDN

Định cấu hình CDN hoặc proxy đảo ngược để chuyển tiếp các yêu cầu khớp với đường dẫn đã định cấu hình đến máy chủ quảng cáo của Google. Chọn CDN bạn muốn:

Cloudflare

  1. Tạo một quy tắc trong trang tổng quan có các giá trị sau:

    • Biểu thức bộ lọc tuỳ chỉnh: Thêm nội dung sau:
      • Trường: URI Path
      • Nhà mạng: starts with
      • Giá trị: đường dẫn của bạn, ví dụ: /adserver/.
    • Host Header Override (Ghi đè tiêu đề máy chủ lưu trữ): Chọn Rewrite to (Ghi lại thành) rồi thêm máy chủ lưu trữ mục tiêu securepubads.g.doubleclick.net.
    • Ghi đè DNS: Chọn Ghi đè thành rồi thêm máy chủ lưu trữ mục tiêu securepubads.g.doubleclick.net.

  2. Tạo quy tắc viết lại URL trong trang tổng quan với các giá trị sau:

    • Biểu thức bộ lọc tuỳ chỉnh: Thêm nội dung sau:
      • Trường: URI Path
      • Nhà mạng: starts with
      • Giá trị: đường dẫn của bạn, ví dụ: /adserver/.
    • Đường dẫn: Chọn Viết lại thành > Tĩnh > rồi thêm đường dẫn đích /pagead/fpm.
    • Truy vấn: Chọn Giữ nguyên.

Amazon CloudFront

  1. Làm theo các bước trong phần Cài đặt nguồn gốc với các giá trị sau:

    • Miền gốc: securepubads.g.doubleclick.net
    • Giao thức: HTTPS

  2. Làm theo hướng dẫn trong phần Tạo hàm và thêm ví dụ sau:

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

    Ví dụ này lấy sự kiện yêu cầu đến, chỉ định URI cho đường dẫn mục tiêu và trả về yêu cầu.

    Nhấp vào Save changes (Lưu thay đổi), chuyển đến thẻ Publish (Xuất bản) rồi nhấp vào Publish function (Xuất bản hàm).

  3. Làm theo hướng dẫn trong phần Cập nhật bản phân phối trong bảng điều khiển bằng các giá trị sau:

    • Mẫu đường dẫn: đường dẫn của bạn, ví dụ: /adserver/*.
    • Nguồn gốc và Nhóm nguồn gốc: máy chủ lưu trữ mục tiêu, securepubads.g.doubleclick.net.
    • Cache policy (Chính sách bộ nhớ đệm): Chọn CachingDisabled.
    • Origin request policy (Chính sách yêu cầu về nguồn gốc): Chọn AllViewerExceptHostHeader.
    • Mối liên kết hàm:
      • Viewer request (Yêu cầu của người xem): Chọn CloudFront Function (Hàm CloudFront) rồi thêm tên hàm của bạn.

Fastly

  1. Làm theo các bước trong phần Thêm máy chủ lưu trữ bằng các giá trị sau:

    • Address (Địa chỉ): máy chủ lưu trữ mục tiêu, securepubads.g.doubleclick.net
    • Cổng: cổng mặc định, 443.
    • Bật TLS?: Có
      • Tên máy chủ của chứng chỉ: securepubads.g.doubleclick.net
        • Chọn Khớp tên máy chủ SNI với Tên chứng chỉ.
      • Tên máy chủ SNI: securepubads.g.doubleclick.net
      • Máy chủ ghi đè: securepubads.g.doubleclick.net

  2. Làm theo hướng dẫn Tạo đoạn mã VCL bằng ví dụ sau:

    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);
}

    Thay thế nội dung sau:

    • NAME: tên của máy chủ lưu trữ, ví dụ: Google_GAM_FPM_Backend.
    • PATH: đường dẫn của bạn, ví dụ: /adserver/.

Google Cloud

  1. Làm theo hướng dẫn trong phần Tạo NEG và điểm cuối Internet bằng các giá trị sau:

    • Network endpoint group type (Loại nhóm điểm cuối mạng): Chọn Internet NEG (Global) (Nhóm điểm cuối mạng Internet (Toàn cầu))
    • Cổng mặc định: 443
    • Điểm cuối mạng mới: Chọn Tên miền đủ điều kiện (FQDN) và cổng.
    • FQDN: thêm máy chủ lưu trữ mục tiêu, securepubads.g.doubleclick.net.

  2. Tạo dịch vụ phụ trợ chung và định cấu hình tiêu đề của yêu cầu tuỳ chỉnh bằng các giá trị sau:

    • Backend type (Loại dịch vụ phụ trợ): Chọn Internet network endpoint group (Nhóm điểm cuối mạng Internet).
    • Giao thức: Chọn HTTPS.
      • Tên tiêu đề: Host
      • Giá trị tiêu đề: thêm máy chủ lưu trữ mục tiêu, securepubads.g.doubleclick.net.

  3. Làm theo các bước trong phần Định cấu hình bản đồ URL.

  4. Trong phần Quy tắc định tuyến, hãy tìm quy tắc máy chủ lưu trữ chính thức khớp với miền con của bạn.

    Cập nhật trình so khớp đường dẫn bằng cấu hình 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

    Thay thế nội dung sau:

    • BACKEND_NAME: tên của dịch vụ phụ trợ mà bạn đã tạo ở bước 2, ví dụ: gam-fpm-backend-service.
    • DEFAULT_BACKEND: dịch vụ phụ trợ mặc định lưu trữ trang web của bạn.
      • Nếu bạn lưu trữ trang web trên Cloud Storage, hãy thay thế backendServices bằng tham số backendBuckets trong đường dẫn tài nguyên của trường defaultService.
    • NAME: tên của trình so khớp đường dẫn, ví dụ: gam-fpm-matcher.
    • PATH: đường dẫn của bạn, ví dụ: /adserver/.
    • PROJECT_ID: mã dự án của bạn.

Kiểm tra kết quả triển khai

Để xác minh rằng CDN của bạn uỷ quyền cho yêu cầu và chuyển địa chỉ IP, hãy chạy một kiểm thử bằng lệnh curl:

curl -i https://example.comPATH

Thay thế PATH bằng đường dẫn của bạn, ví dụ: /adserver/.

Nếu thành công, bạn sẽ nhận được kết quả sau:

  • Trạng thái HTTP: 200 OK
  • Nội dung phản hồi: Tải trọng từ máy chủ phụ trợ của Google, theo mặc định chứa mã thông báo IP đã mã hoá.

Khắc phục sự cố khi triển khai

Phần này trình bày các quy trình khắc phục sự cố khi triển khai đường dẫn phân phối qua bên thứ nhất trong CDN.

Bảng sau đây trình bày chi tiết các vấn đề, nguyên nhân và giải pháp để khắc phục sự cố:

Vấn đề Nguyên nhân Giải pháp
Bạn nhận được mã trạng thái HTTP 404 hoặc 502 từ CDN Tính năng ghi lại đường dẫn không hoạt động hoặc thiếu tiêu đề Host. Xác minh rằng quy tắc ghi lại của bạn liên kết với đường dẫn đích /pagead/fpm và tiêu đề Host được ghi đè thành máy chủ lưu trữ đích, securepubads.g.doubleclick.net.
Địa chỉ IP không được cập nhật trong yêu cầu quảng cáo. Đã bật tính năng lưu vào bộ nhớ đệm trên proxy CDN Hãy nhớ đặt chính sách bộ nhớ đệm trên tuyến đường thành chính sách CachingDisabled hoặc tiêu đề Cache-Control: no-store. Mọi ứng dụng đều phải kết nối với dịch vụ phụ trợ để đánh giá địa chỉ IP cụ thể của ứng dụng đó.
Không bắt tay được SSL hoặc TLS SNI không khớp trên kết nối gốc của phần phụ trợ Đảm bảo rằng bạn đã định cấu hình CDN để gửi máy chủ lưu trữ mục tiêu securepubads.g.doubleclick.net trong tiện ích SNI TLS.
Thiếu tham số ips trong yêu cầu quảng cáo. Đường dẫn Ad Manager không khớp với đường dẫn CDN Xác minh rằng đường dẫn đã nhập trong trang Cài đặt chung của giao diện người dùng Ad Manager khớp với đường dẫn được định cấu hình trên CDN của bạn. Để biết thông tin chi tiết, hãy xem bài viết Truyền địa chỉ IP không bị che giấu do nhà xuất bản cung cấp (Thử nghiệm).