Getting Campaign Data

The AppTrove Andriod SDK provides methods to retrieve campaign-related data associated with an install, such as ad details, campaign IDs, and click information. This data is useful for analytics, attribution, and personalized user experiences. Use these methods to access campaign data and track events, such as updates or purchases, with custom parameters.

Overview

Campaign data includes details about how a user arrived at your app (e.g., via a campaign link like https://trackier58.u9ilnk.me/d/PGJ2m4NtPd). The SDK offers functions to retrieve this data:

• Purpose: Access attribution details (e.g., ad, campaign, click ID) for analytics or event tracking.
• Use Case: Log campaign data when a user performs an action (e.g., updates their profile) and track it as an event with revenue.
• Key Methods: TrackierSDK.getAd(), TrackierSDK.getCampaign(), TrackierSDK.getClickId(), etc.

Example Data:

• ad: Ad name from the campaign.
• campaign: Campaign name.
• clickId: Unique click identifier.
• dlv: Deep link value (e.g., standard).

Implementation

Java

package com.example.myapp

import android.os.Bundle;
import android.util.Log;
import android.view.View;
import androidx.appcompat.app.AppCompatActivity;
import com.trackier.sdk.TrackierEvent;
import com.trackier.sdk.TrackierSDK;
import com.example.myapp.databinding.ActivityMainBinding;

public class MainActivity extends AppCompatActivity {

    private ActivityMainBinding binding;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        binding = ActivityMainBinding.inflate(getLayoutInflater());
        setContentView(binding.getRoot());

        binding.btnEventTrack.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                // Create event
                TrackierEvent event = new TrackierEvent(TrackierEvent.UPDATE);
                event.param1 = "Profile Update";
                event.revenue = 0.5;
                event.currency = "USD";

                // Retrieve campaign data
                String ad = TrackierSDK.getAd();
                String adId = TrackierSDK.getAdID();
                String campaign = TrackierSDK.getCampaign();
                String campaignId = TrackierSDK.getCampaignID();
                String adSet = TrackierSDK.getAdSet();
                String adSetId = TrackierSDK.getAdSetID();
                String channel = TrackierSDK.getChannel();
                String p1 = TrackierSDK.getP1();
                String p2 = TrackierSDK.getP2();
                String p3 = TrackierSDK.getP3();
                String p4 = TrackierSDK.getP4();
                String p5 = TrackierSDK.getP5();
                String clickId = TrackierSDK.getClickId();
                String dlv = TrackierSDK.getDlv();
                String pid = TrackierSDK.getPid();
                String isRetargeting = TrackierSDK.getIsRetargeting();

                // Log campaign data
                Log.d("TrackierSDK", "Campaign Data: ad=" + ad + ", adId=" + adId +
                        ", campaign=" + campaign + ", campaignId=" + campaignId +
                        ", adSet=" + adSet + ", adSetId=" + adSetId +
                        ", channel=" + channel + ", p1=" + p1 + ", p2=" + p2 +
                        ", p3=" + p3 + ", p4=" + p4 + ", p5=" + p5 +
                        ", clickId=" + clickId + ", dlv=" + dlv +
                        ", pid=" + pid + ", isRetargeting=" + isRetargeting);

                // Track event
                TrackierSDK.trackEvent(event);
                Log.d("TrackierSDK", "Event tracked: " + event.eventId);
            }
        });
    }
}

Kotlin

package com.example.myapp

import android.os.Bundle
import android.util.Log
import androidx.appcompat.app.AppCompatActivity
import com.example.myapp.databinding.ActivityMainBinding
import com.trackier.sdk.TrackierEvent
import com.trackier.sdk.TrackierSDK

class MainActivity : AppCompatActivity() {

    private lateinit var binding: ActivityMainBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)

        binding.btnEventTrack.setOnClickListener {
            // Create event
            val event = TrackierEvent(TrackierEvent.UPDATE).apply {
                param1 = "Profile Update"
                revenue = 0.5
                currency = "USD"
            }

            // Retrieve campaign data
            val campaignData = mapOf(
                "ad" to TrackierSDK.getAd(),
                "adId" to TrackierSDK.getAdID(),
                "campaign" to TrackierSDK.getCampaign(),
                "campaignId" to TrackierSDK.getCampaignID(),
                "adSet" to TrackierSDK.getAdSet(),
                "adSetId" to TrackierSDK.getAdSetID(),
                "channel" to TrackierSDK.getChannel(),
                "p1" to TrackierSDK.getP1(),
                "p2" to TrackierSDK.getP2(),
                "p3" to TrackierSDK.getP3(),
                "p4" to TrackierSDK.getP4(),
                "p5" to TrackierSDK.getP5(),
                "clickId" to TrackierSDK.getClickId(),
                "dlv" to TrackierSDK.getDlv(),
                "pid" to TrackierSDK.getPid(),
                "isRetargeting" to TrackierSDK.getIsRetargeting()
            )

            // Log campaign data
            Log.d("TrackierSDK", "Campaign Data: $campaignData")

            // Track event
            TrackierSDK.trackEvent(event)
            Log.d("TrackierSDK", "Event tracked: ${event.eventId}")
        }
    }
}