Personalizar URL de acción y multimedia con Liquid

Personaliza los destinos de los enlaces y el contenido para cada usuario que recibe tu mensaje añadiendo variables Liquid a las URL de botones, enlaces, imágenes y videos.

Vínculo profundo al contenido dentro de la aplicación

Consejo

Para desarrolladores: Para una guía sobre cómo elegir entre esquemas personalizados, enlaces universales y otras opciones, incluyendo cuándo necesitas un archivo AASA, qué métodos de delegado de la aplicación implementar y cómo depurar problemas, consulta la Guía de vinculación en profundidad para iOS y Solución de problemas de vinculación en profundidad.

¿Qué es la vinculación en profundidad?

La vinculación en profundidad es una forma de lanzar una aplicación nativa y proporcionar información adicional que le indica realizar una acción específica o mostrar contenido específico.

Esto consta de tres partes:

1. Identificar qué aplicación lanzar.
2. Indicar a la aplicación qué acción realizar.
3. Proporcionar a la acción cualquier dato adicional que necesite.

Los vínculos profundos son URI personalizados que enlazan a una parte específica de la aplicación y contienen estas tres partes. La clave es definir un esquema personalizado. http: es el esquema con el que casi todos están familiarizados, pero los esquemas pueden comenzar con cualquier palabra. Un esquema debe empezar con una letra, pero luego puede contener letras, números, signos de suma, signos de resta o puntos. En la práctica, no existe un registro central para prevenir conflictos, por lo que es una buena práctica incluir tu nombre de dominio en el esquema. Por ejemplo, twitter:// es el URI de iOS para lanzar la aplicación móvil de X, anteriormente Twitter.

Todo lo que aparece después de los dos puntos dentro de un vínculo profundo es texto de formato libre. Tú defines su estructura e interpretación; sin embargo, una convención común es modelarlo como las URL http:, incluyendo un // inicial y parámetros de consulta (por ejemplo, ?foo=1&bar=2). Para el ejemplo anterior, twitter://user?screen_name=[id] se usaría para lanzar un perfil específico en la aplicación.

Importante

Para aplicaciones creadas con frameworks de envoltorio (por ejemplo, Flutter o Cordova), Braze no proporciona soporte de vinculación en profundidad específico para envoltorios. Debes configurar los vínculos profundos en las capas nativas de iOS y Android. Para Cordova, consulta Vinculación en profundidad en notificaciones push.

Esquemas de URI del sistema

Los esquemas de URI estándar gestionados de forma nativa por iOS y Android (como tel:, mailto: y sms:) se pueden introducir directamente en el campo de URL de vínculo profundo sin necesidad de una integración de vínculo profundo personalizada en tu aplicación.

Estos funcionan para los comportamientos de clic en notificaciones push y las acciones de botones de mensajes dentro de la aplicación. No se necesitan configuraciones adicionales del SDK ni cambios en el código de la aplicación.

Etiquetas UTM y atribución de campañas

¿Qué es una etiqueta UTM?

Las etiquetas UTM (Urchin Traffic Manager) te permiten incluir detalles de atribución de Campaign directamente dentro de los enlaces. Las etiquetas UTM son utilizadas por Google Analytics para recopilar datos de atribución de Campaign y se pueden usar para rastrear las siguientes propiedades:

• utm_source: El identificador de la fuente del tráfico (por ejemplo, my_app)
• utm_medium: El medio de la Campaign (por ejemplo, newsfeed)
• utm_campaign: El identificador de la Campaign (por ejemplo, spring_2016_campaign)
• utm_term: Identificador de un término de búsqueda de pago que llevó al usuario a tu aplicación o sitio web (por ejemplo, pizza)
• utm_content: Un identificador del enlace o contenido específico en el que el usuario hizo clic (por ejemplo, toplink o android_iam_button2)

Las etiquetas UTM se pueden incrustar tanto en enlaces HTTP (web) regulares como en vínculos profundos, y rastrearse mediante Google Analytics.

Cálculos de etiquetas UTM

Braze reporta Total de clics para todos los enlaces en una Campaign o paso en Canvas, lo que puede incluir enlaces que no tienen etiquetas UTM. Esto significa que puedes ver un resultado diferente (a menudo menor) en los enlaces de seguimiento de Campaign de Google Analytics en comparación con el Total de clics mostrado en el rendimiento de tu Campaign o en el generador de informes.

Uso de etiquetas UTM con Braze

Si deseas usar etiquetas UTM con enlaces HTTP (web) regulares (por ejemplo, para hacer atribución de Campaign para tus campañas de correo electrónico) y tu organización ya usa Google Analytics, puedes utilizar el constructor de URL de Google para generar enlaces UTM. Estos enlaces se pueden incrustar fácilmente en el texto de Campaigns de Braze como cualquier otro enlace.

Para usar etiquetas UTM en vínculos profundos a tu aplicación, tu aplicación debe tener el SDK de Google Analytics relevante integrado y correctamente configurado para gestionar vínculos profundos. Consulta con tus desarrolladores si no estás seguro de esto.

Una vez que el SDK de Analytics esté integrado y configurado, las etiquetas UTM se pueden usar con vínculos profundos en Campaigns de Braze. Para configurar etiquetas UTM para tu Campaign, incluye las etiquetas UTM necesarias en la URL de destino o en los vínculos profundos. Los siguientes ejemplos muestran cómo usar etiquetas UTM en notificaciones push y mensajes dentro de la aplicación.

Atribuir aperturas push y clics en mensajes dentro de la aplicación con etiquetas UTM

• aperturas push
• clics en mensajes dentro de la aplicación

1
myapp://products/20-gift-card?utm_source=my_app&utm_medium=push&utm_campaign=spring2016giftcards&utm_content=ios_deeplink

1
myapp://products/20-gift-card?utm_source=my_app&utm_medium=iam&utm_campaign=spring2021giftcards&utm_content=web_link

Usa la personalización Liquid en las URL

Puedes construir dinámicamente tu URL directamente dentro del creador de Braze, lo que te permite añadir parámetros UTM dinámicos a tus URL o enviar a los usuarios vínculos únicos (como dirigirlos a su carrito abandonado o a un producto específico que vuelve a estar disponible).

Crear una URL con etiquetas de personalización Liquid compatibles

Las URL pueden generarse dinámicamente mediante el uso de cualquier etiqueta de personalización Liquid compatible.

1
https://example.com/?campaign_utm={{campaign.${api_id}}}&user_attribute={{custom_attribute.${attribute1}}}

También admitimos el acortamiento de variables Liquid definidas de forma personalizada, como en los siguientes ejemplos:

Crear una URL usando variables Liquid

1
2
{% assign url_var = {{event_properties.${url_slug}}} %}
https://example.com/{{url_var}}

Acortar URL generadas por variables Liquid

Canales compatibles: KakaoTalk, LINE, SMS, RCS, WhatsApp

Acortamos las URL que son generadas por Liquid, incluso aquellas incluidas en propiedades de desencadenamiento por API. Por ejemplo, si {{api_trigger_properties.${url_value}}} representa una URL válida, acortamos y hacemos seguimiento de esa URL antes de enviar el mensaje.

Acortar URL en el endpoint /messages/send

El acortamiento de enlaces también está habilitado para mensajes exclusivos de API a través del endpoint /messages/send. Para obtener una lista completa de los parámetros de solicitud, consulta parámetros de solicitud.