Cómo Configurar un Flock to Unlock Middleware Source

Este tipo de Middleware Source se utiliza para desbloquear una acción al alcanzar un objetivo específico. Por ejemplo, recolecta 100 publicaciones o tweets con un determinado #Hashtag y desbloquea el contenido especial. Puedes conectar el Flock to Unlock e integrar la data a través de nuestro Middleware con tu sistema de gráficas, lo que te permite mostrar en la pantalla una barra de progreso predeterminada.

El widget que puedes conectar a este Middleware Source es el Flock to Unlock.


Para aprender cómo crear un Middleware Source, haz clic aquí.

1. Configuración general

  • Nombre (1): Como buena práctica recomendamos nombrar el Flock to Unlock Middleware Source para que tu y tus compañeros de equipo puedan identificarlo para su uso posterior.

  • Flows seleccionados (2): Cuando creas un Middleware Source de este tipo, es obligatorio asignarle un Flow del cual tomará el número de posts. Haz click en Seleccionar y elije los flows listados quedesees asignar al Middleware Source.

  • Estado (3): Proporcionará el estado de tu Flock to Unlock y te dará acceso al Control Remoto para modificarlo.

  • Posts para alcanzar el objetivo (4):
    • Mostrar porcentaje histórico: nunca disminuye el progreso histórico que ha realizado el Middleware Source.
    • Mostrar porcentaje actual: si cambias el objetivo, el progreso que muestra el Middleware Source puede disminuir.

      Configuraciones adicionales (5)

  • Contar:
    • Posts totales: indica la cantidad de veces que se mencionó un hashtag, palabra clave o cuenta social. De esta forma puedes mostrar a tu audiencia el volumen real de participación.
    • Autores únicos: indica cuántas personas participan. Este conteo es muy útil para las polls, ya que evita que un usuario pueda participar más de una vez.

  • Decimales del Porcentaje: puedes elegir el número de decimales que deseas mostrar en los resultados. Desde 0 hasta 2.

  • Formato de númerosDe acuerdo al idioma seleccionado, el separador de miles será un punto (.) O una coma (,). Para obtener información adicional, haz clic aquí‍.

2. Integración

  • Tipo de integración (1): Selecciona cómo deseas integrar los datos según el sistema gráfico que tengas. Si no aparece en la lista, haz clic en otros. 

Integración Vizrt

Las integraciones con Vizrt se pueden realizar a través de:

  • Flowics Middleware + Data Reader, elige otros del menú desplegable.

Para obtener información adicional sobre la integración con Vizrt, haz clic aquí.

  • Pasos de integración (2): Desde aquí podrás acceder al XML, JSON o encontrarás los pasos para realizar la integración de acuerdo a tu sistema de integración de contenido gráfico.

  • Versión (3): se refiere a la versión del Middleware Source. Recomendamos usar siempre la versión más alta del menú desplegable. Por favor revisa este artículo‍ para mayor información.

  • Conectar con Middleware (4): habilítalo, elige tu middleware del menú desplegable y busca la ruta de destino donde el archivo o la base de datos están siendo escritos en tu unidad de destino por el middleware.

4. Previsualizando Flock to Unlock Middleware Source

Una vez que hayas guardado la configuración del Flock to Unlock Middleware Source, puedes obtener una vista previa de tus datos. Ten en cuenta que esta información no se actualiza en tiempo real, por lo que debes actualizar la ventana para ver los últimos resultados.

5. Integración XML

5.1 Ejemplo y descripción de campos

5.1.1 Ejemplo XML

<flockToUnlock>
    <widgetId>30473</widgetId>
    <widgetTitle>Contes</widgetTitle>
    <flowName>Sign of the Times - Harry Styles</flowName>
    <isLive>true</isLive>
    <target>1500</target>
    <total>1223</total>
    <remaining>277</remaining>
    <percentage>81.53</percentage>
    <formattedTarget>1,500</formattedTarget>
    <formattedTotal>1,223</formattedTotal>
    <formattedRemaining>277</formattedRemaining>
    <formattedPercentage>81.53</formattedPercentage>
    <percentageMode>actual</percentageMode>
    <unlocked>false</unlocked>
</flockToUnlock>


5.1.2 Descripción de los campos

Ten en cuenta que algunos nombres de campo cambian cuando se usa el tipo de integración Avid Maestro.

Campo Descripción Field (Integración Avid Maestro)
flockToUnlock.widgetId Id del widget. flockToUnlock.widgetId
flockToUnlock.widgetTitle El nombre que le has asignado al widget. flockToUnlock.widgetTitle
flockToUnlock.flowName El nombre del Flow asignado al widget. flockToUnlock.flowName
flockToUnlock.isLive Su valor puede ser verdadero o falso.

Un artista gráfico puede utilizar este campo para controlar el comportamiento de la escena conectada a este Middleware Source, es decir, puedes mostrar u ocultar la encuesta en función de su valor.

flockToUnlock.isLive
flockToUnlock.target Expone el valor de umbral que debe alcanzarse para desbloquear el contenido exclusivo. flockToUnlock.targetX
flockToUnlock.total Cantidad total de posts recolectados. flockToUnlock.totalX
flockToUnlock.remaining Cantidad de posts necesarios para alcanzar el objetivo. flockToUnlock.remainingX
flockToUnlock.percentage Muestra el porcentaje que se ha alcanzado. flockToUnlock.percentageX
flockToUnlock.formattedTarget Similar a flockToUnlock.target, pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado). 
flockToUnlock.formattedTarget
flockToUnlock.formattedTotal Similar a flockToUnlock.total, pero el número se formateará de acuerdo con la configuración local solicitada  (con separador de miles agregado).
flockToUnlock.formattedTotal
flockToUnlock.formattedRemaining Similar a flockToUnlock.remaining, pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado).
flockToUnlock.formattedRemaining
flockToUnlock.formattedPercentage Similar a flockToUnlock.percentage, pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado). 
flockToUnlock.formattedPercentage
flockToUnlock.percentageMode
Indica si el porcentaje mostrado es real o histórico.

Real: si cambia el valor del objetivo a uno más alto, el porcentaje de progreso mostrado se calculará en función del número de Tweets actuales.

Histórico: muestra el porcentaje más alto que ha alcanzado el widget independientemente del número de tweets actuales respecto al objetivo.
flockToUnlock.percentageMode
flockToUnlock.unlocked Los valores aquí pueden ser Verdadero o Falso e indican si el objetivo se ha alcanzado o no. flockToUnlock.unlocked


6. Integración de bases de datos

6.1 Descripción de las columnas

Cuando se utiliza este tipo de integración, se crea una tabla de base de datos con las siguientes columnas. El tipo de columnas es textual. Para el tipo específico, verifica la configuración del middleware, pero normalmente son texto para MySQL o PostgreSQL y ntext para Microsoft SQL Server.

Columna Descripción Columna (Integración Avid Maestro)
widgetId Id del widget. widgetId
widgetTitle El nombre que le has asignado al widget.
widgetTitle
flowName El nombre del Flow que le has asignado al widget. flowName
isLive
Su valor puede ser verdaderofalso.

Un artista gráfico puede utilizar este campo para controlar el comportamiento de la escena conectada a este Middleware Source, es decir, puedes mostrar u ocultar la encuesta en función de su valor.

isLive
target
Expone el valor de umbral que debe alcanzarse para desbloquear el contenido exclusivo. targetX
total Cantidad total de posts recolectados. totalX
remaining
Cantidad de posts que se necesitan para alcanzar el objetivo. remainingX
percentage
Muestra el porcentaje que se ha alcanzado. percentageX
formattedTarget Similar al target, pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado). formattedTarget
formattedTotal Similar al target, pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado). formattedTotal
formattedPercentage Similar al target, pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado). formattedPercentage
formattedRemaining
Similar al target, pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado). formattedRemaining
percentageMode
Indica si el porcentaje mostrado es real o histórico.

Real: si cambia el valor del objetivo a uno más alto, el porcentaje de progreso mostrado se calculará en función del número de Tweets actuales.

Histórico: muestra el porcentaje más alto que ha alcanzado el widget independientemente del número de Tweets actuales respecto al objetivo.
percentageMode
unlocked
Los valores aquí pueden ser Verdadero o Falso e indican si el objetivo se ha alcanzado o no. unlocked

7. Integración de archivos JSON

7.1 Ejemplo y descripción de campos

7.1.1 Ejemplo JSON

 {
   " widgetId " : 34309 ,
   " title " : " Rebanada para desbloquear JSON " ,
   " updatedAt " : " 2020-10-08T15: 27: 13Z " ,
   " flowName " : " Real Madrid " ,
   " isLive " : verdadero ,
   " objetivo " : 750 ,
   " total " : 528 ,
   " restante " : 222 ,
   " porcentaje " : 70,4 ,
   " formattedTarget " : " 750 " ,
   " formattedTotal " : " 528 " ,
   " formattedRemaining " : " 222 " ,
   " formattedPercentage " : " 70,40 " ,
   " percentMode " : " actual " ,
   " desbloqueado " : falso
}

7.1.2 Descripción de los campos

Campo
Descripción
widgetId
Id del widget
title
Título del Flock to Unlock, según lo configurado en el widget.
updatedAt
Fecha y hora de la última modificación del Middleware Source (no los datos en sí). Formato ISO8601.
flowName Nombre del Flow asociado al Middleware Source. Normalmente usado para mostrar el hashtag de campaña.
isLive

Su valor puede ser verdadero o falso.

Un artista gráfico puede utilizar este campo para controlar el comportamiento de la escena conectada a este Middleware Source, es decir, puede mostrar u ocultar el Flock to Unlock en función de su valor.

target
Expone el valor del umbral que debe alcanzarse para desbloquear el contenido exclusivo.
total Cantidad total de posts recolectados.
remaining
Cantidad de posts que se necesitan para alcanzar la meta.
percentage
Muestra el porcentaje que se ha alcanzado.
formattedTarget Similar al target, pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado).
formattedTotal Similar al target, pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado).
formattedRemaining
Similar al target, pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado).
formattedPercentage Similar al target, pero el número se formateará de acuerdo con la configuración local solicitada (con separador de miles agregado).
percentageMode
Indica si el porcentaje mostrado es real o histórico.

Real: si cambia el valor del objetivo a uno más alto, el porcentaje de progreso mostrado se calculará en función del número de Tweets actuales.

Histórico: muestra el porcentaje más alto que ha alcanzado el widget independientemente del número de Tweets actuales respecto al objetivo.
unlocked
Los valores aquí pueden ser Verdadero o Falso e indican si el objetivo se ha alcanzado o no.

Was this article helpful?