Tags

แท็กที่เชื่อมโยงกับคอนเทนเนอร์ โดยทั่วไปแท็กจะเชื่อมโยงกับกฎการเริ่มทำงานอย่างน้อย 1 กฎ (ดู firingRuleId ด้านล่าง) และด้วยกฎการบล็อกอย่างน้อย 1 ข้อ (ดูblockingRuleId ด้านล่าง) เมื่อกฎการเริ่มทำงานอย่างน้อย 1 กฎประเมินค่าเป็น "จริง" และ "ไม่มี" กฎการบล็อกที่ประเมินเป็น "จริง" แท็กจะเริ่มทำงาน (เรียกใช้) ใช้พร็อพเพอร์ตี้ priority ที่ไม่บังคับเพื่อปรับเปลี่ยนแท็กที่ต้องการให้เริ่มทำงานก่อนแท็กอื่นๆ ใช้พร็อพเพอร์ตี้ dependencies เพื่อระบุว่าแท็กอื่นใดที่ต้องเริ่มทํางานและดําเนินการให้เสร็จสมบูรณ์ก่อนที่แท็กนี้จะเริ่มทำงาน โปรดดูรายละเอียดเกี่ยวกับพารามิเตอร์ที่ตั้งค่าสำหรับแท็ก Google Tag Manager ได้ที่ข้อมูลอ้างอิงพจนานุกรมแท็ก

โปรดดูรายการวิธีการสำหรับแหล่งข้อมูลนี้ที่ส่วนท้ายของหน้านี้

การรับรองทรัพยากร

แสดงแท็ก Google Tag Manager

{
  "accountId": string,
  "containerId": string,
  "tagId": string,
  "name": string,
  "type": string,
  "firingRuleId": [
    string
  ],
  "blockingRuleId": [
    string
  ],
  "firingTriggerId": [
    string
  ],
  "blockingTriggerId": [
    string
  ],
  "liveOnly": boolean,
  "priority": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ]
  },
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  ],
  "fingerprint": string,
  "setupTag": [
    {
      "tagName": string,
      "stopOnSetupFailure": boolean
    }
  ],
  "teardownTag": [
    {
      "tagName": string,
      "stopTeardownOnFailure": boolean
    }
  ],
  "parentFolderId": string,
  "tagFiringOption": string,
  "paused": boolean
}
ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย Notes
accountId string รหัสบัญชี GTM
blockingRuleId[] list รหัสกฎการบล็อก หากกฎใดๆ ที่ระบุไว้ประเมินได้ว่าเป็น "จริง" แท็กจะไม่เริ่มทํางาน เขียนได้
blockingTriggerId[] list รหัสทริกเกอร์การบล็อก หากทริกเกอร์ใดๆ ในรายการประเมินค่าเป็น "จริง" แท็กจะไม่เริ่มทํางาน เขียนได้
containerId string รหัสคอนเทนเนอร์ GTM
fingerprint string ลายนิ้วมือของแท็ก GTM ที่คำนวณ ณ เวลาจัดเก็บข้อมูล ค่านี้จะคำนวณใหม่ทุกครั้งที่มีการแก้ไขแท็ก
firingRuleId[] list รหัสกฎการเริ่มทำงาน แท็กจะเริ่มทำงานเมื่อกฎใดๆ ที่ระบุไว้เป็นจริง และ blockingRuleIds ทั้งหมด (หากระบุไว้) เป็นเท็จ เขียนได้
firingTriggerId[] list รหัสทริกเกอร์การเริ่มทำงาน แท็กจะเริ่มทำงานเมื่อทริกเกอร์ใดๆ ที่ระบุไว้เป็นจริง และ blockingTriggerIds ทั้งหมด (หากระบุไว้) เป็นเท็จ เขียนได้
liveOnly boolean หากตั้งค่าเป็น "จริง" แท็กนี้จะเริ่มทำงานในสภาพแวดล้อมจริงเท่านั้น (เช่น ไม่อยู่ในโหมดแสดงตัวอย่างหรือแก้ไขข้อบกพร่อง) เขียนได้
name string ชื่อที่แสดงของแท็ก เขียนได้
notes string ผู้ใช้ระบุวิธีใช้แท็กนี้ในคอนเทนเนอร์ เขียนได้
parameter[] list พารามิเตอร์ของแท็ก เขียนได้
parameter[].key string คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ เขียนได้
parameter[].list[] list พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) เขียนได้
parameter[].map[] list พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) เขียนได้
parameter[].type string ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
  • boolean: ค่านี้แทนค่าบูลีน ซึ่งแสดงเป็น "true" หรือ "false"
  • integer: ค่านี้แสดงค่าจำนวนเต็มแบบมีเครื่องหมาย 64 บิตในฐาน 10
  • list: ควรระบุรายการพารามิเตอร์
  • map: ควรระบุแมปของพารามิเตอร์
  • template: ค่าแสดงถึงข้อความทุกอย่าง ซึ่งอาจรวมถึงการอ้างอิงตัวแปร (แม้แต่การอ้างอิงตัวแปรที่อาจแสดงประเภทที่ไม่ใช่สตริง)
  • trigger_reference: ค่านี้แทนทริกเกอร์ ซึ่งแสดงเป็นรหัสทริกเกอร์


ค่าที่ยอมรับมีดังนี้
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
เขียนได้
parameter[].value string ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ เขียนได้
parentFolderId string ID โฟลเดอร์หลัก
paused boolean เป็นจริงหากแท็กหยุดชั่วคราว เขียนได้
priority nested object ตัวเลขลำดับความสำคัญของแท็กที่ผู้ใช้กำหนด แท็กจะเริ่มทำงานแบบอะซิงโครนัสตามลำดับความสำคัญ แท็กที่มีค่าตัวเลขสูงกว่าจะเริ่มทำงานก่อน ลำดับความสำคัญของแท็กอาจเป็นค่าบวกหรือค่าลบก็ได้ ค่าเริ่มต้นคือ 0 เขียนได้
priority.key string คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ เขียนได้
priority.list[] list พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) เขียนได้
priority.map[] list พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) เขียนได้
priority.type string ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
  • boolean: ค่านี้แทนค่าบูลีน ซึ่งแสดงเป็น "true" หรือ "false"
  • integer: ค่านี้แสดงค่าจำนวนเต็มแบบมีเครื่องหมาย 64 บิตในฐาน 10
  • list: ควรระบุรายการพารามิเตอร์
  • map: ควรระบุแมปของพารามิเตอร์
  • template: ค่าแสดงถึงข้อความทุกอย่าง ซึ่งอาจรวมถึงการอ้างอิงตัวแปร (แม้แต่การอ้างอิงตัวแปรที่อาจแสดงประเภทที่ไม่ใช่สตริง)
  • trigger_reference: ค่านี้แทนทริกเกอร์ ซึ่งแสดงเป็นรหัสทริกเกอร์


ค่าที่ยอมรับมีดังนี้
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
เขียนได้
priority.value string ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ เขียนได้
scheduleEndMs long การประทับเวลาสิ้นสุดเป็นมิลลิวินาทีเพื่อตั้งเวลาแท็ก เขียนได้
scheduleStartMs long การประทับเวลาเริ่มต้นเป็นมิลลิวินาทีเพื่อตั้งเวลาแท็ก เขียนได้
setupTag[] list รายการแท็กสำหรับตั้งค่า ปัจจุบันเราอนุญาตให้มีเพียง 1 รายการเท่านั้น
setupTag[].stopOnSetupFailure boolean หากเป็น "จริง" ให้เริ่มการทำงานของแท็กหลักต่อเมื่อแท็กตั้งค่าเริ่มทำงานสำเร็จเท่านั้น หากเป็น "เท็จ" ให้เริ่มการทํางานของแท็กหลักไม่ว่าแท็กตั้งค่าจะเริ่มทํางานอย่างไร
setupTag[].tagName string ชื่อของแท็กตั้งค่า
tagFiringOption string ตัวเลือกในการทำให้แท็กนี้เริ่มทำงาน

ค่าที่ยอมรับมีดังนี้
  • "oncePerEvent"
  • "oncePerLoad"
  • "unlimited"
tagId string รหัสแท็กจะระบุแท็ก GTM ที่ไม่ซ้ำ
teardownTag[] list รายการแท็กลบล้าง ปัจจุบันเราอนุญาตให้มีเพียง 1 รายการเท่านั้น
teardownTag[].stopTeardownOnFailure boolean หากเป็น "จริง" ให้เริ่มการทำงานของแท็กลบล้างเมื่อแท็กหลักเริ่มทำงานสำเร็จเท่านั้น หากเป็น "เท็จ" ให้เริ่มการทำงานของแท็ก teardown โดยไม่คำนึงถึงสถานะการเริ่มทำงานของแท็กหลัก
teardownTag[].tagName string ชื่อของแท็กลบล้าง
type string ประเภทแท็ก GTM เขียนได้

วิธีการ

ใช้วิธีการด้านล่างเพื่อสร้าง แก้ไข ลบ หรือเรียกข้อมูลแท็ก

สร้าง
สร้างแท็ก GTM
ลบ
ลบแท็ก GTM
รับ
รับแท็ก GTM
list
แสดงรายการแท็ก GTM ทั้งหมดของคอนเทนเนอร์
อัปเดต
อัปเดตแท็ก GTM