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

يوضِّح هذا المستند السمات التي يمكن ضبطها لعلامة Google. وحدات ماكرو المدير.

مقدمة

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

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

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

رمز النوع

k

المعلمات

المفتاح	النوع	ملاحظات
name	template	اسم ملف تعريف الارتباط.

مثال

 {
   "name": "Sample 1st Party Cookie Macro",
   "type": "k",
   "parameter": [
    {
     "type": "template",
     "key": "name",
     "value": "myCookieName"
    }
   ]
 }

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

رمز النوع

aev

المعلمات

المفتاح	النوع	ملاحظات
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

المعلمات

المفتاح	النوع
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

المعلمات

المفتاح	النوع
javascript	template

مثال

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

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

رمز النوع

v

المعلمات

المفتاح	النوع	ملاحظات
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 Macro",
   "type": "dbg"
  }

عنصر DOM

رمز النوع

d

المعلمات

المفتاح	النوع	ملاحظات
elementId	template
attributeName	template	اختياريّ.

مثال

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

مُحيل HTTP

رمز النوع

f

المعلمات

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

مثال

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

متغيّر JavaScript

رمز النوع

j

المعلمات

المفتاح	النوع	ملاحظات
name	template	اسم المتغير العمومي.

مثال

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

جدول البحث

رمز النوع

smm

المعلمات

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

مثال

  {
   "name": "Sample Lookup Table Macro",
   "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 Macro",
   "type": "r"
  }

URL

رمز النوع

u

المعلمات

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

مثال

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