Tag Manager API - การอ้างอิงพจนานุกรมมาโคร

เอกสารนี้อธิบายพร็อพเพอร์ตี้ที่ตั้งค่าสำหรับแท็ก Google ได้ มาโครการจัดการ

บทนำ

มาโครของ Google Tag Manager แต่ละรายการ มีโค้ด 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"
    }
   ]
  }

URL ที่มา 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}}"
    }
   ]
  }