REST Resource: floodlightGroups

Zasób: FloodlightGroup

jedna grupa Floodlight,

Zapis JSON 
{
  "name": string,
  "floodlightGroupId": string,
  "displayName": string,
  "webTagType": enum (WebTagType),
  "lookbackWindow": {
    object (LookbackWindow)
  },
  "customVariables": {
    object
  },
  "activeViewConfig": {
    object (ActiveViewVideoViewabilityMetricConfig)
  }
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zasobu grupy Floodlight.
floodlightGroupId

string (int64 format)

Tylko dane wyjściowe. Unikalny identyfikator grupy Floodlight. Przypisany przez system.
displayName

string

Wymagane. Wyświetlana nazwa grupy Floodlight.
webTagType

enum (WebTagType)

Wymagane. Typ tagu witryny włączony w grupie Floodlight.
lookbackWindow

object (LookbackWindow)

Wymagane. Okres ważności grupy Floodlight. Wymagane są zarówno clickDays, jak i impressionDays. Akceptowane wartości w obu przypadkach to od 0 do 90 włącznie.
customVariables

object (Struct format)

Niestandardowe zmienne definiowane przez użytkownika, które należą do grupy Floodlight. Używaj niestandardowych zmiennych Floodlight, aby tworzyć dane raportowania, które odpowiadają Twoim unikalnym potrzebom biznesowym. Niestandardowe zmienne Floodlight używają kluczy U1=, U2= itd. i mogą przyjmować dowolne wartości, które do nich przekażesz. Zmienne umożliwiają monitorowanie praktycznie wszystkich typów danych, które gromadzisz o klientach. Może to być gatunek filmu kupionego przez klienta, kraj, do którego produkt został wysłany itd.

Niestandardowych zmiennych Floodlight nie można używać do przekazywania żadnych danych, które mogłyby służyć lub zostać uznane za informacje umożliwiające identyfikację.

Przykład: customVariables { fields { "U1": value { numberValue: 123.4 }, "U2": value { stringValue: "MyVariable2" }, "U3": value { stringValue: "MyVariable3" } } }

Akceptowane wartości kluczy to „U1”–„U100” włącznie. Wartości ciągów tekstowych muszą mieć mniej niż 64 znaki i nie mogą zawierać tych znaków: "<>.
activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

Konfiguracja danych o widoczności wideo w Widoku aktywnym dla grupy Floodlight.

WebTagType

Możliwe typy tagów witryny w grupie Floodlight.

Wartości w polu enum
WEB_TAG_TYPE_UNSPECIFIED Wartość typu nie jest określona lub jest nieznana w tej wersji.
WEB_TAG_TYPE_NONE Brak typu tagu.
WEB_TAG_TYPE_IMAGE Tag graficzny.
WEB_TAG_TYPE_DYNAMIC Tag dynamiczny.

LookbackWindow

Określa liczbę dni, które mają być uwzględniane przy ustalaniu, czy zarejestrować konwersję.

Zapis JSON 
{
  "clickDays": integer,
  "impressionDays": integer
}
Pola
clickDays

integer

Okres ważności w dniach jest porównywany z ostatnim terminem, w którym dany użytkownik kliknął jedną z Twoich reklam.
impressionDays

integer

Okres ważności w dniach od ostatniego terminu, w którym dany użytkownik zobaczył jedną z Twoich reklam.

ActiveViewVideoViewabilityMetricConfig

Konfiguracja niestandardowych danych o widoczności wideo w Widoku aktywnym.

Zapis JSON 
{
  "displayName": string,
  "minimumViewability": enum (VideoViewabilityPercent),
  "minimumVolume": enum (VideoVolumePercent),
  "minimumDuration": enum (VideoDurationSeconds),
  "minimumQuartile": enum (VideoDurationQuartile)
}
Pola
displayName

string

Wymagane. Wyświetlana nazwa danych niestandardowych.
minimumViewability

enum (VideoViewabilityPercent)

Wymagane. Minimalny odsetek pikseli reklamy wideo widocznych na ekranie, aby wyświetlenie zostało zarejestrowane.
minimumVolume

enum (VideoVolumePercent)

Wymagane. Minimalny odsetek głośności reklamy wideo wymagany do zarejestrowania wyświetlenia.
minimumDuration

enum (VideoDurationSeconds)

Minimalny wymagany czas widoczności filmu (w sekundach), aby można było zarejestrować wyświetlenie.

Musisz podać minimumDuration, minimumQuartile lub oba te atrybuty. Jeśli określisz oba te warunki, wyświetlenie będzie pasować do kryteriów danych, gdy tylko spełni jeden z tych wymogów (obojętne który).
minimumQuartile

enum (VideoDurationQuartile)

Minimalny wymagany czas widoczności filmu (w kwartylach), aby można było zarejestrować wyświetlenie.

Musisz podać minimumDuration, minimumQuartile lub oba te atrybuty. Jeśli określisz oba te warunki, wyświetlenie będzie pasować do kryteriów danych, gdy tylko spełni jeden z tych wymogów (obojętne który).

VideoViewabilityPercent

Możliwe wartości procentowe widocznych pikseli reklamy wideo.

Wartości w polu enum
VIEWABILITY_PERCENT_UNSPECIFIED Wartość nie jest określona lub jest nieznana w tej wersji.
VIEWABILITY_PERCENT_0 0% widocznych wyświetleń.
VIEWABILITY_PERCENT_25 25% widocznych.
VIEWABILITY_PERCENT_50 50% widocznych.
VIEWABILITY_PERCENT_75 75% widocznych.
VIEWABILITY_PERCENT_100 100% widocznych.

VideoVolumePercent

Możliwe wartości procentowe głośności odtwarzania reklamy wideo.

Wartości w polu enum
VIDEO_VOLUME_PERCENT_UNSPECIFIED Wartość nie jest określona lub jest nieznana w tej wersji.
VIDEO_VOLUME_PERCENT_0 0% głośności.
VIDEO_VOLUME_PERCENT_10 10% głośności.

VideoDurationSeconds

Możliwe wartości w sekundach widocznego czasu trwania reklamy wideo.

Wartości w polu enum
VIDEO_DURATION_UNSPECIFIED Wartość nie jest określona lub jest nieznana w tej wersji.
VIDEO_DURATION_SECONDS_NONE Brak wartości czasu trwania.
VIDEO_DURATION_SECONDS_0 0 sekund.
VIDEO_DURATION_SECONDS_1 1 sekunda.
VIDEO_DURATION_SECONDS_2 2 sekundy.
VIDEO_DURATION_SECONDS_3 3 sekundy.
VIDEO_DURATION_SECONDS_4 4 sekundy.
VIDEO_DURATION_SECONDS_5 5 sekund.
VIDEO_DURATION_SECONDS_6 6 sekund.
VIDEO_DURATION_SECONDS_7 7 sekund.
VIDEO_DURATION_SECONDS_8 8 sekund.
VIDEO_DURATION_SECONDS_9 9 sekund.
VIDEO_DURATION_SECONDS_10 10 sekund.
VIDEO_DURATION_SECONDS_11 11 sekund.
VIDEO_DURATION_SECONDS_12 12 sekund.
VIDEO_DURATION_SECONDS_13 13 sekund.
VIDEO_DURATION_SECONDS_14 14 sekund.
VIDEO_DURATION_SECONDS_15 15 sekund.
VIDEO_DURATION_SECONDS_30 30 sekund.
VIDEO_DURATION_SECONDS_45 45 sekund.
VIDEO_DURATION_SECONDS_60 60 sekund.

VideoDurationQuartile

Możliwe wartości kwartyli widocznego czasu trwania reklamy wideo.

Wartości w polu enum
VIDEO_DURATION_QUARTILE_UNSPECIFIED Wartość nie jest określona lub jest nieznana w tej wersji.
VIDEO_DURATION_QUARTILE_NONE Brak wartości kwartyla.
VIDEO_DURATION_QUARTILE_FIRST Pierwszy kwartyl
VIDEO_DURATION_QUARTILE_SECOND Drugi kwartyl (punkt środkowy)
VIDEO_DURATION_QUARTILE_THIRD Trzeci kwartyl
VIDEO_DURATION_QUARTILE_FOURTH Czwarty kwartyl (ukończenie).

Metody

get

 Pobiera grupę Floodlight.

patch

 Aktualizuje istniejącą grupę Floodlight.