Parámetros de acción
Para inyectar parámetros de consulta cuando se dispara una acción, defina la opción actionParameters como un objeto donde cada clave define una acción y el valor el parámetro correspondiente a inyectar.
Las claves de acción soportadas están definidas por los siguientes
- chatLink, al redirigir a un enlace incluido en un mensaje de chat.
- addToCart, cuando se añade un producto al carrito mediante una URL resuelta personalizada.
- cartCheckout, al redirigir a la URL de pago.
- shopInStore, al redirigir a la página de productos de la tienda.
- promotionalBanner, al redirigir a una URL de «banner promocional».
- showMe, al redirigir a una URL de llamada a la acción «muéstrame».
- download, al redirigir a una URL de llamada a la acción de «descarga».
Se puede utilizar cualquier valor para definir el parámetro de consulta que se inyectará cuando se active una acción. La forma más genérica es definir el parámetro de consulta con un objeto como el siguiente para la acción shopInStore.
{
"shopInStore": {
"key": "the_query_parameter_key",
"value": "the_query_parameter_value"
}
}
Si el parámetro de consulta no se define como un objeto o la clave no está incluida en la definición, se utilizará la clave de la acción (action key) en su lugar (shopInStore en el ejemplo anterior).
IMPORTANTE: Los parámetros de acción definidos siempre se inyectan, independientemente de si coinciden o no con la expresión regular de los parámetros de propagación, y no es necesario definir todas las acciones como en el siguiente ejemplo.
{
"chatLink": {
"key": "utm_content",
"value": "Click_On_Live_Chat"
},
"shopInStore": {
"key": "utm_content",
"value": "Click_Product_On_Live"
}
}
Concatenación de parámetros de acción
NOTA IMPORTANTE: Al utilizar propagationParameters, algunos parámetros de consulta pueden coincidir tanto con el regex de propagación como con una clave de un parámetro de acción. Para evitar la anulación de valores, utilice joinParamsPropagation para concatenar los parámetros de acción y los parámetros que coinciden con la expresión regular de propagación.
Si no se define joinParamsPropagation, los parámetros de acción sustituyen a los existentes en la URL en la que se inyectan, a menos que la opción join esté presente en la definición del parámetro de acción.
{
"shopInStore": {
"key": "utm_content",
"value": "Click_Product_On_Live",
"join": "-"
}
}
La opción join se utiliza para concatenar el valor actual y el que se va a inyectar. Con la definición del ejemplo anterior, si el parámetro de consulta utm_content ya existe con el valor Product_Campaign en la URL en la que se está inyectando el parámetro de acción, el valor resultante tras la inyección será Product_Campaign-Click_Product_On_Live.