Merge pull request #427 from segmentio/singular

update singular for device mode

Author: sperand-io

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

@@ -5,6 +5,8 @@ title: Singular Destination
 
 [Singular](https://www.singular.net/?utm_source=segmentio&utm_medium=docs&utm_campaign=partners) is a Marketing Intelligence Platform that transforms marketing data into accurate, granular and actionable insights to drive growth. By unifying marketing campaign data with attribution data, marketers can measure ROI from every touchpoint across multiple channels for a single source of truth.
 
+The destination is available to receive data via Cloud Mode from all platforms and to integrate via Device Mode on Mobile.
+
 This destination is maintained by Singular. For any issues with the destination, please [reach out to Singular Support](mailto:[email protected]).
 
 ## Getting Started
@@ -30,6 +32,9 @@ Enable automatic tracking of lifecycle events (`Application Opened`, `Applicatio
 
 ## Apple Search Ads Attribution
 
+> note "Note"
+> If you are using the Device-Based Destination, there’s no need to implement the code below, as the data is already collected automatically.
+
 To get [iAD attribution](https://searchads.apple.com/help/measure-results/) data into Singular, you must include the [analytics-ios-iads-attribution](https://github.com/segmentio/analytics-ios-iads-attribution) dependency and version 3.6.0 or higher of the [Analytics SDK](https://github.com/segmentio/analytics-ios).
 
 To install it, simply add the following line to your Podfile:
@@ -98,4 +103,22 @@ Analytics.with(context).track("Order Completed", new Properties().putRevenue(1.9
 ```
 
 ## Custom User ID
-Singular has mapped the **Custom User ID** to the Segment [User ID](https://segment.com/docs/connections/spec/identify/#user-id) value. Follow the steps here to configure for: [iOS](https://segment.com/docs/connections/sources/catalog/libraries/mobile/ios/#identify), [Android](https://segment.com/docs/connections/sources/catalog/libraries/mobile/android/#identify).
+For the cloud-mode destination, Singular has mapped the **Custom User ID** to the Segment [User ID](https://segment.com/docs/connections/spec/identify/#user-id) value. Follow the steps here to configure for: [iOS](https://segment.com/docs/connections/sources/catalog/libraries/mobile/ios/#identify), [Android](https://segment.com/docs/connections/sources/catalog/libraries/mobile/android/#identify).
+
+For the device-based destination, Singular’s SDK uses the ​identify​ method to map Segment’s ​User ID​ value to the Custom User ID.
+
+Android example:
+
+```java
+Analytics.with(context).identify("myUserId");
+```
+
+In order to unset the Custom User ID, call the ​reset​ method.
+
+Android example:
+
+```java
+Analytics.with(context).reset();
+```
+
+