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 حالية.