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=×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", "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×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", "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×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", "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×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
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×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 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=×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&pos=1 |
Last updated