AdGyde Logo

Offline Campaign - Tracking Installs


This section talks about the tracking solutions for following
  1. Pre-embed Campaign
  2. OEM Store/Side-Load Campaign
  3. Online APK campaign

Pre-embed Campaign
In case you wish to get your application Pre-embedded in phones before they are shipped to the market, then you can contact the Original Equipment Manufacturer (OEM) to get the same done.

Note : Installs will be counted only when user open the application for the first time.

AdGyde can track the New Users in this case and show it under the Pre-Embed Channel. Because AdGyde counts installs on First open, therefore the count shown will be Activated Pre-embed device count and not All Pre-embedded device count.
To track the New Users under Pre-Embed channel, the Pre-Embed channel needs to be Hardcoded in the application before the APK is shared with the OEM partner.

No Need to create campaign for Pre-Embed only add below code in APK
  • Pass the following String as parameter in AdGyde.init(this, "Your Appkey", "Pre_embed") function

OEM Store/Side-Load Campaign
Methods to track Android attribution through Google Play Store and Side-Load is supported by AdGyde.

In case you wish to track the installs through multiple Sources of Side-Load like different OEM App Stores, then the developer needs to create separate Hardcoded APKs for each source.

To track the campaign in Dashboard the developer needs to Hardcode the Channel and Campaign Name in the application before sharing the APK to the required OEM App Store.

How to hardcode Channel and Campaign
  • Pass the following String as parameter in AdGyde.init(this, "Your Appkey", "ChannelName") function
    Where ChannelName = ChannelName_offlinewd_CampaignId
    Example: Loopback_offlinewd_125

Step by Step Offline Campaign Setup

Online APK Campaign
In case you wish to track the installs through APK Campaign, then the developer needs to create separate Hardcoded APKs for each source and run the campaigns with GAID.

NOTE : Passing Advertising ID (GAID) is compulsory in this method. Also, if incorrect Link is used then Install will be tracked as Organic

Same Channel APK can be used for all the campaigns of the Channel which has been hardcoded.

How to hardcode Channel
  • Pass the following String as parameter in AdGyde.init(this, "Your Appkey", "ChannelName") function
    ChannelName = ChannelName_offline
    Example: Loopback_offline

  • Pass the advertising_id parameter in the Campaign Tracking URL
    i.e. https://log2.adgyde.com/intf/b/1/o?c={Campaign Open Id}&p={Partner Id}&ag_r={RedirectUrl}&advertisingId={AdvertisingId}

Step by Step Offline Campaign Setup

  1. Login to AdGyde Dashboard
  2. Open Setup Page from Left Navigation Menu
  3. Click on Manage Campaigns under Campaign Tracking
  4. Click on 'Create New Campaign' button on Top right Corner
  5. Go to Add Campaign configurations
  6. Selects the Application for which the campaign is required
  7. Search and enters the Channel / Partner Name
  8. Enter the Campaign Name
  9. Enter the Campaign Type as "Offline / APK"
  10. Select the desired click Attribution Window



  11. Go to Add Channel Configurations
  12. If you wish to associate Cost with Campaign to track your expenditure, then Select Provided by Channel and Pass same
  13. For Offline Campaign 2 tracking link Parameters are required - APK URL and Advertising ID
  14. Fill in a dummy URL if APK is not ready, change it later through Edit
  15. Add extra parameters in tracking link



  16. Go to Setup Events Postback
  17. Select If you wish to send Install Postback for Campaign Normally and in case of Fraud
  18. Select If you wish to send Event Postback for Campaign and in case of Fraud
  19. Configure in-app events which will be sent to the publisher. Enter the publisher event token as event value



  20. Create the campaign
  21. The Tracking Link and Impression Link can be copied from Campaign details shown in next page after creation
    Copy the Channel details for both type of Offline Campaigns. Copy the Campaign id details for "OEM Store/Side-Load Campaign"



  22. APK changes for Offline Tracking
    OEM Store/Side-Load Campaign:
    1. Create the string ChannelName using Channel and campaign details copied
    2. Where ChannelName = ChannelName_offlinewd_CampaignId
    3. Pass the following String as parameter in AdGyde.init(this, "Your Appkey", "ChannelName_offlinewd_CampaignId") function
      e.g. AdGyde.init(this, "Your Appkey", "Loopback_offlinewd_125");
    4. Replace the above line in application and create Hardcoded APK

    Online APK Campaigns:
    1. Create the string ChannelName using Channel details copied
    2. Where ChannelName = ChannelName_offline
    3. Pass the following String as parameter in AdGyde.init(this, "Your Appkey", "ChannelName_offline") function
      e.g. AdGyde.init(this, "Your Appkey", "Loopback_offline");
    4. Replace the above line in application and create Hardcoded APK

  23. Upload the APK at some location and create a direct downloadable link for the APK. Check by clicking the created link and APK should start downloading directly
  24. Edit the campaign and set the new APK URL in the tracking link parameters section in channel configuration
  25. Copy the tracking link from the campaign details page
  26. The created link is now ready to be shared with your partner for running the campaign.

Offline Campaign Install Test
  1. Please start testing using a fresh device on which the application was never installed before or use a whitelisted device.
  2. Make sure that the application you are installing has the AdGyde SDK integrated
  3. Launch the application after install and use for few seconds
  4. AdGyde dashboard should now show the installation conversion under ‘non-organic‘.

Note: The name of the partner / Channel and Campaign Id set in AdGyde.init(this, "app-Key", "channel_offlinewd_campaignid") should be exactly as the name entered during Campaign creation in AdGyde Dashboard.

package com.adgyde.example;

import android.app.Application;
import android.util.Log;

import com.adgyde.android.AdGyde;

public class ExampleApplication extends Application implements Constants {
@Override
public void onCreate() {
super.onCreate();
Log.d(TAG, "ExampleApplication.onCreate()");
// Initialize AdGyde SDK with appkey & default channel id.
// SDK will use default channel id if no INSTALL_REFERRER being sent by Google Play Service.
// This case only will happen in debug. (Install APK to phone with adb.)
AdGyde.init(this, "app-key", "Loopback_offlinewd_125");
AdGyde.setDebugEnabled(false);
}
}

This website uses cookies in order to improve your experience and our services. By continuing to use our website, agree to the use of such cookies. Click here for Privacy Policy.