REST Resource: curators.dataSegments

Risorsa: DataSegment

Definisce un identificatore per un segmento di inventario che può essere scelto come target da curatori o 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),

  // Union field fee can be only one of the following:
  "cpmFee": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of list of possible types for union field fee.
  "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 in cui è stato aggiornato l'ultima volta 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".
state

enum (State)

Solo output. Lo stato del segmento di dati.
Campo unione fee. La commissione verrà addebitata quando altri account utilizzano questo segmento di dati. Ad esempio, quando altri account aggiungono questo segmento di dati a un deal o a un pacchetto di aste. Una volta impostato, il tipo di commissione del segmento di dati non può essere modificato. fee può essere solo uno dei seguenti tipi:
cpmFee

object (Money)

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

string (int64 format)

Facoltativo. La commissione verrà addebitata come percentuale del costo dell'impressione, rappresentata in millesimi di percentuale. Ad esempio, l'1% è rappresentato come 1000.
userListId

string

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

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

Stato

Solo output. Utilizza il metodo activate e deactivate per modificare lo stato.

Enum
STATE_UNSPECIFIED Valore predefinito.
ACTIVE Il segmento di dati è attivo.
INACTIVE Il segmento di dati è inattivo.
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 suo nome.

list

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

patch

 Aggiorna un segmento di dati.