Findify

Findify Developer Hub

Welcome to the Findify developer hub. You'll find comprehensive guides and documentation to help you start working with Findify as quickly as possible, as well as support if you get stuck. Let's jump right in!

Integrating Findify Analytics

Access your website template through FTP.

  1. To integrate Findify Analytics on your product page and cart page, you must use your SFTP credentials, and open an FTP client such as FileZilla, to log into the file server and access your website template and asset files. So, download FileZilla Client and access the website template of your current theme.
  1. Once you access your website template through FileZilla, go to 'httpdocs' located on the bottom right box→ 'assets' → scroll down and click on ‘themes’.
  1. Under themes, select the current theme of your website template and continue to complete the following steps.

1. Add analytics tags to the Product Page

  1. Under the current theme, you selected, go to 'templates' → 'product' → find 'template.html' in the box below that displays all the files
  1. Insert one of the following snippets to the top of the ‘template.html’:
  • If the product feed contains 'sku' from Neto as 'item_group_id' in Findify product feed, then insert this snippet:
<div data-findify-event="view-page" data-findify-item-id="[%if [@[email protected]] ne '0' and [@[email protected]] ne ''%][@[email protected]][%else%][@[email protected]][%/if%]" data-findify-variant-item-id="[@[email protected]]"></div>
<div data-findify-filter="brand" data-findify-filter-value="[@[email protected]]"></div>
<div data-findify-filter="id" data-findify-filter-value="[%if [@[email protected]] ne '0' and [@[email protected]] ne ''%][@[email protected]][%else%][@[email protected]][%/if%]"></div>
[%content_path id:'[@[email protected]]' type:'category' limit: '1' %]\
    [%param *body%]
        [%set [@[email protected]]%][@[email protected]][%/set%]
        [%content_path content_id:'[@[email protected]]' show_path:'y' type:'category' %]
            [%param *body%]
                [%if [@^[email protected]] ne [@[email protected]]%]
                    [%set [@^[email protected]]%][@[email protected]] > [@^[email protected]][%/set%]
                [%/if%] 
            [%/param%]
        [%/content_path%]
        <div data-findify-filter="category" data-findify-filter-value="[@[email protected]]"></div>
    [%/param%]
[%/content_path%]
<div data-findify-event="update-cart">
    [%cart_items%]
        [%param *body%]
        <div data-findify-item-id="[%if [@[email protected]] ne '0' and [@[email protected]] ne ''%][@[email protected]][%else%][@[email protected]][%/if%]" data-findify-variant-item-id="[@[email protected]]" data-findify-unit-price="[@[email protected]]" data-findify-quantity="[@[email protected]]"></div>
        [%/param%]
    [%/cart_items%]
</div>
  • If the product feed contains 'inventory_id' from Neto as 'item_group_id' in Findify product feed, then insert this snippet:
<div data-findify-event="view-page" data-findify-item-id="[%if [@[email protected]] ne '0' and [@[email protected]] ne ''%][@[email protected]][%else%][@[email protected]][%/if%]" data-findify-variant-item-id="[%if [@[email protected]] ne '0' and [@[email protected]] ne ''%][@[email protected]][%else%][@[email protected]][%/if%]"></div>
<div data-findify-filter="brand" data-findify-filter-value="[@[email protected]]"></div>
<div data-findify-filter="id" data-findify-filter-value="[%if [@[email protected]] ne '0' and [@[email protected]] ne ''%][@[email protected]][%else%][@[email protected]][%/if%]"></div>
[%content_path id:'[@[email protected]]' type:'category' limit: '1' %]\
    [%param *body%]
        [%set [@[email protected]]%][@[email protected]][%/set%]
        [%content_path content_id:'[@[email protected]]' show_path:'y' type:'category' %]
            [%param *body%]
                [%if [@^[email protected]] ne [@[email protected]]%]
                    [%set [@^[email protected]]%][@[email protected]] > [@^[email protected]][%/set%]
                [%/if%] 
            [%/param%]
        [%/content_path%]
        <div data-findify-filter="category" data-findify-filter-value="[@[email protected]]"></div>
    [%/param%]
[%/content_path%]
<div data-findify-event="update-cart">
    [%cart_items%]
        [%param *body%]
        <div data-findify-item-id="[%if [@[email protected]] ne '0' and [@[email protected]] ne ''%][@[email protected]][%else%][@[email protected]][%/if%]" data-findify-variant-item-id="[%if [@[email protected]] ne '0' and [@[email protected]] ne ''%][@[email protected]][%else%][@[email protected]][%/if%]" data-findify-unit-price="[@[email protected]]" data-findify-quantity="[@[email protected]]"></div>
        [%/param%]
    [%/cart_items%]
</div>

2. Add 'update-cart' tags to the Cart Page

  1. Open the theme folder of the current theme you are using and go to 'templates' → 'cart' → 'shopping_cart.template.html'
  1. Insert one of the following snippets to the top of the ‘shopping_cart.template.html’ :
  • If the product feed contains 'sku' from Neto as 'item_group_id' in Findify product feed, then insert this snippet:
<div data-findify-event="update-cart">
    [%cart_items%]
        [%param *body%]
        <div data-findify-item-id="[%if [@[email protected]] ne '0' and [@[email protected]] ne ''%][@[email protected]][%else%][@[email protected]][%/if%]" data-findify-variant-item-id="[@[email protected]]" data-findify-unit-price="[@[email protected]]" data-findify-quantity="[@[email protected]]"></div>
        [%/param%]
    [%/cart_items%]
</div>
  • If the product feed contains 'inventory_id' from Neto as 'item_group_id' in Findify product feed, then insert this snippet:
<div data-findify-event="update-cart">
    [%cart_items%]
        [%param *body%]
        <div data-findify-item-id="[%if [@[email protected]] ne '0' and [@[email protected]] ne ''%][@[email protected]][%else%][@[email protected]][%/if%]" data-findify-variant-item-id="[@[email protected]]" data-findify-unit-price="[@[email protected]]" data-findify-quantity="[@[email protected]]"></div>
        [%/param%]
    [%/cart_items%]
</div>

3. Add 'purchase-tracking' tags

  1. Open your Neto admin panel and go to 'Settings & tools' → 'All settings & tools'.
  1. Scroll down to Analytics & 3rd Party Scripts and click on 'Custom Scripts'.
  1. Click on 'Add New' located on the top right of your dashboard.
  1. Name custom script: 'Findify Revenue Tracking' and leave all 'keys' empty.
  1. Go to 'Purchase Confirmation (Thank You Page)' tab which is the fourth tab and insert the snippet below in space available under Scripts:

Snippets:

  • If the product feed contains 'sku' from Neto as 'item_group_id' in Findify product feed, then insert this snippet:
[%SHOW_ORDER id:'[@[email protected]]'%]

[%PARAM *header%]
<div data-findify-event="purchase" data-findify-order-id="[@[email protected]]" data-findify-currency="AUD" data-findify-revenue="[@[email protected]]">
[%END PARAM%]
    [%PARAM *body%]
    <div data-findify-item-id="[%if [@[email protected]] ne '0' and [@[email protected]] ne ''%][@[email protected]][%else%][@[email protected]][%/if%]" data-findify-variant-item-id="[@[email protected]]" data-findify-unit-price="[@[email protected]]" data-findify-quantity="[@[email protected]]"></div>
    [%END PARAM%]
    [%PARAM *footer%]
</div>
[%END PARAM%]

[%END SHOW_ORDER%]
  • If the product feed contains 'inventory_id' from Neto as 'item_group_id' in Findify product feed, then insert this snippet:
[%SHOW_ORDER id:'[@[email protected]]'%]

[%PARAM *header%]
<div data-findify-event="purchase" data-findify-order-id="[@[email protected]]" data-findify-currency="AUD" data-findify-revenue="[@[email protected]]">
[%END PARAM%]
    [%PARAM *body%]
    <div data-findify-item-id="[%if [@[email protected]] ne '0' and [@[email protected]] ne ''%][@[email protected]][%else%][@[email protected]][%/if%]" data-findify-variant-item-id="[%if [@[email protected]] ne '0' and [@[email protected]] ne ''%][@[email protected]][%else%][@[email protected]][%/if%]" data-findify-unit-price="[@[email protected]]" data-findify-quantity="[@[email protected]]"></div>
    [%END PARAM%]
    [%PARAM *footer%]
</div>
[%END PARAM%]

[%END SHOW_ORDER%]

Please, make sure if the 'Purchase Confirmation (Thank You Page)' has Findify script in place. If not, then you would need to add right before all of the tags:

<script src="//findify-assets-2bveeb6u8ag.netdna-ssl.com/search/prod/your_store_name.min.js async defer></script>
[%SHOW_ORDER id:'[@[email protected]]'%]

[%PARAM *header%]
<div data-findify-event="purchase" data-findify-order-id="[@[email protected]]" data-findify-currency="AUD" data-findify-revenue="[@[email protected]]">
[%END PARAM%]
    [%PARAM *body%]
    <div data-findify-item-id="[%if [@[email protected]] ne '0' and [@[email protected]] ne ''%][@[email protected]][%else%][@[email protected]][%/if%]" data-findify-variant-item-id="[@[email protected]]" data-findify-unit-price="[@[email protected]]" data-findify-quantity="[@[email protected]]"></div>
    [%END PARAM%]
    [%PARAM *footer%]
</div>
[%END PARAM%]

[%END SHOW_ORDER%]

📘

Help

For further help, feel free to email [email protected]

Updated 4 months ago

Integrating Findify Analytics


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.