- 2 Minutes to read
- Print
- DarkLight
Campaigns
- 2 Minutes to read
- Print
- DarkLight
Campaign tracking is configured in Mapp Q3 ( Configuration > Marketing Configuration). Without this configuration, no campaign information will be collected.
Further information about campaigns can be found in the training chapter Campaign Configuration.
Campaigns can be tracked in both page and event requests.
Parameter Constants
Campaign parameters must be specified in the MICampaignParameters() object. You need to specify the campaign ID when initializing the MICampaignParameters() object.
Parameter | Description | Where to configure (Mapp Q3 > Configuration > ...) | Where to analyze |
---|---|---|---|
campaignId | A campaign ID consists of a media code name and its value, separated by "%3D". | - | Marketing > Campaign > Advertising Media |
mediaCode | If you use media codes as a data source for your campaign tracking, entering their name can raise the accuracy of the measurement. Otherwise, accuracy may be reduced by up to 10% if certain firewalls are used, for example. | Marketing Configuration | - |
oncePerSession | If you only want to track each campaign once within a specific session, you can force this by using this parameter. | - | - |
action | Specifies the action on the campaign. Possible values: click, view Default: click | - | |
customParameters | Campaign parameters can either be entered directly in the page configuration or in the campaign configuration with a target URL along with the media code. Please consult the Deep Linking section if you want to measure campaigns from a deep link in your app. | Custom Parameters > Campaign Parameters > Create new Custom Parameter > Preconfigured > Own Configuration |
Methods for Campaigns
Campaigns can be tracked in both page and event requests.
Example iOS
Please note that custom parameters are optional in the request.
Define all event information you want to track:
let campaignProperties = MICampaignParameters("email.newsletter.nov2020.thursday") campaignProperties.mediaCode = "abc" campaignProperties.oncePerSession = true campaignProperties.action = .view campaignProperties.customParameters = [12: "camParam1"] let event = MIPageViewEvent(name: "TestCampaign") event.campaignParameters = campaignProperties
Call the trackPage method
MappIntelligence.shared()?.trackPage(event)
Full Code Example
@IBAction func testCampaign(_ sender: Any) {
let campaignProperties = MICampaignParameters("email.newsletter.nov2020.thursday")
campaignProperties.mediaCode = "abc"
campaignProperties.oncePerSession = true
campaignProperties.action = .view
campaignProperties.customParameters = [12: "camParam1"]
let event = MIPageViewEvent(name: "TestCampaign")
event.campaignParameters = campaignProperties
MappIntelligence.shared()?.trackPage(event)
}
Define all event information you want to track:
MICampaignParameters* campaignProperties = [[MICampaignParameters alloc] initWith:@"email.newsletter.nov2020.thursday"]; [campaignProperties setMediaCode:@"abc"]; [campaignProperties setOncePerSession:YES]; [campaignProperties setAction:view]; [campaignProperties setCustomParameters:[@{@12 : @"camParam1"} copy]]; MIPageViewEvent* event = [[MIPageViewEvent alloc] initWithName:@"TestCampaign"]; [event setCampaignParameters:campaignProperties];
Call the trackPage method
[[MappIntelligence shared] trackPage:event];
Full Code Example
-(void) testCampaignTracking {
MICampaignParameters* campaignProperties = [[MICampaignParameters alloc] initWith:@"email.newsletter.nov2020.thursday"];
[campaignProperties setMediaCode:@"abc"];
[campaignProperties setOncePerSession:YES];
[campaignProperties setAction:view];
[campaignProperties setCustomParameters:[@{@12 : @"camParam1"} copy]];
MIPageViewEvent* event = [[MIPageViewEvent alloc] initWithName:@"TestCampaign"];
[event setCampaignParameters:campaignProperties];
[[MappIntelligence shared] trackPage:event];
}