Adjust S2S API Quick Start Guide

The Adjust S2S API destination is currently in Early Access. Please contact [email protected] for more information about this integration.

Destination Info

• Supports Track calls

• Supports HIPAA mode

• Refer to this destination as Adjust S2S in the Integrations object

• Connection Modes:

	Client-side	Server-side
Web
Mobile
Server

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. Additionally this guide assumes you have the Freshpaint snippet installed on your site, if you do not please follow this guide.

1. Find/create your Adjust App Token

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.

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)

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

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

1. Reach out to Adjust's team to enable S2S event tracking for this application

Enable the Freshpaint Adjust API destination

1. Navigate to the Freshpaint Destinations page.

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:

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.

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

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.

If an event name isn't captured in the event or session sections of your Adjust configuration, it will not be sent to Adjust.

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

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.

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)

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.