Puedes crear Dynamic Links cortos o largos con la API de Firebase Dynamic Links Builder, que acepta un Dynamic Link largo o un objeto que contenga parámetros de Dynamic Links y muestra URLs similares a las de estos ejemplos:
https://example.com/link/WXYZ https://example.page.link/WXYZ
Configura Firebase y el SDK de Dynamic Links
Para poder crear Dynamic Links en la app para Android, debes incluir el SDK de Firebase. Si tu app está configurada para recibir Dynamic Links, ya completaste estos pasos y puedes omitir esta sección.
Si aún no lo has hecho, agrega Firebase a tu proyecto de Android.
Cuando registres tu app, especifica la clave de firma SHA-1. Si usas App Links, también debes especificar la clave SHA‑256.
-
Usa la BoM de Firebase para Android a fin de declarar la dependencia de la biblioteca de Android para Dynamic Links en el archivo Gradle (generalmente
app/build.gradle
) de tu módulo (nivel de app).Para obtener una experiencia óptima con Dynamic Links, recomendamos habilitar Google Analytics en tu proyecto de Firebase y agregar el SDK de Firebase para Google Analytics a la app.
Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:30.3.1') // Declare the dependencies for the Dynamic Links and Analytics libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-dynamic-links' implementation 'com.google.firebase:firebase-analytics' }
Si usas la BoM de Firebase para Android, tu app siempre utilizará versiones compatibles de las bibliotecas de Firebase para Android.
Como alternativa, puedes declarar las dependencias de la biblioteca de Firebase sin usar la BoM.
Si eliges no usar la BoM de Firebase, debes especificar cada versión de la biblioteca de Firebase en su línea de dependencia.
Si usas varias bibliotecas de Firebase en tu app, es muy recomendable que utilices la BoM para administrar las versiones de las bibliotecas, lo que garantiza que todas las versiones sean compatibles.
dependencies { // Declare the dependencies for the Dynamic Links and Analytics libraries // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-dynamic-links:21.0.1' implementation 'com.google.firebase:firebase-analytics:21.1.0' }
Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:30.3.1') // Declare the dependencies for the Dynamic Links and Analytics libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-dynamic-links-ktx' implementation 'com.google.firebase:firebase-analytics-ktx' }
Si usas la BoM de Firebase para Android, tu app siempre utilizará versiones compatibles de las bibliotecas de Firebase para Android.
Como alternativa, puedes declarar las dependencias de la biblioteca de Firebase sin usar la BoM.
Si eliges no usar la BoM de Firebase, debes especificar cada versión de la biblioteca de Firebase en su línea de dependencia.
Ten en cuenta que, si usas múltiples bibliotecas de Firebase en tu app, es muy recomendable que utilices la BoM para administrar las versiones de las bibliotecas, lo que garantiza que todas las versiones sean compatibles.
dependencies { // Declare the dependencies for the Dynamic Links and Analytics libraries // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-dynamic-links-ktx:21.0.1' implementation 'com.google.firebase:firebase-analytics-ktx:21.1.0' }
- En Firebase console, abre la sección Dynamic Links.
-
Si aún no aceptaste las Condiciones del Servicio ni configuraste un dominio para los Dynamic Links, deberás hacerlo cuando el sistema lo solicite.
Si ya tienes un dominio de Dynamic Links, anótalo. Deberás proporcionar un dominio para crear Dynamic Links de manera programática.
- Recomendado: Especifica los patrones de URL que se permiten en tus vínculos directos y de resguardo. De esa manera, evitas que grupos no autorizados creen Dynamic Links que redireccionen de tu dominio a otros sitios que no puedes controlar. Consulta cómo permitir patrones de URL específicos.
Usa Firebase console
Visita Firebase console y sigue los pasos que se indican en el formulario para generar un Dynamic Link manualmente. Esta es la forma más sencilla de producirlos, ya sea para hacer pruebas o para que tu equipo de marketing cree con facilidad un vínculo que pueda usarse, por ejemplo, en publicaciones de redes sociales.
Crea un Dynamic Link a partir de parámetros
Para crear un Dynamic Link, crea un objeto DynamicLink
nuevo con su compilador y especifica los parámetros del Dynamic Link con los métodos del compilador. Luego, llama a buildDynamicLink
o buildShortDynamicLink
.
El siguiente ejemplo simple crea un Dynamic Link largo a
https://www.example.com/
que se abre con tu app para Android
y la app com.example.ios
en iOS:
Java
DynamicLink dynamicLink = FirebaseDynamicLinks.getInstance().createDynamicLink() .setLink(Uri.parse("https://www.example.com/")) .setDomainUriPrefix("https://example.page.link") // Open links with this app on Android .setAndroidParameters(new DynamicLink.AndroidParameters.Builder().build()) // Open links with com.example.ios on iOS .setIosParameters(new DynamicLink.IosParameters.Builder("com.example.ios").build()) .buildDynamicLink(); Uri dynamicLinkUri = dynamicLink.getUri();
Kotlin+KTX
val dynamicLink = Firebase.dynamicLinks.dynamicLink { link = Uri.parse("https://www.example.com/") domainUriPrefix = "https://example.page.link" // Open links with this app on Android androidParameters { } // Open links with com.example.ios on iOS iosParameters("com.example.ios") { } } val dynamicLinkUri = dynamicLink.uri
Para crear un Dynamic Link corto, compila un DynamicLink
de la misma manera y,
a continuación, llama a buildShortDynamicLink
. La compilación de un vínculo corto requiere una llamada de red, de manera que, en lugar de mostrar directamente el vínculo, buildShortDynamicLink
muestra un Task
, que habilita el vínculo corto cuando se completa la solicitud. Por ejemplo:
Java
Task<ShortDynamicLink> shortLinkTask = FirebaseDynamicLinks.getInstance().createDynamicLink() .setLink(Uri.parse("https://www.example.com/")) .setDomainUriPrefix("https://example.page.link") // Set parameters // ... .buildShortDynamicLink() .addOnCompleteListener(this, new OnCompleteListener<ShortDynamicLink>() { @Override public void onComplete(@NonNull Task<ShortDynamicLink> task) { if (task.isSuccessful()) { // Short link created Uri shortLink = task.getResult().getShortLink(); Uri flowchartLink = task.getResult().getPreviewLink(); } else { // Error // ... } } });
Kotlin+KTX
val shortLinkTask = Firebase.dynamicLinks.shortLinkAsync { link = Uri.parse("https://www.example.com/") domainUriPrefix = "https://example.page.link" // Set parameters // ... }.addOnSuccessListener { (shortLink, flowchartLink) -> // You'll need to import com.google.firebase.dynamiclinks.ktx.component1 and // com.google.firebase.dynamiclinks.ktx.component2 // Short link created processShortLink(shortLink, flowchartLink) }.addOnFailureListener { // Error // ... }
Según la configuración predeterminada, se generan los Dynamic Links cortos con sufijos de vínculos de 17 caracteres.
Esto hace que sea muy improbable que una persona adivine un Dynamic Link válido. Si
en tu caso de uso no es perjudicial que una persona adivine correctamente los vínculos cortos,
puedes generar sufijos que solo tengan el largo suficiente
a fin de que sean únicos. Para ello, pasa ShortDynamicLink.Suffix.SHORT
al método buildShortDynamicLink
de esta manera:
Java
Task<ShortDynamicLink> shortLinkTask = FirebaseDynamicLinks.getInstance().createDynamicLink() // ... .buildShortDynamicLink(ShortDynamicLink.Suffix.SHORT); // ...
Kotlin+KTX
val shortLinkTask = Firebase.dynamicLinks.shortLinkAsync(ShortDynamicLink.Suffix.SHORT) { // Set parameters // ... }
Parámetros del Dynamic Link
Puedes usar la API de Dynamic Link Builder para crear Dynamic Links con cualquiera de los parámetros admitidos. Consulta la referencia de la API para obtener más detalles.
El siguiente ejemplo crea un Dynamic Link con varios parámetros comunes configurados:
Java
DynamicLink dynamicLink = FirebaseDynamicLinks.getInstance().createDynamicLink() .setLink(Uri.parse("https://www.example.com/")) .setDomainUriPrefix("https://example.page.link") .setAndroidParameters( new DynamicLink.AndroidParameters.Builder("com.example.android") .setMinimumVersion(125) .build()) .setIosParameters( new DynamicLink.IosParameters.Builder("com.example.ios") .setAppStoreId("123456789") .setMinimumVersion("1.0.1") .build()) .setGoogleAnalyticsParameters( new DynamicLink.GoogleAnalyticsParameters.Builder() .setSource("orkut") .setMedium("social") .setCampaign("example-promo") .build()) .setItunesConnectAnalyticsParameters( new DynamicLink.ItunesConnectAnalyticsParameters.Builder() .setProviderToken("123456") .setCampaignToken("example-promo") .build()) .setSocialMetaTagParameters( new DynamicLink.SocialMetaTagParameters.Builder() .setTitle("Example of a Dynamic Link") .setDescription("This link works whether the app is installed or not!") .build()) .buildDynamicLink(); // Or buildShortDynamicLink()
Kotlin+KTX
val dynamicLink = Firebase.dynamicLinks.dynamicLink { // or Firebase.dynamicLinks.shortLinkAsync link = Uri.parse("https://www.example.com/") domainUriPrefix = "https://example.page.link" androidParameters("com.example.android") { minimumVersion = 125 } iosParameters("com.example.ios") { appStoreId = "123456789" minimumVersion = "1.0.1" } googleAnalyticsParameters { source = "orkut" medium = "social" campaign = "example-promo" } itunesConnectAnalyticsParameters { providerToken = "123456" campaignToken = "example-promo" } socialMetaTagParameters { title = "Example of a Dynamic Link" description = "This link works whether the app is installed or not!" } }
Puedes configurar los parámetros del Dynamic Link con los siguientes métodos:
Parámetros de Dynamic Link | |
---|---|
setLink |
El vínculo que abrirá tu app. Especifica una URL que tu app pueda manejar, como el contenido o la carga útil, que inicia una lógica específica de la app (como darle créditos al usuario con un cupón o mostrar una pantalla de bienvenida). Este vínculo debe ser una URL con un formato correcto y la codificación URL adecuada, debe usar HTTP o HTTPS y no puede ser otro Dynamic Link. |
setDomainUriPrefix | El prefijo de URL del Dynamic Link, que puedes encontrar en Firebase console. Un dominio de Dynamic Link tiene un formato similar a los siguientes ejemplos:
https://example.com/link https://example.page.link |
Parámetros de Android | |
---|---|
setFallbackUrl | El vínculo que se debe abrir cuando la app no está instalada. Especifica el parámetro para hacer otra acción que no sea instalar tu app desde Play Store cuando no esté instalada, como abrir la versión web móvil del contenido o mostrar una página promocional de tu app. |
setMinimumVersion | El versionCode de la versión mínima de tu app que puede abrir el vínculo. Si la app instalada es una versión anterior, se dirige al usuario a Play Store para que la actualice. |
Parámetros de iOS | |
---|---|
setAppStoreId | El ID de la app en App Store, que se usa para enviar usuarios a App Store cuando la app no está instalada. |
setFallbackUrl | El vínculo que se debe abrir cuando la app no está instalada. Especifica este parámetro para hacer otra acción que no sea instalar la app desde App Store cuando no esté instalada, como abrir la versión web móvil del contenido o mostrar una página promocional de la app. |
setCustomScheme | El esquema URL personalizado de la app si se define con un valor diferente del ID del paquete. |
setIpadFallbackUrl | El vínculo que se debe abrir en iPads cuando la app no está instalada. Especifica este parámetro para hacer otra acción que no sea instalar la app desde App Store cuando no esté instalada, como abrir la versión web del contenido o mostrar una página promocional de la app. |
setIpadBundleId | El ID del paquete de la app para iOS que se usa en iPads a fin de abrir el vínculo. La app debe estar conectada a tu proyecto desde la página Información general de Firebase console. |
setMinimumVersion | El número de la versión mínima de la app que puede abrir el vínculo. Este indicador pasa a la app cuando esta se abre, y la app debe decidir qué hacer con él. |
Parámetros de Navigation Info | |
---|---|
setForcedRedirectEnabled | Si se configura en “1”, omite la página de vista previa de la app cuando se abre el Dynamic Link y, en su lugar, redirecciona a la app o la tienda. La página de vista previa de la app (habilitada de forma predeterminada) puede enviar a los usuarios de manera más confiable al destino más apropiado cuando abren Dynamic Links en apps. Sin embargo, si esperas que un Dynamic Link se abra solo en apps que pueden abrir estos vínculos de manera confiable sin esta página, puedes inhabilitarla con este parámetro. Este parámetro afectará el comportamiento del Dynamic Link solo en iOS. |
SocialMetaTagParameters | |
---|---|
setTitle | El título que se usará cuando se comparta el Dynamic Link en una publicación de redes sociales. |
setDescription | La descripción que se usará cuando se comparta el Dynamic Link en una publicación de redes sociales. |
setImageUrl | La URL a una imagen relacionada con este vínculo. La imagen debe tener, al menos, 300x200 px y pesar menos de 300 KB. |
Parámetros de Google Analytics | |
---|---|
setSource setMedium setCampaign setTerm setContent |
Parámetros de análisis de Google Play. Estos parámetros (utm_source , utm_medium , utm_campaign , utm_term , utm_content ) se pasan a Play Store y se agregan a la carga útil del vínculo.
|
Parámetros de análisis de iTunes Connect | |
---|---|
setProviderToken setAffiliateToken setCampaignToken |
Parámetros de análisis de iTunes Connect. Estos parámetros (pt , at y ct ) se pasan a la App Store. |
Acorta un Dynamic Link largo
Para acortar un Dynamic Link largo, especifica su URL mediante setLongLink
en lugar de configurar parámetros con los otros
métodos de compilación:
Java
Task<ShortDynamicLink> shortLinkTask = FirebaseDynamicLinks.getInstance().createDynamicLink() .setLongLink(Uri.parse("https://example.page.link/?link=https://www.example.com/&apn=com.example.android&ibn=com.example.ios")) .buildShortDynamicLink() .addOnCompleteListener(this, new OnCompleteListener<ShortDynamicLink>() { @Override public void onComplete(@NonNull Task<ShortDynamicLink> task) { if (task.isSuccessful()) { // Short link created Uri shortLink = task.getResult().getShortLink(); Uri flowchartLink = task.getResult().getPreviewLink(); } else { // Error // ... } } });
Kotlin+KTX
val shortLinkTask = Firebase.dynamicLinks.shortLinkAsync { longLink = Uri.parse("https://example.page.link/?link=" + "https://www.example.com/&apn=com.example.android&ibn=com.example.ios") }.addOnSuccessListener { (shortLink, flowChartLink) -> // You'll need to import com.google.firebase.dynamiclinks.ktx.component1 and // com.google.firebase.dynamiclinks.ktx.component2 // Short link created processShortLink(shortLink, flowChartLink) }.addOnFailureListener { // Error // ... }