Creare un'esportazione dei segmenti di pubblico

I segmenti di pubblico in Google Analytics ti permettono di suddividere gli utenti in base agli aspetti più importanti per la tua attività. Con i segmenti di pubblico, puoi raggruppare gli utenti del tuo sito o della tua applicazione in base ad attributi condivisi.

Puoi esportare i segmenti di pubblico, incluso uno snapshot dei relativi utenti, utilizzando l' API Data.

Consulta la guida alle aspettative dei dati di esportazione dei segmenti di pubblico per informazioni importanti sui dati visualizzati nelle esportazioni dei segmenti di pubblico.

Panoramica

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

  1. Chiama il audienceExports.create metodo per creare un'esportazione di segmenti di pubblico.
  2. Chiama il audienceExports.query metodo per recuperare gli utenti del segmento di pubblico.

Per ulteriori informazioni, puoi chiamare audienceExports.get per recuperare i metadati di configurazione di un'esportazione di segmenti di pubblico specifica e audienceExports.list per elencare tutte le esportazioni di segmenti di pubblico per una proprietà specifica.

Selezionare un'entità di reporting

Tutti i metodi dell'API Data richiedono che l'identificatore della proprietà Google Analytics sia specificato all'interno di un percorso della richiesta URL, nel formato properties/GA_PROPERTY_ID. Ad esempio:

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

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

Se utilizzi una delle librerie client dell'API Data, non devi modificare il percorso dell'URL della richiesta. La maggior parte dei client API fornisce un parametro property che prevede una stringa nel formato properties/GA_PROPERTY_ID. Per esempi di utilizzo delle librerie client, consulta la guida rapida.

Creare un'esportazione di segmenti di pubblico

Per creare un'esportazione di segmenti di pubblico, chiama il audienceExports.create metodo utilizzando l' AudienceExport oggetto nella richiesta. Sono necessari i seguenti parametri:

  • Un nome di segmento di pubblico valido nel audience campo, formattato come properties/{propertyId}/audiences/{audienceId}. Puoi utilizzare il audiences.list metodo dell'API Google Analytics Admin v1 per ottenere questo valore. Il campo Audience.name della risposta audiences.list contiene il nome del segmento di pubblico.
  • Un elenco valido di dimensioni nel dimensions campo. L'elenco delle dimensioni supportate da questo metodo è disponibile nella documentazione dello schema di esportazione dei segmenti di pubblico. In un'esportazione di segmenti di pubblico sono inclusi solo i dati delle dimensioni menzionate in questo campo.

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

Richiesta HTTP

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

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

Risposta HTTP

{
  "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 di segmenti di pubblico.

Eseguire query sullo stato di preparazione dell'esportazione di segmenti di pubblico

La generazione dell'esportazione di segmenti di pubblico potrebbe richiedere alcuni minuti dopo la audienceExports.create chiamata.

Puoi controllare lo stato di preparazione di un'esportazione di segmenti di pubblico chiamando il audienceExports.get metodo.

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

Ecco una richiesta di esempio:

Richiesta HTTP

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

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

Ecco una risposta di esempio:

Risposta HTTP

{
  "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 di segmenti di pubblico chiamando il audienceExports.list metodo.

Recuperare gli utenti da un'esportazione di segmenti di pubblico

Una volta generata l'esportazione di segmenti di pubblico, chiama il metodo audienceExports.query e specifica il dell'esportazione di segmenti di pubblico name nella richiesta.

Ecco una richiesta di esempio:

Richiesta HTTP

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

Se l'esportazione di segmenti di pubblico è pronta, questa chiamata restituisce l'elenco degli utenti del segmento di pubblico.

Ecco una risposta di esempio:

Risposta HTTP

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