واجهة برمجة تطبيقات إدارة العلامات - مرجع قاموس المتغير

يوضّح هذا المستند الخصائص التي يمكن ضبطها لمتغيّرات "إدارة العلامات من Google".

مقدمة

يحتوي كل متغيّر على أداة "إدارة العلامات من Google" على رمز type لتحديد المتغيّر. بالإضافة إلى ذلك، تحتوي معظم المتغيّرات على معلَمات (key وtype أزواج) التي يمكنك ضبطها كجزء من "كائن معلَمة" عند إنشاء متغيّر أو تعديله. لمعرفة المزيد من المعلومات عن كيفية ضبط هذه المَعلمات باستخدام كائن مَعلمة، يُرجى الاطّلاع على مرجع المَعلمات.

تسرد بقية هذا المستند تفاصيل جميع المتغيّرات المتوافقة.

ملفات تعريف الارتباط للطرف الأول

رمز النوع

k

المَعلمات

المفتاح	Type	Notes
name	template	اسم ملف تعريف الارتباط.

مثال

 {
   "name": "Sample First Party Cookie Variable",
   "type": "k",
   "parameter": [
    {
     "type": "template",
     "key": "name",
     "value": "myCookieName"
    }
   ]
 }

متغيّر الحدث التلقائي

رمز النوع

aev

المَعلمات

المفتاح	Type	Notes
varType	template	واحد من ELEMENT أوCLASSES أو ID أو TARGET أو TEXT أو URL أو HISTORY_NEW_URL_FRAGMENT أو HISTORY_OLD_URL_FRAGMENT أو HISTORY_NEW_STATE أو HISTORY_OLD_STATE أو HISTORY_CHANGE_SOURCE.
defaultValue	template	اختياريّ.

مثال

  {
   "name": "Sample AutoEvent Variable",
   "type": "aev",
   "parameter": [
    {
     "type": "template",
     "key": "varType",
     "value": "CLASSES"
    },
    {
     "type": "template",
     "key": "defaultValue",
     "value": "MyDefault"
    }
   ]
  }

السلسلة الثابتة

رمز النوع

c

المَعلمات

المفتاح	Type
value	template

مثال

  {
   "name": "Sample Constant String",
   "type": "c",
   "parameter": [
    {
     "type": "template",
     "key": "value",
     "value": "MyString"
    }
   ]
  }

رقم إصدار الحاوية

رمز النوع

ctv

المَعلمات

لا ينطبق

مثال

  {
   "name": "Sample Container Version Number",
   "type": "ctv"
  }

الحدث المخصّص

رمز النوع

المَعلمات

لا ينطبق

مثال

  {
   "name": "Custom Event Name",
   "type": "e"
  }

محتوى JavaScript مخصّص

رمز النوع

jsm

المَعلمات

المفتاح	Type
javascript	template

مثال

  {
   "name": "Sample Custom Javascript",
   "type": "jsm",
   "parameter": [
    {
     "type": "template",
     "key": "javascript",
     "value": "function() {\n return \"Hello World\";\n}"
    }
   ]
  }

متغيّر طبقة البيانات

رمز النوع

v

المَعلمات

المفتاح	Type	Notes
name	template	اسم متغيّر طبقة البيانات
defaultValue	template
dataLayerVersion	integer	1 أو 2.

مثال

  {
   "name": "Sample Data Layer Variable",
   "type": "v",
   "parameter": [
    {
     "type": "template",
     "key": "name",
     "value": "DL Variable Name"
    },
    {
     "type": "template",
     "key": "defaultValue",
     "value": "DEFAULT"
    },
    {
     "type": "integer",
     "key": "dataLayerVersion",
     "value": "2"
    }
   ]
  }

وضع تصحيح الأخطاء

رمز النوع

dbg

المَعلمات

لا ينطبق

مثال

  {
   "name": "Sample Debug Mode Variable",
   "type": "dbg"
  }

عنصر DOM

رمز النوع

d

المَعلمات

المفتاح	Type	Notes
elementId	template
attributeName	template	اختياريّ.

مثال

  {
   "name": "Sample DOM Element Variable",
   "type": "d",
   "parameter": [
    {
     "type": "template",
     "key": "elementId",
     "value": "MyElementId"
    },
    {
     "type": "template",
     "key": "attributeName",
     "value": "MyAttributeName"
    }
   ]
  }

مُحيل HTTP

رمز النوع

f

المَعلمات

المفتاح	Type	Notes
component	template	واحد من: URL, PROTOCOL, HOST, PORT, PATH, QUERY, FRAGMENT.
stripWww	boolean	بالنسبة إلى المكوِّن = HOST
queryKey	template	بالنسبة إلى المكوِّن = QUERY

مثال

  {
   "name": "Sample HTTP Referrer Variable",
   "type": "f",
   "parameter": [
    {
     "type": "template",
     "key": "component",
     "value": "URL"
    }
   ]
  }

متغيّر JavaScript

رمز النوع

j

المَعلمات

المفتاح	Type	Notes
name	template	اسم المتغيّر العمومي.

مثال

  {
   "name": "Sample Javascript Variable",
   "type": "j",
   "parameter": [
    {
     "type": "template",
     "key": "name",
     "value": "MyGlobalVarName"
    }
   ]
  }

جدول البحث

رمز النوع

smm

المَعلمات

المفتاح	Type	Notes
input	template	يجب أن تكون القيمة المستخدمة للبحث مرجعًا متغيرًا.
map	list	قائمة من الخرائط، ولكل منها زوج واحد من [key، value].
map[].key	template
map[].value	template
defaultValue	template	اختياريّ.

مثال

  {
   "name": "Sample Lookup Table Variable",
   "type": "smm",
   "parameter": [
    {
     "type": "template",
     "key": "input",
     "value": "{{event}}"
    },
    {
     "type": "list",
     "key": "map",
     "list": [
      {
       "type": "map",
       "map": [
        {
         "type": "template",
         "key": "key",
         "value": "EventEqualsThis"
        },
        {
         "type": "template",
         "key": "value",
         "value": "ThenSetToThis"
        }
       ]
      }
     ]
    },
    {
     "type": "template",
     "key": "defaultValue",
     "value": "MyDefaultValue"
    }
   ]
  }

رقم عشوائي

رمز النوع

r

المَعلمات

لا ينطبق

مثال

  {
   "name": "Sample Random Number Variable",
   "type": "r"
  }

URL

رمز النوع

u

المَعلمات

المفتاح	Type	Notes
component	template	واحد من: URL, PROTOCOL, HOST, PORT, PATH, QUERY, FRAGMENT.
customUrlSource	template	اختياريّ.
stripWww	boolean	بالنسبة إلى المكوِّن = HOST.
queryKey	template	بالنسبة إلى المكوِّن = QUERY.

مثال

  {
   "name": "Sample URL Variable",
   "type": "u",
   "parameter": [
    {
     "type": "template",
     "key": "component",
     "value": "URL"
    },
    {
     "type": "template",
     "key": "customUrlSource",
     "value": "{{element}}"
    }
   ]
  }