You can create Marketing Links to acquire new mobile app users on-the-fly by manually configuring the URL parameters.
This feature requires SDK version 4.6 or later. For more information, see Acquisition prerequisites.
The following diagram illustrates the components of a manually built tracking link and displays the different URL parameters that you must properly configure when manually creating acquisition links.
This link is configured to perform a platform-specific redirect to the Google Play store or the Apple App Store for a mobile app. If the destination cannot be determined, the default store has been set to the Apple App Store. After the app has been installed, the my.custom.key:test
custom context key is attached to the Analytics Install Hit.
To manually create links, use the following URL format:
http(s)://c00.adobe.com/v3/ {mobile-services-app-hash}/start? {parameters}
The version of Android SDK you are using has no impact on this process.
For iOS, ensure that you use the correct protocol:
Where the following conditions have been met:
{mobile-services-app-hash}
matches the application identifier in the configuration acquisition:appid
file.
You can locate {mobile-services-app-hash}
in the Manage App Settings page under Acquisition SDK Options in the Tracking ID field.
{parameters}
is a list of standard specifically named URL query parameters.
Here is the list of parameters:
a_g_id
Google Play Store App Identifier.
com.adobe.beardcons
a_g_lo
Google Play Store Locale Override.
ko
a_i_id
iTunes App Identifier.
835196493
a_i_lo
iTunes Locale Override.
jp
a_dd
Default Store for Auto Redirect.
i | g
a_cid
Custom ID Override (generally IDFA for iOS or ADID for Android).
Any String < 255 characters (UTF-8 encoded)
ctx*
Keys prefixed with ctx
will be in the context data of the resulting launch hit.
ctxmy.custom.key=myValue
ctxa.referrer.campaign.name
Acquisition Campaign Name.
This parameter is required for reporting if you want to compare the performance of different acquisition links.
ctxa.referrer.campaign.trackingcode
Tracking Code
This parameter is required for reporting if you want to compare the performance of different acquisition links.
lexsxouj
ctxa.referrer.campaign.source
The source.
ctxa.referrer.campaign.medium
Medium
ctxa.referrer.campaign.content
Content
ctxa.referrer.campaign.term
Term
When you manually create acquisition links, remember the following information:
All parameters that do not match parameters in the table are passed on as part of the app store redirect.
All parameters are technically optional, although the link will be nonfunctional, if at least one store ID is specified.
An example of a store ID is a_g_id
/ a_i_id
.
If the destination store cannot be automatically determined, and no default is provided, an 404 error is returned.