Структура тегів в AdSense для відео й AdSense для ігор суттєво відрізняється від тієї, що використовується в AdSense для вмісту. Вона базується на тегу інтерактивної медіареклами (IMA) – оголошення показуються лише тоді, коли запит на них зроблено з відеопрогравача або панелі запуску ігор, які підтримують інтеграцію пакета Google IMA SDK і/або відповідають стандартам VAST та VPAID (наприклад, Адаптер IMA).
Для створення таких тегів можна використовувати генератор тегів AdSense для відео. Нижче подано повний список критеріїв, які можна налаштувати для цих тегів оголошення. Тег AdSense для відео має лише кілька обов’язкових параметрів для показу оголошень. Однак ви можете підбирати більш відповідні оголошення для показу за допомогою додаткових параметрів, як-от ідентифікаторів каналу, мінімальної або максимальної тривалості оголошення, мови тощо.
| Параметр тегу оголошення IMA | Обов’язковий параметр |
|---|---|
| ad_type | Так |
| client | Так |
| description_url | Так (потрібно закодувати в URL-адресі) |
| channel | Ні (рекомендується за наявності) |
| adsafe | Ні (рекомендується) |
| videoad_start_delay | Ні (рекомендується) |
| hl | Ні (рекомендується) |
| max_ad_duration | Ні (рекомендується) |
| min_ad_duration | Ні (рекомендується) |
| sdmax | Ні (рекомендується) |
| adtest | Ні |
| cust_age | Ні |
| cust_gender | Ні |
| host | Ні |
| h_ch | Ні |
| overlay | Ні |
Базова URL-адреса
Для всіх описаних нижче параметрів запиту як основу використано цю URL-адресу:
https://googleads.g.doubleclick.net/pagead/ads?
ad_type
(Сегмент) Визначає потрібний тип оголошення. Елементи мають з’єднуватися символом підкреслення ("_").
Значення
- video – усі відеооголошення (еквівалент standardvideo_skippablevideo_bumpervideo).
- skippablevideo – лише відеооголошення, які можна пропустити. Щоб отримувати такі оголошення, можуть знадобитися додаткові дозволи видавця.
- bumpervideo – дозволяються відеооголошення тривалістю 6 секунд, які не можна пропустити.
- standardvideo – лише відеооголошення, які не можна пропустити.
- image – дозволяються графічні оголошення, які відповідають визначеному розміру нелінійного рекламного місця.
- text – дозволяються текстові оголошення.
Приклади
- &ad_type=video_text_image
- Дозволяються всі формати.
- &ad_type=video_text
- Дозволяються будь-які формати відео й текстових оголошень.
- &ad_type=standardvideo_image
- Дозволяються лише стандартні відео- та графічні оголошення, які не можна пропустити.
client
(Сегмент) Ідентифікатор веб-ресурсу видавця.
Приклад: &client=ca-video-afvtest
description_url
(Сегмент) Повна URL-адреса HTML-сторінки з описом відео, закодована у форматі URL-адреси. Значення description_url можна створити динамічно за допомогою серверної мови програмування або вручну, скориставшись інструментом кодування URL-адреси онлайн.
Приклад: &description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2
Приклад URL-адреси
Ось приклад URL-адреси з мінімальним набором обов’язкових параметрів: https://googleads.g.doubleclick.net/pagead/ads?client=ca-video- afvtest&ad_type=video&description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalu e%26key2%3Dvalue2
Надсилає запит на відеорекламу для видавця ca-video-afvtest разом із URL-адресою сторінки з описом http:// myurl.com/page?key=value&key2=value2
channel
(Сегмент) Список каналів, розділених знаком плюса, що використовуються в AdSense для націлювання та звітів. У запиті оголошення може передаватися щонайбільше п’ять каналів.
Приклад: &channel=mychannel+otherchannel+targetingchannel
adsafe
(Сегмент) Визначає налаштування, призначене фільтрувати показувані оголошення. Значення за умовчанням: "high".
Значення:
- high (за умовчанням) – показує оголошення, прийнятні для сімейного перегляду. Виключає показ вмісту сексуального характеру або неприйнятного для сімейного перегляду;
- medium – показує оголошення, прийнятні або неприйнятні для сімейного перегляду (наприклад, рекламу азартних ігор чи препаратів, що відпускаються за рецептом). Виключає показ оголошень із вмістом сексуального характеру для дорослих.
Приклад: &adsafe=high
adtest
(Сегмент) Визначає, чи розміщено оголошення в тестовому форматі. Можливі значення: "on" або "off". Якщо встановлено значення "on", покази та кліки не записуватимуться в обліковому записі AdSense для відео. Цей параметр є ОБОВ’ЯЗКОВИМ під час тестування. Якщо його не визначити, за умовчанням установлюється значення "off".
Значення:
- off (за умовчанням) – плата за всі оголошення нараховується у звичайному режимі; це налаштування для звичайного (не тестового) показу оголошень;
- on – завдяки цьому налаштуванню під час тестування покази або кліки оголошень не реєструються.
Приклад: &adtest=on
videoad_start_delay
(Ціле число) Час у мілісекундах, починаючи з якого оголошення починає відтворюватись у відео. За умовчанням установлюється значення "1" (оголошення відображається в середині відео).
Значення:
- –1 – позначає оголошення після відео, яке відображатиметься наприкінці вмісту;
- 0 – позначає оголошення на початку відео, яке буде показуватися до відтворення основного вмісту;
- будь-яке додатне ціле число – позначає оголошення в середині відео, яке почне відтворюватися за певну кількість мілісекунд від початку відтворення основного вмісту.
Приклад:
- &videoad_start_delay=-1 – оголошення після відео;
- &videoad_start_delay=15000 – оголошення почне відтворюватися з 15-ї секунди відео.
cust_age
(Ціле число) Визначає вік користувача. Підтримується ціле значення виповнених років, а також вікова група, визначена в com.google.ads.ima.api.Demographics.
Приклад:
- &cust_age=1001 – від 18 до 24 років;
- &cust_age=38 – рівно 38 років.
cust_gender
(Ціле число) Визначає стать користувача за визначенням у com.google.ads.ima.api.Demographics.
Значення:
- 1 – чоловік;
- 2 – жінка.
Приклад:
- &cust_gender=1 – чоловік;
- &cust_gender=2 – жінка.
host
(Сегмент) Ідентифікатор хосту, призначений для тристороннього розподілу доходу.
Приклад: &host=ca-host-test – виділяє частку доходу для цього хосту.
h_ch
(Сегмент) Список сегментів, розділених знаком плюса, що відповідають ідентифікаторам каналів для націлювання та звітів в AdSense для певного хосту.
Приклад: &h_ch=channel1+channel2+channel3 – націлює на ці додаткові канали для хосту та створює звіти для них.
ht_id
(Число) Ідентифікатор рівня, що використовується для визначення рівня розподілу доходу між видавцем і хостом.
Приклад: &ht_id=2 – хост 2-го рівня.
hl
(Сегмент) Код мови, що використовується для запитів оголошень цією мовою. Це може бути будь-який код ISO 639-1 (із двох літер) або ISO 639-2 (з трьох літер). Список допустимих кодів.
Приклад:
- &hl=en – англійська;
- &hl=es – іспанська.
max_ad_duration
(Ціле число) Визначає максимальну тривалість запитаного відеооголошення в мілісекундах. Якщо цей параметр не задано, за умовчанням установлюється значення 100 секунд.
Приклад: &max_ad_duration=30000 – максимальна тривалість оголошення, яке не можна пропустити, становитиме 30 секунд.
min_ad_duration
(Ціле число.) Визначає мінімальну тривалість відео, яке має повернутися (у мілісекундах). Якщо цей параметр не задано, за умовчанням установлюється значення 0 секунд.
Приклад:
- &min_ad_duration=15000 – тривалість запитаного оголошення, яке не можна пропустити, має становити принаймні 15 секунд;
- &min_ad_duration=0 – тривалість запитаного оголошення буде обмежено лише значенням параметра max_ad_duration.
sdmax
(Ціле число) Визначає максимальну тривалість відео для оголошень, які можна пропустити (у мілісекундах). Якщо цей параметр не задано, за умовчанням встановиться необмежене значення.
Приклад: &sdmax=120000 – тривалість запитаного оголошення, яке можна пропустити, має бути меншою 2 хвилин.
overlay
(Ціле число) Обмежує розмір запитаного оголошення, що накладається на відео, і дозволяє використовувати лише нелінійні оголошення в нижній третині вікна показу. За умовчанням обмеження не встановлюється.
Приклад:
- &overlay=1 – на запит показуються лише оголошення, що накладаються на нижню третину вікна показу відео (запити на повноформатні оголошення в накладанні не надсилаються);
- &overlay=0 – значення за умовчанням, яке не обмежує розміри оголошень, що накладаються на відео. Розміри таких оголошень визначатимуться на основі параметрів AdsRequest.nonLinearAdSlotWidth і adsRequest.nonLinearAdSlotHeight.
