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