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 ( |
| Felder | |
|---|---|
name |
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: |
createTime |
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: |
updateTime |
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: |
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 |
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 |
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 |
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 |
|
|---|---|
|
Aktiviert ein Datensegment. |
|
Erstellt ein Datensegment, das dem aufgeführten Kurator gehört. |
|
Deaktiviert ein Datensegment. |
|
Ruft ein Datensegment anhand seines Namens ab. |
|
Die Datensegmente eines Kurators auflisten. |
|
Aktualisiert ein Datensegment. |