Vous pouvez interroger rapidement vos données de performances sans dépasser votre quota en exécutant une requête quotidienne portant sur une journée de données.
Vous devez choisir les informations que vous souhaitez inclure dans vos données : les types de recherche (Web, image, vidéo, etc.) : et les dimensions (page, requête, pays ou appareil), et si vous souhaitez regrouper les résultats par page ou propriété. Lorsque vous interrogez une page et/ou une chaîne de requête, certaines données peuvent être supprimées (en savoir plus).
Présentation
- Nous vous recommandons d'exécuter une requête chaque jour pendant toute une journée de données en utilisant l'un des styles de requête décrits ci-dessous. L'exécution d'une requête quotidienne sur une journée de données ne doit pas dépasser votre quota quotidien. Les données sont généralement disponibles au bout de deux ou trois jours. Pour savoir quelles sont les données les plus récentes disponibles, exécutez une requête simple regroupée par date pour les 10 derniers jours. Dans votre requête :
- Indiquez si vous souhaitez regrouper les résultats par page ou par propriété.
- Indiquez si vous souhaitez obtenir des nombres plus complets ou davantage de variables dans votre requête. Remarque : Les données d'apparence dans les résultats de recherche (AMP, lien bleu, résultat enrichi, etc.) doivent être interrogées à l'aide d'un processus en deux étapes.
- Parcourez les résultats en réexécutant la même requête, en augmentant la valeur
startRow
de 25 000 dans la requête jusqu'à atteindre la dernière page (une réponse avec 0 ligne). - Vous pouvez éventuellement exécuter la même requête avec un autre paramètre
type
.
Voici un exemple de pseudo-code pour une seule requête. Vous pouvez l'exécuter une fois par jour pour chaque valeur type
pour laquelle vous souhaitez obtenir des données.
int maxRows = 25000; // Current max response size int i = 0; do { response = Request(startDate = 3_days_ago, endDate = 3_days_ago, ... add dimensions, type ... rowLimit = maxRows, startRow = i * maxRows); i++; … // Do something with the response data. } while (response.rows.count() != 0); // Page through all result rows
Limites de données
En plus du quota d'utilisation de l'API, la méthode Search Analytics expose un maximum de 50 000 lignes de données par jour et par type de recherche (Web, images, etc., triées par clics).
Détails de la requête
Vous pouvez interroger des données regroupées par page ou par propriété.
Regroupement par page
Pour effectuer un décompte précis,vous devez omettre les dimensions de page et de requête, comme suit:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["country", "device"], "type": "web", "aggregationType": "byPage"
startDate
/endDate
: choisissez une période d'un jour en sélectionnant la même date.dimensions
: vous pouvez inclurecountry
et/oudevice
.type
Énumérez plus de chaquetype
valeur selon vos besoins dans une requête distincte.aggregationType
: doit êtrebyPage
.
Pour obtenir des informations plus détaillées, y compris sur les pages et/ou les requêtes, au risque de perdre des données, exécutez une requête telle que celle-ci:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["page", "query", "country", "device"], "type": "web"
startDate
/endDate
: choisissez une période d'un jour en sélectionnant la même date.dimensions
:page
inclus. Vous pouvez éventuellement inclure n'importe quelle combinaison dequery
,country
oudevice
.type
Énumérez plus de chaquetype
valeur selon vos besoins dans une requête distincte.
Regroupement par propriété
Pour effectuer un décompte précis, vous devez omettre les dimensions de page et de requête, comme suit:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["country", "device"], "type": "web"
startDate
/endDate
: choisissez une période d'un jour en sélectionnant la même date.dimensions
: vous pouvez inclurecountry
et/oudevice
.type
Vous pouvez également énumérer chaquetype
valeur selon vos besoins dans une requête distincte.
Pour obtenir davantage de détails, y compris des informations sur la requête, le pays et/ou l'appareil, au risque de perdre des données, exécutez une requête telle que celle-ci:
"startDate": "2018-06-01", "endDate": "2018-06-01", "dimensions": ["query", "country", "device"], "type": "web"
startDate
/endDate
: choisissez une période d'un jour en sélectionnant la même date.dimensions
: vous pouvez éventuellement inclure n'importe quelle combinaison dequery
,country
oudevice
.type
Énumérez plus de chaquetype
valeur selon vos besoins dans une requête distincte.
Regrouper les résultats par page ou propriété
Les impressions, les clics, la position et le taux de clics sont calculés différemment en regroupant les résultats par page plutôt que par propriété. En savoir plus
Pourquoi est-ce que je perds des données lorsque je demande plus de détails ?
Lorsque vous effectuez un regroupement par page et/ou requête, notre système peut supprimer des données afin de calculer les résultats dans un délai raisonnable en utilisant une quantité raisonnable de ressources de calcul.
Obtenir des données sur l'apparence dans les résultats de recherche
L'apparence dans les résultats de recherche n'est pas disponible en tant que colonne avec d'autres dimensions. Par conséquent, si vous souhaitez consulter les informations sur l'apparence dans les résultats de recherche pour votre site, procédez comme suit:
- Spécifiez
searchAppearance
comme seule dimension, qui regroupera toutes les données par type d'apparence dans les résultats de recherche sans aucune autre dimension. - Vous pouvez également exécuter une deuxième requête en filtrant sur l'un des types d'apparence dans les résultats de recherche mentionnés à l'étape 1, en ajoutant toutes les variables souhaitées à la requête (page, pays, requête, etc.).
Pour récupérer des données sur plusieurs types d'apparences dans les résultats de recherche, vous devez exécuter la deuxième étape une fois par type d'apparence dans les résultats de recherche répertorié à l'étape 1.
Première requête:
obtenir la liste des types d'apparences dans les résultats de recherche sur votre site ;
{ "startDate": "2018-05-01", "endDate": "2018-05-31", "type": "web", "dimensions": [ "searchAppearance" ] }
Résultats :
Votre site est associé au type INSTANT_APP, AMP_BLUE_LINK, etc.
"rows": [ { "keys": [ "INSTANT_APP" ], "clicks": 443024.0, "impressions": 4109826.0, "ctr": 0.10779629113251997, "position": 1.088168452873674 }, { "keys": [ "AMP_BLUE_LINK" ], "clicks": 429887.0, "impressions": 1.7090884E7, "ctr": 0.025152999692701676, "position": 7.313451603790653 },...
Deuxième requête :
Filtrez les données par l'un des types d'apparences dans les résultats de recherche de l'étape 1, ainsi que les dimensions de votre choix (page, appareil, etc.). Ici, nous filtrons les données par AMP_BLUE_LINK.
{ "startDate": "2018-05-01", "endDate": "2018-05-31", "type": "web", "dimensions": [ "device" // and/or page, country, ... ], "dimensionFilterGroups": [ { "filters": [ { "dimension": "searchAppearance", "operator": "equals", "expression": "AMP_BLUE_LINK" } ] } ] }
Résultats :
Répartition des AMP_BLUE_LINK par types d'appareil.
"rows": [ { "keys": [ "MOBILE" ], "clicks": 429887.0, "impressions": 1.7090783E7, "ctr": 0.025153148337323107, "position": 7.31339517914422 }, { "keys": [ "DESKTOP" ], "clicks": 0.0, "impressions": 66.0, "ctr": 0.0, "position": 12.257575757575758 }, ...