Creare un'esportazione dei segmenti di pubblico

Segmenti di pubblico in Google Analytics ti consentono di suddividere gli utenti in base agli obiettivi più importanti per la tua attività. Con segmenti di pubblico, puoi raggruppare gli utenti del tuo sito o della tua applicazione in base ai segmenti di pubblico attributi.

Puoi esportare i segmenti di pubblico, inclusa un'istantanea dei loro utenti, utilizzando lo API di dati.

Consulta le aspettative relative ai dati sull'esportazione dei segmenti di pubblico per ottenere informazioni importanti sui dati visualizzati nelle esportazioni dei segmenti di pubblico.

Panoramica

Effettua le seguenti richieste di API di dati per creare ed eseguire query su un'esportazione dei segmenti di pubblico:

1. Chiama il audienceExports.create per creare un'esportazione dei segmenti di pubblico.
2. Chiama il audienceExports.query viene utilizzato per recuperare gli utenti nel segmento di pubblico.

Per ulteriori informazioni, puoi chiamare Da audienceExports.get a recuperare i metadati di configurazione su una specifica esportazione di segmenti di pubblico audienceExports.list a che elenca tutte le esportazioni dei segmenti di pubblico per una proprietà specifica.

Seleziona un'entità report

Tutti i metodi dell'API di dati richiedono la proprietà Google Analytics identificativo da specificare all'interno di un percorso di richiesta dell'URL, forma di properties/GA_PROPERTY_ID. Ecco un esempio:

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

Il report viene generato in base ai dati sugli eventi di Google Analytics raccolti in la proprietà Google Analytics specificata.

Se utilizzi una delle librerie client dell'API di dati, non è necessario modificare il percorso dell'URL della richiesta. La maggior parte dei client API offre un property parametro che prevede una stringa nel formato properties/GA_PROPERTY_ID. Consulta Guida rapida con esempi di utilizzo della librerie client.

Creare un'esportazione dei segmenti di pubblico

Per creare un'esportazione dei segmenti di pubblico, chiama il metodo audienceExports.create utilizzando la AudienceExport oggetto nella tua richiesta. I seguenti parametri sono obbligatori:

• Un nome del segmento di pubblico valido nel campo audience nel formato properties/{propertyId}/audiences/{audienceId}. Puoi utilizza la audiences.list dell'API Admin Google Analytics v1 per ottenere questo valore. La Audience.name della risposta audiences.list contiene il nome del segmento di pubblico.
• Un elenco valido di dimensioni nel dimensions . L'elenco delle dimensioni supportate da questo metodo è disponibile nella sezione Documentazione sullo schema di esportazione dei segmenti di pubblico. Solo il i dati relativi alle dimensioni menzionate in questo campo sono inclusi in un segmento di pubblico esporta.

Ecco un esempio di richiesta per creare un'esportazione dei segmenti di pubblico:

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

Una risposta del metodo audienceExports.create contiene i valori dell'esportazione dei segmenti di pubblico nome nel campo name, ad esempio properties/1234567/audienceExports/123. Ecco un esempio di risposta:

{
  "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"
  }
}

Puoi utilizzare name per eseguire query sugli utenti dall'esportazione dei segmenti di pubblico.

Esegui una query sullo stato di idoneità dell'esportazione dei segmenti di pubblico

Potrebbero essere necessari diversi minuti per generare l'esportazione dei segmenti di pubblico dopo il audienceExports.create chiamata.

Puoi controllare lo stato di idoneità di un'esportazione dei segmenti di pubblico richiamando il metodo audienceExports.get.

Utilizza il nome dell'esportazione dei segmenti di pubblico da una risposta audienceExports.create a specificare l'esportazione dei segmenti di pubblico nella richiesta.

Ecco una richiesta di esempio:

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

Lo stato di idoneità per un'esportazione dei segmenti di pubblico viene restituito nel campo state. della risposta. Una volta completata la generazione dell'esportazione dei segmenti di pubblico, lo stato modifiche da CREATING a ACTIVE.

Ecco un esempio di risposta:

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

Puoi ottenere lo stato di tutte le esportazioni dei segmenti di pubblico richiamando il metodo audienceExports.list .

Recuperare gli utenti da un'esportazione dei segmenti di pubblico

Dopo aver generato l'esportazione dei segmenti di pubblico, chiama il metodo audienceExports.query e specifica la name nella richiesta dell'esportazione dei segmenti di pubblico.

Ecco una richiesta di esempio:

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

Se l'esportazione dei segmenti di pubblico è pronta, questa chiamata restituisce l'elenco di utenti nel pubblico.

Ecco un esempio di risposta:

{
  "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
}