Skip to content

Commit 047fec1

Browse files
author
Brie
committed
Update docs for Adjust, AppsFlyer, and Braze for iOS14 support
1 parent 785f2fe commit 047fec1

File tree

3 files changed

+67
-0
lines changed

3 files changed

+67
-0
lines changed

src/connections/destinations/catalog/adjust/index.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,36 @@ SEGAnalyticsConfiguration *config = [SEGAnalyticsConfiguration configurationWith
4545
4646
In cases where the Adjust integration sometimes does not track the install attribution properly, you can configure a delay for the Adjust reporting to ensure all session parameters have been loaded properly. Segment allows you to configure this using our UI by enabling `setDelay` and providing a `delayTime` in seconds. Segment then calls the [Adjust iOS SDK's configuration](https://github.com/adjust/ios_sdk#delay-start) to set a delay. The maximum delay start time of the Adjust SDK is 10 seconds.
4747
48+
#### Additional Device Mode Setup for iOS 14 Support
49+
Segment’s Adjust SDK has been updated to use Adjust version 4.23.0 as a key way for you to prepare for iOS 14. This updated SDK offers iOS14 support, along with AppTrackingTransparency (ATT) and SKAdNetwork dashboard features.
50+
51+
See Adjust's [Steps to Support iOS 14 documentation](https://help.adjust.com/manage-data/data-privacy/ios-14-user-privacy-frameworks#Steps-to-support-iOS-14) for more information. To utilize the latest Adjust SDK to collect IDFAs you must do the following:
52+
53+
1. Upgrade to using Xcode12.
54+
2. Update your Segment Adjust SDK to version 3.0.0 or greater.
55+
> The latest SDK has integrated support for the SKAdNetwork and is switched on by default. For access to the SKAdNetwork ensure your ad networks are registered with Apple. This means that Adjust will automatically register for SKAdNetwork attribution upon SDK initialization and can handle the conversion value update. You can choose to turn it off by calling [adjustConfig deactivateSKAdNetworkHandling]; on the config object in your AppDelegate.m file.
56+
3. Import and implement the AppTrackingTransparency (ATT) Framework. You will need to navigate to your project `Info.plist` and add a “Privacy - Tracking Usage Description”. This description will be used in the popup when the application initializes in iOS 14. Users will be prompted to indicate whether or not they want to allow tracking.
57+
4. Launch an opt-in pop up via Adjust’s SDK wrapper built on top of `requestTrackingAuthorizationWithCompletionHandler` for the ATT Framework. When the wrapper is called the first time, the iOS pop-up launches. Every time after, the wrapper retrieves the tracking authorization status. This is sent to the Adjust backend, and Adjust relays the information directly to you. Here is an example of how to use this wrapper:
58+
59+
```ios
60+
61+
[Adjust requestTrackingAuthorizationWithCompletionHandler:^(NSUInteger status) {
62+
switch (status) {
63+
case 0:
64+
// ATTrackingManagerAuthorizationStatusNotDetermined case
65+
break;
66+
case 1:
67+
// ATTrackingManagerAuthorizationStatusRestricted case
68+
break;
69+
case 2:
70+
// ATTrackingManagerAuthorizationStatusDenied case
71+
break;
72+
case 3:
73+
// ATTrackingManagerAuthorizationStatusAuthorized case
74+
break;
75+
}];
76+
```
77+
5. Follow [Segment's guide for collecting IDFA](https://segment.com/docs/connections/sources/catalog/libraries/mobile/ios/#idfa-collection-in-40-beta-and-later)
4878

4979
### Android
5080

src/connections/destinations/catalog/appsflyer/index.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,32 @@ This document was last updated on April 27, 2018. If you notice any gaps, outdat
1818

1919
**Important:** If you plan on using the server-side destination for an Android project, make sure to enter your **Android App ID**. If you are using only the mobile SDK, Android projects only require the **AppsFlyer Dev Key**. iOS projects always require both the **AppsFlyer Dev Key** and the **Apple App ID**. Also, note that if you do use the server-side destination, you will not be able to selectively disable calls sent to AppsFlyer using your Segment dashboard.
2020

21+
### Additional Device Mode Setup for iOS 14 Support
22+
Segment’s ApplsFlyer iOS SDK has been updated to use AppsFlyer version 6.0 beta as a key way for you to prepare for iOS 14. The SDK beta is compatible with the beta version of the iOS 14 and supports AppsFlyer's aggregate attribution, and Apple's AppTrackingTransperancy framework, among other functionality. See [AppsFlyer's blog](https://www.appsflyer.com/blog/privacy-centric-attribution-ios14/] written by their CEO, which coverrs their new privacy-centric attribution model.
23+
24+
To utilize the latest AppsFlyer SDK to collect IDFAs you must do the following:
25+
26+
1. Upgrade to using Xcode12.
27+
2. Update your Segment AppsFlyer SDK to version 6.0.2 or greater.
28+
3. Import and implement the AppTrackingTransparency (ATT) Framework. You will need to navigate to your project `Info.plist` and add a “Privacy - Tracking Usage Description”. This description will be used in the popup when the application initializes in iOS 14. Users will be prompted to indicate whether or not they want to allow tracking.
29+
4. Use the following block in your `AppDelegate.m` file on `didFinishLaunchingWithOptions` if you wish for AppsFlyer collect IDFA
30+
31+
```ios
32+
// The following block is for applications wishing to collect IDFA.
33+
// for iOS 14 and above - The user will be prompted for permission to collect IDFA.
34+
// If permission granted, the IDFA will be collected by the SDK.
35+
// for iOS 13 and below - The IDFA will be collected by the SDK. The user will NOT be prompted for permission.
36+
if #available(iOS 14, *) {
37+
// Set a timeout for the SDK to wait for the IDFA collection before handling app launch
38+
AppsFlyerLib.shared().waitForAdvertisingIdentifier(withTimeoutInterval: 60)
39+
// Show the user the Apple IDFA consent dialog (AppTrackingTransparency)
40+
// Can be called in any place
41+
ATTrackingManager.requestTrackingAuthorization { (status) in
42+
}
43+
}
44+
```
45+
5. Follow [Segment's guide for collecting IDFA](https://segment.com/docs/connections/sources/catalog/libraries/mobile/ios/#idfa-collection-in-40-beta-and-later)
46+
2147
### Server
2248

2349
AppsFlyer offers an **augmentative** server-side [HTTP API](https://support.appsflyer.com/hc/en-us/articles/207034486-Server-to-Server-In-App-Events-API-HTTP-API-) intended for use along side their mobile SDK. Use the server-side destination alongside the mobile SDK to associate out-of-app events such as website or offline purchases with attributed users/devices. Read further for more information on this functionality.

src/connections/destinations/catalog/braze/index.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,17 @@ If you notice any gaps or outdated information in this document, or simply want
4747
4848
Braze has created a sample iOS application that integrates Braze using Segment. Check it out at the [Github repo](https://github.com/Appboy/appboy-segment-ios/tree/master/Example).
4949
50+
#### Additional Device Mode Setup for iOS 14 Support
51+
Segment’s Braze SDK has been updated to use AppBoy's version 3.26.1 as a key way for you to prepare for iOS 14. Braze will continue to allow apps to provide a user’s IDFA value to the Braze SDK. The `ABK_ENABLE_IDFA_COLLECTION` macro, which would conditionally compile in optional automatic IDFA collection, will be removed in their iOS 14 release.
52+
53+
See Braze's [iOS 14 SDK Upgrade Guide](https://www.braze.com/docs/developer_guide/platform_integration_guides/ios/ios_14/) for more information. To utilize the latest Braze SDK to collect IDFAs you must do the following:
54+
55+
1. Upgrade to using Xcode12.
56+
2. Update your Segment Appboy SDK to version 3.3.0 or greater.
57+
3. Import and implement the AppTrackingTransparency (ATT) Framework. You will need to navigate to your project `Info.plist` and add a “Privacy - Tracking Usage Description”. This description will be used in the popup when the application initializes in iOS 14. Users will be prompted to indicate whether or not they want to allow tracking.
58+
4. Implement Braze's `ABKIDFADelegate`. For more information on how to implement this see [Braze’s IDFA Collection documentation](https://www.braze.com/docs/developer_guide/platform_integration_guides/ios/initial_sdk_setup/other_sdk_customizations/#implementing-idfa-collection).
59+
5. Follow [Segment's guide for collecting IDFA](https://segment.com/docs/connections/sources/catalog/libraries/mobile/ios/#idfa-collection-in-40-beta-and-later)
60+
5061
### Android
5162
5263
1. In your top-level project `build.gradle` add the following as a repository under allprojects > repositories.

0 commit comments

Comments
 (0)