Obtenir les données sur vos performances

Vous pouvez interroger rapidement vos données de performances, sans dépasser votre quota, en exécutant une requête quotidienne pour une journée de données.

Vous devez choisir les informations que vous souhaitez inclure dans vos données : les types de recherche (Web, images, vidéos, etc.). et les dimensions (page, requête, pays ou appareil), ainsi que si vous souhaitez regrouper les résultats par page ou par 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 sur l'équivalent de données d'une journée. Pour ce faire, utilisez l'un des modèles de requête décrits ci-dessous. L'exécution d'une requête quotidienne pour 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 à trois jours. Pour connaître les données les plus récentes, exécutez une requête simple groupée par date pour les 10 derniers jours. Lors de la rédaction de votre requête:
- Indiquez si vous souhaitez regrouper les résultats par page ou par propriété.
- Indiquez si vous souhaitez obtenir des décomptes plus complets ou plus de dimensions dans votre requête. Remarque : Les données sur l'apparence dans la 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 exécutant à nouveau 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 lignes).
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 effectuer cette opération 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 affiche 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é.

Regroupées par page

Pour obtenir des décomptes précis, vous devez omettre les dimensions "Page" et "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'une journée en sélectionnant la même date.
dimensions: vous pouvez inclure country et/ou device (facultatif).
type: énumérer sur chaque valeur type comme vous le souhaitez dans une requête distincte.
aggregationType: doit être byPage.

Pour obtenir plus de détails, y compris des informations sur la page et/ou la requête, au risque de perdre des données, exécutez une requête comme celle-ci:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["page", "query", "country", "device"],
"type": "web"

startDate / endDate: choisissez une période d'une journée en sélectionnant la même date.
dimensions : incluez page. Vous pouvez également inclure n'importe quelle combinaison de query, country ou device.
type: énumérer sur chaque valeur type comme vous le souhaitez dans une requête distincte.

Regroupées par propriété

Pour obtenir des décomptes précis,vous devez omettre les dimensions de page et de requête, comme ceci:

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["country", "device"],
"type": "web"

startDate / endDate: choisissez une période d'une journée en sélectionnant la même date.
dimensions: vous pouvez inclure country et/ou device (facultatif).
type : énumérez éventuellement chaque valeur type dans une requête distincte.

Pour obtenir plus de détails, y compris des informations sur la requête, le pays et/ou l'appareil, au détriment de la perte de certaines données, exécutez une requête comme celle-ci :

"startDate": "2018-06-01",
"endDate": "2018-06-01",
"dimensions": ["query", "country", "device"],
"type": "web"

startDate / endDate: choisissez une période d'une journée en sélectionnant la même date.
dimensions : incluez éventuellement une combinaison de query, country ou device.
type: énumérer sur chaque valeur type comme vous le souhaitez dans une requête distincte.

Regrouper les résultats par page ou par propriété

Les impressions, les clics, la position et le taux de clics sont calculés différemment lorsque vous regroupez les résultats par page plutôt que par propriété. En savoir plus

Why do I lose data when asking for more detail?

Lorsque vous effectuez un regroupement par page et/ou requête, notre système peut supprimer certaines données afin de pouvoir 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 sous forme de colonne avec les autres dimensions. Par conséquent, si vous souhaitez consulter les informations sur l'apparence de votre site dans la recherche, procédez comme suit :

Spécifiez searchAppearance comme seule dimension afin de regrouper 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 par l'un des types d'apparence de recherche listés à l'étape 1, et en ajoutant les dimensions souhaitées à la requête (page, pays, requête, etc.).

Pour récupérer des données sur plusieurs types d'apparence 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 indiqué à l'étape 1.

Première requête:

Obtenez la liste des types d'apparences dans les résultats de recherche de votre site.

{
  "startDate": "2018-05-01",
  "endDate": "2018-05-31",
  "type": "web",
  "dimensions": [
    "searchAppearance"
  ]
}

Résultats :

Votre site contient le 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 en fonction de l'un des types d'apparences dans les résultats de recherche décrits à l'étape 1, ainsi que des dimensions de votre choix (page, appareil, etc.). Ici, nous filtrons 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"
        }
      ]
    }
  ]
}