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 internetowego włączony w grupie Floodlight.
lookbackWindow

object (LookbackWindow)

Wymagane. Okres ważności w grupie Floodlight. Wymagane są pola clickDays i impressionDays. Akceptowane wartości to 0–90.
customVariables

object (Struct format)

Zmienne niestandardowe zdefiniowane przez użytkownika należące 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 prześlesz. 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.

Niestandardowe zmienne Floodlight nie mogą służyć do przekazywania żadnych danych, które mogłyby służyć lub zostać uznane za 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” do „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 wideo w Widoku aktywnym w grupie Floodlight.

WebTagType

Możliwe typy tagów internetowych dla grupy Floodlight.

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

Konfiguracja danych dotyczących widoczności w wideo w widoku aktywnym

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, które są niezbędne do zarejestrowania wyświetlenia.
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 wyświetlenie zostało zarejestrowane.

Musisz podać parametr minimumDuration, minimumQuartile lub oba te parametry. Jeśli wybierzesz oba, wyświetlenie będzie pasować do kryteriów danych, gdy tylko spełni 1 z tych 2 wymogów (obojętne który).
minimumQuartile

enum (VideoDurationQuartile)

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

Musisz podać parametr minimumDuration, minimumQuartile lub oba te parametry. 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 0% widoczności.
VIEWABILITY_PERCENT_25 25% widoczności.
VIEWABILITY_PERCENT_50 50% widoczności.
VIEWABILITY_PERCENT_75 75% widoczności.
VIEWABILITY_PERCENT_100 100% widoczności.

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 widocznego czasu trwania reklamy wideo (w sekundach).

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 widocznego czasu trwania 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.