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