Getting Campaign Data
The AppTrove Expo 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.
Overview
Campaign data includes details about how a user arrived at your app (e.g., via a campaign link like https://trackier.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
Here's how to retrieve campaign data in your Expo app:
import { TrackierConfig, TrackierSDK, TrackierEvent } from 'trackier-expo-sdk';
function trackEventWithCampaignData() {
// Create event
const trackierEvent = new TrackierEvent(TrackierEvent.UPDATE);
trackierEvent.param1 = "Profile Update";
trackierEvent.revenue = 0.5;
trackierEvent.currency = "USD";
// Retrieve campaign data
const campaignData = {
ad: TrackierSDK.getAd(),
adId: TrackierSDK.getAdID(),
campaign: TrackierSDK.getCampaign(),
campaignId: TrackierSDK.getCampaignID(),
adSet: TrackierSDK.getAdSet(),
adSetId: TrackierSDK.getAdSetID(),
channel: TrackierSDK.getChannel(),
p1: TrackierSDK.getP1(),
p2: TrackierSDK.getP2(),
p3: TrackierSDK.getP3(),
p4: TrackierSDK.getP4(),
p5: TrackierSDK.getP5(),
clickId: TrackierSDK.getClickId(),
dlv: TrackierSDK.getDlv(),
pid: TrackierSDK.getPid(),
isRetargeting: TrackierSDK.getIsRetargeting(),
};
// Log campaign data
console.log("Campaign Data:", campaignData);
// Track event
TrackierSDK.trackEvent(trackierEvent);
console.log("Event tracked:", trackierEvent.eventId);
}
Available Campaign Data Functions
The SDK provides several functions to retrieve different types of campaign data:
- getAd(): Get the ad name
- getCampaign(): Get the campaign name
- getCampaignID(): Get the campaign ID
- getAdSet(): Get the ad set name
- getAdSetID(): Get the ad set ID
- getChannel(): Get the channel name
- getP1(): Get parameter 1
- getP2(): Get parameter 2
- getP3(): Get parameter 3
- getP4(): Get parameter 4
- getP5(): Get parameter 5
- getClickId(): Get the click ID
- getDlv(): Get the deep link value
- getPid(): Get the partner ID
- getIsRetargeting(): Check if this is a retargeting campaign
Next Steps
After implementing campaign data retrieval:
- Test campaign data retrieval on both Android and iOS devices
- Implement personalization features based on campaign data
- For assistance, contact Trackier support at support@trackier.com