Créer une exportation d'audience

Audiences dans Google Analytics vous permettent de segmenter les utilisateurs afin de dégager les données importantes pour votre entreprise. Avec vous pouvez regrouper les utilisateurs de votre site ou application en fonction .

Vous pouvez exporter vos audiences, y compris un instantané de leurs utilisateurs, à l'aide de l'API API Data :

Consultez Attentes concernant les données d'exportation des audiences pour obtenir des informations importantes sur les données que vous voyez dans les exportations d'audiences.

Présentation

Envoyez les requêtes suivantes de l'API Data pour créer et interroger une exportation d'audience:

1. Appelez la méthode audienceExports.create. pour créer une exportation d'audience.
2. Appelez la méthode audienceExports.query. est utilisée pour récupérer les utilisateurs de l'audience.

Pour en savoir plus, vous pouvez appeler audienceExports.get jusqu'à récupérer les métadonnées de configuration concernant une exportation d'audience spécifique ; audienceExports.list jusqu'à répertorier toutes les exportations d'audiences pour une propriété spécifique ;

Sélectionner une entité de reporting

Toutes les méthodes de l'API Data nécessitent la propriété Google Analytics d'URL à spécifier dans le chemin d'une requête d'URL, dans l'attribut au format properties/GA_PROPERTY_ID. Exemple :

  POST  https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/audienceExports

Le rapport est généré en fonction des données d'événement Google Analytics collectées dans la propriété Google Analytics spécifiée.

Si vous utilisez l'une des bibliothèques clientes de l'API Data, il n'est pas nécessaire de modifier le chemin de l'URL de la requête. La plupart des clients API fournissent un property qui attend une chaîne au format properties/GA_PROPERTY_ID. Voir Le guide de démarrage rapide fournit des exemples d'utilisation des bibliothèques clientes.

Créer une exportation d'audience

Pour créer une exportation d'audience, appelez la méthode audienceExports.create à l'aide de la méthode AudienceExport dans votre requête. Les paramètres suivants sont requis :

• Un nom d'audience valide dans le audience au format properties/{propertyId}/audiences/{audienceId}. Vous pouvez utilisez la audiences.list de la version 1 de l'API Admin de Google Analytics. La Audience.name de la réponse audiences.list contient le nom de l'audience.
• Une liste valide de dimensions dans le dimensions . La liste des dimensions acceptées par cette méthode est disponible dans le Documentation sur le schéma d'exportation des audiences. Seuls les les données pour les dimensions mentionnées dans ce champ sont incluses dans une audience exporter.

Voici un exemple de requête permettant de créer une exportation d'audience:

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports
{
  "audience": "properties/1234567/audiences/12345",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ]
}

Une réponse de la méthode audienceExports.create contient les informations dans le champ name, par exemple properties/1234567/audienceExports/123. Voici un exemple de réponse :

{
  "response": {
    "@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceExport",
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "CREATING",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  }
}

Vous pouvez utiliser name pour interroger les utilisateurs à partir de l'exportation d'audience.

Interroger l'état de préparation de l'exportation d'audience

La génération de l'exportation d'audience peut prendre plusieurs minutes une fois que le audienceExports.create .

Vous pouvez vérifier l'état de préparation d'une exportation d'audience en appelant la méthode audienceExports.get.

Utilisez le nom d'exportation d'audience d'une réponse audienceExports.create pour spécifiez l'exportation d'audience dans votre demande.

Voici un exemple de requête:

GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123

L'état de préparation pour une exportation d'audience est renvoyé dans le champ state. de la réponse. Une fois la génération d'exportation d'audience terminée, son état passe de CREATING à ACTIVE.

Voici un exemple de réponse :

{
  "name": "properties/1234567/audienceExports/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "state": "CREATING",
  "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}

Vous pouvez obtenir l'état de toutes les exportations d'audiences en appelant la méthode audienceExports.list .

Récupérer les utilisateurs à partir d'une exportation d'audience

Une fois l'exportation d'audience générée, appelez la méthode audienceExports.query et spécifiez la name de l'exportation d'audience dans la requête.

Voici un exemple de requête:

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query

Si l'exportation d'audience est prête, cet appel renvoie la liste des utilisateurs du audience cible.

Voici un exemple de réponse :

{
  "audienceExport": {
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "ACTIVE",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  },
  "audienceRows": [
    {
      "dimensionValues": [
        {
          "value": "1000276123.1681742376"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000374452.1668627377"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000391956.1652750758"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000410539.1682018694"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000703969.1666725875"
        }
      ]
    }
  ],
  "rowCount": 5
}