REST Resource: curators.dataSegments

Zasób: DataSegment

Definiuje identyfikator segmentu zasobów reklamowych, na który mogą kierować reklamy selekcjonerzy lub osoby planujące media w interfejsie umów lub pakietów aukcji. Zasoby reklamowe są wybierane przez kuratorów na platformach zewnętrznych. -- Next ID: 9 --

Zapis 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
}
Pola
name

string

Wartość niezmienna. Identyfikator. Unikalny identyfikator segmentu danych. Identyfikator konta odpowiada identyfikatorowi konta, na którym utworzono segment. Format: curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}

createTime

string (Timestamp format)

Tylko dane wyjściowe. Czas utworzenia segmentu danych.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Tylko dane wyjściowe. Czas ostatniej aktualizacji segmentu danych.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

state

enum (State)

Tylko dane wyjściowe. Stan segmentu danych.

Opłata zostanie naliczona, gdy inne konta będą korzystać z tego segmentu danych. Na przykład gdy inne konta dodają ten segment danych do umowy lub pakietu aukcji. Po ustawieniu typu opłaty za segment danych nie można go zmienić. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
cpmFee

object (Money)

Opcjonalnie: Stała opłata pobierana za tysiąc wyświetleń. Po ustawieniu kodu waluty nie można go zmienić.

millipercentOfMediaFee

string (int64 format)

Opcjonalnie: Opłata będzie naliczana jako procent kosztu wyświetlenia, wyrażony w miliprocentach. Na przykład 1% jest reprezentowany jako 1000.

Koniec pól wykluczających się wzajemnie.
userListId

string

Opcjonalnie: Wartość niezmienna. Identyfikator listy użytkowników opakowanej przez ten segment danych.

Kuratorzy, którzy mają połączone konto dostawcy danych, mogą utworzyć segment danych, który zawiera listę użytkowników należącą do połączonego konta dostawcy danych. Listy użytkowników można przesyłać i nimi zarządzać za pomocą interfejsu Data Manager API. Połączenie listy użytkowników z segmentem danych umożliwia zdefiniowanie segmentu zasobów reklamowych na podstawie utworzonych przez Ciebie odbiorców.

Stan

Tylko dane wyjściowe. Aby zmienić stan, użyj metody aktywacji i dezaktywacji.

Wartości w polu enum
STATE_UNSPECIFIED Wartość domyślna.
ACTIVE Segment danych jest aktywny.
INACTIVE Segment danych jest nieaktywny.
SUSPENDED Segment danych jest zawieszony i nie można go aktywować.

Metody

activate

Aktywuje segment danych.

create

Tworzy segment danych należący do wymienionego podmiotu dokonującego selekcji.

deactivate

Dezaktywuje segment danych.

get

Pobiera segment danych o podanej nazwie.

list

Wyświetlanie segmentów danych należących do podmiotu dokonującego selekcji.

patch

Aktualizuje segment danych.