Ad Response
AD RESPONSE & TRACKING AD EVENTS
1 - Ad Response Each Ad response contains data of 15 products, in descending order of display priority. You can see an ad response example below. Description for important data in ad response:
Param | Description | Sample Data |
data.admp.ad | Contains urls to call for tracking and other ad information. Please notice 03 urls below: | |
impUrl | Contains the url to call when trigger an impression log | |
trueImpUrl | Contains the url to call when trigger a viewable impression log | |
clickUrl | Contains the url to call when trigger a click log. (mobile app only) after calling this url, client will receive a response which contains “click_bc” (a unique identifier used to collect shopper’s activities data after clicking the ad). This data should be saved in local device storage and inserted in ANTS Analytics “click_bc” param | { "click_bc": "10487538601-1572232924", } |
data.admp.ad.properties | Contains advertising product information used for ad rendering | |
image | advertising banner | |
landingPage | Landing page of banner |
Sample:
{ "id": "", "requestid": "", "data": { "adm": { "375x64": [ { "crid": "3697014293", "cid": "3696978529", "ad": [ { "id": "3697014293", "clickUrl": "//t.ants.vn/a3/c/?bc=97131d66e2,1571277022204,1572477743,10487538601,1,3695999087,638770403,1345134787,26307153,1,3697014293,3696978529,5,0_1&t_rls=3695999087-638770407-0-400&t_s=3695999087-3697014293-1345134787:1&t_kw=&t_z=&t_age=3695999087-3697014293-2:1.0&t_gd=3695999087-3697014293-1:1.0&t_tp=&t_itr=&t_imk=&t_rm=&c_tp=&c_itr=&c_imk=&c_rm=&ti_area=29:1:VN&ti_gd=1&ti_age=3&ti_pl=1&ti_nw=:::1000&ti_dv=1:1:2:52:1:288796&aid=10487538601&cv=c41d430c&nspace=tiki&action_name=×tamp=1572477743334&url=&urlref=&hostname=&gent=&format=18&template=0&res=&gd=1&loc=29-1-vn&device_model=desktop&redirect=http%3A%2F%2Ftiki.vn&render_type=1", "impUrl": "//t.ants.vn/a3/pi/?bc=97131d66e2,1571277022204,1572477743,10487538601,1,3695999087,638770403,1345134787,26307153,1,3697014293,3696978529,5,0_1&t_rls=3695999087-638770407-0-400&t_s=3695999087-3697014293-1345134787:1&t_kw=&t_z=&t_age=3695999087-3697014293-2:1.0&t_gd=3695999087-3697014293-1:1.0&t_tp=&t_itr=&t_imk=&t_rm=&c_tp=&c_itr=&c_imk=&c_rm=&ti_area=29:1:VN&ti_gd=1&ti_age=3&ti_pl=1&ti_nw=:::1000&ti_dv=1:1:2:52:1:288796×tamp=1572477743339&url=&urlref=&hostname=&format=18&template=0&res=&gd=1&loc=29-1-VN&skw=", "trueImpUrl": "//t.ants.vn/a3/ti/?bc=97131d66e2,1571277022204,1572477743,10487538601,1,3695999087,638770403,1345134787,26307153,1,3697014293,3696978529,5,0_1&t_rls=3695999087-638770407-0-400&t_s=3695999087-3697014293-1345134787:1&t_kw=&t_z=&t_age=3695999087-3697014293-2:1.0&t_gd=3695999087-3697014293-1:1.0&t_tp=&t_itr=&t_imk=&t_rm=&c_tp=&c_itr=&c_imk=&c_rm=&ti_area=29:1:VN&ti_gd=1&ti_age=3&ti_pl=1&ti_nw=:::1000&ti_dv=1:1:2:52:1:288796×tamp=1572477743339&url=&urlref=&hostname=&format=18&template=0&res=&gd=1&loc=29-1-VN&skw=", "properties": { "image": "//c0-vcdn.anthill.vn/images/2019/10/30/e308ac9aa590195a6eb47f87458c99f8.png", "landingPage": "https://tiki.vn" } } ] } ] } } } |
2 - Tracking Impression
(pc) Trigger impression logs of the 1st to 5th products at the same time when they are fully rendered. For each 5 products onwards (6th-10th, 11th-15th,...), send their impression logs when shopper clicks on next icon in the right-end of the widget to see them. Call to the urls in “impUrl” and insert ad slot order number in “pos”.
(app) Trigger impression logs of each 10 products at the same time when they are fully rendered. For each 10 products onwards (11th-20th, 21st-30th,...), send their impresion logs each time when shopper takes action to view more (may be swiping at the end, or clicking on see more button,… depending on UI). Call to the urls in “impUrl” and insert ad slot order number in “pos”.
Param | Data Type | Description | Required | Sample Data |
pos | number | slot order number | no | 1 |
Sample:
https://t.ants.vn/a3/ti/?bc=a0b021bec7,1572143223940,1572143491,10933521987,1,788666385,638770403,638770405,10384,1,3503639993,3503639807,1,0_1&t_rls=788666385-638770407-0-1200&t_s=&t_kw=788666385-3503639993-666198849:1&t_z=&t_age=788666385-3503639993-4:1.0&t_gd=788666385-3503639993-2:1.0&t_tp=&t_itr=&t_imk=&t_rm=&c_tp=&c_itr=&c_imk=&c_rm=&ti_area=29:1:VN&ti_gd=1&ti_age=3&ti_pl=1&ti_nw=:::1000&ti_dv=1:1:2:52:1:288796×tamp=1572143491590&url=https://tiki.vn/search?q=balo&urlref=&hostname=tiki.vn&format=33&template=0&res=&gd=1&loc=29-1-VN&skw=balo&prd_imp=788666385-3503639993-2902441563:1&pos=1 |
3 - Tracking Viewable Impression
For the 1st to 5th product, Trigger viewable impression logs when the ad widget is exposed 50% of its area for 1 second in viewer’s screen. For the 6th product and onwards, Trigger viewable impression logs at the same time with impression logs. Call to the urls in “trueImpUrl” and insert ad slot order number in “pos”.
Param | Data Type | Description | Required | Sample Data |
pos | number | slot order number | no | 1 |
Sample:
https://t.ants.vn/a3/pi/?bc=a0b021bec7,1572143223940,1572143491,10933521987,1,788666385,638770403,638770405,10384,1,3503639993,3503639807,1,0_1&t_rls=788666385-638770407-0-1200&t_s=&t_kw=788666385-3503639993-666198849:1&t_z=&t_age=788666385-3503639993-4:1.0&t_gd=788666385-3503639993-2:1.0&t_tp=&t_itr=&t_imk=&t_rm=&c_tp=&c_itr=&c_imk=&c_rm=&ti_area=29:1:VN&ti_gd=1&ti_age=3&ti_pl=1&ti_nw=:::1000&ti_dv=1:1:2:52:1:288796×tamp=1572143491590&url=https://tiki.vn/search?q=balo&urlref=&hostname=tiki.vn&format=33&template=0&res=&gd=1&loc=29-1-VN&skw=balo&prd_imp=788666385-3503639993-2902441563:1&pos=1 |
4 - Tracking Click
Trigger when a shopper click on a product in ad widget. Call to the urls in “clickUrl” and insert ad slot order number in “pos”.
Param | Data Type | Description | Required | Sample Data |
pos | number | slot order number | no | 1 |
Sample:
https://t.ants.vn/a3/c/?bc=a0b021bec7,1572143223940,1572143491,10933521987,1,788666385,638770403,638770405,10384,1,3503639993,3503639807,1,0_1&t_rls=788666385-638770407-0-1200&t_s=&t_kw=788666385-3503639993-666198849:1&t_z=&t_age=788666385-3503639993-4:1.0&t_gd=788666385-3503639993-2:1.0&t_tp=&t_itr=&t_imk=&t_rm=&c_tp=&c_itr=&c_imk=&c_rm=&ti_area=29:1:VN&ti_gd=1&ti_age=3&ti_pl=1&ti_nw=:::1000&ti_dv=1:1:2:52:1:288796&skw=balo&aid=10933521987&cv=d6f4abe9&nspace=tiki&action_name=×tamp=1572143491590&url=https%3A%2F%2Ftiki.vn%2Fsearch%3Fq%3Dbalo&urlref=&hostname=tiki.vn&gent=&format=33&template=0&res=&gd=1&loc=29-1-vn&device_model=desktop&redirect=https%3A%2F%2Ftiki.vn%2Fproduct%2F35264563%3Fspid%3D35264563&prd_imp=788666385-3503639993-2902441563:1&render_type=1&pos=1 |
Last updated