Media Postback Macro
Postback macro
Postback macro is use for sending dynamic data which collect by Adbrix.
You can create Postback URL using postback macro list on this page. Adbrix postback worker will confirm the postback URL when postback data send to your postback server.
Certain postback macro cannot be used on postback type (Attribution / Event) and Attribution and event type(first_install, last_install, last_deeplink). So please check the postback type and postback macro for configuring the postback URL.
Attribution Postback Macro
Attribution postback is postback data which send to media's postback server when user execute "App Open Event".
*App Open Event
- first_install : New Install
- last_install : Last Install (If the new install is only attribution, first_install = last_install)
- last_deeplink : Open the app with deeplink.
Click Data
This is the macro list of tracking link click data. These click data macro will send to your server when attribution has happened.
All these macro can be used on all attribution event type like first_install, last_install and last_deeplink.
| Macro | Description | Sample | |
| Click | {a_key} | Click ID provided by Adbrix | 1530859076437:902a3631-676a-4d57-a428-f7d8962775ad |
| {a_cookie} | Click cookie data provide by Adbrix | 131bc0bc-ceba-4be9-9aa3-b163d9e5afec | |
| {a_ip} | Click ip adress provide by Adbrix | 14.33.77.170 | |
| {a_fp} | Click device fingerprint provide by Adbrix | Android 7.0:LG-F800L:14.33.77.170 | |
| {a_country} | Click current country code provide by Adbrix | kr | |
| {a_city} | Click current city provide by Adbrix | suwon-si | |
| {a_region} | Click current province provide by Adbrix | gyeonggi-do | |
| {a_appkey} | Click appKey provide by Adbrix | 6aE6E7OO5EOsw35P8vCHtQ | |
| {a_partner} | Click partner key provide by Adbrix | WWEzlPofL0CKBJQQLweyHw | |
| {a_agency} | Click agency data provide by Adbrix | a_agency_ | |
| {a_my_adgroup} | Click advertising group data provide by Adbrix | a_my_adgroup_ | |
| {a_my_ad} | Click advertisement data provide by Adbrix | a_my_ad_ | |
| {a_my_campaign} | Click campaign data provide by Adbrix | a_my_campaign_ | |
| {a_server_datetime} | Adtouch datetime (Adbrix server time) | 2018-07-0606:38:03.497 | |
| Partner | {m_creative} | Creative ID data provide by partner | m_createive_ |
| {m_publisher} | Media ID provide by partner | pub_id_120 | |
| {m_sub_publisher} | Sub media ID provide by partner | sub_pub_id_980 | |
| {m_adgroup} | Advertising group ID provide by partner | Test_English_adgroup | |
| {m_ad} | Advertisement ID data provide by partner | Test_English_ad | |
| {m_keyword} | Keyword ID provide by partner | Test_English_keyword | |
| {m_placement} | Advertising placement ID provide by partner | Test_English_placement | |
| {m_cost_model} | Type of advertising settlement provide by partner | 0 | |
| {m_cost} | Advertisement budget provide by partner | 1000 | |
| {m_cost_currency} | Advertisement budget curreny type provide by partner | krw | |
| {m_play_percent} | Percentage of advertisement play provide by partner | 20 | |
| {m_play_second} | Play time of advertisement provide by partner | 10 | |
| {m_view_percent} | Percentage of advertisement view provide by partner | 10 | |
| {m_view_second} | Vier time of advertisement provide by partner | 4 | |
| {cb_1} | Partner click data | click_data_1 | |
| {cb_2} | Partner click data | click_data_2 | |
| {cb_3} | Partner click data | click_data_3 | |
| {cb_4} | Partner click data | click_data_4 | |
| {cb_5} | Partner click data | click_data_5 | |
| {m_adid} | Device ID provide by partner (GAID, IDFA) | 0fa27c1e-9378-4d1c-8f01-118e094240e5 | |
| GA | {utm_source} | GA Tracking Data | utm_source_data |
| {utm_medium} | GA Tracking Data | utm_medium_data | |
| {utm_campaign} | GA Tracking Data | utm_campaign_data | |
| {utm_term} | GA Tracking Data | utm_data | |
| {utm_content} | GA Tracking Data | utm_content_data |
Attribution data
This is the list of attribution data macro.
All these macro can be used on all attribution event type like first_install, last_install, last_deeplink
| Macro | Description | Example | |
| Device | {req.common.identity.adid} | Device ID (Google ADID / Apple IDFA) | 0fa27c1e-9378-4d1c-8f01-118e094240e5 |
| {req.common.identity.idfv} | Apple vendor ID | ||
| {req.common.identity.ad_id_opt_out} | Adblock info | FALSE | |
| {req.common.device_info.os} | Device OS version | 6 | |
| {req.common.device_info.model} | Device Model name | modelmodel | |
| {req.common.device_info.vendor} | Device manufacturer | samsung | |
| {req.common.device_info.resolution} | Device resolution (landscape x height) | 800x600 | |
| {req.common.device_info.is_portrait} | Device Orientation | FALSE | |
| {req.common.device_info.platform} | Device Platform (iOS / Android) | 1 | |
| {req.common.device_info.network} | Device Network type | network | |
| {req.common.device_info.is_wifi_only} | Device cellular data support | FALSE | |
| {req.common.device_info.carrier} | Device Carrier | skt | |
| {req.common.device_info.language} | Device Language | kr | |
| {req.common.device_info.country} | Device Country | ko | |
| {req.common.build_id} | Device build_id | 1 | |
| App | {req.common.package_name} | Android package name / Apple bundle ID | com.adbrix.v2 |
| {req.common.appkey} | Adbrix Remaster Appkey | 6aE6E7OO5EOsw35P8vCHtQ | |
| {req.common.sdk_version} | Adbrix Remaster SDK version | 1.1.1 | |
| {req.common.installer} | Installer info | ||
| {req.common.app_version} | App version | 1.0.0 | |
| Attribution | {attr_type} | Attribution event Type | 0 |
| {event_name} | Attribution event name | abx:firstopen | |
| {event_datetime} | Attribution event date time | 2018-07-0606:37:59.798 | |
| {deeplink_custom_path} | Attribution Deeplink info | scheme://host?key=value | |
| {req.evt.param.market_install_btn_clicked} | Install button click time provice by Google | 1530859019 | |
| {req.evt.param.app_install_start} | Install start time provide by Google | 1530859079 | |
| {req.evt.param.app_install_completed} | Install complete time provide by Google | 1530859079 | |
| {req.evt.param.app_first_open} | First App open time provide by Google | 1530859079 | |
| {seconds_gap} | Click to Install Time | 3 |
Event Postback Macro
Event postback is the in-app event data send to your media server which collects from Adbrix SDK.
Event postback macro is can be offer attribution data with the in-app event and in-app event data.
Attribution Data
This is the macro list for attribution data with the in-app event.
These macros can be offer base on *attribution event type.
*Attribution event type
- first_install : First install attribution
- last_install : Last install attribution (If first install is last one first_install = last_install)
- last_deeplink : Last app open attribution
- last : (Regardless attribution event type) Last attribution
Macro can be use {attribution_type.data_name} format base on the attribution event type.
All these macro can be used on all attribution event type. (first_install, last_install, last_deeplink, last)
Base macro's attribution_type can be substituted as all event attribution event type.
Example) {attibution_type.cb_1} Substitute base macro for all attribution event type.
- {first_install.cb_1} : Click data from first install attribution event
- {last_install.cb_1} : Click data from last install attribution event
- {last_deeplink.cb_1} : Click data from last open attribution event
- {last.cb_1} : (Regardless attribution event type) Click data from last attribution event
| Base macro | Description | Sample | |
| Click | {attribution_type.a_key} | Click data provide by Adbrix | 1530859076437:902a3631-676a-4d57-a428-f7d8962775ad |
| {attribution_type.a_cookie} | Click cookie data provide by Adbrix | 131bc0bc-ceba-4be9-9aa3-b163d9e5afec | |
| {attribution_type.a_ip} | Click ip data provide by Adbrix | 14.33.77.170 | |
| {attribution_type.a_fp} | Click fingerprint data provide by Adbrix | Android 7.0:LG-F800L:14.33.77.170 | |
| {attribution_type.a_country} | Click country code provide by Adbrix | kr | |
| {attribution_type.a_city} | Click city data provide by Adbrix | suwon-si | |
| {attribution_type.a_region} | Click province data provide by Adbrix | gyeonggi-do | |
| {attribution_type.a_appkey} | Click appkey data provide by Adbrix | 6aE6E7OO5EOsw35P8vCHtQ | |
| {attribution_type.a_partner} | Click partner_key provide by Adbrix | WWEzlPofL0CKBJQQLweyHw | |
| {attribution_type.a_agency} | Click agency data provide by Adbrix | a_agency_ | |
| {attribution_type.a_my_adgroup} | Click Ad group data provide by Adbrix | a_my_adgroup_ | |
| {attribution_type.a_my_ad} | Click advertise data provide by Adbrix | a_my_ad_ | |
| {attribution_type.a_my_campaign} | Click campaign data provide by Adbrix | a_my_campaign_ | |
| {attribution_type.a_server_datetime} | Adtouch datetime (Base on Adbrix server time) | 2018-07-0606:38:03.497 | |
| Partner | {attribution_type.m_creative} | Ad creative data provide by partner | m_createive_ |
| {attribution_type.m_publisher} | Media id provide by partner | pub_id_120 | |
| {attribution_type.m_sub_publisher} | Sub media id provide by partner | sub_pub_id_980 | |
| {attribution_type.m_adgroup} | Ad group id provide by partner | 테스트_한글_광고그룹 | |
| {attribution_type.m_ad} | Ad id provide by partner | 테스트_한글_광고 | |
| {attribution_type.m_keyword} | Keyword id provide by partner | 테스트_한글_키워드 | |
| {attribution_type.m_placement} | Ad placement ID provide by partner | 테스트_한글_지역 | |
| {attribution_type.m_cost_model} | Cost model type provide by Adbrix | 0 | |
| {attribution_type.m_cost} | Ad budget provide by partner | 1000 | |
| {attribution_type.m_cost_currency} | Ad budget currency type provide by partner | krw | |
| {attribution_type.m_play_percent} | Ad play percentage provide by partner | 20 | |
| {attribution_type.m_play_second} | Ad play time provide by partner | 10 | |
| {attribution_type.m_view_percent} | Ad view percentage provide by partner | 10 | |
| {attribution_type.m_view_second} | View time provide by partner | 4 | |
| {attribution_type.cb_1} | Partner click data | click_data_1 | |
| {attribution_type.cb_2} | Partner click data | click_data_2 | |
| {attribution_type.cb_3} | Partner click data | click_data_3 | |
| {attribution_type.cb_4} | Partner click data | click_data_4 | |
| {attribution_type.cb_5} | Partner click data | click_data_5 | |
| {attribution_type.m_adid} | Device id collect by partner (GAID, IDFA) | 0fa27c1e-9378-4d1c-8f01-118e094240e5 | |
| GA | {attribution_type.utm_source} | GA tracking data | utm_source_data |
| {attribution_type.utm_medium} | GA tracking data | utm_medium_data | |
| {attribution_type.utm_campaign} | GA tracking data | utm_campaign_data | |
| {attribution_type.utm_term} | GA tracking data | utm_term_data | |
| {attribution_type.utm_content} | GA tracking data | utm_content_data | |
| Attribution | {attribution_type.adid} | Attribution device ID (GAID, IDFA) | 45343208-c952-4584-9b60-6f1354a5b9fc |
| {attribution_type.attribute_datetime} | Attribution datatime | 2018-07-0607:01:41.436 | |
| {attribution_type.attribute_timestamp} | Attribution timestamp | 1509670980 | |
| {attribution_type.attribute_timestamp_d} | Attribution timestamp with millisecond | 1509670980.235 | |
| {attribution_type.seconds_gap} | Click to install time | 3 | |
| {attribution_type.deeplink_custom_path} | Deeplink url info | scheme://host?key=value |
Event Data
Send event data to the media server which collect from Adbrix SDK.
There are two event type. Adbrix SDK pre-defined event type and custom event which using Adbrix SDK.
- Adbrix SDK pre-defined event
- Event which collect directly by Adbrix SDK (Example : app_start , app_open etc)
- evt.group : abx
- Adbrix SDK pre-defined event (Example : Tutorial_complete, purchase etc)
- evt.group : abx
- Event which collect directly by Adbrix SDK (Example : app_start , app_open etc)
- Custom event
- custom evnet using Adbrix SDK. (not pre-defined)
- evt.group : custom
- custom evnet using Adbrix SDK. (not pre-defined)
| Macro | Description | Example | |
| Device | {req.common.identity.adid} | Device ID (Google ADID / Apple IDFA) | 0fa27c1e-9378-4d1c-8f01-118e094240e5 |
| {req.common.identity.idfv} | Apple vendor ID | ||
| {req.common.identity.ad_id_opt_out} | Adblock info | FALSE | |
| {req.common.device_info.os} | Device OS version | 6 | |
| {req.common.device_info.model} | Device Model name | modelmodel | |
| {req.common.device_info.vendor} | Device manufacturer | samsung | |
| {req.common.device_info.resolution} | Device resolution (landscape x height) | 800x600 | |
| {req.common.device_info.is_portrait} | Device Orientation | FALSE | |
| {req.common.device_info.platform} | Device Platform (iOS / Android) | 1 | |
| {req.common.device_info.network} | Device Network type | network | |
| {req.common.device_info.is_wifi_only} | Device cellular data support | FALSE | |
| {req.common.device_info.carrier} | Device Carrier | skt | |
| {req.common.device_info.language} | Device Language | kr | |
| {req.common.device_info.country} | Device Country | ko | |
| {req.common.build_id} | Device build_id | 1 | |
| App | {req.common.package_name} | Android package name / Apple bundle ID | com.adbrix.v2 |
| {req.common.appkey} | Adbrix Remaster Appkey | 6aE6E7OO5EOsw35P8vCHtQ | |
| {req.common.sdk_version} | Adbrix Remaster SDK version | 1.1.1 | |
| {req.common.installer} | Installer info | ||
| {req.common.app_version} | App version | 1.0.0 | |
| event | {req.evt.event_name} | Event name | abx:firstopen |
| {req.evt.group} | Event group | abx | |
| {req.evt.event_datetime} | Event datetime | 2018-07-0607:01:49.615 | |
| {req.evt.event_timestamp} | Event timestamp | 1509670980 | |
| {req.evt.event_timestamp_d} | Event timestamp with millisecond | 1509670980.235 | |
| {req.evt.param_json} | Event parameter (json type) | { "abx:item.color":"메탈블랙", "abx:item.abx:product_id":"30290121", "abx:item.abx:product_name":"여름한정 떨이상품 크록스 20%할인", "abx:item.abx:price":50000, "abx:item.abx:quantity":1, "abx:item.abx:discount":10000, "abx:item.abx:sales":40000, "abx:item.abx:currency":"KRW", "abx:item.abx:category1":"기획전" } |
Apprendix
Adbrix pre-defined event
Adbrix can offer a pre-defined event which widely uses on app marketing.
| {evt.group} | {evt.event_name} | Description | |
| Common | abx | abx:sign_up | App Sign up |
| abx | abx:sign_in | App Login | |
| abx | abx:appUpdate | App update | |
| abx | abx:useCredit | Use in-app point | |
| abx | abx:purchase | In-app purchase | |
| Game | abx | abx:tutorial_complete | Tutorial complete |
| abx | abx:levelAchieved | Level up | |
| abx | abx:characterCreated | Create character | |
| abx | abx:stageCleared | Stage clear | |
| Commerce | abx | abx:viewHome | App's main view |
| abx | abx:productView | Product view | |
| abx | abx:addToCart | Add to cart | |
| abx | abx:addToWishList | Add to wishlist | |
| abx | abx:listView | Product list view | |
| abx | abx:cartView | Cart view | |
| abx | abx:reviewOrder | Confirm order | |
| abx | abx:refund | Refund (order cancel) | |
| abx | abx:search | Product search | |
| abx | abx:share | Share | |
| abx | abx:paymentInfoAdded | Add payment info |
Comments
0 comments
Please sign in to leave a comment.