Send MMP Attribution

Host apps can send Mobile Measurement Partner (MMP) data for direct app attribution in the metadata parameter when calling the install() method.

You can send attribution data for the following mobile measurement partners:

• Adjust
• AppsFlyer
• Singular

Direct app attribution requires DTIS SDK version 4.0 or later and Reignite version 21.2 or later on the device. If you are using an older version of either the SDK or Ignite, attribution attempts return as errors.

Bundle Attribution Data

Bundle MMP attribution data and send it in the metadata parameter when calling the install() method.

To bundle MMP data:

1. Create an empty bundle.

Kotlin

val metadataBundle = Bundle()

1. Send attribution data for all apps as SdkConstants.AttributionData constants.

Kotlin

/*
 * Send Attribution data for one App or multiple Apps
 * To send Attribution data for multiple apps, create multiple attributionData objects (attributionDataApp1, attributionDataApp2, etc.)
 */
val attributionDataApp1 = mapOf(
    SdkConstants.AttributionData.MMP_NAME to etMmpNameValue,
    SdkConstants.AttributionData.MMP_PROVIDER to etMmpProviderValue,
    SdkConstants.AttributionData.MMP_TRANSACTION_ID to etMmpTransactionIdValue,
    SdkConstants.AttributionData.MMP_LINK to etMmpLinkValue
)

PARAMETER	DESCRIPTION	SAMPLE DATA	REQUIRED FOR
MMP_NAME	Name of mobile measurement partner.	AppsFlyer Adjust Singular	Yes	Yes	Yes
MMP_PROVIDER	Name of provider.	Adjust	Yes	No	No
TRANSACTION_ID	MMP Transaction ID for attribution.	3e456bj7f89065s433	No	Yes	No
MMP_LINK	Fully populated tracking URL. Do not use aliases.	https://app.adjust.com/17cokf03?campaign=WoodySort_Android_20630_MX_Multi_IGNITE_CPI&adgroup=15792&id2=dltSWkJQ&idfa=&gps_adid_lower_sha1=cceb917745519888862b3b5e4390df0a49c27ef0&android_id=&subpublisher_id=%5BSUBSITE_ID%5D&digital_turbine_referrer=APPIA112272313849595687647011480182574916004&cost_type=CPI&cost_amount=0.14&cost_currency=USD https://tactile.sng.link/D196p/g7w3?pcn=LG%3AUS%3AA%3A01%3ADTGrowth&psid=12903&cl=APPIA98303053034660451540383180027752312312&id2=dl5XWUJU&aifa=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx&test_an=digitalturbine	Yes	No	Yes

1. Create an attribution data map that associates the package name or URI with the corresponding attribution data.

Kotlin

override fun onSuccess(result: InstallationResponse) {
    Log.d(TAG, "Install application onSuccess(): taskId=${result.taskId}, appId=${result.applicationId}, package=${result.packageName}")   
 
    toast("Installed successfully Attibution Data Saved = ${result.application.attributionDataStorageSuccess} and Error = ${result.application.errorMessage}")
}

1. Add the map to the bundle. For example, the following example provides the MMP_ATTRIBUTION_DATA key for the attributionDataMap map.

Kotlin

metadataBundle.putSerializable(
    SdkConstants.AttributionData.MMP_ATTRIBUTION_DATA,
    attributionDataMap

Attribution Results

Ignite sends the results of attribution data to the MMP in the result.application object in the onSuccess callback. If either the Host App uses an unsupported version of the SDK or the device uses an unsupported version of Ignite, DT sends an error message to the onSuccess callback.

Kotlin

override fun onSuccess(result: InstallationResponse) {
    Log.d(TAG, "Install application onSuccess(): taskId=${result.taskId}, appId=${result.applicationId}, package=${result.packageName}")   
 
    toast("Installed successfully Attibution Data Saved = ${result.application.attributionDataStorageSuccess} and Error = ${result.application.errorMessage}")
}

PARAMETER	TYPE	DESCRIPTION
attributionDataStorageSuccess	Boolean	Indicates whether DT was able to store attribution data after successful installation: TRUE = Attribution data saved successfully. FALSE = Attribution data was not saved.
errorMessage	String	If attribution data is not saved successfully, this string provides information on the error.