# Adjust S2S API Quick Start Guide

{% hint style="warning" %}
The Adjust S2S API destination is currently in Early Access. Please contact <support@freshpaint.io> for more information about this integration.
{% endhint %}

## Destination Info

* Supports [Track](https://documentation.freshpaint.io/developer/freshpaint-sdk-reference#track) calls
* Supports [HIPAA mode](https://documentation.freshpaint.io/hipaa-mode)
* Refer to this destination as **Adjust S2S** in the [Integrations object](https://documentation.freshpaint.io/reference/developer/freshpaint-sdk-reference#using-the-integrations-object)
* Connection Modes:

<table><thead><tr><th width="200.33333333333331" align="right"> </th><th data-type="checkbox">Client-side</th><th data-type="checkbox">Server-side</th></tr></thead><tbody><tr><td align="right">Web</td><td>false</td><td>false</td></tr><tr><td align="right">Mobile</td><td>false</td><td>true</td></tr><tr><td align="right">Server</td><td>false</td><td>true</td></tr></tbody></table>

## Getting Started

This guide enables you to fully enable the Adjust S2S API destination for your site.  For simplicity the event used for demonstration purposes is the generic `Page View` event.  For more complex events see[ our additional documentation](/readme/setting-up-your-events.md).  Additionally this guide assumes you have the Freshpaint snippet installed on your site, if you do not please follow[ this guide](/readme/guides/quickstart/installing-freshpaint.md).&#x20;

1. Find/create your Adjust **App Token**&#x20;
2. Find/create your Adjust **S2S Security Token**
3. Enable the Freshpaint Adjust S2S destination
   * If in HIPAA mode enable the required fields
4. Confirm and validate events

### Find your Adjust App Token

1. Log in to your [Adjust Suite](https://suite.adjust.com/).
2. From the top-left menu select **All Apps.**
3. Find or Create your App. The App Token will be the copyable string next to the app name (e.g., `oi9ov8laljwg`)

<figure><img src="/files/DbagoJeva5P5dWNdAKwi" alt=""><figcaption></figcaption></figure>

3. Click on your chosen application and turn on S2S Security under the Protection section

<figure><img src="/files/c5ZVCXoMOhDDnrMPRacN" alt=""><figcaption></figcaption></figure>

4. Copy the S2S Security Token and copy or generate token as needed.

<figure><img src="/files/mmEqFCdcnX98RbTUo0Dt" alt=""><figcaption></figcaption></figure>

5. Reach out to Adjust's team to enable S2S event tracking for this application&#x20;

### Enable the Freshpaint Adjust API destination

1. Navigate to the [Freshpaint Destinations page](https://app.freshpaint.io/destinations/catalog).
2. Search for the **Adjust S2S** destination.
3. Select **Configure** to paste your **App Token** and **S2S Security Token** from the above steps.
4. Customers that use HIPAA mode should then configure the required, recommended, and recommended view-through properties. You can find all properties that the Freshpaint Adjust S2S integration supports here:&#x20;
5. Enable Adjust.

### Set up Event/Session Names

Adjust will only accept event tokens, which requires set up within the application.

1. Navigate to the Events section
2. Set up your events, which will auto generate the appropriate event token.

<figure><img src="/files/xSFOOHmA5l4WUUuM5QxQ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/AzV1yrzUGIItQZ53p1gp" alt=""><figcaption></figcaption></figure>

1. Copy these values over to your Freshpaint Adjust S2S configuration. Alternatively, bulk upload the event CSV from Adjust's `Download event list`.

<figure><img src="/files/2U5rGX6zNjvBycorlDkK" alt=""><figcaption></figcaption></figure>

Sessions can also be set up via names in the Freshpaint Adjust S2S configuration view. The default event name value is `Application Installed` but you can add any session names you'd like to support.

<figure><img src="/files/HdnzXGP00lWjnfJhO6uD" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
If an event name isn't captured in the event or session sections of your Adjust configuration, it will not be sent to Adjust.
{% endhint %}

Once you've followed the steps above you can start sending events to the Adjust S2S API.&#x20;

## Confirm and validate sessions and events

### Confirm and Validate Conversions in Freshpaint

1. Navigate to your site and visit a page that should trigger your event
2. Trigger a session event (Our demonstration session name is `Application Installed`)
3. Navigate to the [Event Verification tool](https://app.freshpaint.io/event-verification).
4. Select `Adjust S2S` and verify your session went through.
   * This can take up to 90 seconds.
5. Verify the event is marked as `OK` or resolve missing property issues.
6. Send an event to the same session (Our demonstration event name is `Sign Up`)
7. Verify that the event went through

### Confirm and Validate Sessions and Events in Adjust

To check whether Adjust is receiving events.

1. Log in to your Adjust account.
2. On your S2S app, click on Installs.
3. This should take you to a quick view of events and sessions for your app (This may 24 to 48 hours to appear in Adjust)

<figure><img src="/files/T3qNkrmvN8NTO7fq4eQb" alt=""><figcaption></figcaption></figure>

1. Alternatively, you can spot check a device, by copying the Adjust Advertising ID into the testing console. The Advertising ID can be found in the event verification response of a session event.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.freshpaint.io/integrations/destinations/mobile-measurement-partners-mmp/adjust-s2s-early-access/adjust-s2s-api-quick-start-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.