Cette page a été traduite par l'API Cloud Translation.

Obtenir les données sur vos performances

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

Vous devez choisir les informations que vous souhaitez inclure dans vos données: quels types de recherche (Web, image, vidéo, etc.) et les dimensions (page, requête, pays ou appareil), ainsi que l'opportunité de 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 les données d'une journée à l'aide de l'un des styles de requête décrits ci-dessous. L'exécution d'une requête quotidienne sur un jour 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 identifier les données les plus récentes disponibles, exécutez une requête simple dont les données sont regroupées par date sur les 10 derniers jours. Lorsque vous écrivez 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 d'apparence dans les résultats de recherche (AMP, lien bleu, résultat enrichi, etc.) doivent être interrogées selon 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 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 exécuter 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 d'analyse de la recherche expose un maximum de 50 000 lignes de données par jour et par type de recherche (Web, image, etc., triées par clic).

Détails de la requête

Vous pouvez interroger des données regroupées par page ou par propriété.

Regroupé par page

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",
"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érez chaque valeur type 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: inclure page. Vous pouvez également inclure n'importe quelle combinaison de query, country ou device.
type: énumérez chaque valeur type dans une requête distincte.

Regroupé 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 sur la requête, le pays et/ou l'appareil), au risque de perdre des 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: vous pouvez inclure toute combinaison de query, country ou device.
type: énumérez chaque valeur type 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 et non par propriété. En savoir plus

Pourquoi est-ce que je perds des données lorsque je me demande plus de détails ?

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 afficher des informations sur l'apparence dans les résultats de recherche pour votre site, vous devez procéder 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.
Si vous le souhaitez, vous pouvez exécuter une seconde requête, en filtrant selon l'un des types d'apparences dans les résultats de recherche répertoriés à l'étape 1, 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'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 listé à 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 est de 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"
        }
      ]
    }
  ]
}

Résultats :

Répartition de AMP_BLUE_LINK par type 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
  },
...