Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Как настроить собственный путь показа

Функция "Собственный путь показа" позволяет восстановить незамаскированный IP-адрес пользователя, направив запрос через вашу сеть доставки контента (CDN) или веб-инфраструктуру на серверы объявлений Google.

В сторонних запросах IP-адреса могут быть скрыты из-за настроек браузера, ОС или сети. Это может повлиять на доход от рекламы, геотаргетинг и выявление недействительного трафика.

Ваша CDN получает незамаскированный IP-адрес клиента во всех входящих запросах к вашему домену. Преимущества этой функции:

Не нужно изменять клиентский код. Вам не придется редактировать код JavaScript или передавать параметры вручную. Тег Google Publisher Tag (GPT) считывает настроенный путь из настроек Google Менеджера рекламы и асинхронно выполняет запрос на восстановление.
Меньше накладных расходов. Запрос не требует больших ресурсов, кешируется локально для каждого сеанса просмотра страницы и выполняется асинхронно с определениями рекламных мест.
Зашифрованная полезная нагрузка. По умолчанию эта функция возвращает IP-адрес пользователя в виде зашифрованной полезной нагрузки.

На этой странице рассказывается, как настроить собственный путь показа для выбранной вами сети доставки контента.

Требования

Прежде чем настраивать CDN, выполните следующие действия:

Укажите путь показа в аккаунте Менеджера рекламы, например /adserver/. Чтобы указать путь, выполните инструкции из раздела Способ 1. Собственный путь показа.
- Убедитесь, что путь показа уникален и не используется для отправки трафика.
Убедитесь, что у вас есть:
- Целевой хост или источник: securepubads.g.doubleclick.net
- Целевой путь: /pagead/fpm.
- Протокол: HTTPS с портом по умолчанию 443.
- Заголовки. Укажите заголовок Host: securepubads.g.doubleclick.net.
- Кеширование. Настройте CDN так, чтобы кеширование для маршрута не выполнялось. Например, задайте правила кеширования, чтобы не использовать кеш или заголовок Cache-Control: no-store.
Если вы используете Cloudflare в качестве CDN, для создания правила источника вам потребуется подписка Cloudflare Enterprise.

Настройте CDN

Настройте CDN или обратный прокси-сервер так, чтобы запросы, соответствующие заданному пути, перенаправлялись на серверы объявлений Google. Выберите нужную сеть доставки контента:

Cloudflare

Создайте правило на панели управления со следующими значениями:
- Custom filter expression (Пользовательское выражение фильтра): добавьте следующее:
  - Поле: URI Path
  - Оператор: starts with
  - Значение – ваш путь, например /adserver/.
- Host Header Override (Переопределение заголовка хоста). Выберите Rewrite to (Изменить на) и добавьте целевой хост securepubads.g.doubleclick.net.
- DNS Override (Переопределение DNS): выберите Override to (Переопределить на) и добавьте целевой хост securepubads.g.doubleclick.net.
Создайте правило перезаписи URL на панели управления со следующими значениями:
- Custom filter expression (Пользовательское выражение фильтра): добавьте следующее:
  - Поле: URI Path
  - Оператор: starts with
  - Значение – ваш путь, например /adserver/.
- Путь. Выберите Переписать в > Статический и добавьте целевой путь /pagead/fpm.
- Запрос. Выберите Сохранить.

Amazon CloudFront

Выполните действия, описанные в разделе Настройки источника, указав следующие значения:
- Домен источника: securepubads.g.doubleclick.net
- Протокол: HTTPS.
Следуйте инструкциям в разделе Создание функций и добавьте следующий пример:
```
function handler(event) {
    var request = event.request;
    request.uri = '/pagead/fpm';
    return request;
}
```
В этом примере берется событие входящего запроса, URI назначается целевому пути и возвращается запрос.

Нажмите Сохранить изменения, перейдите на вкладку Опубликовать и нажмите Опубликовать функцию.
Следуйте инструкциям в статье Как обновить дистрибутив в консоли, используя следующие значения:
- Схема пути. Укажите путь, например /adserver/*.
- Источник и группы источников – целевой хост. securepubads.g.doubleclick.net
- Правила кеширования: выберите CachingDisabled.
- Origin request policy (Правило запроса источника): выберите AllViewerExceptHostHeader.
- Связи функций:
  - Viewer request (Запрос зрителя). Выберите CloudFront Function (Функция CloudFront) и добавьте название функции.

Fastly.

Выполните инструкции из раздела Добавление хоста, указав следующие значения:
- Адрес – целевой хост, securepubads.g.doubleclick.net.
- Port (Порт) – порт по умолчанию, 443.
- Включить TLS? Да
  - Имя хоста сертификата: securepubads.g.doubleclick.net
    - Выберите Сопоставить имя хоста SNI с именем сертификата.
  - Имя хоста SNI: securepubads.g.doubleclick.net.
  - Переопределить хост: securepubads.g.doubleclick.net
Следуйте инструкциям в статье Создание фрагментов кода 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

Выполните инструкции из раздела Создание группы конечных точек сети и конечной точки в интернете, используя следующие значения:
- Тип группы конечных точек сети – выберите Группа конечных точек сети в интернете (глобальная).
- Порт по умолчанию: 443.
- Новая конечная точка сети: выберите Полное доменное имя (FQDN) и порт.
- FQDN: добавьте целевой хост securepubads.g.doubleclick.net.
Создайте глобальную бэкенд-службу и настройте пользовательские заголовки запросов со следующими значениями:
- Тип серверной ВМ – выберите Группа конечных точек сети в интернете.
- Протокол – выберите HTTPS.
  - Название заголовка: Host
  - Значение заголовка – добавьте целевой хост, securepubads.g.doubleclick.net.
Выполните инструкции из статьи Как настроить сопоставление URL.
В разделе Правила маршрутизации найдите правило для рабочего хоста, соответствующее вашему субдомену.

Обновите сопоставители путей с помощью конфигурации 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.

Устранение неполадок

В этом разделе описываются рабочие процессы по устранению неполадок, связанных с реализацией собственного пути показа в вашей сети доставки контента.

В таблице ниже приведены проблемы, их причины и способы устранения.

Проблема	Причина	Решение
Вы получаете от CDN код статуса HTTP 404 или 502	Перезапись пути неактивна или отсутствует заголовок `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`.	Путь в Менеджере рекламы не совпадает с путем в CDN	Убедитесь, что путь, указанный в интерфейсе Менеджера рекламы на странице Глобальные настройки, совпадает с путем, заданным в настройках CDN. Подробнее о том, как издателям передавать незамаскированные IP-адреса (бета)…