Índice:
- ¿Cuál es la fuente de información sobre equivalencia publicitaria?
- ¿STILINGUE ofrece la API para Radar o solo para las áreas del panel?
- ¿Cómo puedo obtener los datos de la Operación de STILINGUE Smart Care a través de la API de Stilingue?
- ¿Cómo se calcula la métrica de alcance en el punto final de métricas propietarias?
- ¿Cómo filtrar los datos en la API de Stilingue (por fecha, interacción, filtro de Conversaciones)?
- ¿Cómo funcionan las activaciones de las integraciones con bots?
- ¿Cómo funciona la puntuación en el gráfico de Destacados?
- ¿Cómo funciona el parámetro last_days?
- ¿Cómo puedo acceder a los recortes recopilados en mi investigación?
- ¿Cómo puedo integrar la API STILINGUE con otras herramientas de visualización de datos, como Google DataStudio y Microsoft PowerBI, por ejemplo?
- Debido a la conformidad con la Ley General de Protección de Datos, ¿cuáles son los cambios en la API de STILINGUE?
- ¿Es posible integrar la API de STILINGUE con alguna herramienta?
- ¿Es posible negar filtros de la misma manera que se hace en el filtro global de la herramienta?
- ¿Es posible obtener los textos de las publicaciones a través de la API de Listening?
- ¿Es posible acceder a los audios y videos de los recortes recopilados de la radio o la televisión?
- ¿Hay un límite para la cantidad de solicitudes que se pueden realizar en la API de STILINGUE?
- Mi empresa utiliza un servicio de recortes diferente al que STILINGUE utiliza actualmente, ¿puedo recopilar esas publicaciones en mi investigación?
- Mi investigación recopilará solo los clippings offline o también incluye el contenido online?
- No puedo acceder a los datos de la API, me da un error 404, ¿cuál es la razón?
- ¿El parámetro page_id puede devolver un valor nulo en la Interacción Propietaria de Instagram?
- ¿Qué sucede si no se especifica un intervalo de fechas en la solicitud?
- ¿Qué es y cómo funciona la recopilación de Clipping?
- ¿Qué puede causar que no se libere el token de acceso?
- ¿Dónde puedo encontrar más información sobre las API externas utilizadas por STILINGUE?
- Los datos de la API no coinciden con los de la herramienta, ¿cuál es la razón?
- ¿Por qué algunas imágenes de publicaciones recopiladas en STILINGUE caducan después de un tiempo? ¿Es posible recuperar el link de la imagen original?
- ¿Por qué un mismo parámetro (por ejemplo, la ubicación) a veces viene vacío ("") y a veces aparece como nulo?
- ¿Por qué algunas métricas se incluyen en algunas clippings y en otras no?
- ¿Qué campos se proporcionan y cuáles no se proporcionan en la API de STILINGUE para cada red?
- ¿Qué campos se pueden filtrar?
- ¿Cuál es el propósito de los operadores en la configuración de la búsqueda?
¿Cuál es la fuente de información sobre equivalencia publicitaria?
Todas las informaciones de equivalencia publicitaria - centimetraje, minutaje, valor en dinero, etc. - son proporcionadas por las agencias de recorte Los desarrolladores de STILINGUE no tienen acceso al cálculo realizado. Nuestra área de resumen permite reunir esta información para ayudar en las insights de tus clippings.
¿STILINGUE ofrece la API para Radar o solo para las áreas del panel?
La API solo devuelve datos de Escucha (Filtro de Publicaciones y Conversaciones), Métricas Propietarias y Smart Care, es decir: no proporcionamos la API para el Radar.
¿Cómo puedo obtener los datos de la Operación de STILINGUE Smart Care a través de la API de Stilingue?
Los datos de la operación se pueden obtener a través de la API de exportación de STILINGUE Smart Care.
API de informe de STILINGUE Smart Care:
- Tiempo que la persona que realiza la atención pasó tratando la publicación: se puede encontrar en el campo de cambio de estado, filtrando los cambios de estado que estaban pendientes:
- Tiempo que la persona que realiza la atención tardó en cerrar la conversación de la publicación (campo de conversaciones): se muestra el tiempo que se necesitó para el cierre:
- Fecha y hora en que se abrió la publicación (campo de conversaciones): en initAt se encuentra el momento en que comenzó la primera conversación:
- Fecha y hora en que se cerró la publicación (campo de conversaciones): en endAt:
- Fecha y hora en que se volvió a abrir la publicación;
- Para la Reapertura de las publicaciones, no hay un tratamiento nativo en la herramienta. Para ello, la API proporciona un área llamada "cases" que se calcula en tiempo de ejecución, y siempre que una conversación cambia de estado de cerrada a pendiente o abierta, se crea un objeto que contiene el ID de esa conversación con un "_n" al final, representando el número de reaperturas de esa conversación. Ahí es posible encontrar la hora en que fue reabierto y "cerrado de nuevo".
¿Cómo se calcula la métrica de alcance en el punto final de métricas propietarias?
Este valor de alcance -> total corresponde al promedio del alcance de las publicaciones. En este caso, la publicación puede ser una historia, una publicación o una publicación oculta.
¿Cómo filtrar los datos en la API de Stilingue (por fecha, interacción, filtro de Conversaciones)?
Los filtros aceptados en la API Stilingue son los mismos que se encuentran en el filtro global del sistema, tanto para las publicaciones como para las conversaciones.
Puede utilizarlos como parámetros enviados en el cuerpo de la solicitud de la API o directamente en la URL. Los nombres de los filtros se encuentran en la documentación.
Para agregar filtros a la URL, simplemente incluya el nombre y el valor seguidos de un "?" al final de la URL. Si necesita más de un filtro, agregue un signo "&" después. Por ejemplo:
api.stilingue.com.br/wrapi/visao_geral/<TOKEN>?date_range=30d&sentiment=1
¿Cómo funcionan las activaciones de las integraciones con bots?
Para integrar la API STILINGUE con chatbots, por favor, comuníquese con su Gerente de Éxito y realice la solicitud. STILINGUE se reunirá con el equipo de desarrollo del bot para solicitar la integración, incluyendo una URL de la API en el bot que permitirá la conexión deseada, ya sea para eliminar mensajes de conversación o agregar etiquetas a mensajes, por ejemplo.
¿Cómo funciona la puntuación en el gráfico de Destacados?
Dada la recopilación de una noticia mediante match de uno o más descriptores configurados en el Editor de Búsqueda, la puntuación representa la relevancia de estos descriptores según la ubicación de las palabras clave en la noticia, de acuerdo con los siguientes pesos:
- Título: Peso 5
- Texto (cuerpo de la noticia): Peso 3
- Leyenda de las imágenes: Peso 1
- La puntuación final es la suma de estos pesos entre las noticias recopiladas en el período.
Observación: Nuestro proveedor de noticias puede identificar si hubo algún punto destacado en el texto o el título, y esta puntuación también se considera incluso en ausencia de operadores registrados en la Configuración de Búsqueda.
¿Cómo funciona el parámetro last_days?
El parámetro last_days devuelve datos referentes a 1 día, considerando el número de días anteriores a la fecha de la solicitud.
Ejemplo:
last_days= 3
En este caso, solo se devolverán los datos del día en cuestión, contando 3 días anteriores a hoy. Entonces, si hago una solicitud el 23/05 con last_days= 3, se devolverán solo los datos del 20/05.
¿Cómo puedo acceder a los recortes recopilados en mi investigación?
Puede encontrar todos los clippings recopilados en la sección de Prensa para acceder a los gráficos de resumen de datos y las clasificaciones de la recopilación. Sus clippings también estarán disponibles como tarjetas en nuestro Tablón de Publicaciones.
¿Cómo puedo integrar la API STILINGUE con otras herramientas de visualización de datos, como Google DataStudio y Microsoft PowerBI, por ejemplo?
Para integrar la API de STILINGUE en otras plataformas, debes solicitar el token de acceso a tu Gerente de cuentas. Después, para la conexión, utilizaremos un token de prueba con un límite de 400 publicaciones del tablón de publicaciones de los últimos 3 días para acceder a la solicitud: api.stilingue.com.br/wrapi/publicacoes/ <TOKEN> (sustituye <TOKEN> por el número de tu token. Finalmente, solo tienes que conectar la plataforma deseada.
Servicios Personalizados: ¿Necesitas ayuda para construir y gestionar plataformas de análisis de datos? ¡Podemos ayudarte! Nuestro equipo de expertos está listo para atenderte. Ponte en contacto con tu Gerente de cuentas de STILINGUE para acceder a este y muchos otros servicios.
Debido a la conformidad con la Ley General de Protección de Datos, ¿cuáles son los cambios en la API de STILINGUE?
Las principales modificaciones se encuentran en la API y en la integración de otras herramientas. Los datos personales de los usuarios, como el nombre, la imagen, el texto y otros que son exclusivos del usuario, con excepción del ID, ya no serán accesibles a través de la API. El acceso a estos datos solo podrá realizarse a través de la API de cada red. Para obtener el token de acceso, es necesario solicitarlo a su Gerente de Cuentas. Entonces, su Gerente de Cuentas le enviará un formulario de conformidad que deberá completar correctamente, y luego nuestro equipo de soporte le enviará el token en un plazo de 3 días laborables.
Si tiene alguna pregunta sobre la LGPD, nuestro departamento legal está a su disposición. Póngase en contacto con nosotros a través del correo electrónico: juridico@stilingue.com.br.
¿Es posible integrar la API de STILINGUE con alguna herramienta?
Sí. Las herramientas que aceptan recibir datos de APIs pueden integrarse con la API STILINGUE, para ello, es necesario que un equipo técnico realice la integración.
Para las herramientas más comunes, existe un tutorial en el Centro de Ayuda:
- Google Sheets
- Power BI
- Data Studio
Para integrarse con Data Studio y Google Sheets es necesario utilizar un conector de terceros llamado Supermetrics, también es posible generar hojas de cálculo a partir de la API utilizando Google Apps Script.
Nota: la integración solo se realiza con datos internos de STILINGUE hacia otras herramientas. No está permitida la integración en sentido contrario (datos de terceros hacia STILINGUE).
¿Es posible negar filtros de la misma manera que se hace en el filtro global de la herramienta?
Sí, en la API la negativización se realiza mediante el signo de menos "-". Los campos que pueden ser negativizados son los mismos que en la herramienta.
- Ejemplo de negativización del canal Instagram en la llamada;
- Ejemplo de negativización de un id de usuario.
¿Es posible obtener los textos de las publicaciones a través de la API de Listening?
No proporcionamos estos datos debido a cuestiones de cumplimiento y LGPD con las redes sociales.
¿Es posible acceder a los audios y videos de los recortes recopilados de la radio o la televisión?
Claro. Al hacer clic en "Leer Publicación Completa" en tu tarjeta de publicación, encontrarás el texto, video o audio completo junto con su transcripción y detalles.
¿Hay un límite para la cantidad de solicitudes que se pueden realizar en la API de STILINGUE?
Actualmente no hay un límite en el número de solicitudes que se pueden realizar en la API de STILINGUE. Sin embargo, solo se permite ejecutar una solicitud a la vez.
Mi empresa utiliza un servicio de recortes diferente al que STILINGUE utiliza actualmente, ¿puedo recopilar esas publicaciones en mi investigación?
Si, puedes. Ponte en contacto con tu Gerente de Cuentas para contratar el servicio e informarle acerca de tu herramienta de recorte. Luego, sigue el mismo proceso de envío de correos electrónicos y nuestro equipo de servicios se asegurará de que tus clippings se recojan.
Mi investigación recopilará solo los clippings offline o también incluye el contenido online?
Al adquirir el panel de STILINGUE, tu investigación ya incluye la recopilación de contenido de portales y canales de recolección. Cuando actives el servicio de clippings, tu investigación también recopilará contenido de los canales offline disponibles. Estos canales incluyen radio, televisión, prensa impresa, entre otros.
No puedo acceder a los datos de la API, me da un error 404, ¿cuál es la razón?
Este error ocurre cuando el token del cliente no está presente en el código de la API, lo cual puede suceder cuando:
- El cliente ingresa el token incorrecto;
- El token no ha sido actualizado en el código.
¿El parámetro page_id puede devolver un valor nulo en la Interacción Propietaria de Instagram?
Cuando la publicación de Instagram es del tipo carrusel, el page_id puede ser nulo.
El cliente puede utilizar el parámetro "uid" para verificar el ID de la página que realizó la publicación.
¿Qué sucede si no se especifica un intervalo de fechas en la solicitud?
Cuando el cliente no proporciona un rango de fechas en la solicitud, la API considerará el día actual a partir de las cero horas (00:00).
¿Qué es y cómo funciona la recopilación de Clipping?
Los clippings son menciones de una marca específica en los medios de comunicación abiertos (televisión, portales, prensa, revistas, radio, por ejemplo). De esta manera, es posible integrar nuevas fuentes externas de datos, realizar análisis cada vez más completos y obtener insights aún más sólidas dentro de la plataforma STILINGUE.
Para recopilar y monitorear los clippings, es necesario contar con los servicios de las empresas de recopilación, como Fábrica de Ideas o Clipping Service, y ponerse en contacto con su Gerente de Cuentas para activar esta funcionalidad.
Para integrar los datos de la empresa de recopilación, es necesario especificar los operadores en su Configuración de Búsqueda y luego realizar la integración.
¿Qué puede causar que no se libere el token de acceso?
Tener la autorización del token denegada es muy raro. Si un caso es crítico, su Gerente de Cuentas lo abordará en paralelo con el equipo de cumplimiento. Normalmente, el token no se libera para fines de monitoreo político.
¿Dónde puedo encontrar más información sobre las API externas utilizadas por STILINGUE?
Puede consultar la documentación relacionada con las API proporcionada por cada red social, siendo la actualización de estos contenidos responsabilidad de las redes mencionadas.
Consulte a continuación los links a las API de cada red:
Los datos de la API no coinciden con los de la herramienta, ¿cuál es la razón?
La API extrae los mismos datos que la herramienta, cuando hay alguna diferencia, la razón es el filtro utilizado en la herramienta y en la API.
Si hay alguna discrepancia en los datos, verifique el filtro de fecha (date_range): simplemente coincida el filtro de fecha que esté en la URL de la API con el que esté en la URL de la herramienta. De forma predeterminada, el rango de fechas de la API es de 1 día.
Consejo: Para facilitar, puede utilizar el parámetro "filters" que se encuentra en la propia herramienta y usarlo en la API.
Los únicos parámetros que funcionan junto con "filters" son "date_range", "limit" y "order_by". Si hay algún parámetro que no sea alguno de estos 3 junto a "filters", la solicitud no funcionará.
¿Por qué algunas imágenes de publicaciones recopiladas en STILINGUE caducan después de un tiempo? ¿Es posible recuperar el link de la imagen original?
En el caso de publicaciones de Facebook, Twitter e Instagram, los links de las imágenes relacionadas con las publicaciones recopiladas pueden caducar después de algunas semanas, por definición de la red. Esta situación puede ocurrir en diferentes áreas de la plataforma, como Escucha o Métricas Propietarias.
Cuando esto sucede, la imagen recopilada en STILINGUE también se vuelve no disponible y no se puede actualizar en la plataforma. Si deseas recuperar la URL original, será necesario buscarla manualmente en la red social de origen.
¿Por qué un mismo parámetro (por ejemplo, la ubicación) a veces viene vacío ("") y a veces aparece como nulo?
Esto significa que los datos de ubicación no están disponibles.
De manera más técnica, tenemos:
- Comillas dobles sin nada en su interior: indican que el campo está vacío y no contiene información (el usuario no compartió datos de geolocalización).
- El valor "null" indica un valor inválido o desprovisto (por ejemplo, la API no proporciona este valor). Desprovisto se refiere a cuando los eliminamos por cuestiones de cumplimiento con los términos de la Red Social, ya que entra en conflicto con la LGPD (Ley General de Protección de Datos).
También puede haber variación entre las redes sociales, donde una red puede proporcionar un valor de geolocalización vacío, mientras que otras pueden no proporcionar estos datos. Dado que este parámetro está siempre disponible en la respuesta de nuestra API (por defecto mostramos todos los campos), aparecerá como "null" cuando la red social no lo proporcione.
¿Por qué algunas métricas se incluyen en algunas clippings y en otras no?
Cuando faltan algunas métricas, es porque la propia clipadora no proporcionó la métrica del clipping. En ocasiones, también notamos una entrega incorrecta del día y la hora de publicación del clipping.
Póngase en contacto con nuestro equipo de Atención al Cliente en el chat y podrán confirmar la situación. Si se confirma, se le guiará para que se comunique con la clipadora y notifique la falta o error de datos, en este caso, quedará a su discreción.
¿Qué campos se proporcionan y cuáles no se proporcionan en la API de STILINGUE para cada red?
Actualmente tenemos documentación sobre la API STILINGUE:
- Parámetros obligatorios y opcionales de entrada
- Limitaciones
- Requisitos de autenticación
- Métodos aceptados
- Valor recibido
La API STILINGUE está disponible para los productos Listening, Métricas Propietarias y STILINGUE Smart Care.
¿Qué campos se pueden filtrar?
Es posible filtrar por los mismos campos disponibles en el filtro de la herramienta.
¿Cuál es el propósito de los operadores en la configuración de la búsqueda?
Tan pronto como los links de clippings sean enviados a nuestro correo electrónico de recopilación, la funcionalidad estará habilitada. Sin embargo, es necesario que agregues los operadores "integracion:Fábrica de Ideas" o "integracion:Servicio de Clipping" en los Grupos de tu preferencia, para que el contenido se integre en la Configuración de Búsqueda. De esta manera, podrás clasificar las publicaciones recopiladas y elegir los canales de recopilación deseados.
Para obtener más información, visita la discusión sobre el tema en nuestra comunidad o los videos en nuestro canal. 😃