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

Как запрашивать показатели видимости и недействительного трафика

Обзор

В этой статье рассказывается, как с помощью API составлять запросы для действительного трафика (видимости) и недействительного трафика. Эти показатели доступны только для инвентаря, закупленного через Google Рекламу и Дисплей и Видео 360.

Для сбора аккредитованных MRC показателей просмотров TrueView требуется ADH API, поскольку шаблона такого запроса не существует. Учитывайте, что показатели просмотров TrueView – не то же самое, что показатели видимости.

Выберите сервис покупки рекламы, для которого вы хотите составить запрос показателей видимости.

Как составить запрос показателей видимости в интерфейсе

Этот шаблон запроса видимости позволяет получить показатели, аккредитованные MRC.

Аккредитация MRC имеет только два варианта: ваши результаты могут быть аккредитованы MRC или нет. Она применяется ко всей таблице результатов. Чтобы получить аккредитацию MRC, необходимо выполнить запрос в шаблоне, не изменяя его и используя режим проверки различий. Аккредитация MRC для Ads Data Hub не распространяется на запросы, выполняемые в режиме шума.

Чтобы выполнить аккредитованный MRC запрос в шаблоне, сделайте следующее:

Создайте запрос, выбрав в качестве сервиса покупки рекламы Google Ads, а в качестве шаблона запроса – Видимость видеообъявлений по типу устройства.
Рядом с Использовать шаблон нажмите кнопку Выполнить.

Как запросить показатели недействительного трафика и видимости через API

Показатели недействительного трафика и видимости можно получать с помощью ADH API, используя конечные точки generateIvtReport и startAnalysis. Показатели недействительного трафика необходимо извлекать с помощью generateIvtReport , чтобы показатели получили аккредитацию MRC и был применен ярлык adh-mrc-accredited. Приведенный ниже глобальный запрос также должен использоваться для показателей видимости через ADH API, чтобы получить аккредитацию MRC. В этом разделе рассказывается, как отправить запрос в эту конечную точку, используя клиентскую библиотеку Python.

Инструкции по настройке и авторизации/аутентификации вы найдете в кратком руководстве по API.

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

Секретный код клиента.
Идентификатор клиента.
Ключ API.
Campaign IDs
Часовой пояс.

Образец кода

Недействительный трафик

import json
import os.path
from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# If modifying these scopes, delete the file `token.json`.
SCOPES = ['https://www.googleapis.com/auth/adsdatahub']
TOKEN_FILE = 'token.json'

creds = None

# The file token.json stores the user's access and refresh tokens, and is
# created automatically when the authorization flow completes for the first
# time.
if os.path.exists(TOKEN_FILE):
    creds = Credentials.from_authorized_user_file(TOKEN_FILE, SCOPES)
# If there are no (valid) credentials available, let the user log in.
if not creds or not creds.valid:
    if creds and creds.expired and creds.refresh_token:
        creds.refresh(Request())
    else:
        flow = InstalledAppFlow.from_client_secrets_file(
            'YOUR_CLIENT_SECRETS.json', SCOPES)
        creds = flow.run_local_server(port=0)
    # Save the credentials for the next run.
    with open(TOKEN_FILE, 'w') as token:
        token.write(creds.to_json())

service = build('adsdatahub', 'v1', credentials=creds,
                developerKey='YOUR_API_KEY', static_discovery=False)

body = {
    'ads_data_customer_id': YOUR_CUSTOMER_ID,
    'start_date': {
        'year': 2019,
        'month': 12,
        'day': 15
    },
    'end_date': {
        'year': 2019,
        'month': 12,
        'day': 20
    },
    'time_zone': 'YOUR_TIMEZONE',
    # Optional. Defaults to 'DAY' (one set of rows per day). Use
    # 'ENTIRE_DATE_RANGE' for a single set of rows covering the whole range.
    'date_dimension_granularity': 'DAY',
    'google_ads_dimensions': {
        'campaign_ids': [YOUR_CAMPAIGN_IDS],
        'metric_type': 'METRIC_TYPE_IMPRESSION'
    },
    'dest_table': 'YOUR_DESTINATION_TABLE'
}

resp = service.customers().generateIvtReport(
    name='customers/YOUR_CUSTOMER_ID', body=body).execute()
print(json.dumps(resp))

Показатели видимости

import json
import os.path
from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# If modifying these scopes, delete the file `token.json`.
SCOPES = ['https://www.googleapis.com/auth/adsdatahub']
TOKEN_FILE = 'token.json'

creds = None

# The file token.json stores the user's access and refresh tokens, and is
# created automatically when the authorization flow completes for the first
# time.
if os.path.exists(TOKEN_FILE):
    creds = Credentials.from_authorized_user_file(TOKEN_FILE, SCOPES)
# If there are no (valid) credentials available, let the user log in.
if not creds or not creds.valid:
    if creds and creds.expired and creds.refresh_token:
        creds.refresh(Request())
    else:
        flow = InstalledAppFlow.from_client_secrets_file(
            'YOUR_CLIENT_SECRETS.json', SCOPES)
        creds = flow.run_local_server(port=0)
    # Save the credentials for the next run.
    with open(TOKEN_FILE, 'w') as token:
        token.write(creds.to_json())

service = build('adsdatahub', 'v1', credentials=creds,
                developerKey='YOUR_API_KEY', static_discovery=False)

name = 'customers/global/analysisQueries/f41320e7296d49158e572aba662f35b1'
body = {
  'spec': {
    'ads_data_customer_id': YOUR_CUSTOMER_ID,
    'start_date': {
      'year': 2019,
      'month': 12,
      'day': 15
    },
    'end_date': {
      'year': 2019,
      'month': 12,
      'day': 20
    },
    'time_zone': 'YOUR_TIMEZONE',
    'parameter_values': {
      'campaign_ids': {
        'array_value': {
          'values': [
            {
              'value': 'YOUR_CAMPAIGN_ID'
            },
          ]
        }
      }
    }
  },
  'dest_table': 'YOUR_DESTINATION_TABLE',
  'customer_id': YOUR_CUSTOMER_ID
}

resp = service.customers().analysisQueries().start(name=name,body=body).execute()
print(json.dumps(resp))

Как рассчитываются показатели видимости за вычетом общего недействительного трафика

Ниже представлены формулы, по которым рассчитываются показатели видимости за вычетом общего недействительного трафика, аккредитованные MRC.

Общее число показов (за вычетом общего недействительного трафика) = Общее число показов – Общий недействительный трафик
Показы в видимой области экрана (за вычетом общего недействительного трафика) = Показы в видимой области экрана – Общий недействительный трафик (показы в видимой области экрана)
Отслеживаемые показы (за вычетом общего недействительного трафика) = Отслеживаемые показы + Недействительные отслеживаемые показы – Отслеживаемые показы (общий недействительный трафик)
Доступные показы (за вычетом общего недействительного трафика) = Доступные показы + Недействительные доступные показы – Доступные показы (общий недействительный трафик)
Показы вне видимой области экрана (за вычетом общего недействительного трафика) = Отслеживаемые показы (за вычетом общего недействительного трафика) – Показы в видимой области экрана (за вычетом общего недействительного трафика)
Неотслеживаемые показы (за вычетом общего недействительного трафика) = Доступные показы (за вычетом общего недействительного трафика) – Отслеживаемые показы (за вычетом общего недействительного трафика)
Процент отслеживаемых показов (за вычетом общего недействительного трафика) = Отслеживаемые показы (за вычетом общего недействительного трафика) / Доступные показы (за вычетом общего недействительного трафика)
Процент показов в видимой области экрана (за вычетом общего недействительного трафика) = Показы в видимой области экрана (за вычетом общего недействительного трафика) / Отслеживаемые показы (за вычетом общего недействительного трафика)