REST Resource: accounts.containers.workspaces.triggers

المرجع: عامل التشغيل

يمثّل عامل تشغيل في أداة "إدارة العلامات من Google".

تمثيل JSON 
{
  "path": string,
  "accountId": string,
  "containerId": string,
  "workspaceId": string,
  "triggerId": string,
  "name": string,
  "type": enum (EventType),
  "customEventFilter": [
    {
      object (Condition)
    }
  ],
  "filter": [
    {
      object (Condition)
    }
  ],
  "autoEventFilter": [
    {
      object (Condition)
    }
  ],
  "waitForTags": {
    object (Parameter)
  },
  "checkValidation": {
    object (Parameter)
  },
  "waitForTagsTimeout": {
    object (Parameter)
  },
  "uniqueTriggerId": {
    object (Parameter)
  },
  "eventName": {
    object (Parameter)
  },
  "interval": {
    object (Parameter)
  },
  "limit": {
    object (Parameter)
  },
  "fingerprint": string,
  "parentFolderId": string,
  "selector": {
    object (Parameter)
  },
  "intervalSeconds": {
    object (Parameter)
  },
  "maxTimerLengthSeconds": {
    object (Parameter)
  },
  "verticalScrollPercentageList": {
    object (Parameter)
  },
  "horizontalScrollPercentageList": {
    object (Parameter)
  },
  "visibilitySelector": {
    object (Parameter)
  },
  "visiblePercentageMin": {
    object (Parameter)
  },
  "visiblePercentageMax": {
    object (Parameter)
  },
  "continuousTimeMinMilliseconds": {
    object (Parameter)
  },
  "totalTimeMinMilliseconds": {
    object (Parameter)
  },
  "tagManagerUrl": string,
  "notes": string,
  "parameter": [
    {
      object (Parameter)
    }
  ]
}
الحقول
path

string

المسار النسبي لواجهة برمجة تطبيقات مشغّل "إدارة العلامات من Google"
accountId

string

رقم تعريف حساب "إدارة العلامات من Google"
containerId

string

رقم تعريف حاوية "إدارة العلامات من Google"
workspaceId

string

رقم تعريف مساحة عمل "إحصاءات Google‏ 4"
triggerId

string

يحدّد رقم تعريف المشغّل بشكلٍ فريد مشغّل "إحصاءات Google‏ 4".
name

string

الاسم المعروض لعامل التشغيل
type

enum (EventType)

تحدِّد هذه السمة حدث طبقة البيانات الذي يتسبّب في هذا المشغِّل.
customEventFilter[]

object (Condition)

تُستخدَم في حال الحدث المخصّص الذي يتم تنشيطُه إذا كانت جميع الشروط صحيحة.
filter[]

object (Condition)

لن يتم تنشيط عامل التفعيل إلا إذا كانت جميع الشروط صحيحة.
autoEventFilter[]

object (Condition)

يُستخدَم في حال تتبُّع الأحداث التلقائي.
waitForTags

object (Parameter)

ما إذا كان علينا تأخير عمليات إرسال النماذج أو فتح الروابط إلى أن يتم تنشيط جميع العلامات (من خلال منع الإجراء التلقائي ومحاكاة الإجراء التلقائي لاحقًا). لا يسري هذا الخيار إلا على مشغِّلات "إرسال النموذج" و"النقر على الرابط".
checkValidation

object (Parameter)

ما إذا كان علينا تنشيط العلامات فقط في حال عدم إلغاء حدث إرسال النموذج أو النقر على الرابط من خلال بعض معالجات الأحداث الأخرى (مثلاً بسبب التحقّق من الصحة). لا يسري هذا الخيار إلا على مشغِّلات "إرسال النموذج" و"النقر على الرابط".
waitForTagsTimeout

object (Parameter)

مدة الانتظار (بالملي ثانية) لإطلاق العلامات عندما يتم تقييم "waits_for_tags" أعلاه على النحو التالي

true

. صالح فقط لمشغِّلات "إرسال النموذج" و"النقر على الرابط".
uniqueTriggerId

object (Parameter)

المعرّف الفريد على مستوى العالم للعامل المشغِّل الذي ينشئ هذا الإجراء تلقائيًا (مُستمع إرسال نموذج أو نقرة على رابط أو موقّت)، إن توفّر تُستخدَم لجعل الأحداث التلقائية غير المتوافقة تعمل معًا مع فلترة عوامل التشغيل استنادًا إلى أرقام تعريف عوامل التشغيل. تتم تعبئة هذه القيمة أثناء إنشاء الإخراج لأنّ العلامات التي تشير إليها عوامل التشغيل لا تكون متوفّرة حتى ذلك الحين. لا يكون صالحًا إلّا لمشغِّلات "إرسال النموذج" و"النقر على الرابط" و"الموقّت".
eventName

object (Parameter)

اسم حدث "إحصاءات Google‏ 4" الذي يتمّ تشغيله. صالح فقط لعوامل تشغيل الموقّت.
interval

object (Parameter)

الوقت بين بدء أحداث الموقّت المتكرّرة (بالملّي ثانية) صالح فقط لعوامل تشغيل الموقّت.
limit

object (Parameter)

الحدّ الأقصى لعدد أحداث "إحصاءات Google‏ 4" التي سيُشغِّلها "مشغِّل الموقّت" هذا. في حال عدم ضبط أي حدّ، سنواصل تنشيط أحداث "إحصاءات Google‏ 4" إلى أن يغادر المستخدِم الصفحة. صالح فقط لعوامل تشغيل الموقّت.
fingerprint

string

بصمة مشغّل "إدارة العلامات من Google" كما تم احتسابها في وقت التخزين تتم إعادة احتساب هذه القيمة عند تعديل العامل المشغِّل.
parentFolderId

string

معرّف المجلد الرئيسي
selector

object (Parameter)

أداة اختيار لغة CSS لعامل تشغيل النقرة (أي "a" أو "button" أو غير ذلك) صالح فقط لعامل تشغيل النقرة في AMP.
intervalSeconds

object (Parameter)

المدة بين تنشيط أحداث الموقّت (بالثواني) صالح فقط لعامل تشغيل موقّت AMP.
maxTimerLengthSeconds

object (Parameter)

الحد الأقصى للوقت لتشغيل أحداث الموقّت (بالثواني). صالح فقط لعامل تشغيل موقّت AMP.
verticalScrollPercentageList

object (Parameter)

قائمة بقيم النسبة المئوية الصحيحة لعوامل تشغيل الانتقال إلى أعلى أو أسفل الصفحة سيتم تنشيط المشغِّل عند بلوغ كل نسبة مئوية عند تمرير العرض عموديًا. لا ينطبق إلا على عوامل تشغيل الانتقال في صفحات AMP.
horizontalScrollPercentageList

object (Parameter)

قائمة بقيم النسبة المئوية الصحيحة لعوامل تشغيل الانتقال إلى أعلى أو أسفل الصفحة سيتم تنشيط المشغِّل عند بلوغ كل نسبة مئوية عند تمرير العرض أفقيًا. لا ينطبق إلا على عوامل تشغيل الانتقال في صفحات AMP.
visibilitySelector

object (Parameter)

محدّد CSS لمشغِّل مستوى الرؤية (أي "‎#id"). صالحة فقط لعامل تشغيل مستوى الرؤية في صفحات AMP.
visiblePercentageMin

object (Parameter)

يحدّد مشغِّل مستوى الرؤية الحدّ الأدنى للنسبة المئوية المرئية. صالحة فقط لعامل تشغيل مستوى الرؤية في صفحات AMP.
visiblePercentageMax

object (Parameter)

يحدّد مشغِّل مستوى الرؤية الحدّ الأقصى للنسبة المئوية لمستوى الظهور. صالحة فقط لعامل تشغيل مستوى الرؤية في صفحات AMP.
continuousTimeMinMilliseconds

object (Parameter)

الحد الأدنى للوقت المستمر الذي يظهر فيه عامل تشغيل الظهور (بالملي ثانية) صالحة فقط لعامل تشغيل مستوى الرؤية في صفحات AMP.
totalTimeMinMilliseconds

object (Parameter)

يحدّد عامل تشغيل مستوى الرؤية الحدّ الأدنى للوقت الإجمالي للظهور (بالمللي ثانية). صالحة فقط لعامل تشغيل مستوى الرؤية في صفحات AMP.
tagManagerUrl

string

رابط تم إنشاؤه تلقائيًا يؤدي إلى واجهة مستخدِم أداة "إدارة العلامات من Google"
notes

string

ملاحظات المستخدم حول كيفية تطبيق هذا المشغِّل في الحاوية
parameter[]

object (Parameter)

المَعلمات الإضافية

EventType

عمليات التعداد
eventTypeUnspecified
pageview
domReady
windowLoaded
customEvent
triggerGroup
init
consentInit
serverPageview
always
firebaseAppException
firebaseAppUpdate
firebaseCampaign
firebaseFirstOpen
firebaseInAppPurchase
firebaseNotificationDismiss
firebaseNotificationForeground
firebaseNotificationOpen
firebaseNotificationReceive
firebaseOsUpdate
firebaseSessionStart
firebaseUserEngagement
formSubmission
click
linkClick
jsError
historyChange
timer
ampClick
ampTimer
ampScroll
ampVisibility
youTubeVideo
scrollDepth
elementVisibility

الطُرق

create

 تُنشئ عبارة تشغيل في "إدارة العلامات من Google".

delete

 لحذف مشغّل في أداة "إدارة العلامات من Google"

get

 الحصول على عامل تشغيل في "إدارة العلامات من Google"

list

 تعرض هذه السمة جميع مشغّلات "إدارة العلامات من Google" لحاوية معيّنة.

revert

 تُلغي التغييرات التي تم إجراؤها على عامل تشغيل في "إحصاءات Google‏ 4" في مساحة عمل "إحصاءات Google‏ 4".

update

 تعديل عامل تشغيل في "إدارة العلامات من Google"