Migration Guide
===============

This guide describes the changes that are required when migrating from Connector Script 2 to Connector Script 3.

Connector Script 3 is mostly backwards compatible with existing integrations. However, some features
require that you apply changes to your integration before upgrading.

URLs of Connector Script 3
--------------------------

The URLs that you use to integrate Connector Script 3 are slightly different from the ones for
Connector Script 2.

See :ref:`urls_of_connector_script` for a list of all URLs.

Also make sure that you turn off the :ref:`legacy-integration` setting on Connector Admin Interface.


JWT Paid Content API
--------------------

If you are using :doc:`./configuration/inpage_configuration/jwt_dynamic_paid_content_api` you need to update the structure of the JWT and use the new :doc:`./configuration/inpage_configuration/config_token`, instead.

It extends the existing feature set by adding support for Time Passes and Subscriptions.


Automatic Analytics Integration
-------------------------------

Connector Script 3 automatically supports `Google Analytics for Web (analytics.js) <https://developers.google.com/analytics/devguides/collection/analyticsjs/>`_.

If you are using :ref:`analytics_automatic_analytics_integration` with `Legacy Google Analytics for Web (ga.js) <https://developers.google.com/analytics/devguides/collection/gajs/>`_ or `Webtrekk <https://www.webtrekk.com/en/home/>`_, you need to implement a :ref:`analytics_custom_analytics_integration`.


AdVantage
---------

The AdVantage service has been discontinued and it is not supported by Connector Script 3.