Obtenir vos données sur les performances

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

  1. 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.
  2. 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).
  3. 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 inclure country et/ou device.
  • type Énumérez plus de chaque type valeur selon vos besoins dans une requête distincte.
  • aggregationType : doit être byPage.

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 de query, country ou device.
  • type Énumérez plus de chaque type 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 inclure country et/ou device.
  • type Vous pouvez également énumérer chaque type 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 de query, country ou device.
  • type Énumérez plus de chaque type 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:

  1. 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.
  2. 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
  },
...