Settings for Pre-Loaded Apps | TUNE Docs (Legacy)

To attribute pre-loaded apps, the TUNE SDK provides a setter method for sending (or “hard-coding”) the partner info for attribution and subsequent postbacks. If multiple partners are pre-loading your mobile app, then you can create a partner-specific build of your app for distribution to each publishing partner (where each build includes different partner settings, respective to the particular partner). The partner-specific build is what the partner pre-loads onto the desired devices.

For information about more custom setter methods, please visit the Custom SDK Settings.

Preferred Platform and Version and Version and Version and Version

// Required setter
void setPreloadedApp(TunePreloadData preloadData);

+ (void)setPreloadData:(TunePreloadData *)preloadData;

public static void SetPreloadedApp(MATPreloadData preloadData)

Select a preferred platform.

public class MyApplication extends TuneApplication {
 
    @Override
    public void onCreate() {
        super.onCreate();
 
        // Initialize TUNE
        Tune tune = Tune.init(getApplicationContext(), "your_advertiser_ID", "your_conversion_key");
 
        // On first app open, set pre-loaded values
        // You will need to determine some criteria for this
        if (firstAppOpen) {
            TunePreloadData preloadData = new TunePreloadData("your_publisher_id") // Required
                             .withOfferId("your_offer_id") // Rest are optional
                             .withAgencyId("your_agency_id")
                             .withPublisherReferenceId("your_publisher_ref_id")
                             .withPublisherSub1("your_pub_sub1")
                             .withPublisherSub2("your_pub_sub2")
                             .withPublisherSub3("your_pub_sub3")
                             .withPublisherSub4("your_pub_sub4")
                             .withPublisherSub5("your_pub_sub5")
                             .withPublisherSubAd("your_pub_sub_ad")
                             .withPublisherSubAdgroup("your_pub_sub_adgroup")
                             .withPublisherSubCampaign("your_pub_sub_campaign")
                             .withPublisherSubKeyword("your_pub_sub_keyword")
                             .withPublisherSubPublisher("your_pub_sub_publisher")
                             .withPublisherSubSite("your_pub_sub_site")
                             .withAdvertiserSubAd("your_ad_sub_ad")
                             .withAdvertiserSubAdgroup("your_ad_sub_adgroup")
                             .withAdvertiserSubCampaign("your_ad_sub_campaign")
                             .withAdvertiserSubKeyword("your_ad_sub_keyword")
                             .withAdvertiserSubPublisher("your_ad_sub_publisher")
                             .withAdvertiserSubSite("your_ad_sub_site");
            tune.setPreloadedApp(preloadData);
        }
    }
}

TunePreloadData *pd = [TunePreloadData preloadDataWithPublisherId:@"112233"];
pd.offerId = @"offer_id";
pd.agencyId = @"agency_id";
pd.publisherReferenceId = @"publisher_ref_id";
pd.publisherSub1 = @"pub_sub1";
pd.publisherSub2 = @"pub_sub2";
pd.publisherSub3 = @"pub_sub3";
pd.publisherSub4 = @"pub_sub4";
pd.publisherSub5 = @"pub_sub5";
pd.publisherSubAd = @"pub_sub_ad";
pd.publisherSubAdgroup = @"pub_sub_adgroup";
pd.publisherSubCampaign = @"pub_sub_campaign";
pd.publisherSubKeyword = @"pub_sub_keyword";
pd.publisherSubPublisher = @"pub_sub_publisher";
pd.publisherSubSite = @"pub_sub_site";
pd.advertiserSubAd = @"ad_sub_ad";
pd.advertiserSubAdgroup = @"ad_sub_adgroup";
pd.advertiserSubCampaign = @"ad_sub_campaign";
pd.advertiserSubKeyword = @"ad_sub_keyword";
pd.advertiserSubPublisher = @"ad_sub_publisher";
pd.advertiserSubSite = @"ad_sub_site";
    
[Tune setPreloadData:pd];
[Tune measureSession];

MATPreloadData pd = new MATPreloadData("112233");
pd.offerId = @"offer_id";
pd.agencyId = @"agency_id";
pd.publisherReferenceId = @"publisher_ref_id";
pd.publisherSub1 = @"pub_sub1";
pd.publisherSub2 = @"pub_sub2";
pd.publisherSub3 = @"pub_sub3";
pd.publisherSub4 = @"pub_sub4";
pd.publisherSub5 = @"pub_sub5";
pd.publisherSubAd = @"pub_sub_ad";
pd.publisherSubAdgroup = @"pub_sub_adgroup";
pd.publisherSubCampaign = @"pub_sub_campaign";
pd.publisherSubKeyword = @"pub_sub_keyword";
pd.publisherSubPublisher = @"pub_sub_publisher";
pd.publisherSubSite = @"pub_sub_site";
pd.advertiserSubAd = @"ad_sub_ad";
pd.advertiserSubAdgroup = @"ad_sub_adgroup";
pd.advertiserSubCampaign = @"ad_sub_campaign";
pd.advertiserSubKeyword = @"ad_sub_keyword";
pd.advertiserSubPublisher = @"ad_sub_publisher";
pd.advertiserSubSite = @"ad_sub_site";
    
Tune.SetPreloadedApp(pd);
Tune.MeasureSession();

Select a preferred platform.

Make sure you use the setter ONLY for the first app open event, and not subsequent events/requests and MUST be excluded in the build for Google Play Store submission.

If you include the hard-coded attribution parameters for all measure sessions or other requests, then all requests are attributed accordingly (to the same hard-coded partner, such as AT&T). Therefore re-engagement does not work because the attribution information is already present/set, which prevents the SDK from collecting new attribution data. The following flowchart shows how the attribution parameters should only be set with the first request.

For more conceptual information about how to attribute pre-installed apps, please visit Attributing Pre-Loaded Apps.