Skip to main content

​
Introducción a las reglas y consultas empresariales

Los productos que utilizan operadores empresariales te proporcionan datos sociales basados en las reglas de filtrado que configures. Las reglas se componen de una o más “cláusulas”, donde una cláusula es una palabra clave, una frase exacta o uno de los muchos operadores empresariales. Antes de comenzar a crear reglas con operadores empresariales, asegúrate de revisar la sintaxis descrita a continuación, consultar la lista de operadores disponibles y comprender las restricciones a la hora de crear reglas. También debes asegurarte de comprender los matices de cómo se evalúan las reglas desde el punto de vista lógico, en la sección “Orden de operaciones”. Se pueden combinar varias cláusulas con lógica “and” y “or”. Ten en cuenta: La lógica “and” se especifica con un espacio entre cláusulas, mientras que la lógica “or” se especifica con un OR en mayúsculas. Cada regla puede tener hasta 2.048 caracteres de longitud, sin límites en el número de cláusulas positivas (elementos que quieres hacer coincidir o filtrar) y cláusulas negativas (elementos que quieres excluir y con los que no quieres hacer coincidir).  

​
Creación de reglas y consultas

Coincidencia de palabras clave Las coincidencias de palabras clave son similares a las consultas en una interfaz de búsqueda. Por ejemplo, la siguiente regla de operador enterprise coincidiría con actividades que tengan el término “social” en el cuerpo del texto. social Aplicar AND a términos con espacio en blanco Agregar otra palabra clave equivale a agregar otro requisito para encontrar coincidencias. Por ejemplo, esta regla solo coincidiría con actividades donde tanto “social” como “media” estén presentes en el texto, en cualquier orden: tener un espacio entre términos funciona como una lógica booleana AND. Si incluyes un AND explícito en tu regla, será rechazado por el endpoint de reglas. social media Aplicar OR a términos con OR en mayúsculas En muchas situaciones, en realidad se necesita lógica booleana OR. Esto también se logra fácilmente. Ten en cuenta que el operador OR debe estar en mayúsculas y que un ‘or’ en minúsculas se tratará como una palabra clave normal. social OR data Negar términos En otros escenarios quizá quieras excluir resultados con ciertas palabras clave (lógica booleana NOT). Por ejemplo, actividades con ‘happy’, pero excluyendo cualquier actividad con ‘birthday’ en el texto. social -personality Agrupación con paréntesis Estos tipos de lógica se pueden combinar mediante agrupación con paréntesis y ampliarse a consultas mucho más complejas. (social OR data) (academic OR research) -personality -information -university Sin embargo, esto es solo el principio: aunque los ejemplos anteriores se basan simplemente en coincidencias tokenizadas de palabras clave, los productos enterprise también ofrecen operadores para realizar distintos tipos de coincidencia sobre el texto. Coincidencia exacta "social media research" Coincidencia de subcadena contains:info Coincidencia por proximidad "social media research"~3 Además, otros operadores te permiten filtrar en función de aspectos únicos de los datos sociales, más allá del texto.  El usuario que está publicando una Publicación from:XDeveloeprs Tweets geolocalizados en un radio de 10 millas de Pearl St. en Boulder, CO, Estados Unidos point_radius:[-105.27346517 40.01924738 10.0mi] Uniéndolo todo Estos operadores se pueden combinar con filtros de texto utilizando los mismos tipos de lógica descritos anteriormente. (social OR data) (academic OR research OR "social media research") point_radius:[-105.27346517 40.01924738 10.0mi] lang:en -personality -information -university

​
Sintaxis booleana

Los ejemplos de la sección anterior utilizaron varios tipos de lógica booleana y agrupación. Consulta la tabla a continuación para obtener más detalles sobre la sintaxis y los requisitos de cada una. Ten en cuenta que los operadores pueden ser positivos o negativos. Los operadores positivos definen lo que quieres incluir en los resultados. Por ejemplo, el operador has:hashtags indica “Quiero actividades que contengan hashtags”. Los operadores negativos definen lo que quieres excluir de los resultados y se crean utilizando la lógica booleana NOT descrita anteriormente. Por ejemplo, -has:hashtags indica “Excluye cualquier actividad que contenga hashtags, incluso si por lo demás coincide con mi regla”. Los productos de operadores Premium no tienen restricciones en el número de cláusulas positivas y negativas, sujeto a una longitud máxima de 2.048 caracteres.  

​
Orden de operaciones

Al combinar la funcionalidad AND y OR en una misma regla, el siguiente orden de operaciones determinará cómo se interpreta tu regla.
  1. Primero se combinan los operadores conectados por lógica AND
  2. Luego se aplican los operadores conectados con lógica OR
Ejemplo:
  • apple OR iphone ipad se evaluaría como apple OR (iphone ipad)
  • ipad iphone OR android se evaluaría como (iphone ipad) OR android
Para eliminar la incertidumbre y asegurarte de que tus reglas se evalúen como está previsto, agrupa los términos con paréntesis cuando corresponda. Por ejemplo:
  • (apple OR iphone) ipad
  • iphone (ipad OR android)

​
Signos de puntuación, diacríticos y distinción entre mayúsculas y minúsculas

Si especificas una regla de palabra clave o hashtag con acentos o diacríticos para operadores empresariales, esta hará coincidir el texto de las Publicaciones respetando los diacríticos (en hashtags o palabras clave). Una regla con la palabra clave Diacr**í**tica o el hashtag #cumplea**ñ**os coincidirá con “Diacrítica” o “#cumpleaños” pero no con “Diacritica” o “#cumpleanos” sin la tilde en la í o la eñe. Los caracteres con acentos o diacríticos se tratan igual que los caracteres normales y no se consideran límites de palabra. Por ejemplo, una regla de cumpleaños solo coincidiría con actividades que contengan la palabra cumpleaños y no coincidiría con actividades que contengan cumplea, cumplean u os. Todos los operadores se evalúan sin distinguir entre mayúsculas y minúsculas. Por ejemplo, la regla Cat coincidirá con todo lo siguiente: “cat”, “CAT”, “Cat”.

​
Etiquetas de reglas de PowerTrack

Como se describe en nuestra página “Matching rules”, cada regla puede crearse con una etiqueta. Estas etiquetas no tienen ningún efecto sobre el filtrado, pero se pueden usar para crear agrupaciones lógicas de reglas dentro de tu App. Cada regla puede tener solo una etiqueta, con un máximo de 255 caracteres. Las etiquetas se incluyen con la regla en formato JSON en el momento de su creación mediante la API, como se describe en nuestra página “Matching rules”.

​
Poner reglas en formato JSON

Para agregar o eliminar una regla de un stream a través de la API, las reglas deben utilizar el formato JSON. Básicamente, esto requiere colocar cada regla en la siguiente estructura: {"value":"insert_rule_here"} Reglas con comillas dobles Si la regla contiene caracteres de comillas dobles (") asociados con coincidencias exactas u otros operadores, deben escaparse usando una barra invertida para distinguirlos de la estructura del formato JSON. "social data" @XDevelopers La regla en formato JSON sería: {"value":"\"social data\" @XDevelopers"} Reglas con literales de cadena con comillas dobles Para incluir un carácter de comillas dobles como literal de cadena dentro de una coincidencia exacta, debe escaparse dos veces. Por ejemplo, para una regla que coincida con la frase exacta “Toys “R” Us”, incluyendo las comillas dobles alrededor de “R”, la representación en texto plano se vería de la siguiente manera: "Toys \"R\" Us" Al convertir esto a formato JSON, debes usar la siguiente estructura: {"value":"\"Toys \\\"R\\\" Us\""} Reglas con Tags Para incluir una tag opcional con tu regla, como se describió arriba, simplemente incluye un campo tag adicional con el valor de la regla. {"value":"\"social data\" @XDevelopers","tag":"RULE-TAG-01"} Formato para solicitudes de API Al agregar o eliminar reglas del stream a través de la API, varias reglas en formato JSON deben estar delimitadas por comas y envueltas en un array JSON rules, como se muestra a continuación: {"rules":[{"value":"from:XDevelopers"},{"value":"\social data\" @XDevelopers","tag":"RULE-TAG-01"}]}

​
Operadores que coinciden con Tweets citados

Cuando uses la PowerTrack API y la Historical PowerTrack API, los siguientes operadores coincidirán con contenido tanto de la Publicación original que fue citada como del nuevo Tweet citado. Sin embargo, si estás usando la Search API, estos operadores solo coincidirán con el contenido del Tweet citado y no con ningún contenido de la Publicación original que fue citada.
  • Keywords
  • Phrases
  • Proximity
  • #hashtags
  • @mentions
  • $cashtags
  • url:
  • url_contains:
  • has:links
  • has:mentions
  • has:hashtags
  • has:media
  • has:symbols
  • is:quote
  • is:reply

​
Operadores de Enterprise

A continuación se muestran los operadores disponibles con PowerTrack y Historical PowerTrack. Un subconjunto de ellos está disponible con las APIs de búsqueda de 30 días y de archivo completo (Full Archive). Consulta esta tabla para ver una lista de operadores disponibles por producto.  La siguiente lista muestra los idiomas actualmente admitidos y su correspondiente identificador de idioma BCP 47: Ejemplo: (@XDevelopers OR to:XDevelopers) lang:es Nota: El operador de idioma se aplica al idioma específico de la Publicación determinado por X y establecido en el atributo lang de la Publicación. Consulte aquí para obtener más información sobre los atributos JSON de X Entities. Si no se puede realizar una clasificación de idioma para una Publicación, el valor lang de la Publicación se establecerá como ‘und’ (por indefinido).

​
Operadores según producto

​
Reglas y filtrado: Enterprise

Todos los operadores de Enterprise están disponibles con las API de PowerTrack e Historical PowerTrack. Sin embargo, solo un subconjunto de operadores está disponible en las API de Enterprise Search, como se indica en esta página. Las etiquetas de color azul oscuro indican qué operadores están disponibles para distintos productos de Enterprise: PowerTrack Search