Vungle Ad SDK

A collection of Vungle SDKs for download attribution

View the Project on GitHub Vungle/AdvertiserSDK

Vungle Advertiser SDK

This project is a collection of SDKs for iOS and Android that aid download attribution for Vungle's advertisers.

Tracking Downloads

note: If you are already using the iOS or Android publisher SDK, you do not need to track downloads through ways documented in this file. The publisher SDK, if embedded in your app, will automatically do it for you.

How we identify users

OpenUDID

We're using the open source, industry accepted version of UDID, called [https://github.com/ylechelle/OpenUDID OpenUDID]. This identifier is generated on each device, and provides publishers and advertisers a way to track the performance of their campaigns. We will never use the OpenUDID in conjunction with any PII that may compromise your users privacy or security.

iOS

Add a few source files that will easily handle download reporting for you.

VGDownload iOS Module

This module can be added to your iOS application to track app downloads. To use it, drag these four files into your project:

In your application delegate's startup method:

#import "VGDownload.h"
...
-(BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions
    VGReportDownload(@"<app_id>"); 

Event Tracking

Our SDK also helps you capture in-app events. These events can describe a variety of different actions, such as:

To use event tracking, drag VGAnalytics.h and VGAnalytics.m to your project. Then #import "VGAnalytics.h". These events can be defined in your ViewController, like this:

VGAnalytics *analytics = [[VGAnalytics alloc] initWithAppId:@"<app_id>" andSecretKey:@"<secret_key>"];
analytics.delegate = self;
[analytics trackAction:@"User Signed Up"];

After integrating this, you'll see this event appear in the Vungle dashboard in real-time!

Android

  1. Extract the source to your project's workspace
  2. Drop the 'src' folder to your local project
  3. Remove the "Demo.java" from the src if you don't want usage examples.
  4. In your main application class, add the following to the onCreate method:
Vungle.init(this);

Visit your dashboard and check if installs get reported for your app. If you don't see them appear, check if you've set up the correct Application ID in the dashboard.

Server Side API

Please email tech@vungle.com for more information on how a server to server integration can be used for download attribution.

Collaborators