In-app features

Alongside its tracking capabilities, the SDKs embed some features aimed at Contentsquare users such as SDK Logs.

Implement in-app features

To allow Contentsquare users to enable in-app features, perform these tasks:

Add the custom URL scheme in your app Info
Call the SDK when the app is launched via a deeplink

1. Add the custom URL scheme in your app Info

You have to allow your app to be opened via a custom URL scheme which can be done using one of the following methods:

Xcode

Open your project settings
Select the app target
Select the Info settings
Scroll to URL Types
Set the URL scheme to cs-$(PRODUCT_BUNDLE_IDENTIFIER)

Text editor

Open the Info.plist of your project

Add the following snippet:

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>cs-$(PRODUCT_BUNDLE_IDENTIFIER)</string>
        </array>
    </dict>
</array>

2. Call the SDK when the app is launched via a deeplink

Depending of the project, there are multiple ways to handle the deeplink opening. Choose the method matching your project structure:

In your AppDelegate class, complete or implement the function application(app, open url:, options:) with: Contentsquare.handle(url: url)

In your WindowSceneDelegate class, you need to:

Update func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) with:
```
if let url = connectionOptions.urlContexts.first?.url {
      Contentsquare.handle(url: url)
}
```
Complete or implement func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) with:
```
if let url = URLContexts.first?.url {
    Contentsquare.handle(url: url)
}
```

In the body of your main App struct, add the onOpenURL modifier and call the Contentsquare SDK to handle the URL:

@main
struct MyApp: App {
  var body: some Scene {
    WindowGroup {
      MyView()
        .onOpenURL { url in
          Contentsquare.handle(url: url)
        }
    }
  }
}

Enable in-app features

In-app features can be enabled in different ways:

Scan the QR Code

If you have access to the Contentsquare platform, you can open the in-app features modal from the menu and scan the QR code displayed with your phone.

Take a look at the native documentation for further information.

Alternative methods

We provide alternative methods to enable in-app features especially for iOS Simulator and Android Emulator.

📚 Native Android SDK documentation for Enable in-app features
📚 Native iOS SDK documentation for Enable in-app features

Debugging and Logging

Contentsquare provides Logging capabilities that allow you to see the raw event data logged by your app. This is very useful for validation purposes during the instrumentation phase of development and can help you discover errors and mistakes in your analytics implementation and confirm that all events are being logged correctly.

📚 Native Android SDK documentation for Debugging and Logging
📚 Native iOS SDK documentation for Debugging and Logging

Snapshot Capture

In order to unlock the full data-visualization capabilities of Contentsquare, the SDK provides a way to capture snapshots of your app screens. These snapshots can only be taken by Contentsquare’s users on their device. They are not captured from your end-users device. It means your Personal Data is safe, as long as you use a test user account.

Android
iOS

Follow the Native Android SDK documentation for Snapshot Capture