REST Resource: floodlightGroups

Zasób: FloodlightGroup

Pojedyncza 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 dla obu parametrów to od 0 do 90 (włącznie).
customVariables

object (Struct format)

Zmienne niestandardowe zdefiniowane przez użytkownika, które należą do grupy Floodlight. Używaj niestandardowych zmiennych Floodlight, aby tworzyć dane do raportu dopasowane do potrzeb Twojej firmy. Niestandardowe zmienne Floodlight używają kluczy U1=, U2= itd. i mogą przyjmować dowolne wartości, które do nich przekażesz. Możesz ich używać do śledzenia praktycznie każdego rodzaju danych, które zbierasz o swoich klientach, np. gatunku kupionego przez klienta filmu, kraju, do którego wysyłany jest produkt, itp.

Niestandardowych zmiennych Floodlight nie można używać do przekazywania danych, które mogłyby zostać wykorzystane lub rozpoznane jako 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 od „U1” do „U100” (włącznie). Ciągi znaków 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) od ostatniego kliknięcia przez danego użytkownika jednej z Twoich reklam.
impressionDays

integer

Okres ważności (w dniach) od ostatniego wyświetlenia przez danego użytkownika jednej z Twoich reklam.

ActiveViewVideoViewabilityMetricConfig

Konfiguracja niestandardowych danych o widoczności filmów 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 procent pikseli reklamy wideo, który musi być widoczny na ekranie, aby wyświetlenie zostało zarejestrowane.
minimumVolume

enum (VideoVolumePercent)

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

enum (VideoDurationSeconds)

Minimalny wymagany czas trwania filmu (w sekundach), po upływie którego wyświetlenie zostanie zarejestrowane.

Musisz podać minimumDuration, minimumQuartile lub obie te wartości. Jeśli wybierzesz oba, wyświetlenie zostanie zliczone, gdy spełni jeden z tych wymogów (obojętne który).
minimumQuartile

enum (VideoDurationQuartile)

Minimalny wymagany czas trwania filmu widocznego w kwartylach, aby wyświetlenie zostało zarejestrowane.

Musisz podać minimumDuration, minimumQuartile lub obie te wartości. Jeśli wybierzesz oba, wyświetlenie zostanie zliczone, gdy 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 wyświetleń.
VIEWABILITY_PERCENT_50 50% widocznych wyświetleń.
VIEWABILITY_PERCENT_75 75% widocznych wyświetleń.
VIEWABILITY_PERCENT_100 Widoczne przez cały czas trwania.

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 Głośność 10%.

VideoDurationSeconds

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

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 Film ma trwać 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 czasu widoczności 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.