REST Resource: floodlightGroups

المورد: FloodlightGroup

مجموعة Floodlight واحدة

تمثيل JSON 
{
  "name": string,
  "floodlightGroupId": string,
  "displayName": string,
  "webTagType": enum (WebTagType),
  "lookbackWindow": {
    object (LookbackWindow)
  },
  "customVariables": {
    object
  },
  "activeViewConfig": {
    object (ActiveViewVideoViewabilityMetricConfig)
  }
}
الحقول
name

string

للعرض فقط. اسم المورد لمجموعة Floodlight
floodlightGroupId

string (int64 format)

للعرض فقط. المعرّف الفريد لمجموعة Floodlight يتم تخصيصه من قِبل النظام.
displayName

string

الحقل مطلوب. الاسم المعروض لمجموعة Floodlight
webTagType

enum (WebTagType)

الحقل مطلوب. نوع علامة الويب المفعَّلة لمجموعة Floodlight
lookbackWindow

object (LookbackWindow)

الحقل مطلوب. فترة معاينة الإعلان لمجموعة Floodlight يجب إدخال كل من clickDays وimpressionDays. القيم المقبولة لكليهما هي من 0 إلى 90، ضمنًا.
customVariables

object (Struct format)

متغيّرات مخصّصة يحدّدها المستخدم وتملكها مجموعة Floodlight استخدِم متغيّرات Floodlight المخصّصة لإنشاء بيانات تقارير مصمّمة خصيصًا لتلبية احتياجات مؤسستك الفريدة. تستخدم متغيّرات Floodlight المخصّصة المفاتيح U1= وU2= وما إلى ذلك، ويمكن أن تأخذ أي قيم تختارها لها. ويمكنك استخدامها لتتبُّع أي نوع من البيانات التي تجمعها عن عملائك تقريبًا، مثل نوع الفيلم الذي يشتريه العميل والبلد الذي يتم شحن السلعة إليه وما إلى ذلك.

لا يجوز استخدام متغيّرات Floodlight المخصّصة لنقل أي بيانات يمكن استخدامها أو التعرّف عليها كمعلومات تكشف الهوية الشخصية.

مثلاً: customVariables { fields { "U1": value { numberValue: 123.4 }, "U2": value { stringValue: "MyVariable2" }, "U3": value { stringValue: "MyVariable3" } } }

القيم المقبولة للمفاتيح هي من "U1" إلى "U100"، ضمنًا. يجب أن تكون قيم السلسلة أقل من 64 حرفًا، ولا يمكن أن تحتوي على الأحرف التالية: "<>.
activeViewConfig

object (ActiveViewVideoViewabilityMetricConfig)

إعدادات مقياس إمكانية عرض الفيديو في "العرض النشط" لمجموعة Floodlight

WebTagType

الأنواع المحتملة لعلامات الويب لمجموعة Floodlight

عمليات التعداد
WEB_TAG_TYPE_UNSPECIFIED لم يتم تحديد قيمة النوع أو أنّها غير معروفة في هذا الإصدار.
WEB_TAG_TYPE_NONE ما مِن نوع علامة.
WEB_TAG_TYPE_IMAGE علامة الصورة
WEB_TAG_TYPE_DYNAMIC علامة ديناميكية

LookbackWindow

تحدّد عدد الأيام السابقة التي يجب النظر فيها عند تحديد ما إذا كان سيتم تسجيل إحالة ناجحة أم لا.

تمثيل JSON 
{
  "clickDays": integer,
  "impressionDays": integer
}
الحقول
clickDays

integer

فترة معاينة الإعلان، بالأيام، من آخر مرة نقر فيها مستخدم معيّن على أحد إعلاناتك.
impressionDays

integer

فترة معاينة الإعلان، بالأيام، من آخر مرة شاهد فيها مستخدم معيّن أحد إعلاناتك

ActiveViewVideoViewabilityMetricConfig

إعدادات مقاييس إمكانية عرض الفيديو المخصّصة في "العرض النشط"

تمثيل JSON 
{
  "displayName": string,
  "minimumViewability": enum (VideoViewabilityPercent),
  "minimumVolume": enum (VideoVolumePercent),
  "minimumDuration": enum (VideoDurationSeconds),
  "minimumQuartile": enum (VideoDurationQuartile)
}
الحقول
displayName

string

الحقل مطلوب. الاسم المعروض للمقياس المخصّص
minimumViewability

enum (VideoViewabilityPercent)

الحقل مطلوب. الحد الأدنى للنسبة المئوية لوحدات بكسل إعلان الفيديو التي تظهر على الشاشة ليتم تسجيل مرّة ظهور.
minimumVolume

enum (VideoVolumePercent)

الحقل مطلوب. الحدّ الأدنى لنسبة مستوى صوت إعلان الفيديو المطلوب لتسجيل مرّة ظهور.
minimumDuration

enum (VideoDurationSeconds)

الحد الأدنى لمدة الفيديو المرئية المطلوبة (بالثواني) لتسجيل مرّة ظهور

يجب تحديد minimumDuration أو minimumQuartile أو كليهما. وفي حال تحديد كليهما، يستوفي ظهور الإعلان معايير المقياس إذا تم استيفاء أي من الشرطَين (أيهما يحدث أولاً).
minimumQuartile

enum (VideoDurationQuartile)

الحدّ الأدنى لمدة الفيديو المرئية المطلوبة، استنادًا إلى أرباع الفيديو، لتسجيل ظهور.

يجب تحديد minimumDuration أو minimumQuartile أو كليهما. وفي حال تحديد كليهما، يستوفي ظهور الإعلان معايير المقياس إذا تم استيفاء أي من الشرطَين (أيهما يحدث أولاً).

VideoViewabilityPercent

القيم المئوية المحتملة لوحدات البكسل المرئية في إعلان فيديو

عمليات التعداد
VIEWABILITY_PERCENT_UNSPECIFIED لم يتم تحديد القيمة أو أنّها غير معروفة في هذا الإصدار.
VIEWABILITY_PERCENT_0 ‫0% قابلة للعرض
VIEWABILITY_PERCENT_25 ‫% 25 قابلة للعرض
VIEWABILITY_PERCENT_50 ‫50% قابل للعرض
VIEWABILITY_PERCENT_75 ‫75% قابل للعرض
VIEWABILITY_PERCENT_100 قابلة للعرض بنسبة% 100

VideoVolumePercent

القيم المئوية المحتملة لمستوى صوت تشغيل إعلان فيديو

عمليات التعداد
VIDEO_VOLUME_PERCENT_UNSPECIFIED لم يتم تحديد القيمة أو أنّها غير معروفة في هذا الإصدار.
VIDEO_VOLUME_PERCENT_0 مستوى الصوت% 0
VIDEO_VOLUME_PERCENT_10 ‫10% من مستوى الصوت

VideoDurationSeconds

القيم المحتملة بالثواني لمدة ظهور إعلان فيديو

عمليات التعداد
VIDEO_DURATION_UNSPECIFIED لم يتم تحديد القيمة أو أنّها غير معروفة في هذا الإصدار.
VIDEO_DURATION_SECONDS_NONE ما مِن قيمة للمدة.
VIDEO_DURATION_SECONDS_0 ‫0 ثانية
VIDEO_DURATION_SECONDS_1 ثانية واحدة
VIDEO_DURATION_SECONDS_2 ثانيتان
VIDEO_DURATION_SECONDS_3 ‫3 ثوانٍ
VIDEO_DURATION_SECONDS_4 ‫4 ثوانٍ
VIDEO_DURATION_SECONDS_5 مدة الفيديو المطلوبة 5 ثوانٍ.
VIDEO_DURATION_SECONDS_6 ‫6 ثوانٍ
VIDEO_DURATION_SECONDS_7 ‫7 ثوانٍ
VIDEO_DURATION_SECONDS_8 ‫8 ثوانٍ
VIDEO_DURATION_SECONDS_9 ‫9 ثوانٍ
VIDEO_DURATION_SECONDS_10 ‫10 ثوانٍ
VIDEO_DURATION_SECONDS_11 ‫11 ثانية
VIDEO_DURATION_SECONDS_12 ‫12 ثانية
VIDEO_DURATION_SECONDS_13 ‫13 ثانية
VIDEO_DURATION_SECONDS_14 ‫14 ثانية
VIDEO_DURATION_SECONDS_15 ‫15 ثانية
VIDEO_DURATION_SECONDS_30 ‫30 ثانية
VIDEO_DURATION_SECONDS_45 ‫45 ثانية
VIDEO_DURATION_SECONDS_60 ‫60 ثانية

VideoDurationQuartile

قيم الأرباع المحتملة لمدة ظهور إعلان فيديو

عمليات التعداد
VIDEO_DURATION_QUARTILE_UNSPECIFIED لم يتم تحديد القيمة أو أنّها غير معروفة في هذا الإصدار.
VIDEO_DURATION_QUARTILE_NONE لا تتوفّر قيمة للرُبع.
VIDEO_DURATION_QUARTILE_FIRST الربع الأول
VIDEO_DURATION_QUARTILE_SECOND الربع الثاني (نقطة المنتصف)
VIDEO_DURATION_QUARTILE_THIRD الربع الثالث
VIDEO_DURATION_QUARTILE_FOURTH الربع الرابع (اكتمال المشاهدة)

الطُرق

get

 للحصول على مجموعة Floodlight

patch

 تعديل مجموعة Floodlight حالية