REST Resource: curators.dataSegments

Ressource: DataSegment

Definiert eine Kennung für ein Inventarsegment, auf das Kuratoren oder Mediaplaner in der Benutzeroberfläche für Deals oder Auktionspakete Targeting anwenden können. Die Auswahl des Inventars erfolgt durch Kuratoren auf externen Plattformen. -- Next ID: 9 --

JSON-Darstellung
{
  "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
}
Felder
name

string

Nicht veränderbar. ID. Die eindeutige Kennung für das Datensegment. Die Konto-ID entspricht der Konto-ID, mit der das Segment erstellt wurde. Format: curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}

createTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem das Datensegment erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

updateTime

string (Timestamp format)

Nur Ausgabe. Zeitpunkt, zu dem das Datensegment zuletzt aktualisiert wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30"

state

enum (State)

Nur Ausgabe. Der Status des Datensegments.

Die Gebühr wird erhoben, wenn andere Konten dieses Datensegment verwenden. Das ist beispielsweise der Fall, wenn andere Konten dieses Datensegment einem Deal oder Auktionspaket hinzufügen. Der Gebührentyp des Datensegments kann nach dem Festlegen nicht mehr geändert werden. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
cpmFee

object (Money)

Optional. Eine feste Gebühr, die pro 1.000 Impressionen berechnet wird. Nachdem der Währungscode festgelegt wurde, kann er nicht mehr geändert werden.

millipercentOfMediaFee

string (int64 format)

Optional. Die Gebühr wird als Prozentsatz der Impressionskosten berechnet und in Milliprozent angegeben. Beispiel: 1 % wird als 1000 dargestellt.

Ende der sich gegenseitig ausschließenden Felder.
userListId

string

Optional. Nicht veränderbar. Die ID der Nutzerliste, die von diesem Datensegment umschlossen wird.

Kuratoren mit einem verknüpften Datenpartnerkonto können ein Datensegment erstellen, das eine Nutzerliste des verknüpften Datenpartnerkontos enthält. Nutzerlisten können über die Data Manager API hochgeladen und verwaltet werden. Wenn Sie eine Nutzerliste mit einem Datensegment verknüpfen, können Sie ein Inventarsegment definieren, das auf einer von Ihnen erstellten Zielgruppe basiert.

Bundesland

Nur Ausgabe. Verwenden Sie die Methoden „activate“ und „deactivate“, um den Status zu ändern.

Enums
STATE_UNSPECIFIED Standardwert.
ACTIVE Das Datensegment ist aktiv.
INACTIVE Das Datensegment ist inaktiv.
SUSPENDED Das Datensegment ist gesperrt und kann nicht aktiviert werden.

Methoden

activate

Aktiviert ein Datensegment.

create

Erstellt ein Datensegment, das dem aufgeführten Kurator gehört.

deactivate

Deaktiviert ein Datensegment.

get

Ruft ein Datensegment anhand seines Namens ab.

list

Die Datensegmente eines Kurators auflisten.

patch

Aktualisiert ein Datensegment.