Ad Response

AD RESPONSE & TRACKING AD EVENTS 1 - Ad Response The Ad response contains data of maximum 15 products in descending order of display priority. In case that any product is not eligible (out of stock, or already in the organic results with equal or better product slot), this product should be skipped and the next product will be displayed instead.

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

Trigger when the ad is completely rendered. 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

Trigger when the ad is exposed at least 50% of its area for 1 second in viewer’s screen. 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 an ad. 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