REST Resource: floodlightGroups

Zasób: FloodlightGroup

1 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. Przypisana przez system.

displayName

string

Wymagane. Wyświetlana nazwa grupy Floodlight.

webTagType

enum (WebTagType)

Wymagane. Typ tagu internetowego włączony w grupie Floodlight.

lookbackWindow

object (LookbackWindow)

Wymagane. Okres ważności w grupie Floodlight. Wymagane są właściwości clickDays i impressionDays. Akceptowane wartości w obu przypadkach to od 0 do 90 włącznie.

customVariables

object (Struct format)

Zmienne niestandardowe zdefiniowane przez użytkownika, których właścicielem jest grupa Floodlight. Używaj niestandardowych zmiennych Floodlight, by tworzyć dane do raportu dostosowane do Twoich unikalnych potrzeb biznesowych. Niestandardowe zmienne Floodlight używają kluczy U1=, U2= itd. i mogą przyjmować dowolne wartości, które do nich prześlesz. Dzięki nim możesz śledzić praktycznie dowolny typ danych o klientach, które gromadzisz. 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 zostać użyte lub rozpoznane jako informacje umożliwiające identyfikację osoby.

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

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

activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

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

WebTagType

Możliwe typy tagów internetowych 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ć brane pod uwagę 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 reklam 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, które są niezbędne do zarejestrowania wyświetlenia.

minimumVolume

enum (VideoVolumePercent)

Wymagane. Minimalna wartość procentowa głośności reklamy wideo wymagana do zarejestrowania wyświetlenia.

minimumDuration

enum (VideoDurationSeconds)

Minimalny czas trwania widocznego filmu (w sekundach), jaki jest wymagany do zarejestrowania wyświetlenia.

Musisz określić minimumDuration, minimumQuartile lub obie. Jeśli podasz oba te warunki, wyświetlenie będzie spełniać kryteria danych, o ile zostanie spełniony dowolny z tych warunków (w zależności od tego, co nastąpi wcześniej).

minimumQuartile

enum (VideoDurationQuartile)

Minimalny czas trwania widocznego filmu (określony w kwartylach filmu) wymagany do zarejestrowania wyświetlenia.

Musisz określić minimumDuration, minimumQuartile lub obie. Jeśli podasz oba te warunki, wyświetlenie będzie spełniać kryteria danych, o ile zostanie spełniony dowolny z tych warunków (w zależności od tego, co nastąpi wcześniej).

VideoViewabilityPercent

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

Wartości w polu enum
VIEWABILITY_PERCENT_UNSPECIFIED Wartość nie została określona lub jest nieznana w tej wersji.
VIEWABILITY_PERCENT_0 Widoczna w 0%.
VIEWABILITY_PERCENT_25 Widoczna w 25%
VIEWABILITY_PERCENT_50 Widoczna w 50%
VIEWABILITY_PERCENT_75 Widoczna w 75%
VIEWABILITY_PERCENT_100 Widoczna w 100%.

VideoVolumePercent

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

Wartości w polu enum
VIDEO_VOLUME_PERCENT_UNSPECIFIED Wartość nie została 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 czasu trwania reklamy wideo.

Wartości w polu enum
VIDEO_DURATION_UNSPECIFIED Wartość nie została 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 czasu trwania widocznej reklamy wideo.

Wartości w polu enum
VIDEO_DURATION_QUARTILE_UNSPECIFIED Wartość nie została 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.