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

string

To pole jest wymagane. Wyświetlana nazwa grupy Floodlight.
webTagType

enum (WebTagType)

To pole jest wymagane. Typ tagu witryny włączony w grupie Floodlight.
lookbackWindow

object (LookbackWindow)

To pole jest wymagane. Okres ważności grupy Floodlight. Wymagana jest zarówno właściwość clickDays, jak i impressionDays. Dopuszczalne wartości w obu przypadkach 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 raportowania 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. 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 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. 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 na potrzeby grupy 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 reklam wideo w Widoku aktywnym.

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

string

To pole jest wymagane. Wyświetlana nazwa danych niestandardowych.
minimumViewability

enum (VideoViewabilityPercent)

To pole jest wymagane. Minimalny odsetek pikseli reklamy wideo widocznych na ekranie do zarejestrowania wyświetlenia.
minimumVolume

enum (VideoVolumePercent)

To pole jest wymagane. Minimalny procent głośności reklamy wideo wymagany do zarejestrowania wyświetlenia.
minimumDuration

enum (VideoDurationSeconds)

Minimalny czas trwania widocznego wideo (w sekundach) wymagany do zarejestrowania wyświetlenia.

Musisz określić minimumDuration, minimumQuartile lub oba. Jeśli podasz oba te wymagania, wyświetlenie będzie spełniać kryteria danych, gdy jeden z tych z nich zostanie spełniony (zależnie od tego, co nastąpi wcześniej).
minimumQuartile

enum (VideoDurationQuartile)

Minimalny czas trwania widocznego filmu określony na podstawie kwartyli filmu, aby można było zarejestrować wyświetlenie.

Musisz określić minimumDuration, minimumQuartile lub oba. Jeśli podasz oba te wymagania, wyświetlenie będzie spełniać kryteria danych, gdy jeden z tych z nich zostanie spełniony (zależnie 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 na 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 widocznego 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 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 (połowa).
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.