Advanced event setup

Use our advanced event setup instructions to customize your event integration, assign user details to event triggers, create unique events, and more.

Set up unique events

A unique event is an in-app action that can only be tracked once per device. They’re helpful for adding context to events the app can’t recognize, like showing a registration as unique from a login.

To set up unique events, follow these steps.

  1. Find your app and select the app option caret (^)
  2. Select All Settings > Events
  3. Find the in-app event that you want to make unique, and select Edit (pencil icon)
  4. Select Unique
  5. Select UPDATE

All done! Now Adjust will only track this event once per device.

Deduplicate revenue events

Revenue deduplication stops Adjust from tracking the same purchase event twice. This protects your dataset and promotes accurate reporting. To deduplicate revenue events, follow the instructions for your event tracking set up. 

For server-side revenue tracking

If you track S2S revenue events, validate all transactions internally before submitting them to Adjust.

For SDK revenue tracking

When you set up revenue deduplication with the Adjust SDK, your app sends us a unique transaction ID with every event. Our SDK stores the last 10 transaction IDs and rejects any purchase made with the same one. For setup instructions, use our Github developer guides: (Android; iOS).

Receive custom data with callback parameters

Availability

Requirements

Callback parameters let you receive extra information with your events, like internal user IDs with registration events.

You can set up callback parameters for Adjust-tracked attribution, sessions, and events. These parameters are unique to your app and appear in your callback strings. Callback parameters report as raw data and do not appear in the Adjust dashboard.

You can write callback parameters into the Adjust SDK or append them to your server-to-server events. To set up callback parameters, follow the instructions for your event integration. 

For events tracked with the Adjust SDK

Callback parameters can be set up within the Adjust SDK by your developer. Instructions for each development platform can be found on GitHub in the following locations:

    For events tracked server-to-server

    To receive callback parameters for events tracked server-to-server, pass them as a JSON object (properly escaped) through the callback_params parameter. Here’s an example JSON object with two custom parameters ({"f0o":"bar","bar":"baz"}) appended:

    https://s2s.adjust.com/event?s2s=1&event_token=f0ob4r&app_token=4w565xzmb54d&idfa=8A3CB124-5A79-4334-8802-F75FEC099C58&callback_params=%7B%22f0o%22%3A%22bar%22%2C%20%22bar%22%3A%22baz%22%7D

    The JSON object should only contain strings and should not be nested. If the parameters are incorrectly formatted, then you’ll receive an error from Adjust.

    Send custom data with partner parameters

    Availability

    Requirements

    Partner parameters let your partners receive extra information with your events, like an order_id with a purchase event.

    Set up for standard partners

    Standard partners use our open callback API to receive data from Adjust. 

    To set up partner parameters for standard partners, follow these steps.

    1. In the Adjust SDK, add partner parameters (iOS, Android, Unity
    2. In the Adjust dashboard, find your app and select your app options caret (^)
    3. Select Partner Setup
    4. Select External Data Forwarding
    5. Toggle ON Parameter Forwarding 

    Nice work! Now Adjust can share partner parameter data with your standard partners. To send partner parameters in your callbacks, ask your standard partners to append the {partner_parameters} placeholder to their callback string.

    Set up for module partners

    Module partners use preset callbacks to receive data from Adjust.

    To set up partner parameters for module partners, follow these steps. 
    1. In the Adjust SDK, add partner parameters (iOS, Android, Unity
    2. In the Adjust dashboard, find your app and select your app options caret (^)
    3. Select Partner Setup
    4. Select the partner you want to work with 
    5. Select Partner Parameter Mapping
    6. In the FROM APP field, enter the name of your Adjust partner parameter (as written into the Adjust SDK) 
    7. In the TO PARTNER field, enter the parameter name (as listed by your partner)
    8. Select SAVE

    All done! Now Adjust will send custom data to your module partner.

    On this topic