iOS SDK - Data Privacy

Complying with Data Privacy Laws

Singular provides privacy-safeguarding functionality to help you cooperate with any partners who may be complying with consumer privacy laws such as GDPR and CCPA (California Consumer Privacy Act). These partners want to be notified if the end-user has consented to share their private information.

LimitDataSharing

If you have implemented a way to ask users for consent to share their information, use the limitDataSharing method to notify Singular of the user's choice:

  • Use limitDataSharing:NO to indicate that the user consented (opted in) to share their information.
  • Use limitDataSharing:YES if the user did not consent.

Singular uses LimitDataSharing in "User Privacy Postbacks" as well as passing this information on to partners who require it in order to comply with relevant regulations. See "User Privacy and Limit Data Sharing" for more information.

Note: The use of the method is optional, but there may be attribution information that the partner will share with Singular only if specifically notified that the user has opted in.

limitDataSharing Method
Description Notify Singular of user consent (opt-in) for sharing private data. The Limit Data Sharing method gives you an option to control whether your app sends user data to third parties. This is useful if you want to restrict data sharing based on user preferences or privacy requirements.
Signature (void)limitDataSharing:(BOOL)shouldLimitDataSharing;
Usage Example
SwiftObjective-C
// User has opted into sharing data

Singular.limitDataSharing(false) 

Additional Methods for GDPR Compliance

The Singular SDK provides several methods to help you comply with GDPR policies and let Singular know about user consent or non-consent for tracking.

trackingOptIn Method
Description Notify Singular of user consent (opt-in) for tracking. The TrackingOptIn() method is used to send a "gdpr" event to Singular's servers. If you don't call this method, the app will continue tracking users as if they have given consent, but it won't specifically mark them as GDPR opt-in. If your app needs to comply with GDPR (General Data Protection Regulation), you should call this function to ensure that user consent is properly recorded.
Signature (void)trackingOptIn;
Usage Example
SwiftObjective-C
Singular.trackingOptIn() 
stopAllTracking Method
Description Stop all tracking activities for this user on this app.
Signature (void)stopAllTracking;
Usage Example

Important: Calling this method disables the SDK, even between app restarts (the state is persistent). The only way to turn it off is by calling the resumeAllTracking method.

SwiftObjective-C
Singular.stopAllTracking() 
resumeAllTracking Method
Description Resume tracking activities for this user on this app.
Signature (void)resumeAllTracking;
Usage Example
SwiftObjective-C
Singular.resumeAllTracking() 
isAllTrackingStopped Method
Description Check the status of tracking activities for this user on this app.
Signature (BOOL)isAllTrackingStopped;
Usage Example
SwiftObjective-C
Singular.isAllTrackingStopped()