Crea Dynamic Links en Android

Puedes crear Dynamic Links cortos o largos con la API de Firebase Dynamic Links Builder. Esta API acepta un Dynamic Link largo o un objeto que contenga parámetros de Dynamic Link, y muestra URL 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.

1. 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 vínculos de apps, también debes especificar la clave SHA-256.

2. En tu archivo build.gradle de nivel de proyecto, asegúrate de incluir el repositorio Maven de Google en las secciones buildscript y allprojects.

3. Agrega la dependencia que contiene la biblioteca de Android de Dynamic Links al archivo Gradle (generalmente app/build.gradle) de tu módulo (a nivel de la app).

   Para obtener una experiencia óptima con Dynamic Links, te recomendamos habilitar Google Analytics en tu proyecto. También debes agregar el SDK de Firebase para Analytics a la app cuando configures Analytics.

   Java

   implementation 'com.google.firebase:firebase-dynamic-links:19.1.0'
   implementation 'com.google.firebase:firebase-analytics:17.5.0'

   Kotlin+KTX

   implementation 'com.google.firebase:firebase-dynamic-links-ktx:19.1.0'
   implementation 'com.google.firebase:firebase-analytics-ktx:17.5.0'

4. En Firebase console, abre la sección Dynamic Links.

5. 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.

   

6. 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 incluir patrones de URL en la lista blanca.

Usa Firebase console

Visita Firebase console y sigue los pasos que se indican en el formulario para generar Dynamic Links de forma manual. 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:

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();
MainActivity.java

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
MainActivity.kt

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:

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
                    // ...
                }
            }
        });
MainActivity.java

val shortLinkTask = Firebase.dynamicLinks.shortLinkAsync {
    link = Uri.parse("https://www.example.com/")
    domainUriPrefix = "https://example.page.link"
    // Set parameters
    // ...
}.addOnSuccessListener { result ->
    // Short link created
    val shortLink = result.shortLink
    val flowchartLink = result.previewLink
}.addOnFailureListener {
    // Error
    // ...
}
MainActivity.kt

Según la configuración predeterminada, los Dynamic Links cortos se generan 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 práctico no es perjudicial que una persona adivine de forma correcta 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:

Task<ShortDynamicLink> shortLinkTask = FirebaseDynamicLinks.getInstance().createDynamicLink()
        // ...
        .buildShortDynamicLink(ShortDynamicLink.Suffix.SHORT);
        // ...
MainActivity.java

val shortLinkTask = Firebase.dynamicLinks.shortLinkAsync(ShortDynamicLink.Suffix.SHORT) {
    // Set parameters
    // ...
}
MainActivity.kt

Parámetros de 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:

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()
MainActivity.java

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!"
    }
}
MainActivity.kt

Puedes configurar los parámetros de Dynamic Link con los siguientes métodos:

https://example.com/link
https://example.page.link

Cómo acortar 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:

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
                    // ...
                }
            }
        });
MainActivity.java

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 { result ->
    // Short link created
    val shortLink = result.shortLink
    val flowchartLink = result.previewLink
}.addOnFailureListener {
    // Error
    // ...
}
MainActivity.kt