Skip to content

Commit 41096f4

Browse files
authored
Merge pull request #574 from segmentio/repo-sync
repo sync
2 parents 0bdf64c + 2e563b3 commit 41096f4

File tree

3 files changed

+41
-41
lines changed

3 files changed

+41
-41
lines changed

src/_includes/content/sync-frequency-note.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,6 @@
22
<div class="fa fa-info-circle"></div>
33
<div class="content">
44
<p class="header">Real-time to batch destination sync frequency</p>
5-
<p>Note that real-time audience syncs to {{page.title| replace: "Destination", " "}} may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.</p>
5+
<p>Real-time audience syncs to {{page.title| replace: "Destination", " "}} may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.</p>
66
</div>
77
</div>

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

Lines changed: 34 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -3,32 +3,32 @@ rewrite: true
33
title: Adjust Destination
44
id: 56f6ce7280412f644ff12fb2
55
---
6-
[Adjust](https://adjust.com) is the mobile attribution provider of choice for hundreds of organizations across the globe. They unify all your marketing activities into one powerful platform, giving you the insights you need to scale your business. The Adjust Destination is open-source. You can browse the code on GitHub for [iOS](https://github.com/segment-integrations/analytics-ios-integration-adjust) and [Android](https://github.com/segment-integrations/analytics-android-integration-adjust).
6+
[Adjust](https://adjust.com){:target="_blank"} is the mobile attribution provider of choice for hundreds of organizations across the globe. They unify all your marketing activities into one powerful platform, giving you the insights you need to scale your business. The Adjust Destination is open-source. You can browse the code on GitHub for [iOS](https://github.com/segment-integrations/analytics-ios-integration-adjust){:target="_blank"} and [Android](https://github.com/segment-integrations/analytics-android-integration-adjust){:target="_blank"}.
77

8-
If you notice any gaps, out-dated information or simply want to leave some feedback to help us improve our documentation, [let us know](https://segment.com/help/contact)!
8+
If you notice any gaps, out-dated information, or want to leave feedback to help improve Segment's documentation, [let us know](https://segment.com/help/contact).
99

1010

11-
## Getting Started
11+
## Getting started
1212

1313
{% include content/connection-modes.md %}
1414

1515
1. From the Segment web app, click **Catalog**.
1616
2. Search for "Adjust" in the Catalog, select it, and choose which of your sources to connect the destination to.
17-
3. Do not need to include Adjust's SDK natively as this prevent you from successfully implementing the Adjust.
17+
3. You don't need to include Adjust's SDK natively, as this prevent you from successfully implementing the Adjust.
1818
4. Depending on the source you've selected, include Adjust's library by adding the following lines to your dependency configuration.
1919

2020
### iOS
2121

2222
> info ""
23-
> **Note**: The Adjust SDK requires these [frameworks from Apple](https://github.com/adjust/ios_sdk#add-ios-frameworks) to enable advanced features like attribution. For best results, add these frameworks to your application.
23+
> **Note**: The Adjust SDK requires these [frameworks from Apple](https://github.com/adjust/ios_sdk#add-ios-frameworks){:target="_blank"} to enable advanced features like attribution. For best results, add these frameworks to your application.
2424
25-
If you are using iOS, add this line to your [CocoaPods](http://cocoapods.org) `Podfile`:
25+
If you are using iOS, add this line to your [CocoaPods](http://cocoapods.org){:target="_blank"} `Podfile`:
2626

2727
```ruby
2828
pod "Segment-Adjust"
2929
```
3030

31-
After adding the dependency, you must register the destination with our SDK. To do this, import the Adjust destination in your `AppDelegate`:
31+
After adding the dependency, you must register the destination with Segment's SDK. To do this, import the Adjust destination in your `AppDelegate`:
3232

3333
```objc
3434
#import <Segment-Adjust/SEGAdjustIntegrationFactory.h>
@@ -46,19 +46,19 @@ SEGAnalyticsConfiguration *config = [SEGAnalyticsConfiguration configurationWith
4646

4747
```
4848
49-
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.
49+
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. You can configure this using Segment's 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){:target="_blank"} to set a delay. The maximum delay start time of the Adjust SDK is 10 seconds.
5050
5151
#### Additional device-mode set up for iOS 14 support
5252
5353
Segment's Adjust SDK was updated to use Adjust version 4.23.0 to prepare for iOS 14. The updated Adjust SDK offers iOS 14 support, AppTrackingTransparency (ATT) and SKAdNetwork dashboard features.
5454
55-
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.
55+
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){:target="_blank"} for more information.
5656
57-
To use the latest Adjust SDK to collect IDFAs you must do the following:
57+
To use the latest Adjust SDK to collect IDFAs, you must do the following:
5858
5959
1. Upgrade to use Xcode12.
6060
2. Update your Segment Adjust SDK to version 3.0.0 or later.
61-
The latest SDK has integrated support for the SKAdNetwork, which is enabled by default. For access to the SKAdNetwork, make sure your ad networks are registered with Apple. Adjust automatically registers for SKAdNetwork attribution on SDK initialization, and can handle the conversion value update. You can choose to disable this by calling `[adjustConfig deactivateSKAdNetworkHandling];` on the config object in your `AppDelegate.m` file.
61+
The latest SDK has integrated support for the SKAdNetwork, which is enabled by default. For access to the SKAdNetwork, make sure your ad networks are registered with Apple. Adjust automatically registers for SKAdNetwork attribution on SDK initialization, and can handle the conversion value update.
6262
3. Import and implement the AppTrackingTransparency (ATT) Framework.
6363
Navigate to your project `Info.plist` and add a “Privacy - Tracking Usage Description”. This description appears in a popup when the application initializes in iOS 14. Users are prompted to indicate whether or not they want to allow tracking.
6464
4. Launch an opt-in popup using Adjust's SDK wrapper, built on top of `requestTrackingAuthorizationWithCompletionHandler` for the ATT Framework. An iOS pop-up launches when the wrapper is called the first time. When it is called again, the wrapper retrieves the tracking authorization status, which is sent to the Adjust backend. Adjust relays the information directly to you. The example below shows how to use this wrapper.
@@ -92,7 +92,7 @@ compile 'com.segment.analytics.android.integrations:adjust:+'
9292

9393
```
9494

95-
After adding the dependency, you must register the destination with our SDK. To do this, import the Adjust destination:
95+
After adding the dependency, you must register the destination with Segment's SDK. To do this, import the Adjust destination:
9696

9797
```java
9898
import com.segment.analytics.android.integrations.adjust.AdjustIntegration;
@@ -154,7 +154,7 @@ analytics.identify('12091906-01011992', {
154154
});
155155
```
156156

157-
When you call `identify`, Segment will call Adjust's [addSessionPartnerParameter](https://github.com/adjust/ios_sdk#session-partner-parameters) method and set the `userId` and/or `anonymousId`. This will set these values within Adjust, and allow Adjust to send back attribution data from their servers.
157+
When you call `identify`, Segment will call Adjust's [addSessionPartnerParameter](https://github.com/adjust/ios_sdk#session-partner-parameters){:target="_blank"} method and set the `userId` and/or `anonymousId`. This will set these values within Adjust, and allow Adjust to send back attribution data from their servers.
158158

159159

160160
## Track
@@ -170,16 +170,16 @@ analytics.track('Article Completed', {
170170

171171
When you call `track` Segment maps the event to your pre-defined Adjust custom event. You **must** map your `track` events to your custom Adjust Event Token in your Adjust destination settings.
172172

173-
If you don't provide a mapping, Adjust cannot accept the event. We include all the event `properties` as callback parameters on the Adjust event, and automatically translate `revenue` and `currency` to the appropriate Adjust event properties based on our [spec'd properties](/docs/connections/spec/track/#properties).
173+
If you don't provide a mapping, Adjust cannot accept the event. Segment includes all the event `properties` as callback parameters on the Adjust event, and automatically translate `revenue` and `currency` to the appropriate Adjust event properties based on Segment's [spec'd properties](/docs/connections/spec/track/#properties).
174174

175175

176176
## Install Attributed
177177

178178
### Client
179179

180-
Segment will trigger an `Install Attributed` event if you have **trackAttributionData** enabled in your settings, and the Segment-Adjust integration installed in your app.
180+
Segment will trigger an `Install Attributed` event if you have **trackAttributionData** enabled in your settings and the Segment-Adjust integration installed in your app.
181181

182-
Using Adjust's [Attribution callback](https://github.com/adjust/ios_sdk#attribution-callback), Segment listens for an attribution change from Adjust's SDK and triggers the call with the following Adjust attribution parameters:
182+
Using Adjust's [Attribution callback](https://github.com/adjust/ios_sdk#attribution-callback){:target="_blank"}, Segment listens for an attribution change from Adjust's SDK and triggers the call with the following Adjust attribution parameters:
183183

184184
| Key | Value | Description |
185185
| ------------------- | ------------------------ | -------------------------------------------------- |
@@ -203,50 +203,50 @@ Since there will not be a change in attribution for registered testing devices y
203203
To do so:
204204
1. Take note of the IDFA/advertisingId (you can find this in the raw view of an event in your Segment debugger)
205205
2. Uninstall the app from your device
206-
3. Delete the `IDFA`/`advertisingId` from [Adjust's testing console](https://docs.adjust.com/en/testing-console/)
207-
4. Re-install the app on the device and you should now see the device register in Adjust and an `Install Attributed` triggered.
206+
3. Delete the `IDFA`/`advertisingId` from [Adjust's testing console](https://docs.adjust.com/en/testing-console/){:target="_blank"}.
207+
4. Re-install the app on the device. You should now see the device register in Adjust and an `Install Attributed` triggered.
208208

209209
### Server
210210

211211
Unlike the Device-mode option to send `Install Attributed` to Segment, the Cloud-mode option will not include device context information nor will it be sent to enabled device mode destinations.
212212

213-
If you are bundling the Segment-Adjust integration and would like attribution data sent from Adjust's servers back to Segment, you can [enable Segment as a Special Partner in Adjust](https://docs.adjust.com/en/special-partners/segment/#sending-partner-parameters-to-segment). Once set up, Install Attributed will be sent to Segment, and on to enabled Cloud-mode destinations.
213+
If you are bundling the Segment-Adjust integration and would like attribution data sent from Adjust's servers back to Segment, you can [enable Segment as a Special Partner in Adjust](https://docs.adjust.com/en/special-partners/segment/#sending-partner-parameters-to-segment){:target="_blank"}. Once set up, Install Attributed will be sent to Segment, and on to enabled Cloud-mode destinations.
214214

215-
contact the Adjust team at `[email protected]` for questions related to enabling Segment as a Adjust Special Partner.
215+
Contact the Adjust team at `[email protected]` for questions related to enabling Segment as a Adjust Special Partner.
216216

217217

218-
## Additional Features
218+
## Additional features
219219

220220
### Environments
221221

222-
By default, our destination sends data to the Adjust Sandbox Environment. When you release your app to the App Store, enable the `Production` option in the Adjust destination settings on Segment (or use two separate sources, one for dev and one for prod, with different environment settings for Adjust).
222+
By default, Segment's destination sends data to the Adjust Sandbox Environment. When you release your app to the App Store, enable the `Production` option in the Adjust destination settings on Segment (or use two separate sources, one for dev and one for prod, with different environment settings for Adjust).
223223

224-
### Callback Parameters
224+
### Callback parameters
225225

226-
The destination sends all event `properties` as callback parameters to Adjust. To set [Partner Parameters](https://github.com/adjust/ios_sdk#partner-parameters), you can [access the Adjust SDK directly](https://docs.adjust.com/en/special-partners/segment/).
226+
The destination sends all event `properties` as callback parameters to Adjust. To set [Partner Parameters](https://github.com/adjust/ios_sdk#partner-parameters){:target="_blank"}, you can [access the Adjust SDK directly](https://docs.adjust.com/en/special-partners/segment/){:target="_blank"}.
227227

228-
**Note** that we now support setting these Partner Parameters. Be sure you are pulling in the minimum versions for [iOS 1.1.0](https://github.com/segment-integrations/analytics-ios-integration-adjust/blob/master/CHANGELOG.md#version-110-6th-july-2017) and [Android 0.3.0](https://github.com/segment-integrations/analytics-android-integration-adjust/blob/master/CHANGELOG.md#version-030-6th-july-2017).
228+
Segment supports setting these Partner Parameters. Be sure you are pulling in the minimum versions for [iOS 1.1.0](https://github.com/segment-integrations/analytics-ios-integration-adjust/blob/master/CHANGELOG.md#version-110-6th-july-2017){:target="_blank"} and [Android 0.3.0](https://github.com/segment-integrations/analytics-android-integration-adjust/blob/master/CHANGELOG.md#version-030-6th-july-2017){:target="_blank"}.
229229

230-
### Transaction Deduplication
230+
### Transaction deduplication
231231

232232
The destination will automatically recognize the spec'd `orderId` property, and send it as the transaction ID to Adjust for revenue de-duplication.
233233

234-
### Duplicate Purchase Events
234+
### Duplicate purchase events
235235

236-
If you're using Adjust's iOS SDK, it will automatically takes care of duplicate purchase events. We use Adjust's default deduplication (using `transactionId`) when you send an `orderId` (see the [ecommerce spec](/docs/connections/spec/ecommerce/v2/#order-completed)).
236+
If you're using Adjust's iOS SDK, it will automatically takes care of duplicate purchase events. Segment uses Adjust's default deduplication (using `transactionId`) when you send an `orderId` (see the [ecommerce spec](/docs/connections/spec/ecommerce/v2/#order-completed)).
237237

238-
### In-App Purchase Receipts
238+
### In-app purchase receipts
239239

240-
The destination does not currently support in-app purchase receipts. If this is important to you, [let us know](https://segment.com/help/contact/).
240+
The destination does not currently support in-app purchase receipts. If this is important to you, [reach out to support](https://segment.com/help/contact/).
241241

242-
### Push Notifications
242+
### Push notifications
243243

244244
The destination automatically forwards push notification tokens through to Adjust.
245245

246-
### Event Buffering
246+
### Event buffering
247247

248248
By default, our destination enables event buffering for Adjust. This saves your customers' battery life. However, you can disable this in the options on the Adjust destination settings on Segment.
249249

250-
### Deep Linking
250+
### Deep linking
251251

252-
The destination does not automatically support deep linking out of the box (you'd need to write code here regardless). This means you can use [Adjust's deep-linking](https://github.com/adjust/ios_sdk#7-set-up-deep-link-reattributions) by accessing [the Adjust SDK directly](/docs/connections/sources/catalog/libraries/mobile/ios/#faq).
252+
The destination does not automatically support deep linking out of the box (you'd need to write code here regardless). This means you can use [Adjust's deep-linking](https://github.com/adjust/ios_sdk#7-set-up-deep-link-reattributions){:target="_blank"} by accessing [the Adjust SDK directly](/docs/connections/sources/catalog/libraries/mobile/ios/#faq).

0 commit comments

Comments
 (0)