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 ( |
| Pola | |
|---|---|
name |
Wartość niezmienna. Identyfikator. Unikalny identyfikator segmentu danych. Identyfikator konta odpowiada identyfikatorowi konta, na którym utworzono segment. Format: |
createTime |
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: |
updateTime |
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: |
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 |
Opcjonalnie: Stała opłata pobierana za tysiąc wyświetleń. Po ustawieniu kodu waluty nie można go zmienić. |
millipercentOfMediaFee |
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 |
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 |
|
|---|---|
|
Aktywuje segment danych. |
|
Tworzy segment danych należący do wymienionego podmiotu dokonującego selekcji. |
|
Dezaktywuje segment danych. |
|
Pobiera segment danych o podanej nazwie. |
|
Wyświetlanie segmentów danych należących do podmiotu dokonującego selekcji. |
|
Aktualizuje segment danych. |