Добавление макросов к URL посадочной
страницы или пикселя отслеживания событий в настройках креатива
позволяет передавать необходимые данные (например, страну или адрес
страницы запроса) при помощи макросов.
Список доступных макросов вы можете найти в таблице ниже.
Как использовать
- Если рекламодатель запрашивает такую передачу данных, URL посадочной страницы или пикселя отслеживания события подставьте в плейсхолдеры рекламодателя соответствующие макросы из списка доступных
- Вставьте измененный URL в поле Посадочная страница или в Отслеживание событий на странице создания видео-креатив
User Data
Macros |
Description |
[IP] |
User IP address |
[DNT] |
Do not track |
[YOB] |
Year of birth |
[GENDER] |
User gender |
[GDPR] |
Indicates whether or not the GDPR (General Data Protection Regulation) applies to the ad request |
[CONSENT] |
A consent string passed from various Consent Management Platforms (CMPs) |
[PUBUID] |
Unique user ID for reuse in the 1st-party DMP
|
[VISITORKEY] or [AM-UID] |
Unique user ID or Cookie ID
|
[WS64VISTORKEY] |
Unique user ID or Cookie ID encoded in Base64
|
Geo Data
Macros |
Description |
[GEOLOCATION] |
Geolocation of the user (country) |
[LATITUDE] |
Device latitude. Along with longitude, it defines device location |
[LONGITUDE] |
Device longitude. Along with latitude, it defines device location |
[LOCATION] |
Location (latitude, longitude) of the device |
[ACCURACY] |
Estimated latitude/longitude accuracy in meters |
[COUNTRY] |
User country |
Site Data
Macros |
Description |
[PAGE] |
URL-encoded page |
[FULL_PAGE_ESC] |
Full URL, protocol incl., encoded |
[USERAGENT] |
URL-encoded User-Agent |
[IAB_CATEGORY] |
Comma-separated array of IAB content categories for the application |
[PROTOCOL] |
http or https protocol |
[DOMAIN] |
2nd-level domain + TLD |
[REFERER] |
URL of the page where the impression occurs |
Application Data
Macros |
Description |
[APP_NAME], [APP_ID] |
Application name |
[BUNDLE] |
Application ID |
[APP_VER] |
Application version |
[APP_STORE_ID] |
Platform-specific app store ID |
[STOREURL] |
App store URL |
Device Data
Macros |
Description |
[DEVICE_W] |
Width of the screen in pixels |
[DEVICE_H] |
Height of the screen in pixels |
[IFA] |
Unique value that is completely disconnected from a hardware ID, MAC address, IMEI, or IP address |
[DEVICEID] |
32 hexadecimal digit string value,
displayed in five groups and separated by hyphens, in the form of
8-4-4-4-12, for a total of 36 characters |
[DEVICE_MAKE] |
Device manufacturer |
[DEVICE_MODEL] |
Device model |
[DEVICE_OS] |
Device OS |
[DEVICE_OSV] |
Device OS version |
[ISP] |
Internet provider (the same as Carrier by openRTB) |
[CONNECTION] |
Type of user connection: 1 – Ethernet, 2 – WIFI, 3 – Unknown cellular, 4 – 2G, 5 – 3G, 6 – 4G |
Video Ad Data
Macros |
Description |
[VAST_PROTOCOLS] |
Supported VAST protocols according to IAB protocols |
[PLAYER_WIDTH] |
Width of the video player in DIPS |
[PLAYER_HEIGHT] |
Height of the video player in DIPS |
[MUTED] |
Integer |
[VIDEO_AUTOPLAY] |
Integer |
[MINDURATION] |
Allowed minimum duration in seconds |
[MAX_DURATION] |
Allowed maximum duration in seconds |
[SKIP] |
Shows if the video is skippable by the user: 0 – false (default if not passed), 1 – true |
[SKIP_MIN] |
Videos of total duration greater than this number of seconds can be skippable. Only applicable if the ad is skippable |
[SKIP_AFTER] |
Defines the custom time in seconds after the ad can be skipped |
[BREAKPOSITION] |
Indicates the position of the ad
break within the underlying video/audio content that the ad is playing
within. Values: 1 for pre-roll, 2 for mid-roll, 3 for post-roll, 4 for
standalone, 0 for none of the above/other |
[CONTENTID] |
Publisher-specific content
identifier for the content asset into which the ad is being loaded or
inserted. Only applicable to in-stream ads |
Auction Data
Macros |
Description |
[AUCTION_ID], [AM-RID] |
Unique request identifier. Automatically generated by the system as a UUID |
[PUBLISHER_ID] |
Publisher ID |
[SITE_ID] |
Site UUID |
[UNIVERSAL_SITE_ID] |
Site ID |
[ZONE_ID] |
Zone UUID |
[ADVERTISER] |
Advertiser UUID |
[CAMPAIGN_ID] |
Campaign ID |
[PROFILE_ID] |
Profile UUID |
[CREATIVE_ID] |
Creative UUID |
[CACHEBUSTING], [TIMESTAMP], [RND]
|
Timestamp in milliseconds |
Entity Data
Чтобы передавать данные сущностей (например, профайла, сайта или рекламного места), используйте макрос ID сущностей.
Macros |
Description |
[PUBLISHER_INT_ID] |
Publisher ID |
[SITE_INT_ID] |
Site ID |
[ZONE_INT_ID] |
Ad Unit ID |
[ADVERTISER_INT_ID] |
Trading Desk ID |
[CAMPAIGN_INT_ID] |
Campaign ID |
[PROFILE_INT_ID] |
Profile ID |
[CREATIVE_INT_ID] |
Ad Item ID |
[PROFILE_NAME] |
Profile name |
[CAMPAIGN_NAME] |
Campaign name |
[CREATIVE_NAME] |
Creative name |
Обновлено 13 августа, 2024