# 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.&#x20;

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                | <p>Contains the url to call when trigger a click log.<br></p><p>(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 <a href="https://docs.google.com/document/d/1DFjezg0Cip5IbmZvvp14YQGnJM6cfMUx1UqubYiWZqE/edit">ANTS Analytics “click_bc” param</a>  </p> | <p>{  "click_bc": "10487538601-1572232924",</p><p>}<br></p> |
| data.admp.ad.properties | Contains advertising product information used for ad rendering                                                                                                                                                                                                                                                                                                                                                                                                       |                                                             |
| sku                     | Sku of advertising product                                                                                                                                                                                                                                                                                                                                                                                                                                           |                                                             |
| product\_id             | Id of advertising product                                                                                                                                                                                                                                                                                                                                                                                                                                            |                                                             |

Sample:\


| <p>{ </p><p>   "id":"",</p><p>   "requestid":"",</p><p>   "data":{ </p><p>      "adm":[ </p><p>         { </p><p>            "ses":"638770405",</p><p>            "crid":"3503639993",</p><p>            "cid":"3503639807",</p><p>            "ad":[ </p><p>               { </p><p>                  "id":"2902441563",</p><p>                  "beacon":"a0b021bec7,1572143223940,1572143491,10933521987,1,788666385,638770403,638770405,10384,1,3503639993,3503639807,1,0_1",</p><p>                  "clickUrl":"//t.ants.vn/a3/c/?bc=a0b021bec7,1572143223940,1572143491,10933521987,1,788666385,638770403,638770405,10384,1,3503639993,3503639807,1,0_1&#x26;t_rls=788666385-638770407-0-1200&#x26;t_s=&#x26;t_kw=788666385-3503639993-666198849:1&#x26;t_z=&#x26;t_age=788666385-3503639993-4:1.0&#x26;t_gd=788666385-3503639993-2:1.0&#x26;t_tp=&#x26;t_itr=&#x26;t_imk=&#x26;t_rm=&#x26;c_tp=&#x26;c_itr=&#x26;c_imk=&#x26;c_rm=&#x26;ti_area=29:1:VN&#x26;ti_gd=1&#x26;ti_age=3&#x26;ti_pl=1&#x26;ti_nw=:::1000&#x26;ti_dv=1:1:2:52:1:288796&#x26;skw=balo&#x26;aid=10933521987&#x26;cv=d6f4abe9&#x26;nspace=tiki&#x26;action_name=&#x26;timestamp=1572143491590&#x26;url=https%3A%2F%2Ftiki.vn%2Fsearch%3Fq%3Dbalo&#x26;urlref=&#x26;hostname=tiki.vn&#x26;gent=&#x26;format=33&#x26;template=0&#x26;res=&#x26;gd=1&#x26;loc=29-1-vn&#x26;device_model=desktop&#x26;redirect=https%3A%2F%2Ftiki.vn%2Fproduct%2F35264563%3Fspid%3D35264563&#x26;prd_imp=788666385-3503639993-2902441563:1",</p><p>                  "impUrl":"//t.ants.vn/a3/pi/?bc=a0b021bec7,1572143223940,1572143491,10933521987,1,788666385,638770403,638770405,10384,1,3503639993,3503639807,1,0_1&#x26;t_rls=788666385-638770407-0-1200&#x26;t_s=&#x26;t_kw=788666385-3503639993-666198849:1&#x26;t_z=&#x26;t_age=788666385-3503639993-4:1.0&#x26;t_gd=788666385-3503639993-2:1.0&#x26;t_tp=&#x26;t_itr=&#x26;t_imk=&#x26;t_rm=&#x26;c_tp=&#x26;c_itr=&#x26;c_imk=&#x26;c_rm=&#x26;ti_area=29:1:VN&#x26;ti_gd=1&#x26;ti_age=3&#x26;ti_pl=1&#x26;ti_nw=:::1000&#x26;ti_dv=1:1:2:52:1:288796&#x26;timestamp=1572143491590&#x26;url=https://tiki.vn/search?q=balo&#x26;urlref=&#x26;hostname=tiki.vn&#x26;format=33&#x26;template=0&#x26;res=&#x26;gd=1&#x26;loc=29-1-VN&#x26;skw=balo&#x26;prd_imp=788666385-3503639993-2902441563:1",</p><p>                  "trueImpUrl":"//t.ants.vn/a3/ti/?bc=a0b021bec7,1572143223940,1572143491,10933521987,1,788666385,638770403,638770405,10384,1,3503639993,3503639807,1,0_1&#x26;t_rls=788666385-638770407-0-1200&#x26;t_s=&#x26;t_kw=788666385-3503639993-666198849:1&#x26;t_z=&#x26;t_age=788666385-3503639993-4:1.0&#x26;t_gd=788666385-3503639993-2:1.0&#x26;t_tp=&#x26;t_itr=&#x26;t_imk=&#x26;t_rm=&#x26;c_tp=&#x26;c_itr=&#x26;c_imk=&#x26;c_rm=&#x26;ti_area=29:1:VN&#x26;ti_gd=1&#x26;ti_age=3&#x26;ti_pl=1&#x26;ti_nw=:::1000&#x26;ti_dv=1:1:2:52:1:288796&#x26;timestamp=1572143491590&#x26;url=https://tiki.vn/search?q=balo&#x26;urlref=&#x26;hostname=tiki.vn&#x26;format=33&#x26;template=0&#x26;res=&#x26;gd=1&#x26;loc=29-1-VN&#x26;skw=balo&#x26;prd_imp=788666385-3503639993-2902441563:1",</p><p>                  "properties":{ </p><p>                     "sku":"35264563",</p><p>                     "product_id":"35264563",</p><p>                     "title":"Balo Tomtoc A71 Unisex in hình họa tiết cho Laptop, Macbook 15'' - Họa tiết Đen",</p><p>                     "description":null,</p><p>                     "image":"//c0-vcdn.anthill.vn/dynamic/2019/10/26/b65a3c928df71e05da7240f5cdebbe5a.jpg",</p><p>                     "currency":"đ",</p><p>                     "price":"990000",</p><p>                     "original_price":"1100000"</p><p>                  }</p><p>               }</p><p>            ]</p><p>         }</p><p>      ]</p><p>   }</p><p>}</p> |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

**2 - Tracking Impression**

Trigger when the ad is completely rendered. Call to the urls in “impUrl” and insert ad slot order number in “pos”. &#x20;

| 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”.&#x20;

| 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 |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
