llms.txt et Google Analytics sur le site

Présentation

Après avoir pris soin du référencement, du sitemap, des robots.txt, des pages de cours, des FAQ et du contenu structuré, j'ai commencé à regarder un nouveau front : comment faciliter la lecture du site par des outils d'intelligence artificielle.

C'est là que le dossier est entré. llms.txt.

L'idée est simple: si les moteurs de recherche utilisent sitemap.xml e robots.txt Pour mieux comprendre un site Web, il est également logique d'offrir un fichier clair, organisé et direct pour les modèles de langue, les assistants d'IA et les outils qui doivent interpréter le contenu d'une page.

Mais je ne voulais pas seulement publier le fichier et espérer que quelqu'un y accéderait.

Donc j'ai configuré Google Analytics 4 pour voir si llms.txt J'étais consulté.

Qu'est-ce que llms.txt ?

O llms.txt il s'agit d'une proposition de standardisation de mettre, à la racine d'un site, un fichier Markdown avec des informations conçues pour aider les modèles linguistiques à mieux comprendre ce site lorsqu'ils doivent répondre à des questions ou chercher un contexte.

Dans la pratique, il fonctionne comme un résumé organisé du site.

Au lieu d'une IA besoin de naviguer à travers plusieurs pages, menus, scripts, bannières et structures HTML, le llms.txt offre un chemin plus propre: explique ce qu'est le site, quelles sont les pages les plus importantes et où trouver les informations pertinentes.

Ceci est important parce que les modèles linguistiques ont une limite pratique: ils ne peuvent pas mettre un site entier, avec tous ses détails, dans le contexte d'une réponse.

Le site du projet llms.txt lui-même explique que le complexe HTML, la navigation, les annonces et JavaScript peuvent rendre difficile l'extraction de contenu utile pour les LLM.

Pourquoi est-ce important pour My Robot ?

Dans le cas de My Robot Barra da Tijuca, le site n'est pas seulement une carte de visite.

C'est-à-dire qu'il y a beaucoup de contexte important.

Lorsqu'une personne demande une IA quelque chose comme:

Où avez-vous un cours de robotique pour les enfants à Barra da Tijuca?

ou

Quelle école enseigne la programmation et l'intelligence artificielle pour les adolescents à Rio de Janeiro?

Je veux que le contenu de My Robot soit aussi clair que possible pour être compris correctement.

O llms.txt n'est pas une garantie de rang, ni remplace SEO, Google Business Profile, bien écrit contenu ou annonces. C'est une couche complémentaire d'organisation.

Son travail est d'aider IA à mieux comprendre le site.

ilms.txt ne remplace pas le sitemap ou les robots.txt

Ce point est important.

O sitemap.xml aide les chercheurs à trouver des pages indexables.

O robots.txt indique les règles d'accès pour les robots.

Les llms.txt Le projet lui-même explique qu'il a été pensé coexister avec les modèles web actuels, complétant le sitemap et robots.txt, ne remplaçant pas ces fichiers.

Donc, dans la pratique, je vois ça comme ça :

robots.txt   = orienta acesso de robôs
sitemap.xml  = lista páginas importantes
llms.txt     = explique clairement le site aux outils d'IA

Chacun a une fonction différente.

Quelle devrait être la structure d'un ilms.txt?

Le format recommandé est Markdown.

Le fichier devrait de préférence rester à la racine du site, en /llms.txt, et vous devez avoir au moins un titre principal avec le nom du projet ou le site Web. Vous pouvez également avoir un résumé, des explications supplémentaires et des listes de liens organisés par sections.

Un exemple simple serait:

# My Robot Barra da Tijuca

> École de robotique, de programmation et de technologie éducative pour enfants et adolescents à Barra da Tijuca, Rio de Janeiro.

## Pages principales
- [Cours](https://www.exemplo.com/cursos.html) : cours de robotique, de programmation, d'IA et de technologie.
- [FAQ](https://www.exemplo.com/faq.html) : principales questions des familles et des responsables.
- [Contact](https://www.exemplo.com/contato.html) : adresse, WhatsApp et moyens de contact.

L'idéal est d'utiliser un langage objectif, des liens bien décrits et d'éviter les termes ambigus.

Le projet lui-même recommande un langage clair, des descriptions informatives sur les liens et les tests avec les modèles de langue pour vérifier s'ils peuvent bien répondre au contenu du site.

Le problème : Google Analytics ne mesure pas automatiquement llms.txt

Après avoir publié le dossier, j'ai posé une question pratique :

Comment savoir si quelqu'un a accès aux llms.txt?”

La première tentative a été de regarder GA4 en temps réel. .txt n'est pas une page HTML.

Il ne charge pas le script Google Analytics.

Il n'a pas <head>.

Il n'exécute pas JavaScript.

Donc si je publie le fichier en texte simple, GA4 ne mesurera probablement pas l'accès automatiquement.

C'est pourquoi je devais créer une mesure côté serveur.

La solution : envoyer un événement à GA4 via le protocole de mesure

Pour résoudre cela, j'ai utilisé le protocole de mesure Google Analytics 4.

Measurement Protocol est un moyen d'envoyer des événements directement aux serveurs Google Analytics par requêtes HTTP.

La documentation Google elle-même explique qu'elle vous permet d'envoyer des données à Analytics différemment de gtag, Google Tag Manager ou Firebase, exigeant que les événements soient programmés manuellement.

Dans mon cas, la logique était la suivante :

1. Alguém acessa /llms.txt
2. O servidor entrega o arquivo normalmente
3. Ao mesmo tempo, o servidor envia um evento para o GA4
4. O evento aparece no Analytics como llms_txt_access

L'événement que j'ai créé était :

llms_txt_access

Avec cela, je peux dire si l'URL est consultée sans dépendre de JavaScript dans le navigateur.

Comment j'ai configuré la mesure dans GA4

Le processus comportait deux parties : une dans Google Analytics et une autre dans le code du site.

1. J'ai l'ID de mesure

En GA4, je suis allé à:

Administrador > Coleta e modificação de dados > Fluxos de dados

Puis j'ai sélectionné le flux web du site et copié l'ID métrique, qui a ce format:

G-XXXXXXXXXX

Cette valeur a été enregistrée comme variable d'environnement:

GA4_MEASUREMENT_ID

2. J'ai créé l'API secrète du protocole de mesure

Toujours dans le flux web, j'ai accédé:

Chaves secretas da API Measurement Protocol

Puis j'ai cliqué sur la création d'une nouvelle clé.

Cette clé a été enregistrée comme:

GA4_API_SECRET

Voici un soin important : cette clé ne doit pas être exposée dans le dépôt HTML, dans le public JavaScript ou dans le dépôt GitHub.

Comment l'événement est envoyé

L'implémentation côté serveur envoie un POST pour le paramètre GA4 Measurement Protocol.

La charge utile utilisée suit cette idée :

{
  "client_id": "id_anonimo_gerado_no_servidor",
  "events": [
    {
      "name": "llms_txt_access",
      "params": {
        "file_path": "/llms.txt",
        "file_url": "https://www.myrobotbarra.com.br/llms.txt",
        "content_type": "text/plain",
        "source_type": "server",
        "page_location": "https://www.myrobotbarra.com.br/llms.txt",
        "engagement_time_msec": 100,
        "session_id": 1234567890
      }
    }
  ]
}

Également inclus session_id e engagement_time_msec, car ces paramètres aident l'événement à apparaître correctement dans des rapports comme le temps réel.

Que ne pas envoyer à Google Analytics

Ce point est fondamental.

Je n'envoie pas de nom, de téléphone, d'email, d'IP, de WhatsApp, de données pour étudiants, d'adresse ou de données personnelles lors de cet événement.

Le but est juste de savoir que le fichier a été consulté.

Donc l'événement ne mesure que quelque chose de technique:

Alguém ou algum robô acessou /llms.txt

Ça ne mesure pas qui était la personne.

Je ne peux pas identifier le visiteur.

Ne transforme pas ça en parcours.

Comment puis-je valider si ça marche ?

Après l'implémentation, j'ai fait le test le plus simple:

1. Acessei /llms.txt no navegador.
2. Voltei ao Google Analytics.
3. Entrei em Relatórios > Tempo real.
4. Verifiquei se /llms.txt apareceu na tabela de páginas.

Et ça a marché.

GA4 a commencé à afficher l'accès au fichier en temps réel.

Après cela, vous pouvez également consulter:

Relatórios > Engajamento > Eventos

Et cherchez l'événement :

llms_txt_access

Cet événement devrait-il être une conversion?

Pas dans ma vision.

Accès llms.txt Ce n'est pas du plomb.

Ne pas cliquer sur WhatsApp.

Ce n'est pas un formulaire complet.

Ce n'est pas un programme expérimental.

C'est un événement technique.

Il sert à comprendre si les outils, les robots, les rampeurs ou les utilisateurs consultent le fichier. llms_txt_access comme conversion dans Google Ads.

Les principaux événements devraient représenter les résultats commerciaux confirmés :

conversa_whatsapp_iniciada
formulario_enviado
aula_marcada

Les vues de page, les clics téléphoniques, l'ouverture de page et d'autres événements de navigation restent utiles pour l'analyse, mais ne sont pas des événements principaux. clique_whatsapp, generate_lead e ContatoWhatsApp sont limités au mode de débogage pour éviter le comptage en double.

Ce que j'en ai appris

L'apprentissage principal est que le référencement technique et l'intelligence artificielle se rapprochent.

Auparavant, la préoccupation était seulement :

O Google consegue encontrar minhas páginas?

Maintenant la question commence à être:

As ferramentas de IA conseguem entender corretamente o meu site?

O llms.txt C'est exactement le problème.

Il ne résout pas tout, ne remplace pas le bon contenu et ne garantit pas la visibilité automatique. Mais il aide à organiser les informations du site plus clairement pour les modèles de langue.

Et la mesure de cet accès à GA4 permet d'éliminer le doute du champ d'hypothèse.

Au lieu de publier le fichier et d'attendre, je peux maintenant suivre s'il est consulté.

Conclusion

Créer un llms.txt C'est une initiative simple mais stratégique.

Pour un site web éducatif comme My Robot Barra da Tijuca, il aide à mieux expliquer la proposition, les cours, la méthodologie, les pages principales et les voies les plus importantes pour ceux qui cherchent des informations sur la robotique, la programmation et la technologie éducative.

Mais publier le fichier n'est que la moitié du travail.

L'autre moitié mesure.

En mettant en place un événement côté serveur dans Google Analytics 4, j'ai pu savoir si le fichier est accessible et valider que l'URL apparaît correctement dans les rapports en temps réel.

Dans la pratique, c'est le type d'ajustement technique qui n'apparaît pas pour le visiteur commun, mais améliore l'organisation numérique du site et prépare mieux la présence de la marque pour un environnement où les recherches, l'IA et le contenu structuré marchent de plus en plus ensemble.

Prochaine étape

Maintenant que l'événement fonctionne, je le suivrais chaque semaine :

Relatórios > Engajamento > Eventos > llms_txt_access

Quel est le rapport avec la programmation d'apprentissage?

Derrière une configuration comme celle-ci, il y a quelque chose de plus grand que « Move » en outil : il y a la logique de programmation, la lecture de documentation, l'organisation des données, l'intégration du système, la protection de la vie privée et la capacité de transformer un besoin réel en solution fonctionnelle.

Ce sont exactement les types de concepts qui rapprochent les jeunes du monde professionnel de la technologie.

Lorsqu'un étudiant comprend comment un événement est envoyé à un outil d'analyse, comment une API reçoit des données ou comment un système a besoin de gérer l'information en toute sécurité, il commence à se rendre compte que la programmation n'est pas seulement l'écriture de code : elle crée des ponts entre le problème, la logique et le résultat.

Cours connexes

Prochaines parcours pour continuer à apprendre

Si le thème de l'article avait un sens pour votre famille, ces parcours aident à transformer l'intérêt en un projet pratique.

Autobot

Arduino, capteurs et automatisation pour comprendre comment les commandes numériques déplacent les systèmes réels.

Cours

Produits connexes

Produits pour comprendre la programmation au-delà de l'écran

Bien que l'article soit technique, il parle de logique, d'événements, de données et d'intégrations. Ces produits aident les jeunes à comprendre comment le code et l'électronique peuvent se transformer en solutions réelles.

Plaque compatible Arduino Uno R3

Une base accessible pour connecter la programmation, les entrées, les sorties et les expériences physiques.

Voir dans Maker Store

Kit Arduino Maker Store

Convient pour explorer la logique, les capteurs, l'automatisation et les premiers projets de calcul physique.

Voir dans Maker Store

Kit Maker Connect 52 en 1

Aide à connecter la programmation, le montage et le dépannage dans des projets robotiques pratiques.

Voir dans Maker Store

Liens d'affiliation : En achetant pour ces liens, vous supportez My Robot Barra da Tijuca.

Sources consultées

• Proposition officielle
• Google Analytics 4 — Protocole de mesure
• Google Analytics 4 — Envoi d'événements
• Google Analytics 4 — Référence du protocole de mesure
• Politique Google Analytics sur les informations personnelles