Skip to main content

Affiliate links

An affiliate link is this easiest way for you to make sure that Olino associates with you any traffic you send.

Your partner code​

An affiliate link relies on a unique public identifyer only associated to you: the partner code.
If you have not already received it on the email provided during the contract signature or if you need to generate a new partner code, send your customer success manager an email and you will receive a new one in less than two business days.

Main Benefit: No technical integration​

You can directly communicate your partner code to your users in emails, on your website, etc. Your users will then need to fill your partner code manually in the promotional code field of the checkout page.

Partner code & attribution​

Your users will only be able to use your Partner code on existing and new quotes (Partner Code do not apply to existing contracts). By default, a Partner code only applies to the contract first period (usually one year).

In case of doubt, please refer to the documentation provided by your customer success manager.

Whenever you can, we highly recommend that you use affiliate links instead of the partner code.

To work properly and be compatible with advanced customization options, an Olino affiliate link should be of the following form :

https://partner.olino.fr/YOUR_PARTNER_CODE

Warning: During your tests, you might notice that this format seemingly provides the same results:

https://app.olino.fr/YOUR_PARTNER_CODE

Indeed, your partner code will correctly be applied and your users will be able to use it BUT the more advanced customization options described on won't be applied. Conclusion: save yourself some time (and headaches) and only use on the partner.olino.fr url.

Main benefit: less error prone & more reliable​

By using an affiliate link, you prevent manual errors when users fill your partner code (or forget to do so !). More importantly, it enables Olino to still apply your partner code to users who have not completed their subscription process (even if they are not using your affiliate link the next time they visit Olino's application) for up to 6 months. This duration can be extended to another 6 months if the user re-use your affiliate links (a simple visit on Olino's app.olino.fr won't extend the duration).

Affiliate link & attribution​

Affiliate Links follow the same rules as the Partner codes (described in the section "Partner code & attribution").

Advanced Customization​

To provide a seamless experiences to your users, you can customize some of the look and feel of the onboarding workflow (eg. change the logo), or pre-fill the form with information you already have about the user. If you don't have already access to Advanced Customization, please contact your customer success manager by email and don't hesitate to describe any additional customization that you would need and are not described in this document.

Your company logo is a good way to reassure your users that the subscription flow is endorsed by your company and will increase the conversion rate.

To customize the logo, you will need to contact your partnership manager, and ask them to change the logo for your partner code.

Prefilled form​

To reduce the time needed by users to fill the subscription flow you can pre-populate the form with information you already have.

caution

For the time being, all the following parameters are mandatory. If a parameter is missing, or wrong, the user will have to fill all the information. The partner code will still be applied.

We know that this is not ideal and we work on having as many optional parameters as possible. The parameters are the following:

User parameters​

  • user_first_name: The customer's first name
  • user_last_name: The customer's last name
  • user_email: The customer's email
  • user_phone: The customer's phone number (must be in international format, ex: +33123456789)

Company parameters​

  • company_siret: The customer's company SIRET number

  • company_name: The customer's company name

  • company_founded_at: The customer's company founding date (must follow the ECMA262 spec)

  • company_naf_code: The customer's company NAF code (ex: 62.02A)

  • company_legal_status: The customer's company legal status (ex: SARL, SAS, etc...)

  • company_turnover: The customer's company turnover

  • company_address_line_1: The customer's company address

  • company_address_line_2: The customer's company address

  • company_postal_code: The customer's company zip code

  • company_city: The customer's company city

  • company_country: The customer's company country (must be FRANCE, as Olino is only available in France for now)

Example​

https://partner.olino.fr/PARTNER_CODE?user_first_name=John&user_last_name=Doe&user_email=john.doe%40example.com&user_phone=%2B33123456789&company_siret=12345678901234&company_name=John%20Doe%20Inc.&company_founded_at=2000-01-23T01:23:45.678%2B09:00&company_naf_code=62.02A&company_legal_status=SARL&company_turnover=1000000&company_address_line_1=1%20Main%20Street&company_address_line_2=Suite%201&company_postal_code=12345&company_city=Paris&company_country=FRANCE

Testing your integration​

When testing your integration, some errors may occur. If the error is non critical, the user will be redirected to the subscription/onboarding page (depending on whether or not the user is logged in). Else, the error might require an action from the user, which will be displayed on the page. In both cases, the error will be logged in the console. The partner code will be applied.

Embedding in your website​

If you want to embed the subscription page in your website, you can use an iframe. Refer to the iframe documentation for more information.