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