Додавання макросів до 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 |