Une propriété de catalogue représente un flux que vous envoyez à Google Knowledge Graph. Utilisez votre propriété de catalogue pour surveiller l'état et le contenu des ingestions de flux.
Le flux d'une propriété de catalogue comprend une ou plusieurs entités appartenant à la même verticale. Supposons que vous soyez un fournisseur de streaming vidéo et que vous disposiez d'un flux comprenant des entités individuelles associées à une action de visionnage (qui permet à un utilisateur de regarder un film sur un appareil). Dans ce cas, la verticale de votre flux serait "WatchAction", et les entités seraient "Movie", "TVSeries", "TVEpisode", etc.
Lorsque vous créez et configurez un flux en collaboration avec votre représentant Google, nous créons automatiquement une propriété de catalogue qui représente votre flux dans la Search Console.
Verticales acceptées
Les verticales suivantes sont acceptées par la Search Console :
- WatchAction (vidéo)
- ListenAction (musique, radio, podcast)
- ReadAction (livre, e-book, livre audio)
- BorrowAction (livre, e-book, livre audio)
- Play Game Action (jeu vidéo)
- Annonces immobilières
Utiliser votre propriété de catalogue pour surveiller votre flux
Les propriétés de catalogue offrent les fonctionnalités suivantes pour vous aider à surveiller vos flux sur Google :
- Surveiller l'état de chaque flux : à quel moment il a été lu, si Google a pu le lire, s'il existe des erreurs d'accès au fichier ou de syntaxe, etc.
- Afficher le nombre d'éléments que Google a pu importer ou non dans le dernier flux.
- Surveiller les problèmes de fichiers et d'entités lors de la dernière tentative d'ingestion et consulter l'historique des problèmes survenus au cours des 90 derniers jours.
Les propriétés de catalogue acceptent uniquement certains types d'entités.
Accédez à votre propriété de catalogue en utilisant le sélecteur de propriétés dans la partie supérieure de la barre de navigation de la Search Console :
Un compte Search Console peut contenir à la fois des propriétés de catalogue et de site Web.
Limites
La première version des propriétés de catalogue dans la Search Console présente certaines limites. Nous espérons pouvoir les éliminer et vous proposer davantage de fonctionnalités très prochainement.
- Les propriétés de flux sont actuellement en lecture seule dans la Search Console. Si vous souhaitez apporter des modifications à votre ingestion de flux, comme la programmation, la liste des fichiers ou d'autres paramètres, veuillez contacter votre représentant Google.
- Toutes les verticales ne sont pas acceptés. Consultez la liste des verticales acceptées.
- Les flux partiels ne sont pas acceptés.
- Seuls les envois basés sur des fichiers sont acceptés. Aucune autre méthode d'ingestion (API, etc.) ne peut être utilisée.
À propos des données
- Dans la plupart des cas, l'état d'une ingestion est affiché dans la Search Console au bout de quelques heures.
- L'état Valide ou Valide avec des avertissements ne garantit pas qu'une entité est ajoutée dans le Knowledge Graph. Ces états signifient que l'entité est éligible à y figurer. D'autres problèmes non présents dans la Search Console peuvent empêcher son ajout.
Tester votre flux pendant le développement
Vous pouvez utiliser cet outil de test en direct pour déboguer certaines parties de votre flux pendant le développement.
Flux en direct
La propriété de catalogue peut comporter un ou plusieurs flux. Le flux qui sera envoyé à Google s'appelle le flux en direct. Tous les autres flux servent uniquement à des tests.
Lorsque votre flux est prêt à être transmis à Google, demandez à votre représentant Google de désigner le flux choisi dans votre propriété en tant que flux en direct. Une fois qu'un flux est défini en tant que tel, toutes les ingestions réussies de ce flux sont transmises à Google. Un seul flux par propriété de catalogue peut être désigné comme flux en direct. Le flux en direct est signalé par le badge En direct dans la Search Console. L'apparition de ce badge après la première transmission réussie peut prendre quelques heures.
Vous ne pouvez pas modifier la désignation du flux en direct actif dans votre propriété. Si vous disposez de plusieurs flux et que vous souhaitez envoyer à Google un flux non diffusé en direct, vous devez en copier le contenu dans le flux en direct. Si vous souhaitez suspendre ou arrêter la transmission des flux, contactez votre représentant Google.
Surveiller les ingestions de flux
Pour consulter vos ingestions de flux, consultez la page "Vue d'ensemble" de votre propriété ou le rapport détaillé pour chaque flux. Les ingestions de flux sont programmées en dehors de la Search Console et indépendamment les unes des autres.
Si vous possédez un seul flux, il est simplement intitulé Flux dans la Search Console. Si vous en possédez plusieurs, chacun sera indiqué par le nom du flux dans la Search Console. Un flux n'apparaît dans votre propriété qu'après avoir été évalué et avoir reçu l'un des résultats d'ingestion.
Si un flux échoue pour une raison quelconque, Google continue à effectuer les ingestions de flux comme prévu.
Réussite et échec
Les flux peuvent connaître des échecs au niveau du fichier (lecture et analyse d'un fichier) et au niveau de l'entité (analyse et validation des entités dans le flux). Pour un flux en direct, une modification importante du nombre d'entités peut également entraîner un échec.
L'ingestion des flux dans le Knowledge Graph est atomique : en cas de réussite de l'ingestion, celle-ci est appliquée. En cas d'échec, elle n'est pas appliquée. Si l'ingestion est appliquée, la totalité de l'inventaire associé au flux est supprimée du Knowledge Graph et remplacée par toutes les entités éligibles de la nouvelle ingestion. Si une ingestion échoue, aucune modification n'est apportée à l'inventaire du Knowledge Graph.
Conseils pour réussir l'ingestion
- Assurez-vous que Google peut explorer vos fichiers de flux. Examinez la question avec votre représentant Google.
- Les échecs au niveau du fichier peuvent être temporaires. Nous vous recommandons d'attendre plusieurs erreurs de flux consécutives avant de tenter de déboguer les échecs d'ingestion, sauf si vous êtes certain d'en connaître l'origine.
- Le robot d'exploration de flux Google ignore les règles du fichier robots.txt.
- Le robot d'exploration des flux Google suit les redirections. Cependant, il est déconseillé d'utiliser des redirections permanentes dans votre flux. En cas de modification de l'emplacement des fichiers du flux, mettez plutôt à jour les paramètres de votre flux.