# \[Beta] Create a Partner Integration

{% hint style="info" %}
**Note:** This functionality is in beta. Contact your CSM or our [support team](https://app.impact.com/support/portal.ihtml?createTicket=true&) if you'd like to test this feature.
{% endhint %}

The Partner Integrations Hub allows you to connect with technical partners who require a JavaScript integration with your website. These technical partner integrations make use of the [impact.com universal tracking tag (UTT)](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/tracking/javascript-tag-tracking/tracking-with-universal-tracking-tag-utt), a JavaScript tag that is placed on your website, to execute new code from the technical partner.

{% hint style="info" %}
**Note:** You must [have UTT enabled](https://help.impact.com/brand/what-would-you-like-to-learn-about/platform-features/tracking/javascript-tag-tracking/tracking-with-universal-tracking-tag-utt) as a pre-requisite for making use of the Partner Integrations Hub, and have approval from your website's IT or Site Reliability teams before deploying a JavaScript tag.
{% endhint %}

#### Step 1: Add the integration details

1. From the top navigation bar, select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1183576591b45997efe4dc81a25024640591d02a%2F245137dc972a7a7f6165b59538fcdbac8fd5bd8fee4ba9f20c1a2982c5b58b57.svg?alt=media) **\[User profile] → Settings**.&#x20;
2. In the *Account* column, scroll to the *Technical* heading and select **Partner Integrations Hub**.
3. From the top-right of the page, select **Add Integration**.
4. Select the integration's *Integration Tag* from the ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media) **\[Drop-down menu]**.
   * The identifiers required to set up an integration will differ from partner to partner. When you select a partner from the drop-down menu, you'll see which identifier the partner requires.
   * If you have any questions, please reach out directly to the partner with which you are integrating.
5. Enter any unique identifier required by the selected partner. For instance, in the screenshot below, the integration requires the *domain* identifier.
6. Select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-d2954616dc486c3e12c9211e20ff376bda0ab1af%2F7586e04e82e7c7203e5c82320dd417f8ac564cae5035024fdf0eb2ed017e6376.svg?alt=media) **\[Checked box]** **Email partner when integration is added** to send an email notification to the relevant technical partner.

   <div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-e6f5f1691494425498ccd482ad10af0e657c7e9a%2F2fcb8034572be1af758d86c4a74439204cd263d07cf8aa6009c11e0cf91cbb4b.png?alt=media" alt=""><figcaption></figcaption></figure></div>
7. Next, select **Add Integration** to save the integration details and proceed to the review stage.

#### Step 2: Review and publish the integration

After adding the integration, the *Review and Publish* page is displayed. This page includes a validation checklist to ensure you've addressed common technical and compliance requirements before the integration goes live. Completing this checklist helps verify several common implementation gaps and ensures your integration is published accurately and can be tracked successfully.

1. To enable the *Publish Tag* button, you must review and select the ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-b5e1740618ed6571d97b8fed7c25a7678f85d375%2F299632fb6f4f91fbf9847471754cc6180e4284a65b4960af4c4ea472a159f552.svg?alt=media) **\[Unchecked box]** for each item listed below:

   | Field                         | Description                                                                                                                                                                                                                             |
   | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | Code Placement confirmed      | <p>Verify that the impact.com Universal Tag is correctly placed on your website.</p><p>If applicable, confirm that the partner's tag domain is allowed in your website's Content Security Policy (CSP) so the script isn't blocked.</p> |
   | Correct Integration ID        | Validate the unique IDs (e.g., "id") entered are accurate and match those provided by your integration partner.                                                                                                                         |
   | Privacy & Compliance Review   | Confirm adherence to data privacy regulations (e.g. GDPR, CCPA) and other legal requirement, ensuring no personal data is inadvertently collected or shared.                                                                            |
   | Internal Stakeholder Sign-Off | Since new code will be placed on your website, secure approval from required internal stakeholders (e.g. Site reliability Engineer, Product manager, Legal) before publishing.                                                          |
2. Once the required confirmations are complete:
   * Select **Publish Tag** to enable the integration immediately.
   * Alternatively, if you are not ready to publish yet, select **Publish Later** to save the integration in a disabled state.

{% hint style="info" %}
**Note:** Depending on your organization’s content security policy, you may need to add `https://*.partner.com` into your Content Security Policy directive. Replace`partner` with the top-level domain of the partner with which you are integrating.
{% endhint %}

#### Publish an added integration

If you've saved an integration in a disabled state, you can publish it by following these steps:

1. From the [*Partner Integrations Hub*](https://app.impact.com/secure/advertiser/fr/partner-integrations-hub.ihtml) page, find the *Disabled* integration you want to publish.
2. Hover your cursor over the integration and select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[More]** → **Publish**.
3. After selecting *Publish*, the *Review and Publish* page is displayed. Complete the verification steps outlined in Step 2: Review and publish the integration.
4. The published integration is now enabled and will be displayed with an *Enabled* status on the list in the *Partner Integrations Hub*.

   <div data-with-frame="true"><figure><img src="https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c5d5b43ad141bde6e6443a3c4b9ddbefff2f35ca%2Fb3d20036325b684d83e3d9ff688942ac83fb1c4b0bb8a2576ed7d2f15fa0c36c.png?alt=media" alt=""><figcaption></figcaption></figure></div>

#### Update an integration

You can edit an integration as follows:

1. From the [*Partner Integrations Hub*](https://app.impact.com/secure/advertiser/fr/partner-integrations-hub.ihtml) page, find the integration you want to edit.
2. Hover your cursor over the integration and select ![](https://4048883401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[More]** → **Edit**.
3. Enter a new identifier, usually supplied by the technical partner, into the textbox.
4. Select **Save** to save your changes.
