Tag Manager API - مرجع فرهنگ لغت ماکرو

این سند ویژگی هایی را که می توان برای ماکروهای Google Tag Manager تنظیم کرد، توضیح می دهد.

مقدمه

هر ماکرو Google Tag Manager دارای یک کد type برای شناسایی ماکرو است. علاوه بر این، اکثر ماکروها دارای پارامترهایی هستند ( key ، جفت type ) که می‌توانید هنگام ایجاد یا به‌روزرسانی یک ماکرو، آن‌ها را به عنوان بخشی از یک «شیء پارامتر» تنظیم کنید. برای کسب اطلاعات بیشتر در مورد نحوه تنظیم این پارامترها با استفاده از یک شی پارامتر به مرجع پارامتر مراجعه کنید.

بقیه این سند جزئیات همه ماکروهای پشتیبانی شده را فهرست می کند.

کوکی 1st Party

کد را تایپ کنید

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

پارامترها

N/A

مثال

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

رویداد سفارشی

کد را تایپ کنید

پارامترها

N/A

مثال

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

جاوا اسکریپت سفارشی

کد را تایپ کنید

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

پارامترها

N/A

مثال

  {
   "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"
    }
   ]
  }

متغیر جاوا اسکریپت

کد را تایپ کنید

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

پارامترها

N/A

مثال

  {
   "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}}"
    }
   ]
  }