Concetti fondamentali di Esportazione dei segmenti di pubblico

I segmenti di pubblico in Google Analytics 4 ti consentono di segmentare gli utenti in base ai modi 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.

Con l'API di dati di Google Analytics v1 puoi generare esportazioni dei segmenti di pubblico, che includono un'istantanea degli utenti inclusi nel segmento di pubblico.

Creare un'esportazione del pubblico

La versione 1 dell'API di dati di Google Analytics utilizza un approccio asincrono per creare le esportazioni dei segmenti di pubblico. Innanzitutto, per creare un'esportazione dei segmenti di pubblico degli utenti è necessaria una richiesta al metodo audienceExports.create. Poi, il metodo audienceExports.query viene utilizzato per recuperare gli utenti nel segmento di pubblico.

Inoltre, puoi utilizzare audienceExports.get per recuperare i metadati di configurazione su un'esportazione dei segmenti di pubblico specifica e audienceExports.list per elencare tutte le esportazioni dei segmenti di pubblico per una proprietà.

Seleziona un'entità segnalante

Tutti i metodi dell'API di dati v1 richiedono l'identificatore della proprietà Google Analytics 4 da specificare all'interno di un percorso di richiesta dell'URL nella forma di properties/GA4_PROPERTY_ID, ad esempio:

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

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

Se utilizzi una delle librerie client dell'API di dati, non è necessario modificare manualmente il percorso dell'URL della richiesta. La maggior parte dei client API fornisce un parametro property che prevede una stringa in forma di properties/GA4_PROPERTY_ID. Consulta la guida rapida per esempi di utilizzo delle librerie client.

Richiedere la creazione dell'esportazione del pubblico

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

• Un nome del segmento di pubblico valido nel campo audience, con il formato properties/{propertyId}/audiences/{audienceId}. Per ottenere questo valore, puoi utilizzare il metodo audiences.list dell'API Google Analytics Admin v1. Il campo Audience.name della risposta audiences.list contiene il nome del segmento di pubblico.
• Un elenco valido di dimensioni nel campo dimensions. L'elenco delle dimensioni supportate da questo metodo è disponibile nella documentazione relativa allo schema di esportazione dei segmenti di pubblico. Solo i dati relativi alle dimensioni menzionate in questo campo sono inclusi in un'esportazione dei segmenti di pubblico.

Esempio di richiesta di creazione dell'esportazione del 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 dei segmenti di pubblico nel campo name (ad esempio properties/1234567/audienceExports/123), che può essere utilizzato nelle query successive per recuperare gli utenti dall'esportazione dei segmenti di pubblico.

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

Query sullo stato di idoneità dell'esportazione dei segmenti di pubblico

La generazione dell'esportazione dei segmenti di pubblico potrebbe richiedere diversi minuti dopo la chiamata a audienceExports.create. Puoi ottenere lo stato di idoneità per un'esportazione di segmenti di pubblico chiamando il metodo audienceExports.get.

Utilizza il nome dell'esportazione dei segmenti di pubblico (ad esempio properties/1234567/audienceExports/123) ricevuto da una risposta audienceExports.create per specificare l'esportazione dei segmenti di pubblico.

Esempio:

Richiesta HTTP

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

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

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

Recuperare gli utenti in un'esportazione dei segmenti di pubblico

Dopo aver generato l'esportazione dei segmenti di pubblico creata utilizzando il metodo audienceExports.create, chiama il metodo audienceExports.query e specifica il nome dell'esportazione dei segmenti di pubblico (ad esempio properties/1234567/audienceExports/123).

Richiesta HTTP

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

Se l'esportazione dei segmenti di pubblico è pronta, viene restituita una risposta contenente l'elenco degli utenti in un segmento di pubblico:

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
}

Aspettative relative ai dati di Esportazione dei segmenti di pubblico

La seguente sezione definisce le aspettative relative ai dati relativi alle iscrizioni degli utenti nelle esportazioni dei segmenti di pubblico.

Aggiornamento dei dati

L'aggiornamento dei dati di Audience Export è il tempo impiegato da Google Analytics per raccogliere eventi, elaborare gli eventi e quindi aggiornare l'appartenenza degli utenti ai segmenti di pubblico. Se l'intero processo richiede 24 ore, l'aggiornamento dei dati di Audience Export sarà di 24 ore. Per saperne di più, consulta Aggiornamento dei dati.

Nota: l'aggiornamento dei dati di Audience Export è in genere di 24 ore.

Ad esempio, se un utente completa il primo acquisto e poi sette ore dopo crei un'esportazione del pubblico per il segmento di pubblico "Acquirenti", quasi certamente l'utente non si troverà ancora nell'esportazione del segmento di pubblico "Acquirenti". Nelle 14-38 ore successive al primo acquisto, l'utente verrà probabilmente visualizzato in nuove esportazioni dei segmenti di pubblico.

Le esportazioni dei segmenti di pubblico sono istantanee

Le esportazioni dei segmenti di pubblico sono elenchi di utenti in un segmento di pubblico in un'istantanea del tempo. Per il remarketing di Google Ads, Google Analytics esporta automaticamente e continuamente gli utenti nei segmenti di pubblico in Google Ads. Al contrario, con la funzionalità Esporta segmenti di pubblico create utilizzando l'API di dati v1, devi creare una nuova esportazione dei segmenti di pubblico per visualizzare gli ultimi utenti in quel segmento di pubblico.

Le esportazioni dei segmenti di pubblico vengono create in base agli ultimi abbonamenti disponibili degli utenti. Tuttavia, il tempo di aggiornamento dei dati delle esportazioni dei segmenti di pubblico può essere di 20 ore, il che significa che l'esportazione dei segmenti di pubblico sarà basata su tutti gli eventi delle 20 ore precedenti al momento corrente.

I dati più recenti sugli abbonamenti vengono aggiornati una volta al giorno, in genere durante le ore diurne nel fuso orario della proprietà. Ciò significa che un'esportazione dei segmenti di pubblico per lo stesso segmento di pubblico alle 09:00 e alle 11:00 restituirà probabilmente gli stessi dati, ma un'esportazione dei segmenti di pubblico alle 15:00 potrebbe essere diversa in base all'inclusione dei dati di un giorno aggiuntivo.

Nota: ti consigliamo di richiedere un'esportazione dei segmenti di pubblico solo una volta al giorno per segmento di pubblico.

Scadenza delle esportazioni dei segmenti di pubblico

Le esportazioni dei segmenti di pubblico scadono dopo 72 ore. Ogni giorno nuovi utenti possono entrare e uscire da un segmento di pubblico. Per ottenere lo snapshot più recente degli utenti, devi creare nuove esportazioni dei segmenti di pubblico per ogni giorno.

Limiti relativi agli utenti per l'esportazione dei segmenti di pubblico

Quando le dimensioni di un segmento di pubblico o di una proprietà superano un limite utente, le esportazioni dei segmenti di pubblico restituiscono campioni rappresentativi del segmento di pubblico. Questi limiti dipendono dal tipo di proprietà (ad es. una proprietà standard o 360) e vengono applicati singolarmente in ogni esportazione dei segmenti di pubblico. Gli utenti di ritorno sono utenti del segmento di pubblico richiesto, mentre gli utenti considerati sono quelli che possono o meno essere membri del segmento di pubblico.

Tipo di limite	Limiti delle proprietà standard	Limiti delle proprietà di Analytics 360
Numero massimo di utenti restituiti	2 milioni	200 milioni
Numero massimo di utenti considerati	10 milioni	1 miliardo

Coerenza dell'identità report

L'identità report determina in che modo gli utenti vengono deduplicati nei report. Le esportazioni dei segmenti di pubblico NON cambiano in base all'impostazione dell'identità report. Le esportazioni dei segmenti di pubblico identificano sempre gli utenti per User-ID e poi per ID dispositivo.

Ciò significa che i report su un segmento di pubblico possono mostrare più utenti rispetto a quelli restituiti da Esportazione dei segmenti di pubblico. Ad esempio, se l'identità report è "Basata sul dispositivo" e l'ID utente viene raccolto, i report non deduplicano gli utenti in base allo User-ID, ma le esportazioni dei segmenti di pubblico verranno deduplicati in base all'ID utente.

Coerenza del backfill

Quando crei un segmento di pubblico in Google Analytics e attivi il remarketing di Google Ads, Google Analytics esegue il backfill del segmento di pubblico in Google Ads con i membri aggiunti di recente. Tuttavia, i report di Google Analytics e le esportazioni dei segmenti di pubblico NON contengono i membri del segmento di pubblico sottoposto a backfill. Un utente dovrà registrare un evento dopo la creazione del segmento di pubblico affinché i report e le esportazioni dei segmenti di pubblico mostrino l'utente all'interno di quel segmento.

Ad esempio, se un utente registra un evento di acquisto il 20 giugno e tu crei un segmento di pubblico "Acquirenti" il 21 giugno, molto probabilmente dovrai attendere il 22 giugno per vedere l'utente nelle nuove esportazioni dei segmenti di pubblico. Tuttavia, quell'utente verrà visualizzato nell'esportazione dei segmenti di pubblico solo se ha registrato un evento il 21 giugno.