analytics-ios-mcvid

A middleware to inject an Adobe Marketing Cloud Visitor IDs to your Segment events. Initialize the middleware with your Adobe Organization ID and DCS Region. A list of DCS Regions can be found here. The middleware makes a call to Adobe's Experience Cloud ID Service to retrieve the Marketing Cloud ID. Documentation on the HTTP request can be found here. If there is an advertisingId present on the device we will sync that ID to the Adobe Marketing Cloud ID. The Adobe Marketing Cloud ID will then be appended to identify, track, screen, and group payloads in the integration specific object.

Example

To run the example project, clone the repo, and run pod install from the Example directory first.

Requirements

Installation

analytics-ios-mcvid is available through CocoaPods. This pod requires version 3.6.0 or higher of the Analytics pod. To install it, simply add the following line to your Podfile:

pod 'Analytics'
pod 'analytics-ios-mcvid'

#import <analytics-ios-mcvid/SEGMCVIDTracker.h>

// Initialize the configuration as you would normally.
SEGAnalyticsConfiguration *configuration = [SEGAnalyticsConfiguration configurationWithWriteKey:@"YOUR_WRITE_KEY"];

// Configure the client with the MCVID middleware to attach Adobe 'marketingCloudId' to your 'identify' payload. Initialize the middleware with your Adobe OrganizationId and Adobe Region (ie. dcs_region key).  
configuration.middlewares = @[ [[SEGMCVIDTracker alloc]  initWithOrganizationId:@"YOUR_ADOBE_ORGID@AdobeOrg" region:@"YOUR_REGION_HERE"] ];

[SEGAnalytics setupWithConfiguration:configuration];

Author

Segment.io, Inc., [email protected]

License

analytics-ios-mcvid is available under the MIT license. See the LICENSE file for more info.