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 المخصّصة لنقل أي بيانات يمكن استخدامها أو التعرّف عليها على أنّها معلومات تحديد الهوية الشخصية (PII).

مثلاً: 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 حالية