Получайте уведомления о показах

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

Настройте конечную точку уведомлений о показах.

Для получения уведомлений о показах необходимо создать HTTP-конечную точку и предоставить Google её URL-адрес. URL-адрес, на который отправляются уведомления о показах, можно задать одним из следующих способов:

  1. Укажите URL-адрес конечной точки уведомлений о показах для каждого вызова функции обработки данных в режиме реального времени.
    • Вы можете динамически задавать URL-адрес, используемый для уведомлений о показах для каждого вызова Real-time Curation, который вы получаете, заполнив поле SegmentResponse.burl .
    • Для каждого вызова функции курирования в реальном времени необходимо установить поле SegmentResponse.burl , чтобы получать уведомления о показах для этого вызова. Если поле SegmentResponse.burl не заполнено, уведомление для этого вызова отправлено не будет, даже если поле SegmentResponse.burl было установлено в предыдущих вызовах.
  2. Укажите URL-адрес конечной точки для уведомлений о показах на уровне учетной записи.
    • Вы можете установить URL-адрес конечной точки уведомлений о показах на уровне учетной записи, связавшись со своим менеджером по работе с клиентами. Это идеально подходит, если ваш URL-адрес конечной точки меняется нечасто.
    • Все уведомления о показах в режиме реального времени будут использовать URL-адрес уведомлений о показах на уровне учетной записи, который вы настроили для своей учетной записи, если только вы не переопределите URL-адрес на уровне учетной записи, установив поле SegmentResponse.burl для отдельного уведомления о показах в режиме реального времени.

Анализ уведомления о показе

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

Разберитесь, как разворачиваются макросы.

Если вы настроите URL-адрес конечной точки таким образом, чтобы он содержал один или несколько параметров запроса, заданных в виде макросов, уведомления о показах, отправляемые на вашу конечную точку, будут разворачивать эти макросы, заменяя их соответствующими значениями.

Например, вы можете настроить URL-адрес конечной точки уведомлений о показах следующим образом:

https://testendpoint.com/impressions?segmentReqId=${SR_ID}&segmentIds=${SEGMENT_IDS}

При получении уведомления о показе макросы будут заменены, в результате чего URL-адрес будет выглядеть следующим образом:

https://testendpoint.com/impressions?segmentReqId=8Mbl39sMOX5yg1NZgS35ET&segmentIds=test-ds-1|test-ds-2

Узнайте о поддерживаемых макросах

Ниже приведены макросы, которые можно включить в параметры запроса URL-адреса конечной точки уведомлений о показах. Эти макросы заменяются значениями, связанными с выигрышной ставкой, в формировании которой участвовал один или несколько ваших сегментов данных.

Макро Описание
${SR_ID} Уникальный строковый идентификатор, эквивалентный полю SegmentRequest.segment_request_id для соответствующего вызова функции обработки данных в реальном времени. Он относится к запросу сегмента, на который вы ответили одним или несколькими идентификаторами сегментов данных, которые повлияли на выигрышную ставку.
${SEGMENT_IDS} Список строковых идентификаторов сегментов данных, которые повлияли на выигрышную ставку. Каждый элемент списка разделяется символом "|". Например, это можно развернуть в список значений, таких как: "segmentId1|segmentId2|segmentId3" Каждый идентификатор сегмента данных в списке ссылается на идентификатор ресурса curators.dataSegments в API Marketplace.
${AUCTION_PRICE} Строка, представляющая собой цену, выигравшую аукцион. Цена — это стоимость одного показа (CPI), выраженная в микродолларах США. Например, ставка в режиме реального времени в размере 5 долларов США за показ приведет к тому, что макрос ${AUCTION_PRICE} развернется до 5000 микродолларов США в уведомлении о показах в режиме реального времени.
${DEAL_ID} Идентификатор сделки или пакета, выигравшего аукцион. Это сделка или пакет, ориентированный на один или несколько идентификаторов ваших сегментов данных, которые можно определить с помощью макроса ${SEGMENT_IDS} .
${BUYER_SEAT_ID} Идентификатор места покупателя, получившего показ, указанный участником торгов в выигрышной заявке. Например, местами покупателей могут быть агентства или рекламодатели.

Следующие шаги