Primeros pasos con reglas y consultas enterprise
Los productos que utilizan operadores enterprise te entregan datos sociales según las reglas de filtrado que configures. Las reglas están compuestas por una o más ‘cláusulas’, donde una cláusula es una palabra clave, una frase exacta o uno de los muchos operadores enterprise. Antes de comenzar a construir reglas con operadores enterprise, asegúrate de revisar la sintaxis descrita a continuación, mirar la lista de operadores disponibles y comprender las restricciones sobre la construcción de reglas. También debes asegurarte de comprender los matices de cómo se evalúan lógicamente las reglas, 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 unOR en mayúsculas.
Cada regla puede tener hasta 2.048 caracteres de longitud sin límites en el número de cláusulas positivas (cosas con las que quieres coincidir o filtrar) y cláusulas negativas (cosas que quieres excluir y no coincidir).
Construcción de reglas y consultas
Coincidencia de palabra clave Las coincidencias de palabras clave son similares a las consultas en una interfaz de búsqueda. Por ejemplo, la siguiente regla con operador enterprise coincidiría con actividades que contengan el término “social” en el cuerpo del texto.social
Combinar términos con AND usando espacios en blanco
Añadir otra palabra clave es lo mismo que añadir 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 lógica booleana AND. Si incluyes un AND explícito en tu regla, será rechazada por el endpoint de rules.
social media
Combinar términos con OR usando OR en mayúsculas
Muchas situaciones en realidad requieren lógica booleana OR. Esto también se logra fácilmente. Ten en cuenta que el operador OR debe estar en mayúsculas y un ‘or’ en minúsculas será tratado como una palabra clave regular.
social OR data
Negar términos
Otros escenarios pueden requerir excluir resultados con ciertas palabras clave (lógica booleana NOT). Por ejemplo, actividades con ‘happy’, pero excluyendo cualquiera con ‘birthday’ en el texto.
social -personality
Agrupación con paréntesis
Estos tipos de lógica se pueden combinar usando agrupación con paréntesis, y expandir a consultas mucho más complejas.
(social OR data) (academic OR research) -personality -information -university
Esto es solo el comienzo — mientras que los ejemplos anteriores dependen simplemente de la coincidencia tokenizada de palabras clave, los productos enterprise también ofrecen operadores para realizar diferentes tipos de coincidencia en el texto.
Coincidencia exacta
"social media research"
Coincidencia de subcadena
contains:info
Coincidencia de proximidad
"social media research"~3
Además, otros operadores te permiten filtrar por aspectos únicos de los datos sociales, más allá del texto.
El usuario que está publicando un Post
from:XDevelopers
Tweets geoetiquetados dentro de 10 millas de Pearl St. en Boulder, CO, Estados Unidos
point_radius:[-105.27346517 40.01924738 10.0mi]
Juntándolo todo
Estos pueden combinarse con filtros de texto usando 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 y agrupación booleana. Consulta la tabla siguiente para más detalles sobre la sintaxis y los requisitos de cada uno.
Ten en cuenta: que los operadores pueden ser positivos o negativos.
Operadores positivos definen lo que quieres incluir en los resultados. Por ejemplo, el operador
has:hashtags dice “Quiero actividades que contengan hashtags”.
Operadores negativos definen lo que quieres excluir de los resultados, y se crean usando la lógica booleana NOT descrita anteriormente. Por ejemplo, -has:hashtags dice “Excluye cualquier actividad que contenga hashtags, aunque de otro modo coincida con mi regla”.
Los productos con operadores Premium no tienen restricción en el número de cláusulas positivas y negativas, sujetos a una longitud máxima de 2.048 caracteres.
Orden de operaciones
Al combinar la funcionalidad AND y OR en una única regla, el siguiente orden de operaciones dictará cómo se evalúa tu regla.- Los operadores conectados por lógica AND se combinan primero
- Luego, se aplican los operadores conectados con lógica OR
apple OR iphone ipadse evaluaría comoapple OR (iphone ipad)ipad iphone OR androidse evaluaría como(iphone ipad) OR android
(apple OR iphone) ipadiphone (ipad OR android)
Puntuación, diacríticos y sensibilidad a mayúsculas
Si especificas una regla de palabra clave o hashtag con acentos o diacríticos para operadores enterprise, coincidirá con el texto del Post respetando los diacríticos (hashtags o palabras clave). Una regla con la palabra claveDiacr**í**tica o el hashtag #cumplea**ñ**os coincidirá con “Diacrítica” o “#cumpleaños” pero no con “Diacritica” o “#cumpleanos” sin la tilde í o eñe.
Los caracteres con acentos o diacríticos se tratan igual que los caracteres normales y no se tratan como 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, ni os.
Todos los operadores se evalúan de forma insensible a mayúsculas. Por ejemplo, la regla Cat coincidirá con todos los siguientes: “cat”, “CAT”, “Cat”.
Tags de reglas de PowerTrack
Como se describe en nuestra página “Reglas coincidentes”, cada regla puede crearse con una etiqueta. Estas etiquetas no tienen efecto en el filtrado, pero pueden usarse para crear agrupaciones lógicas de reglas dentro de tu app. Cada regla solo puede tener una etiqueta, con un máximo de 255 caracteres. Las etiquetas se incluyen con la regla en formato JSON en el momento de la creación a través de la API, como se describe en nuestra página “Reglas coincidentes”.Poner las reglas en formato JSON
Para agregar o eliminar una regla de un stream a través de la API, las reglas deben usar formato JSON. Esencialmente, esto requiere poner cada regla en la siguiente estructura:{"value":"insert_rule_here"}
Reglas con comillas dobles
Si la regla contiene caracteres de comilla doble (") asociados con coincidencia exacta 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 comilla doble como literal de cadena dentro de una coincidencia exacta, debe estar doblemente escapado. Por ejemplo, para una regla que coincide con la frase exacta “Toys “R” Us”, incluyendo las comillas dobles alrededor de “R”, la representación en texto plano se vería así:
"Toys \"R\" Us"
Traduciendo esto a formato JSON, debes usar la siguiente estructura:
{"value":"\"Toys \\\"R\\\" Us\""}
Reglas con tags
Para incluir un tag opcional con tu regla, como se describe anteriormente, 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, las múltiples reglas en formato JSON deben delimitarse por comas y envolverse 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 Quote Tweets
Al usar la PowerTrack API y la Historical PowerTrack API, los operadores a continuación coincidirán con contenido tanto del Post original que fue citado como del nuevo Quote Tweet. Sin embargo, si estás usando la Search API, estos operadores solo coincidirán con el contenido del Quote Tweet, y no coincidirán con ningún contenido del Post original que fue citado.KeywordsPhrasesProximity#hashtags@mentions$cashtagsurl:url_contains:has:linkshas:mentionshas:hashtagshas:mediahas:symbolsis:quoteis:reply