REST Resource: curators.dataSegments

Risorsa: DataSegment

Definisce un identificatore per un segmento di inventario che può essere scelto come target dai curatori o dai media planner nell'interfaccia utente dei deal o dei pacchetti di aste. La selezione dell'inventario viene eseguita dai curatori su piattaforme esterne. -- Next ID: 9 --

Rappresentazione JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "cpmFee": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
  "userListId": string
}
Campi
name

string

Immutabile. Identificatore. L'identificatore univoco del segmento di dati. L'ID account corrisponde all'ID account che ha creato il segmento. Formato: curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}

createTime

string (Timestamp format)

Solo output. Ora in cui è stato creato il segmento di dati.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Solo output. Ora dell'ultimo aggiornamento del segmento di dati.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

state

enum (State)

Solo output. Lo stato del segmento di dati.

La tariffa verrà addebitata quando altri account utilizzeranno questo segmento di dati. Ad esempio, quando altri account aggiungono questo segmento di dati a un deal o a un pacchetto di aste. Il tipo di tariffa del segmento di dati non può essere modificato una volta impostato. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
cpmFee

object (Money)

Facoltativo. Una tariffa fissa addebitata per mille impressioni. Una volta impostato, il codice valuta non può essere modificato.

millipercentOfMediaFee

string (int64 format)

Facoltativo. La tariffa verrà addebitata come percentuale del costo delle impressioni, rappresentata in millesimi di percentuale. Ad esempio, l'1% è rappresentato come 1000.

Fine dei campi che si escludono a vicenda.
userListId

string

Facoltativo. Immutabile. L'ID dell'elenco di utenti aggregato da questo segmento di dati.

I curatori con un account partner di dati collegato possono creare un segmento di dati che include un elenco utenti di proprietà dell'account partner di dati collegato. Gli elenchi di utenti possono essere caricati e gestiti utilizzando l'API Data Manager. Il collegamento di un elenco di utenti a un segmento di dati ti consente di definire un segmento di inventario basato su un segmento di pubblico che crei.

Stato

Solo output. Utilizza il metodo di attivazione e disattivazione per modificare lo stato.

Enum
STATE_UNSPECIFIED Valore predefinito.
ACTIVE Il segmento di dati è attivo.
INACTIVE Il segmento di dati non è attivo.
SUSPENDED Il segmento di dati è sospeso e non può essere attivato.

Metodi

activate

Attiva un segmento di dati.

create

Crea un segmento di dati di proprietà del curatore elencato.

deactivate

Disattiva un segmento di dati.

get

Recupera un segmento di dati in base al nome.

list

Elenca i segmenti di dati di proprietà di un curatore.

patch

Aggiorna un segmento di dati.