Partner integrations

AdsGram is integrated with Adjust and AppMetrica. It is also possible to work with links from other trackers, but in this case, AdsGram will not be able to transfer the necessary information to the tracker for more detailed analytics.

IMPORTANT

Advertisers using Adjust and AppMetrica for their mobile app can now get data on conversions that users have made after clicking on AdsGram advertising banners.

Adjust

1. Choose Network

In the Campaign Lab section, go to Partners

• Click New Partner.
• In the search bar, type AdsGram and select this network.
• After selecting, click Next.

2. Choose the App

On the next screen, choose the app for which you want to create the link. Use the search bar to find your app, or scroll through the list to find it. You can set up links for one app at a time.
After selecting the app, click Next.

3. Set Data Sharing Options

In this section, you will set up the data sharing parameters with AdsGram, selecting which events and app parameters will be sent to AdsGram for analysis.
Detailed instructions are available on the Adjust documentation page.

4. Get Tracking Link

After configuring all parameters and mappings, you will receive a unique tracking link, which should be used when creating advertising campaigns in AdsGram.
Additionally, you can add extra parameters like UTM tags for more precise tracking of traffic sources.

IMPORTANT

After setting up tracking links, data about user conversions to app installations and in-app events after clicking on AdsGram ads will be displayed only in the Adjust interface.

AppMetrica

Creating a tracker:

1. After registering in the AppMetrica personal account, integrating the SDK into the app, and setting up target action tracking, you can proceed to create the tracker.
2. Specify the name of the tracker.
3. Add the application.

Detailed instructions are available on the AppMetrica documentation page.

Installation data transfer:

4. Choose the postback recipient (AdsGram).
5. Specify the event type that needs to be sent to AdsGram.
6. Obtain the Postback URL — the link through which events and installations will be sent to the AdsGram server.
7. After creating the postbacks, you will receive a tracking link. This link should be used when creating campaigns in AdsGram. Additionally, you may add extra parameters, such as UTM tags, if needed.

Keitaro

1. Creating a Tracker in Keitaro

1. After logging in to the Keitaro dashboard, go to the Trackers section.
2. Click Create tracker or New tracker.
3. Enter the tracker name and select AdsGram as the traffic source type.
4. Click Save to create the tracker.

2. Configuring Postback in Keitaro

1. In the settings of the created tracker, go to the Postback or API Integration section.
2. In the Postback URL field, enter the AdsGram endpoint:

   https://api.adsgram.ai/confirm_conversion?

3. Add the following required query parameters:

   token=YOUR_UNIQUE_TOKEN&record={record_data}

   where YOUR_UNIQUE_TOKEN is the token from your AdsGram profile.

3. Setting Up a Campaign in AdsGram

1. Copy the Click URL from your Keitaro tracker settings (for example: https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}).
2. In the AdsGram dashboard, when creating a campaign, paste this link into the Click URL field.
3. Add the required AdsGram macros to the link:

   https://your-keitaro-domain.com/click.php?campaign_id={campaign_id}&subid={click_id}&publisher={publisher_id}&banner={banner_id}&record={record_data}

4. Make sure the {record_data} macro is included in the final link.

4. Setting Up Goals in Keitaro

1. In your Keitaro tracker settings, go to the Goals or Conversions section.
2. Create a new goal or select an existing one.
3. Enable postback sending to the previously specified URL for this goal.
4. Define the trigger conditions (e.g., upon conversion confirmation or specific status).

Kochava

1. Creating a Tracker in Kochava

1. After logging into the Kochava dashboard, go to the Apps & Assets section.
2. Click Add New and select App to create a new application tracker.
3. Fill in the required fields:
   • Platform: Choose the application platform (iOS, Android, Web).
   • App Name: Enter your app’s name.
   • Store ID: Enter the app’s store identifier (App Store ID, Package Name, etc.).
4. Click Save to create the application.

2. Setting Up Partner Integration

1. In the created app’s page, navigate to the Partner Management section.
2. Click Add Partner.
3. Find and select AdsGram from the list of partners.
4. Click Next to proceed to the configuration settings.

3. Configuring Integration Parameters

1. In the Integration Settings section, select the tracking type (Click-Through, View-Through, or Hybrid).

2. Enable the Server-to-Server Postbacks option.

3. In the Postback URL field, enter the AdsGram endpoint:

   https://api.adsgram.ai/confirm_conversion

4. Add the following parameters to Postback Parameters:

   • Required parameter: {record_data} (automatically inserted by Kochava).
   • Add parameter: token with the value YOUR_UNIQUE_TOKEN (taken from your AdsGram profile).

5. Set up data mapping macros:

   • {campaign_id} → campaign_id
   • {click_id} → click_id
   • {publisher_id} → publisher_id

4. Setting Up a Campaign in AdsGram

1. Return to the Tracking Links section in Kochava and create a tracking link (for example: https://your-app.kochava.com/install?data={encrypted_data}).
2. In the AdsGram dashboard, when creating a campaign, paste this link into the Click URL field.
3. Add mandatory AdsGram macros to the link as parameters:

   https://your-app.kochava.com/install?data={encrypted_data}&campaign_id={campaign_id}&click_id={click_id}&publisher_id={publisher_id}&record={record_data}

4. Make sure the {record_data} macro is included in the final URL.

5. Configuring Events in Kochava

1. In the Kochava dashboard, go to the Events section.
2. Create a new event or choose a standard one (for example, install, purchase).
3. Configure the postback for the selected event:
   • Enable Send Postback.
   • Select the previously created AdsGram integration.
   • Define filters and trigger conditions.
4. Save the event configuration.

6. Testing the Integration

1. Use Test Mode in Kochava to verify install tracking.
2. Check incoming requests in the Kochava and AdsGram logs.
3. Ensure that the record_data parameter is being passed correctly.