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	​
sku	Sku of advertising product	​
product_id	Id of advertising product	​

Sample:

{ "id":"", "requestid":"", "data":{ "adm":[ { "ses":"638770405", "crid":"3503639993", "cid":"3503639807", "ad":[ { "id":"2902441563", "beacon":"a0b021bec7,1572143223940,1572143491,10933521987,1,788666385,638770403,638770405,10384,1,3503639993,3503639807,1,0_1", "clickUrl":"//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=&timestamp=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", "impUrl":"//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&timestamp=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", "trueImpUrl":"//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&timestamp=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", "properties":{ "sku":"35264563", "product_id":"35264563", "title":"Balo Tomtoc A71 Unisex in hình họa tiết cho Laptop, Macbook 15'' - Họa tiết Đen", "description":null, "image":"//c0-vcdn.anthill.vn/dynamic/2019/10/26/b65a3c928df71e05da7240f5cdebbe5a.jpg", "currency":"đ", "price":"990000", "original_price":"1100000" } } ] } ] } }

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&timestamp=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&timestamp=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=&timestamp=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&pos=1