Skip to main content

Premiers pas avec les règles et requêtes Enterprise

Les produits qui utilisent des opérateurs Enterprise vous fournissent des données sociales en fonction des règles de filtrage que vous définissez. Les règles sont constituées d’une ou plusieurs « clauses », où une clause est un mot-clé, une expression exacte ou l’un des nombreux opérateurs Enterprise. Avant de commencer à créer des règles avec des opérateurs Enterprise, assurez-vous de passer en revue la syntaxe décrite ci-dessous, de consulter la liste des opérateurs disponibles et de comprendre les contraintes liées à la création de règles. Vous devez également bien comprendre les subtilités de l’évaluation logique des règles, dans la section « Order of operations ». Plusieurs clauses peuvent être combinées avec une logique « et » et « ou ». Remarque : la logique « et » est spécifiée par un espace entre les clauses, tandis que la logique « ou » est spécifiée par un OR en majuscules.  Chaque règle peut contenir jusqu’à 2 048 caractères, sans limite quant au nombre de clauses positives (éléments que vous souhaitez inclure dans la correspondance ou le filtrage) et de clauses négatives (éléments que vous souhaitez exclure et ne pas faire correspondre).  

Création de règles et de requêtes

Correspondance par mot-clé Les correspondances par mot-clé sont similaires aux requêtes dans une interface de recherche. Par exemple, l’opérateur de règle Enterprise suivant ferait correspondre les activités contenant le terme « social » dans le corps du texte. social Combiner des termes avec un espace Ajouter un autre mot-clé revient à ajouter une autre condition pour trouver des correspondances. Par exemple, cette règle ne ferait correspondre que les activités où « social » et « media » sont tous les deux présents dans le texte, dans n’importe quel ordre – le fait d’avoir un espace entre les termes fonctionne comme une logique booléenne AND. Si vous incluez un AND explicite dans votre règle, il sera rejeté par le point de terminaison des règles. social media Combiner des termes avec OR en majuscules De nombreuses situations nécessitent cependant une logique booléenne OR. Cela est aussi très simple à réaliser. Remarquez que l’opérateur OR doit être en majuscules et qu’un « or » en minuscules sera traité comme un mot-clé ordinaire. social OR data Négation de termes D’autres scénarios peuvent nécessiter l’exclusion de résultats contenant certains mots-clés (logique booléenne NOT). Par exemple, des activités avec « happy », mais en excluant celles contenant « birthday » dans le texte. social -personality Regroupement avec des parenthèses Ces types de logique peuvent être combinés en utilisant le regroupement avec des parenthèses et étendus à des requêtes beaucoup plus complexes. (social OR data) (academic OR research) -personality -information -university Ce n’est cependant qu’un début – bien que les exemples ci‑dessus reposent simplement sur une mise en correspondance tokenisée des mots-clés, les produits Enterprise offrent également des opérateurs pour effectuer différents types de correspondance sur le texte. Correspondance exacte "social media research" Correspondance par sous-chaîne contains:info Correspondance par proximité "social media research"~3 En outre, d’autres opérateurs vous permettent de filtrer selon des aspects uniques des données sociales, au‑delà du simple texte.  L’utilisateur qui publie une Publication from:XDeveloeprs Tweets géolocalisés dans un rayon de 10 miles autour de Pearl St. à Boulder, CO, États-Unis point_radius:[-105.27346517 40.01924738 10.0mi] Combiner tous les éléments Ceux‑ci peuvent être combinés avec des filtres de texte en utilisant les mêmes types de logique que ceux décrits ci‑dessus. (social OR data) (academic OR research OR "social media research") point_radius:[-105.27346517 40.01924738 10.0mi] lang:en -personality -information -university

Syntaxe booléenne

Les exemples de la section précédente utilisaient différents types de logique booléenne et de regroupement. Consultez le tableau ci‑dessous pour plus de détails sur la syntaxe et les exigences de chacune. Veuillez noter : les opérateurs peuvent être positifs ou négatifs. Les opérateurs positifs définissent ce que vous souhaitez inclure dans les résultats. Par exemple, l’opérateur has:hashtags signifie « Je veux des activités contenant des hashtags. » Les opérateurs négatifs définissent ce que vous souhaitez exclure des résultats et sont créés en utilisant la logique booléenne NOT décrite ci‑dessus. Par exemple, -has:hashtags signifie « Exclure toute activité contenant des hashtags, même si elle correspond par ailleurs à ma règle. » Les produits d’opérateurs Premium n’ont aucune restriction sur le nombre de clauses positives et négatives, sous réserve d’une longueur maximale de 2 048 caractères.  

Ordre des opérations

Lorsque vous combinez la logique AND et OR dans une même règle, l’ordre des opérations suivant détermine la façon dont votre règle est évaluée.
  1. Les opérateurs connectés par la logique AND sont d’abord combinés
  2. Ensuite, les opérateurs connectés par la logique OR sont appliqués
Exemple :
  • apple OR iphone ipad sera évalué comme apple OR (iphone ipad)
  • ipad iphone OR android sera évalué comme (iphone ipad) OR android
Pour éliminer toute ambiguïté et garantir que vos règles sont évaluées comme prévu, regroupez les termes entre parenthèses lorsque cela est approprié. Par exemple :
  • (apple OR iphone) ipad
  • iphone (ipad OR android)

Ponctuation, signes diacritiques et sensibilité à la casse

Si vous spécifiez, pour des opérateurs Enterprise, une règle de mot-clé ou de hashtag contenant des accents ou des signes diacritiques, elle correspondra au texte des Publications en respectant ces diacritiques (dans les hashtags ou les mots-clés). Une règle avec un mot-clé Diacr**í**tica ou un hashtag #cumplea**ñ**os correspondra à « Diacrítica » ou « #cumpleaños », mais pas à « Diacritica » ou « #cumpleanos » sans la tilde sur í ou sans le eñe. Les caractères accentués ou comportant des signes diacritiques sont traités de la même façon que les autres caractères et ne sont pas considérés comme des délimiteurs de mots. Par exemple, une règle cumpleaños ne correspondrait qu’aux activités contenant le mot cumpleaños et ne correspondrait pas aux activités contenant cumplea, cumplean ou os. Tous les opérateurs sont évalués sans tenir compte de la casse. Par exemple, la règle Cat correspondra à tous les éléments suivants : « cat », « CAT », « Cat ».

Balises de règles PowerTrack

Comme décrit sur notre page « Matching rules », chaque règle peut être créée avec une balise. Ces balises n’ont aucun effet sur le filtrage, mais peuvent être utilisées pour créer des regroupements logiques de règles au sein de votre App. Chaque règle ne peut avoir qu’une seule balise, avec une longueur maximale de 255 caractères. Les balises sont incluses avec la règle au format JSON lors de leur création via l’API, comme décrit sur notre page « Matching rules ».

Formatage des règles en JSON

Pour ajouter ou supprimer une règle d’un flux via l’API, les règles doivent utiliser le format JSON. Concrètement, cela implique de placer chaque règle dans la structure suivante : {"value":"insert_rule_here"} Règles avec des guillemets doubles Si la règle contient des caractères de guillemet double () associés à des correspondances exactes ou à d’autres opérateurs, ils doivent être échappés avec une barre oblique inverse afin de les distinguer de la structure du format JSON. "social data" @XDevelopers La règle au format JSON serait : {"value":"\"social data\" @XDevelopers"} Règles avec des littéraux de chaîne contenant des guillemets doubles Pour inclure un caractère de guillemet double comme littéral de chaîne dans une correspondance exacte, il doit être échappé deux fois. Par exemple, pour une règle correspondant exactement à la phrase “Toys “R” Us”, incluant les guillemets doubles autour de “R”, la représentation en texte brut ressemblerait à ceci : "Toys \"R\" Us" En convertissant cela au format JSON, vous devez utiliser la structure suivante : {"value":"\"Toys \\\"R\\\" Us\""} Règles avec des tags Pour inclure un tag facultatif avec votre règle, comme décrit ci-dessus, il suffit d’ajouter un champ tag supplémentaire avec la valeur de la règle. {"value":"\"social data\" @XDevelopers","tag":"RULE-TAG-01"} Formatage pour les requêtes API Lorsque vous ajoutez ou supprimez des règles du flux via l’API, plusieurs règles au format JSON doivent être séparées par des virgules et encapsulées dans un tableau JSON rules, comme illustré ci-dessous : {"rules":[{"value":"from:XDevelopers"},{"value":"\social data\" @XDevelopers","tag":"RULE-TAG-01"}]}

Opérateurs correspondant aux Tweets cités

Lorsque vous utilisez la PowerTrack API et la Historical PowerTrack API, les opérateurs ci-dessous correspondent au contenu à la fois de la Publication originale citée et du nouveau Tweet cité. Cependant, si vous utilisez la Search API, ces opérateurs ne correspondent qu’au contenu du Tweet cité et ne correspondent à aucun contenu de la Publication originale citée.
  • Keywords
  • Phrases
  • Proximity
  • #hashtags
  • @mentions
  • $cashtags
  • url:
  • url_contains:
  • has:links
  • has:mentions
  • has:hashtags
  • has:media
  • has:symbols
  • is:quote
  • is:reply

Opérateurs Enterprise

Vous trouverez ci-dessous les opérateurs disponibles avec PowerTrack et Historical PowerTrack. Un sous-ensemble d’entre eux est disponible avec les API de recherche 30-Day et Full-Archive. Consultez ce tableau pour une liste, produit par produit, des opérateurs disponibles.  La liste ci-dessous représente les langues actuellement prises en charge et leur identifiant de langue BCP 47 associé : Exemple : (@XDevelopers OR to:XDevelopers) lang:es Remarque : L’opérateur de langue se base sur la langue spécifique de la Publication, telle que déterminée par X et renseignée dans l’attribut de Publication lang. Voir ici pour plus d’informations sur les attributs JSON des entités X. Si aucune classification de langue ne peut être effectuée pour une Publication, la valeur lang de la Publication sera définie à « und » (pour « indéfini »).

Opérateurs par produit

Règles et filtrage : Enterprise

Tous les opérateurs Enterprise sont disponibles avec les API PowerTrack et Historical PowerTrack. Toutefois, seuls certains opérateurs sont disponibles pour les API de recherche Enterprise, comme indiqué sur cette page. Les tags en bleu foncé indiquent les opérateurs disponibles pour les différents produits Enterprise : PowerTrack Search