REST Resource: floodlightGroups

Kaynak: FloodlightGroup

Tek bir Floodlight grubu.

JSON gösterimi
{
  "name": string,
  "floodlightGroupId": string,
  "displayName": string,
  "webTagType": enum (WebTagType),
  "lookbackWindow": {
    object (LookbackWindow)
  },
  "customVariables": {
    object
  },
  "activeViewConfig": {
    object (ActiveViewVideoViewabilityMetricConfig)
  }
}
Alanlar
name

string

Yalnızca çıkış. Floodlight grubunun kaynak adı.

floodlightGroupId

string (int64 format)

Yalnızca çıkış. Floodlight grubunun benzersiz kimliği. Sistem tarafından atanır.

displayName

string

Zorunlu. Floodlight grubunun görünen adı.

webTagType

enum (WebTagType)

Zorunlu. Floodlight grubu için etkinleştirilen web etiketi türü.

lookbackWindow

object (LookbackWindow)

Zorunlu. Floodlight grubunun yeniden inceleme aralığı. Hem clickDays hem de impressionDays gereklidir. Her ikisi için de kabul edilebilir değerler 0 ile 90 arasındadır (bu değerler dahil).

customVariables

object (Struct format)

Floodlight grubuna ait kullanıcı tanımlı özelleştirilebilen değişkenler. Benzersiz işletme ihtiyaçlarınıza göre uyarlanmış raporlama verileri oluşturmak için özel Floodlight değişkenlerini kullanın. Özel Floodlight değişkenleri U1=, U2= gibi anahtarları kullanır ve bunlara iletmek için seçtiğiniz değerleri alabilir. Bu değişkenleri, müşterileriniz hakkında topladığınız hemen her tür veriyi (ör. bir müşterinin satın aldığı filmin türü, öğenin gönderildiği ülke vb.) izlemek için kullanabilirsiniz.

Özelleştirilebilir Floodlight değişkenleri, kişisel veri (PII) olarak kullanılabilecek veya tanınabilecek verileri iletmek için kullanılamaz.

Örnek: customVariables { fields { "U1": value { numberValue: 123.4 }, "U2": value { stringValue: "MyVariable2" }, "U3": value { stringValue: "MyVariable3" } } }

Anahtarlar için kabul edilen değerler "U1" ile "U100" arasındadır (bu değerler dahil). Dize değerleri 64 karakterden kısa olmalı ve şu karakterleri içermemelidir: "<>.

activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

Floodlight grubu için Aktif Görüntüleme video görüntülenebilirliği metriği yapılandırması.

WebTagType

Floodlight grubu için olası web etiketi türleri.

Sıralamalar
WEB_TAG_TYPE_UNSPECIFIED Tür değeri belirtilmemiş veya bu sürümde bilinmiyor.
WEB_TAG_TYPE_NONE Etiket türü yok.
WEB_TAG_TYPE_IMAGE Resim etiketi.
WEB_TAG_TYPE_DYNAMIC Dinamik etiket.

LookbackWindow

Bir dönüşümün kaydedilip kaydedilmeyeceği belirlenirken geçmişteki kaç günün inceleneceğini belirtir.

JSON gösterimi
{
  "clickDays": integer,
  "impressionDays": integer
}
Alanlar
clickDays

integer

Belirli bir kullanıcının reklamlarınızdan birini son olarak tıklamasından itibaren gün cinsinden yeniden inceleme aralığı.

impressionDays

integer

Belirli bir kullanıcının reklamlarınızdan birini son olarak görüntülemesinden itibaren, gün cinsinden yeniden inceleme aralığı.

ActiveViewVideoViewabilityMetricConfig

Özel Aktif Görüntüleme video görüntülenebilirlik metrikleri için yapılandırma.

JSON gösterimi
{
  "displayName": string,
  "minimumViewability": enum (VideoViewabilityPercent),
  "minimumVolume": enum (VideoVolumePercent),
  "minimumDuration": enum (VideoDurationSeconds),
  "minimumQuartile": enum (VideoDurationQuartile)
}
Alanlar
displayName

string

Zorunlu. Özel metriğin görünen adı.

minimumViewability

enum (VideoViewabilityPercent)

Zorunlu. Bir gösterimin kaydedilmesi için video reklamın ekranda görünür olması gereken minimum piksel yüzdesi.

minimumVolume

enum (VideoVolumePercent)

Zorunlu. Bir gösterimin kaydedilmesi için gereken minimum video reklam ses düzeyi yüzdesi.

minimumDuration

enum (VideoDurationSeconds)

Bir gösterimin kaydedilmesi için gereken minimum görünür video süresi (saniye cinsinden).

minimumDuration, minimumQuartile veya her ikisini birden belirtmeniz gerekir. Her ikisi de belirtilirse gerekliliklerden biri (hangisi önce gerçekleşirse) karşılandığında gösterim, metrik ölçütlerini karşılar.

minimumQuartile

enum (VideoDurationQuartile)

Bir gösterimin kaydedilmesi için video çeyreklerine göre gereken minimum görünür video süresi.

minimumDuration, minimumQuartile veya her ikisini birden belirtmeniz gerekir. Her ikisi de belirtilirse gerekliliklerden biri (hangisi önce gerçekleşirse) karşılandığında gösterim, metrik ölçütlerini karşılar.

VideoViewabilityPercent

Bir video reklamın görünür piksellerinin olası yüzde değerleri.

Sıralamalar
VIEWABILITY_PERCENT_UNSPECIFIED Değer belirtilmemiş veya bu sürümde bilinmiyor.
VIEWABILITY_PERCENT_0 %0 görüntülenebilir.
VIEWABILITY_PERCENT_25 %25 görüntülenebilir.
VIEWABILITY_PERCENT_50 %50 görüntülenebilir.
VIEWABILITY_PERCENT_75 %75 görüntülenebilir.
VIEWABILITY_PERCENT_100 %100 görüntülenebilir.

VideoVolumePercent

Video reklamın oynatma ses düzeyinin olası yüzde değerleri.

Sıralamalar
VIDEO_VOLUME_PERCENT_UNSPECIFIED Değer belirtilmemiş veya bu sürümde bilinmiyor.
VIDEO_VOLUME_PERCENT_0 %0 ses düzeyi.
VIDEO_VOLUME_PERCENT_10 %10 ses seviyesi.

VideoDurationSeconds

Bir video reklamın görünürlük süresinin saniye cinsinden olası değerleri.

Sıralamalar
VIDEO_DURATION_UNSPECIFIED Değer belirtilmemiş veya bu sürümde bilinmiyor.
VIDEO_DURATION_SECONDS_NONE Süre değeri yok.
VIDEO_DURATION_SECONDS_0 0 saniye.
VIDEO_DURATION_SECONDS_1 1 saniye.
VIDEO_DURATION_SECONDS_2 2 saniye.
VIDEO_DURATION_SECONDS_3 3 saniye.
VIDEO_DURATION_SECONDS_4 4 saniye.
VIDEO_DURATION_SECONDS_5 5 saniye.
VIDEO_DURATION_SECONDS_6 6 saniye.
VIDEO_DURATION_SECONDS_7 7 saniye.
VIDEO_DURATION_SECONDS_8 8 saniye.
VIDEO_DURATION_SECONDS_9 9 saniye.
VIDEO_DURATION_SECONDS_10 10 saniye.
VIDEO_DURATION_SECONDS_11 11 saniye.
VIDEO_DURATION_SECONDS_12 12 saniye.
VIDEO_DURATION_SECONDS_13 13 saniye.
VIDEO_DURATION_SECONDS_14 14 saniye.
VIDEO_DURATION_SECONDS_15 15 saniye.
VIDEO_DURATION_SECONDS_30 30 saniye.
VIDEO_DURATION_SECONDS_45 45 saniye.
VIDEO_DURATION_SECONDS_60 60 saniye.

VideoDurationQuartile

Video reklamın görünürlük süresinin olası çeyrek değerleri.

Sıralamalar
VIDEO_DURATION_QUARTILE_UNSPECIFIED Değer belirtilmemiş veya bu sürümde bilinmiyor.
VIDEO_DURATION_QUARTILE_NONE Çeyrek değer yok.
VIDEO_DURATION_QUARTILE_FIRST İlk çeyrek.
VIDEO_DURATION_QUARTILE_SECOND İkinci çeyrek (orta nokta).
VIDEO_DURATION_QUARTILE_THIRD Üçüncü çeyrek.
VIDEO_DURATION_QUARTILE_FOURTH Dördüncü çeyrek (tamamlama).

Yöntemler

get

Bir Floodlight grubunu alır.

patch

Mevcut bir Floodlight grubunu günceller.