Associate the device with a user
You can associate your own ID to each device. In this way it will be easier and more intuitive for you to work with our tool. For example:
- If your users have been identified, you could use your user ID, or email, or any other data that you are used to working with.
- If your users are anonymous because they have not logged into the app, you may have a Google Analytics or Commscore metric system. You could use the ID provided by these tools.
To make this association between your custom ID (externalId), and the identifier handled by indigitall (deviceId), you have to invoke the setExternalCode method.
Indigitall.setExternalCode(this, "YOUR_EXTERNAL_ID", new DeviceCallback(context) {
@Override
public void onSuccess(Device device) {
//DO SOMETHING
}
@Override
public void onFail(ErrorModel errorModel) {
//LOG ERROR
}
});Indigitall.setExternalCode(this, "YOUR_EXTERNAL_ID", object : DeviceCallback(this) {
override fun onSuccess(device: Device) {
// Do something
}
override fun onFail(errorModel: ErrorModel?) {
// Handle the error
}
})Do not worry about anything. Your IDs are irreversibly encrypted on the phone itself and sent securely to our servers. Not even the indigitall team can know this information.
WiFi filter
If it is required to collect the user's WiFi information, in addition to the configuration of the Indigitall panel, you must add in the manifest the permissions that are exposed below, the service corresponding to the filter and add the parameter wifiFilterEnabled when it is initialize the SDK.
Add the following on the manifest:
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!-- Android 12 Wi-Fi -->
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<application>
<service
android:name="com.indigitall.android.push.services.WifiStatusService"
android:exported="false"
android:permission="android.permission.BIND_JOB_SERVICE" />
<receiver
android:name="com.indigitall.android.push.receivers.WifiWakeLockReceiver"
android:exported="false">
<intent-filter>
<action android:name="AlarmReceiver.Action.NETWORK_ALARM" />
</intent-filter>
</receiver>
</application>
</manifest>And on init:
Configuration config = new Configuration
.Builder("<YOUR-APP-KEY>", "<YOUR-SENDER-ID>")
.wifiFilterEnabled(true)
.build();
Indigitall.init(context, config);val config = Configuration.Builder("<YOUR-APP-KEY>", "<YOUR-SENDER-ID>")
.wifiFilterEnabled(true)
.build()
Indigitall.init(context, config)- Please note that the WiFi scan time when the app is in the background or closed may be inaccurate.
Custom domain
if you are ENTERPRISE CUSTOMER you have to add this parameter in the configuration so that the SDK points to the correct environment:
Configuration config = new Configuration
.Builder("<YOUR-APP-KEY>", "<YOUR-SENDER-ID>")
.setUrlDeviceApi("https://{{cloud}}.device-api.indigitall.com/v1")
.setUrlInboxApi("https://{{cloud}}.inbox-api.indigitall.com/v1")
.build();
Indigitall.init(context, config);
// {{cloud}} = check with our support team which is the value of the variable that corresponds to your accountval config = Configuration.Builder("<YOUR-APP-KEY>", "<YOUR-SENDER-ID>")
.setUrlDeviceApi("https://{{cloud}}.device-api.indigitall.com/v1")
.setUrlInboxApi("https://{{cloud}}.inbox-api.indigitall.com/v1")
.build()
Indigitall.init(context, config)