Adobe Marketing Cloud ios SDK 4.x for Marketing Cloud Solutions

Transcription

1 Adobe Marketing Cloud ios SDK 4.x for Marketing Cloud Solutions

2 Contents ios SDK 4.x for Marketing Cloud Solutions...5 Release Notes for ios SDK 4.x for Marketing Cloud Solutions...6 Getting Started...8 Before You Start...8 Core Implementation and Lifecycle...9 Processing Rules and Context Data...11 Configuration...13 ADBMobile JSON Config...13 Override the ADBMobile JSON Config Path...20 Hit Batching...20 Configuration Methods...20 Analytics...25 Track App States...25 Track App Actions...26 Track App Crashes...28 Timed Actions...28 Visitor Lifetime Value...29 Products Variable...30 Products Variable with Merchandising evars and Product-Specific Events...31 Event Serialization...32 Video Analytics...32 Postbacks...38 Postback Example...39 Analytics Methods...39 Last updated 9/16/2015 ios SDK 4.x for Marketing Cloud Solutions

3 Contents Acquisition...45 Mobile App Acquisition...45 Acquisition Methods...45 Messaging...47 In-App Messaging...47 Push Messaging...48 Location...51 Geo-Location and Points of Interest...51 ibeacon tracking...52 Target...55 Target Methods...55 Marketing Cloud...57 Marketing Cloud Visitor ID...57 Marketing Cloud Visitor ID Service Methods...57 Audience Manager...59 Audience Manager Methods...59 Lifecycle Metrics...61 Extensions...66 ios Extension Implementation...66 ios SDK Reference...68 App IDs...68 ios Device Versions...68 Visitor Tracking Between an App and a Web View...70 Opt-Out and Privacy Settings...72 Last updated 9/16/2015 ios SDK 4.x for Marketing Cloud Solutions

4 Using Bloodhound to Test Mobile Applications...73 PhoneGap Plug-in...74 PhoneGap Plug-in Methods x Migration Guide...81 Documentation Updates...86 Historical Release Notes...88 Contact and Legal Information...90 Last updated 9/16/2015 ios SDK 4.x for Marketing Cloud Solutions

5 ios SDK 4.x for Marketing Cloud Solutions 5 ios SDK 4.x for Marketing Cloud Solutions ios SDK 4.x for Marketing Cloud Solutions lets you measure native Apple iphone and ipad applications, deliver targeted content within your apps, and leverage and collect audience data through Audience Manager. Last Update: September 17, 2015 Version 4.6 of the SDK is now available! See Release Notes for ios SDK 4.x for Marketing Cloud Solutions. This SDK supports ios 5 or later. Note: In version 4.2 of this SDK and later, all hits are now sent using HTTP POST. This has no impact on the data that is collected or reported, but you'll need to use a packet analyzer that supports inspecting POST data to view hits, such as Bloodhound. If you are upgrading from a previous version (2.x or 3.x), see the 4.x Migration Guide. Adobe Mobile Services Adobe Mobile services provides a new UI that brings together mobile marketing capabilities for mobile applications from across the Adobe Marketing Cloud. Initially, the Mobile service provides seamless integration of app analytics and targeting capabilities from the Adobe Analytics, Adobe Audience Manager, and Adobe Target solutions, and Marketing Cloud Visitor ID Service. Learn more at Adobe Mobile services documentation.

6 Release Notes for ios SDK 4.x for Marketing Cloud Solutions 6 Release Notes for ios SDK 4.x for Marketing Cloud Solutions Release notes and known issues for ios SDK 4.x for Marketing Cloud Solutions. This section contains the following information: Current Release Notes Marketing Cloud Release Notes, Documentation Updates, and Historical Release Notes Current Release Notes The ios SDK version 4.6 (September 17, 2015) includes the following changes: Feature Push Messaging to Analytics Segments Adobe Mobile Services and the Adobe Mobile SDK allow you to send push messages to Analytics segments. The SDK also allows you to easily report users that have opened your app as a result of opening the push message. See Push Messaging. Acquisition Methods Allows developers to start an app acquisition campaign as if the user had clicked a link. This is helpful for creating manual acquisition links and handling the app store redirect yourself. See Acquisition Methods. Postbacks Postbacks let you send data collected by the SDK to a separate third-party server. Leveraging the same triggers and traits you use to display an in-app message, you can configure the SDK to send customized data to a third-party destination. See Postbacks. Identifiers Added the following new identifiers: The setpushidentifier method in Configuration Methods. The setadvertisingidentifier method in Configuration Methods. The trackpushmessageclickthrough method in Analytics Methods. Marketing Cloud Release Notes, Documentation Updates, and Historical Release Notes In addition to the notes for each release, the following resources provide additional information: Resource Marketing Cloud Release Notes View the latest release notes for the Adobe Marketing Cloud solutions. Documentation Updates View detailed information about updates to this guide that might not be included in these release notes.

7 Release Notes for ios SDK 4.x for Marketing Cloud Solutions 7 Resource Historical Release Notes View information about new features and enhancements in previous releases of ios SDK 4.x for Marketing Cloud Solutions.

8 Getting Started 8 Getting Started Information to help you get starting with the ios SDK for Marketing Cloud Solutions Before You Start Complete these steps to configure a report suite to collect app data. If you are an Analytics administrator: Complete the steps in Set up your App in Adobe Mobile Services to configure a report suite to collect mobile app data. After you complete these steps, create an Analytics account for each app developer and give them access to view the report suite(s) you created. If you are an app developer: Send a link to this page to your Analytics administrator and ask him or her to complete these steps. After the report suite is configured, your administrator will provide you with a login you can use to complete steps in Download the SDK and Testing Tools. This section contains the following information: Set up your App in Adobe Mobile Services Download the SDK and Testing Tools Set up your App in Adobe Mobile Services Note: You must be an Analytics Administrator to complete these steps. Adobe Mobile services is the primary reporting interface for mobile app analytics and targeting. After you complete these steps you can download a configuration file that is pre-configured with your data collection server, report suite, and many other settings. First, sign in at Two ways exist for you to sign in: Marketing Cloud: Sign in to the Marketing Cloud with your Adobe ID. This method assumes that your company has been provisioned in the Marketing Cloud, and you have linked your Analytics account. (If you are unsure, use your existing Adobe Analytics account.) Adobe Analytics: Click Sign in with Analytics provide your Analytics company, username, and password. Complete the following steps to set up a new report suite to collect app data and to define an app in Adobe Mobile services. 1. Click the Create New App button. (If you don't see this button, click Manage Apps > Add instead.) 2. From the Report Suite drop-down, select New Report Suite. 3. Provide the name of your App and select a unique report suite ID, for example, mycomobileappdev. Note that you'll need to set up separate report suites and apps for the development and production versions, so you can repeat these steps when you are ready to set up the production version. 4. Leave Mobile App Template selected. This template enables timestamps to collect offline data and activates the mobile solution variables to capture lifecyle metrics. 5. Select your Timezone and Currency, and then click Save. Download the SDK and Testing Tools After an Analytics Administrator has completed the previous steps, complete the following to download the mobile SDKs. 1. Browse to and log-in the with the account your administrator created for you. 2. Select your App from the drop-down list in the left navigation. 3. Click the Gear icon to open the App configuration.

9 Getting Started 9 4. Scroll to bottom of the page and download the SDK, Bloodhound, and the Sample App for your platform. A config file for your App is included in the SDK download automatically, so you don't need to download that separately unless you have already downloaded the SDK and you just want to get updated settings. Core Implementation and Lifecycle Information to help you implement the ios library and collect lifecyle metrics (launches, upgrades, sessions, engaged users, and so on). This section contains the following information: Get the SDK Add the SDK and Config File to your Project Implement Lifecycle Metrics Get the SDK Requires ios 5 or later Complete the steps in Before You Start to set up a development report suite and download a pre-populated version of the configuration file. After unzipping the [Your_App_Name_]AdobeMobileLibrary-4.*-iOS.zip download file, you'll have the following software components: ADBMobile.h: The Objective-C header file used for ios AppMeasurement. AdobeMobileLibrary.a: a fat binary containing the library builds for devices (armv7, armv7s, arm64) as well as the simulator(i386/x86_64). ADBMobileConfig.json: SDK configuration file customized for your app. Note: If you download the SDK outside of the Adobe Mobile services UI, the ADBMobileConfig.json must be manually configured. If you are new to Analytics and the mobile SDK, we highly recommend using the steps in Before You Start to set up a development report suite and download a pre-populated version of the configuration file. Configuration is not difficult, but it can be a source of frustration when you are getting started. Add the SDK and Config File to your Project 1. Launch the Xcode IDE and open your app. 2. Drag the ADBMobileConfig.json to your project. 3. Drag the AdobeMobile folder into your Xcode project, and confirm the following settings: Select Copy items into destination group's folder (if needed). Select Create groups for any added folders. Select the targets where you want to use AppMeasurement code.

10 Getting Started In the Build Phases tab of your project s target, expand the Link Binary with Libraries section and add the following libraries: libsqlite3.dylib SystemConfiguration.framework 5. Drag the ADBMobileConfig.json to your project. 6. Confirm that your app builds without unexpected errors. Implement Lifecycle Metrics After you enable lifecycle, each time your app is launched, a single hit is sent to measure launches, upgrades, sessions, engaged users, and many other Lifecycle Metrics. Add a collectlifecycledata/collectlifecycledatawithadditionaldata call in application:didfinishlaunchingwithoptions: - (BOOL)application:(UIApplication *)application didfinishlaunchingwithoptions:(nsdictionary *)launchoptions { [ADBMobile collectlifecycledata]; return YES; Including Additional Data with Lifecycle Calls To include additional data with lifecycle metric calls, use collectlifecycledatawithadditionaldata: - (BOOL)application:(UIApplication *)application didfinishlaunchingwithoptions:(nsdictionary *)launchoptions { NSMutableDictionary *contextdata = [NSMutableDictionary dictionary]; [contextdata setobject:@"game" forkey:@"myapp.category"];

11 Getting Started 11 [ADBMobile collectlifecycledatawithadditionaldata:data:contextdata]; return YES; Additional context data values that are sent with collectlifecycledatawithadditionaldata must be mapped to custom variables in Adobe Mobile services: Other Lifecycle Metrics are collected automatically. What to do next: Track App States Track App Actions Processing Rules and Context Data Resources to help you use processing rules effectively. Processing rules are used to copy the data you send in context data variables to evars, props, and other variables for reporting. Processing Rules Summit 2013 Processing Rules Help Become authorized to use Processing Rules We recommend grouping your context data variables using "namespaces", as it helps you keep logical ordering. For example, if you want to collect info about a product, you might define the following variables: "product.type":"hat" "product.team":"mariners" "product.color":"blue" Context data variables are sorted alphabetically in the processing rules interface, so namespaces let you quickly see variables that are in the same namespace. Also, we have heard that some of you are naming context data keys using the evar or prop number: "evar1":"jimbo" This might make it slightly easier when you perform the one time mapping in processing rules, but you lose readability during debugging and future code updates can be more difficult. Instead, we strongly recommend using descriptive names for keys and values: "username":"jimbo"

12 Getting Started 12 Context variables that define counter events can have the same key and value: "logon":"logon" Context data variables that define incrementor events can have the event as the key and the amount to increment as the value: "levels completed":"6" Note: Adobe reserves the namespace "a.". Aside from that small restriction, context data variables just need to be unique in your login company to avoid collisions.

13 Configuration 13 Configuration Information to help you configure the ios SDK, including JSON configuration, hit batching, and SDK methods. ADBMobile JSON Config Information to help you use the ADBMobile JSON Config file. ADBMobileConfig.json Config File Reference The same config file can be used for your app across multiple platforms. ios: The ADBMobileConfig.json can be placed anywhere that it is accessible in your bundle. Android: The ADBMobileConfig.json must be placed in the assets folder. Variable acquisition backdatesessioninfo batchlimit Minimum SDK Version Enables mobile app acquisition. server - Acquisition server that is checked at the initial launch for an acquisition referrer. appid - Generated ID that uniquely identifies this app on the acquisition server. If this section is missing, you need to enable Mobile App acquisition and then re-download the SDK configuration file. See also: referrertimeout Enables/disables the ability for the Adobe SDK to backdate session info hits. Session info hits currently consist of crashes and session length. The default is false. When enabled, the Adobe SDK will backdate the session info hit to 1 second after the last hit of the previous session. This means that crashes and session data will correlate with the correct date in which they happened. This does, however, have a side effect in which it might create a visit for the backdated hit. One hit will be backdated on every new launch of the application. Be aware that backdated session hit information is sent in a session info server call. Additional server calls may apply. When disabled, the Adobe SDK will attach the session info to the current lifecycle. Threshold for number of hits to be sent in consecutive calls. For example, if batchlimit is set to 10, each hit prior to the 10th hit will be stored in the queue. Once the 10th hit comes in, all 10 hits will be sent consecutively Default: 0 (Batching not enabled) Requires offlineenabled = true

14 Configuration 14 Variable charset clientcode lifecycletimeout messages offlineenabled Minimum SDK Version Defines the character set you are using for the data sent to Analytics. The charset is used to convert incoming data into UTF-8 for storage and reporting. See Using the charset Property. (Required by Target) Your assigned client code. Default: 300 seconds Specifies the length of time, in seconds, that must elapse between app launches before the launch is considered a new session. This timeout also applies when your application is sent to the background and reactivated. The time that your app spends in the background is not included in the session length. Generated automatically by Adobe Mobile services, defines the settings for in-app messaging. For details, see Messages description. When enabled, hits are queued while the device is offline and sent later when the device is online. Your report suite must be timestamp-enabled to use offline tracking. Default: false Important: If timestamps are enabled on your report suite, your offlineenabled configuration property must be true. if your report suite is not timestamp enabled, your offlineenabled configuration property must be false. If this is not configured correctly, data will be lost. If you are not sure if a report suite is timestamp enabled, contact Customer Care or download the configuration file from Adobe Mobile services. org poi If you are currently reporting AppMeasurement data to a report suite that also collects data from JavaScript, you might need to set up a separate report suite for mobile data, or include a custom timestamp on all JavaScript hits using the s.timestamp variable. Specifies the Marketing Cloud org ID for the visitor ID service. Each POI array holds the POI name, latitude, longitude, and radius (in meters) for the area of the point. The POI name can be any string. When a tracklocation call is sent, if the current coordinates are within a defined POI, a context data variable is populated and sent with the tracklocation call. "poi" : [ ] ["san francisco", , ,7000], ["santa cruz", , ,600] Note: Starting in version 4.2, POIs are defined in the Adobe Mobile interface and then synchronized dynamically to the app configuration file. This synchronization requires the analytics.poi setting: analytics.poi : /yourfile.json,

15 Configuration 15 Variable Minimum SDK Version If this is not configured, the ADBMobile.json file must be updated to include this line. See "Before you Start" to download an updated configuration file. postback 4.6 The definition for the "callback" message template is shown below: "payload": { "templateurl": "", // required - will be token-expanded prior to being sent "templatebody": "", // optional - if this length > 0 POST will be used as transport method. This is a base64 encoded blob, which will be decoded and token-expanded prior to being sent. "contenttype": "", // optional - if this is length > 0 and POST type is selected this will be set as the Content-Type header. if this is not supplied for a POST request, the default will be "application/x-www-form-urlencoded" "timeout": 0 // optional - number of seconds to wait before timing out. Default is 2. The payload object in the code is an example payload for a message definition that would go in ADBMobileConfig.json. For more information, see the applicable topic: Android: Postbacks ios: Postbacks privacydefault referrertimeout remotes Default: optedin optedin - hits are sent immediately. optedout - hits are discarded. optunknown - If your report suite is timestamp-enabled, hits are saved until the privacy status changes to opt-in (then hits are sent) or opt-out (then hits are discarded). If your report suite is not timestamp-enabled, hits are discarded until the privacy status changes to opt in. This sets the initial value only. If this value is ever set or changed in code, then the new value is used going forward until it is changed, or the app is uninstalled and then reinstalled. (Required by acquisition) Number of seconds the SDK waits for acquisition referrer data on the initial launch before timeout. If you are using acquisition, we recommend a 5 second timeout. If set to 0 or if not included, the SDK does not wait for acquisition data and acquisition metrics are not tracked. Configured automatically, defines the Adobe hosted endpoints for dynamic configuration files. The last update time of each configuration file is checked against the current version at each launch, and any updates are downloaded and saved. analytics.poi - endpoint for hosted POI configuration.

16 Configuration 16 Variable rsids server ssl Minimum SDK Version messages - endpoint for hosted in-app message configuration. (Required by Analytics) One or more report suites to receive Analytics data. Multiple report suite IDs should be comma-separated with no space between. "rsids" : "rsid" "rsids" : "rsid1,rsid2" (Required by Analytics and/or Audience Management). Analytics or Audience Management server, based on the parent node. This variable should be populated with the server domain, without an " or protocol prefix. The protocol prefix is handled automatically by the library based on the ssl variable. If ssl is true, a secure connection is made to this server. If ssl is false, a non-secure connection is made to this server. Default: false Enables (true) or disables (false) sending measurement data via SSL (HTTPS). The definition for the "callback" message template is shown below: "payload": { "templateurl": "", // required - will be token-expanded prior to being sent "templatebody": "", // optional - if this length > 0 POST will be used as transport method. This is a base64 encoded blob, which will be decoded and token-expanded prior to being sent. "contenttype": "", // optional - if this is length > 0 and POST type is selected this will be set as the Content-Type header. if this is not supplied for a POST request, the default will be "application/x-www-form-urlencoded" "timeout": 0 // optional - number of seconds to wait before timing out. Default is 2. The payload object in the code is an example payload for a message definition that would go in ADBMobileConfig.json. For more information, see the applicable topic: Android: Third-Party Callback ios: Third-Party Callback timeout 4.0 Determines how long Target waits for a response. The following is an example of an ADBMobileConfig.json file: { "version": " T19:18:28.169Z", "marketingcloud" : { "org": "016D5C175213CCA80A490D05@AdobeOrg"

17 Configuration 17, "target": { "clientcode": "", "timeout": 5, "audiencemanager": { "server": "", "acquisition": { "server": "c00.adobe.com", "appid": "10a77a60192fbb628376e1b1daeeb65debf934e2c807e067ceb2963a41b165ee", "analytics": { "rsids": "coolapp", "server": "my.coolapp.com", "ssl": false, "offlineenabled": true, "charset": "UTF-8", "lifecycletimeout": 300, "privacydefault": "optedin", "batchlimit": 0, "referrertimeout": 5, "poi": [ ["san francisco", , ,7000], ["santa cruz", , ,600] ], "messages": [ { "messageid": "cb a a-a889-9dbeb451f8ae", "template": "fullscreen", "payload": { "html": "<!DOCTYPE html><html><head><meta charset=\"utf-8\" /><title></title><style></style></head><body><iframe src=\" frameborder=\"0\"></iframe></body></html>", "showoffline": false, "showrule": "always", "enddate": , "startdate": 0, "audiences": [], "triggers": [ { "key": "pev2", "matches": "eq", "values": [ "AMACTION:custom" ] ] ], "remotes": { "analytics.poi": " "messages": " Messages description The messages node is generated automatically by Adobe Mobile services and typically does not need to be manually changed. The following description is provided for troubleshooting purposes: "messageid"

18 Configuration 18 Generated ID, required "template" "alert", "fullscreen", or "local" required "showoffline" true or false default is false "showrule" "always", "once", or "untilclick" required "enddate" number of seconds since Jan 1, 1970 default is "startdate" number of seconds since Jan 1, 1970 default is 0 "payload" "html" fullscreen template only, required html defining the message "image" fullscreen only, optional url to the image to be used for a fullscreen image "altimage" fullscreen only, optional name of the bundled image to use if the url specified in image is unreachable "title" fullscreen and alert, required title text for a fullscreen or alert message "content" alert and local notification, required

19 Configuration 19 sub-text for an alert message, or notification text for a local notification message "confirm" alert, optional text used in the confirm button "cancel" alert, required text used in the cancel button "url" alert, optional url action to load if the confirm button is clicked "wait" local notification, required amount of time to wait (in seconds) to post the local notification after matching its criteria "audiences" array of objects that defines how the message should be shown "key" variable name to look for in the hit, required "matches" type of matcher used when doing the comparison eq = equals ne = does not equal co = contains nc = does not contain sw = starts with ew = ends with ex = exists nx = does not exist lt = less than le = less than or equals gt = greater than ge = greater than or equals "values" an array of values used to match against the value of the variable named in

20 Configuration 20 key with the matcher type in matches "triggers" same as audiences, but this is the action instead of the audience "key" "matches" "values" Override the ADBMobile JSON Config Path Load a different ADBMobile JSON Config file when the application starts. The [ADBMobile overrideconfigpath:filepath] method enables you to specify the path to a different ADBMobile.json configuration file when the application starts. This method must be called in the applicationdidfinishlaunchingwithoptions method, and the call must occur before any other Marketing Cloud SDK call (before collectlifecycledata). Calling this method with a different path causes a one-time override of the configuration file until the application is closed. NSString *filepath = [[NSBundle mainbundle] pathforresource:@"examplejsonfile" oftype:@"json"]; [ADBMobile overrideconfigpath:filepath]; Hit Batching Hit batching allows applications with offline tracking enabled to hold hits from being sent until the number of hits in the queue pass a configurable limit. Requires SDK version 4.1 or later To enable hit batching, you need to update your ADBMobileConfig.json and specify a value for batchlimit: "analytics": { "batchlimit": 5,... When set to a number higher than 0, the SDK queues the number of hits equal to batchlimit. After this threshold is passed, all hits in the queue are sent. The following methods are used in conjunction with hit batching: trackinggetqueuesize() - Returns an NSUInteger with the number of hits currently in the hit batching queue. trackingsendqueuedhits() - Forces the library to send all hits in the queue no matter how many are currently queued. trackingclearqueue() - Clears all hits from the queue without sending them. : Offline tracking must be enabled to use hit batching. Configuration Methods List of Configuration methods provided by the ios library.

21 Configuration 21 The SDK currently has support for multiple Adobe Marketing Cloud Solutions, including Analytics, Target, Audience Manager, and the Marketing Cloud Visitor ID Service. Method version Returns the current version of the Adobe Mobile library. + (NSString *) version; NSString *libraryversion = [ADBMobile version]; privacystatus Returns the enum representation of the privacy status for current user. ADBMobilePrivacyStatusOptIn - hits are sent immediately. ADBMobilePrivacyStatusOptOut - hits are discarded. ADBMobilePrivacyStatusUnknown - If offline tracking is enabled, hits are saved until the privacy status changes to opt-in (then hits are sent) or opt-out (then hits are discarded). If offline tracking is not enabled, hits are discarded until the privacy status changes to opt in. Default: The default value is set in ADBMobileConfig.json. + (ADBMobilePrivacyStatus) privacystatus; ADBMobilePrivacyStatus privacystatus = [ADBMobile privacystatus]; setprivacystatus: Sets the privacy status for the current user to status. Set to one of the following values: ADBMobilePrivacyStatusOptIn - hits are sent immediately. ADBMobilePrivacyStatusOptOut - hits are discarded. ADBMobilePrivacyStatusUnknown - If offline tracking is enabled, hits are saved until the privacy status changes to opt-in (then hits are sent) or opt-out (then hits are discarded). If offline tracking is not enabled, hits are discarded until the privacy status changes to opt in. + (void) setprivacystatus:(adbmobileprivacystatus)status; [ADBMobile setprivacystatus:adbmobileprivacystatusoptin]; lifetimevalue Returns the lifetime value of the current user. Default: 0 + (NSDecimalNumber *) lifetimevalue; NSDecimalNumber *lifevalue = [ADBMobile lifetimevalue];

22 Configuration 22 Method trackingidentifier Returns the automatically generated visitor identifier. This is an app-specific unique visitor id that is generated by Adobe s servers. If Adobe's servers cannot be reached at the time of generation, then it is generated using Apple's CFUUID. The value is generated on initial launch and then stored and used from that point forward. This ID is preserved between app upgrades, is saved and restored during the standard application backup process, and is removed on uninstall. Note: If your app upgrades from the Marketing Cloud 3.x to 4.x SDK, the previous visitor ID (either custom or automatically generated) is retrieved and stored as the custom user identifier (see useridentifier below). This preserves visitor data between upgrades of the SDK. For new installations on the 4.x SDK, user identifier is nil and tracking identifier is used. + (NSString *) trackingidentifier; NSString *tid = [ADBMobile trackingidentifier]; useridentifier Returns the user identifier if a custom identifier has been set. Returns nil if a custom identifier is not set. Default: nil Note: If your app upgrades from the Marketing Cloud 3.x to 4.x SDK, the previous visitor ID (either custom or automatically generated) is retrieved and stored as the custom user identifier. This preserves visitor data between upgrades of the SDK. For new installations on the 4.x SDK, user identifier is nil until set. + (NSString *) useridentifier; NSString *uid = [ADBMobile useridentifier]; setuseridentifier: Sets the user identifier to identifier. + (void) setuseridentifier:(nsstring *)identifier; [ADBMobile setuseridentifier:@"billybob"]; debuglogging Returns the current debug logging preference. Default: NO + (BOOL) debuglogging;

23 Configuration 23 Method BOOL debugging = [ADBMobile debuglogging]; setdebuglogging: Sets the debug logging preference to debug. + (void) setdebuglogging:(bool)debug; [ADBMobile setdebuglogging:yes]; keeplifecyclesessionalive Indicates to the SDK that your next resume from background should not start a new session, regardless of the value of lifecycle session timeout in your config file. Note: this method is intended to be used for apps that register for notifications while in background and should only be called from your code that runs while your app is in the background. + (void) keeplifecyclesessionalive; [ADBMobile keeplifecyclesessionalive]; collectlifecycledata Indicates to the SDK that lifecycle data should be collected for use across all solutions in the SDK. See Lifecycle Metrics. Note: the preferred location to invoke this method is in application:didfinishlaunchingwithoptions: + (void) collectlifecycledata; [ADBMobile collectlifecycledata]; overrideconfigpath Requires SDK 4.2 Lets you load a different ADBMobile JSON Config file when the application starts. The different configuration is used until the application is closed. + (void) overrideconfigpath:filepath NSString *filepath = [[NSBundle mainbundle] pathforresource:@"examplejsonfile" oftype:@"json"]; [ADBMobile overrideconfigpath:filepath];

24 Configuration 24 Method setpushidentifier Sets the device token for push notifications. Be aware that this method should only be used within the application:didregisterforremotenotificationswithdevicetoken: method. + (void) setpushidentifier:(nsdata *)devicetoken; - (void) application:(uiapplication *)application didregisterforremotenotificationswithdevicetoken:(nsdata *)devicetoken { [ADBMobile setpushidentifier:devicetoken]; setadvertisingidentifier Sets the IDFA in the SDK. IDFA will be sent in lifecycle if it has been set in the SDK. It can also be accessed in Signals (Postbacks). Note: Retrieve the IDFA from Apple APIs only if you are using an ad service. If you retrieve IDFA and are not using it properly, your app might be rejected. + (void) setadvertisingidentifier:(nsstring *)identifier; NSString *idfa = [[[ASIdentifierManager sharedmanager] advertisingidentifier] UUIDString]; [ADBMobile setadvertisingidentifier:idfa];

25 Analytics 25 Analytics Information to help you use the ios SDK with Adobe Analytics. Track App States States are the different screens or views in your application. Each time a new state is displayed in your application (for example, when a user navigates from the home page to the news feed), you should send a track state call. On ios, a state is typically tracked in the viewdidload method of each view. States are not tracked automatically, you must make a call to trackstate. How to Track Prerequisites: Add the library to your project and implement lifecycle. 1. Import the library: #import "ADBMobile.h" 2. Call trackstate to send a hit for this state view: [ADBMobile trackstate:@"login Screen" data:nil]; The "State Name" is reported in the View State variable in Adobe Mobile services, and a view is recorded for each trackstate call. In other Analytics interfaces, View State is reported as Page Name and state views is reported as page views. Sending Additional Data In addition to the "State Name", you can send additional context data with each track action call: NSMutableDictionary *contextdata = [NSMutableDictionary dictionary]; [contextdata setobject:@"logged in" forkey:@"myapp.login.loginstatus"]; [ADBMobile trackstate:@"home Screen" data:contextdata]; Context data values must be mapped to custom variables in Adobe Mobile services: App State Reporting States are typically viewed using a pathing report so you can see how users navigate your app, and which states are viewed most.

26 Analytics 26 Adobe Mobile Services Adobe Analytics Ad hoc analytics View States Report. This report is based on the paths users took through your application. For example, Login > Home > Settings, or Home > Feed. States can be viewed anywhere Pages can be viewed, such as the Pages Report, Page Views report, and Path Reports. States can be viewed anywhere Pages can be viewed using the Page dimension, Page Views metric, Path Reports. Track App Actions Actions are the events that occur in your app that you want to measure. Each action has one or more corresponding metrics that are incremented each time the event occurs. For example, you might track an each for each new subscription, each time an article is viewed, or each time a level is completed. The corresponding metrics for these events would be configured as subscriptions, articles read, and levels completed. Actions are not tracked automatically, you must call trackaction when an event you want to track occurs. How to Track Prerequisites: Add the library to your project and implement lifecycle. 1. Import the library: #import "ADBMobile.h" 2. When the action that you want to track occurs in your app, call trackaction to send a hit for this action: [ADBMobile trackaction:@"myapp.actionname" data:nil]; Note: If the code where you are adding this call might run while the app is in the background (for example, a background data retrieval), call trackactionfrombackground instead of trackaction. 3. In Adobe Mobile services, select your app and click Manage App Settings. 4. Click Manage Variables and Metrics and then click the Custom Metrics tab. 5. Map the context data name defined in your code ("a.action=myapp.actionname" in the example) to a custom event. You can also set a prop to hold all action values by mapping a custom prop with a name like "Custom Actions" and setting the value to 'a.action'.

27 Analytics 27 Sending Additional Data In addition to the action name, you can send additional context data with each track action call: NSMutableDictionary *contextdata = [NSMutableDictionary dictionary]; [contextdata setobject:@"twitter" forkey:@"myapp.social.socialsource"]; [ADBMobile trackaction:@"myapp.socialshare" data:contextdata]; Context data values must be mapped to custom variables in Adobe Mobile services: Track Background Actions If you are tracking an action in code that could potentially run when the app is in the background, call trackactionfrombackground instead of trackaction. The parameters are the same, though trackactionfrombackground contains some additional logic to prevent lifecycle calls from firing when they shouldn't. Action Reporting Interface Adobe Mobile Services Report Action Paths Report. View the order in which actions occur in your app. You can also click Customize on any report to view actions ranked, trended, or in a breakdown report. Apply a filter to view actions for a specific segment. Marketing reports & analytics Custom Event Report. After an action is mapped to a custom event, you can view mobile events similar to all other Analytics events.

28 Analytics 28 Interface Ad hoc analytics Report Custom Event Report. After an action is mapped to a custom event, you can view mobile events similar to all other Analytics events. Track App Crashes Crashes are tracked by detecting that the app enters the backgrounded state before exiting (the app receives the applicationdidenterbackground notification from the OS prior to the app closing). If the app does not enter this state, a crash is sent when the next time the application starts. Timed Actions Timed actions let you measure in-app time and total time between the start and end of an action. The SDK calculates the amount of time in session and the total time (cross-session) it takes for the action to be completed. This can be used to define segments to compare on time to purchase, pass level, checkout flow, and so on. The following metrics are reported for timed actions: Total # of seconds in app between start and end - cross sessions Total # of seconds between start and end (clock time) An optional callback allows you to take additional action when the timed action completes: Run code and add any logic - optional custom logic based on duration results. Add context data prior to passing in durations. Cancel hit and durations not yet sent. How to Track Prerequisites: Add the library to your project and implement lifecycle. 1. Import the library: #import "ADBMobile.h" 2. Call tracktimedactionstart and provide a timed action name and optional context data. [ADBMobile tracktimedactionstart:@"timeuntilpurchase" data:@{@"experiencename" : experience]; 3. (Optional) At any point, you can call tracktimedactionupdate with the timed action name to add additional context data. [ADBMobile tracktimedactionupdate:@"timeuntilpurchase" data:@{@"myapp.imageliked" : imagename]; 4. When the event completes, call tracktimedactionend and pass the timed action name and TimedActionBlock (callback) which will look up all data and calculate durations. Timed event metrics are saved in mobile solution variables for automatic reporting. [ADBMobile tracktimedactionend:@"timeuntilpurchase" logic:nil];

29 Analytics 29 Sending Additional Data In addition to the timed action name, you can send additional context data with the action start and action update calls: [ADBMobile : imagename]; Context data values must be mapped to custom variables in Adobe Mobile services: Examples // Timed Action Start Example [ADBMobile tracktimedactionstart:@"timeuntilpurchase" data:@{@"experiencename" : experience]; // Timed Action Update Example [ADBMobile tracktimedactionupdate:@"timeuntilpurchase" data:@{@"imageliked" : imagename]; // Timed Action End Example [ADBMobile tracktimedactionend:@"timeuntilpurchase" logic:nil]; // Timed Action End Example with Callback [ADBMobile tracktimedactionend:@"timeuntilpurchase" logic:^bool(nstimeinterval inappduration, NSTimeInterval totalduration, NSMutableDictionary *data) { [data setobject:@"purchaseitem" forkey:@"item453"]; return YES; //return YES to send the hit, NO to cancel ]; Visitor Lifetime Value Lifetime value lets you measure and target on a lifetime value for each user. Each time you send in a value with tracklifetimevalueincrease, the value is added to the existing value. Lifetime value is stored on device and can be retrieved at any time by calling lifetimevalue. This can be used to store lifetime purchases, ad views, video completes, social shares, photo uploads, and so on. How to Track Prerequisites: Add the library to your project and implement lifecycle.

30 Analytics Import the library: import com.adobe.mobile.*; 2. Call tracklifetimevalueincrease with the amount to increase the value: [ADBMobile tracklifetimevalueincrease:increaseamount data:nil]; Sending Additional Data In addition to the lifetime value, you can send additional context data with each track action call: NSMutableDictionary *contextdata = [NSMutableDictionary dictionary]; [contextdata setobject:imagename forkey:@"myapp.imageliked"]; [ADBMobile tracklifetimevalueincrease:increaseamount data:contextdata]; Context data values must be mapped to custom variables in Adobe Mobile services: Products Variable The products variable cannot be set using processing rules. In the mobile SDK, you must use a special syntax within the context data parameter to set products directly on the server call. To set the products variable, set a context data key to "&&products", and set the value using the syntax defined for the products variable: [contextdata setobject:@"category;product;quantity;price[,category;product;quantity;price]" forkey:@"&&products"]; For example: //create a context data dictionary NSMutableDictionary *contextdata = [NSMutableDictionary dictionary]; // add products, a purchase id, a purchase context data key, and any other data you want to collect. // Note the special syntax for products [contextdata setobject:@";running Shoes;1;69.95,;Running Socks;10;29.99" forkey:@"&&products"]; [contextdata setobject:@" " forkey:@"m.purchaseid"]; [contextdata setobject:@"1" forkey:@"m.purchase"]; // send the tracking call - use either a trackaction or TrackState call. // trackaction example: [ADBMobile trackaction:@"purchase" data:contextdata]; // trackstate example: [ADBMobile trackstate:@"order Confirmation" data:contextdata]; Note that products is set directly on the image request, and the other variables are set as context data:

31 Analytics 31 All context data variables must be mapped using processing rules: You do not need to map the products variable using processing rules since it is set directly on the image request by the SDK. Products Variable with Merchandising evars and Product-Specific Events An example of the products variable with Merchandising evars and product-specific events. //create a context data dictionary NSMutableDictionary *contextdata = [NSMutableDictionary dictionary]; // add products, a purchase id, a purchase context data key, and any other data you want to collect. // Note the special syntax for products [contextdata setobject:@"event1" forkey:@"&&events"]; [contextdata setobject:@";running Shoes;1;69.95;event1=5.5;eVar1=Merchandising,;Running Socks;10;29.99" forkey:@"&&products"]; [contextdata setobject:@" " forkey:@"m.purchaseid"]; [contextdata setobject:@"1" forkey:@"m.purchase"]; // send the tracking call - use either a trackaction or TrackState call. // trackaction example: