Powered by Smartsupp

Custom Integration

Implementation time : 30 min

In our Launify Administration:

  1. Click on Integrations -> Create a key in our administration panel.
  2. Enter a key name and the domains that will be allowed to communicate using this key, then click Save.
  3. If you already have an API key, you will see a </> symbol on the right side of the row. Click on it and copy the code that appears in the pop-up window.

Great! You have now created an API key that works only on your defined domains and have copied our code.


In Your E-shop:

Now, you need to insert our code with the API key into the <head> tag of your e-shop/application. Don't forget to replace YOUR_API_KEY_HERE with your actual API key if you copy the code from here.


  1. Add our tracking code to your e-shop's header, which you copied in the previous step from the Launify administration.
  2. That's it! Your e-shop is now successfully connected to our integration.


Example

<script>
window.onload = () => document.head.appendChild(Object.assign(document.createElement("script"), {
src: 'https://cdn.launify.com/launify.min.js?t=' + Date.now(),
onload: () => new Launify("YOUR_API_KEY_HERE").init(),
async: true,
}));
</script>


Now, you need to set up your form fields (inputs, outputs) for entering addresses, emails, and listening for results.


Mapping

  1. In our administration panel, click on Integrations.
  2. Scroll down in this section to Input and Output Mapping.
  3. By default, you already have a pre-defined mapping group. You can modify this group according to your needs or add additional ones. There are no limits on the number of groups you can create.
  4. You can add form inputs by: id, name, class, or data-attribute.


It is recommended to set up autocomplete for the "street" input (type: Address) and the "email" input (type: Email) by default.


For the autocomplete results, you can choose which data you want to use and which output to send it to.