Method: users.ingest

Carica un elenco di utenti nelle destinazioni fornite. A differenza di audienceMembers.ingest (che aggiunge gli utenti a elenchi di segmenti di pubblico specifici dell'inserzionista per il targeting), users.ingest acquisisce i dati di collegamento delle identità a livello di account (ad esempio, gli identificatori utente collegati agli ID mobile) indipendentemente da segmenti di pubblico specifici.

Questa funzionalità è disponibile solo per gli account in una lista consentita.

Richiesta HTTP

POST https://datamanager.googleapis.com/v1/users:ingest

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "users": [
    {
      object (User)
    }
  ],
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding)
}
Campi
destinations[]

object (Destination)

Obbligatorio. L'elenco delle possibili destinazioni di importazione.
users[]

object (User)

Obbligatorio. L'elenco degli utenti da importare.
encryptionInfo

object (EncryptionInfo)

Facoltativo. Informazioni sulla crittografia delle chiavi di crittografia utilizzate per criptare i dati.
validateOnly

boolean

Facoltativo. Se true, la richiesta viene convalidata ma non eseguita.
encoding

enum (Encoding)

Obbligatorio. Il tipo di codifica degli identificatori utente. Per gli identificatori utente criptati, questo vale solo per la codifica esterna.

Corpo della risposta

Risposta di IngestUsersRequest.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "requestId": string
}
Campi
requestId

string

L'ID richiesta generato della richiesta di importazione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/datamanager

Utente

Rappresenta un singolo utente e contiene identificatori come PII e ID dispositivo mobile che si riferiscono tutti allo stesso utente.

Rappresentazione JSON 
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
Campi
userData

object (UserData)

Obbligatorio. Più dati forniti dall'utente, utilizzati come mezzo per identificare l'utente.
mobileData

object (MobileData)

Obbligatorio. Più stringhe di ID dispositivo mobile per rappresentare un singolo utente.