ต้องมีการให้สิทธิ์
อัปเดตทริกเกอร์ GTM ลองใช้เลยหรือดูตัวอย่าง
ส่งคำขอ
คำขอ HTTP
PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/triggers/triggerId
พารามิเตอร์
ชื่อพารามิเตอร์ | ค่า | คำอธิบาย |
---|---|---|
พารามิเตอร์เส้นทาง | ||
accountId |
string |
รหัสบัญชี GTM |
containerId |
string |
รหัสคอนเทนเนอร์ GTM |
triggerId |
string |
รหัสทริกเกอร์ GTM |
พารามิเตอร์การค้นหาที่ไม่บังคับ | ||
fingerprint |
string |
เมื่อระบุ ลายนิ้วมือนี้ต้องตรงกับลายนิ้วมือของทริกเกอร์ในพื้นที่เก็บข้อมูล |
การให้สิทธิ์
คำขอนี้ต้องได้รับสิทธิ์ด้วยขอบเขตต่อไปนี้ (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)
ขอบเขต |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
เนื้อหาของคำขอ
ในเนื้อหาคำขอ ให้ระบุทรัพยากรทริกเกอร์พร้อมด้วยพร็อพเพอร์ตี้ต่อไปนี้
ชื่อพร็อพเพอร์ตี้ | ค่า | คำอธิบาย | Notes |
---|---|---|---|
พร็อพเพอร์ตี้ที่จำเป็น | |||
autoEventFilter[].parameter[] |
list |
รายการพารามิเตอร์ที่มีชื่อ (คีย์/ค่า) โดยขึ้นอยู่กับประเภทของเงื่อนไข หมายเหตุ:
|
เขียนได้ |
autoEventFilter[].parameter[].type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
autoEventFilter[].type |
string |
ประเภทของโอเปอเรเตอร์สำหรับเงื่อนไขนี้
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
checkValidation.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
continuousTimeMinMilliseconds.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
customEventFilter[].parameter[] |
list |
รายการพารามิเตอร์ที่มีชื่อ (คีย์/ค่า) โดยขึ้นอยู่กับประเภทของเงื่อนไข หมายเหตุ:
|
เขียนได้ |
customEventFilter[].parameter[].type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
customEventFilter[].type |
string |
ประเภทของโอเปอเรเตอร์สำหรับเงื่อนไขนี้
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
eventName.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
filter[].parameter[] |
list |
รายการพารามิเตอร์ที่มีชื่อ (คีย์/ค่า) โดยขึ้นอยู่กับประเภทของเงื่อนไข หมายเหตุ:
|
เขียนได้ |
filter[].parameter[].type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
filter[].type |
string |
ประเภทของโอเปอเรเตอร์สำหรับเงื่อนไขนี้
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
horizontalScrollPercentageList.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
interval.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
intervalSeconds.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
limit.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
maxTimerLengthSeconds.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
name |
string |
ชื่อที่แสดงของทริกเกอร์ | เขียนได้ |
parameter[].type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
selector.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
totalTimeMinMilliseconds.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
uniqueTriggerId.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
verticalScrollPercentageList.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
visibilitySelector.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
visiblePercentageMax.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
visiblePercentageMin.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
waitForTags.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
waitForTagsTimeout.type |
string |
ประเภทพารามิเตอร์ ค่าที่ถูกต้องคือ:
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
พร็อพเพอร์ตี้ที่ไม่บังคับ | |||
autoEventFilter[] |
list |
ใช้ในกรณีที่ติดตามกิจกรรมอัตโนมัติ | เขียนได้ |
autoEventFilter[].parameter[].key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
autoEventFilter[].parameter[].list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
autoEventFilter[].parameter[].map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
autoEventFilter[].parameter[].value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
checkValidation |
nested object |
เราควรให้แท็กเริ่มทำงานก็ต่อเมื่อการส่งแบบฟอร์มหรือกิจกรรมการคลิกลิงก์ไม่ถูกยกเลิกโดยตัวแฮนเดิลเหตุการณ์อื่นๆ บางตัว (เช่น เนื่องจากการตรวจสอบความถูกต้อง) ใช้ได้กับทริกเกอร์การส่งแบบฟอร์มและการคลิกลิงก์เท่านั้น | เขียนได้ |
checkValidation.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
checkValidation.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
checkValidation.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
checkValidation.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
continuousTimeMinMilliseconds |
nested object |
เวลาที่มองเห็นอย่างต่อเนื่องขั้นต่ำของระดับการเข้าถึง (หน่วยเป็นมิลลิวินาที) ใช้ได้กับทริกเกอร์การเปิดเผย AMP เท่านั้น | เขียนได้ |
continuousTimeMinMilliseconds.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
continuousTimeMinMilliseconds.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
continuousTimeMinMilliseconds.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
continuousTimeMinMilliseconds.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
customEventFilter[] |
list |
ใช้ในกรณีของเหตุการณ์ที่กำหนดเอง ซึ่งเริ่มทำงานหากเงื่อนไขทั้งหมดเป็นจริง | เขียนได้ |
customEventFilter[].parameter[].key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
customEventFilter[].parameter[].list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
customEventFilter[].parameter[].map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
customEventFilter[].parameter[].value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
eventName |
nested object |
ชื่อเหตุการณ์ GTM ที่เริ่มทำงาน ใช้ได้กับทริกเกอร์ตัวจับเวลาเท่านั้น | เขียนได้ |
eventName.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
eventName.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
eventName.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
eventName.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
filter[] |
list |
ทริกเกอร์จะเริ่มทำงานเมื่อเงื่อนไขทั้งหมดเป็นจริงเท่านั้น | เขียนได้ |
filter[].parameter[].key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
filter[].parameter[].list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
filter[].parameter[].map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
filter[].parameter[].value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
horizontalScrollPercentageList |
nested object |
รายการค่าเปอร์เซ็นต์จำนวนเต็มสำหรับทริกเกอร์การเลื่อน ทริกเกอร์จะเริ่มทำงานเมื่อถึงเปอร์เซ็นต์ที่กำหนดเมื่อเลื่อนมุมมองในแนวนอน ใช้ได้กับทริกเกอร์การเลื่อน AMP เท่านั้น | เขียนได้ |
horizontalScrollPercentageList.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
horizontalScrollPercentageList.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
horizontalScrollPercentageList.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
horizontalScrollPercentageList.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
interval |
nested object |
เวลาระหว่างการเรียกเหตุการณ์ตัวจับเวลาที่เกิดซ้ำ (หน่วยเป็นมิลลิวินาที) ใช้ได้กับทริกเกอร์ตัวจับเวลาเท่านั้น | เขียนได้ |
interval.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
interval.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
interval.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
interval.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
intervalSeconds |
nested object |
เวลาระหว่างเหตุการณ์ในตัวจับเวลาที่จะเริ่มทำงาน (เป็นวินาที) ใช้ได้กับทริกเกอร์ตัวจับเวลา AMP เท่านั้น | เขียนได้ |
intervalSeconds.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
intervalSeconds.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
intervalSeconds.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
intervalSeconds.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
limit |
nested object |
ขีดจำกัดของจำนวนเหตุการณ์ GTM ที่ทริกเกอร์ตัวจับเวลานี้จะเริ่มทำงาน หากไม่ได้ตั้งค่าขีดจำกัด เราจะสั่งให้เหตุการณ์ GTM เริ่มทำงานต่อไปจนกว่าผู้ใช้จะออกจากหน้าเว็บ ใช้ได้กับทริกเกอร์ตัวจับเวลาเท่านั้น | เขียนได้ |
limit.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
limit.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
limit.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
limit.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
maxTimerLengthSeconds |
nested object |
เวลาสูงสุดในการเริ่มการทำงานของเหตุการณ์ตัวจับเวลา (เป็นวินาที) ใช้ได้กับทริกเกอร์ตัวจับเวลา AMP เท่านั้น | เขียนได้ |
maxTimerLengthSeconds.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
maxTimerLengthSeconds.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
maxTimerLengthSeconds.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
maxTimerLengthSeconds.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
parameter[].key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
parameter[].list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
parameter[].map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
parameter[].value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
selector |
nested object |
ตัวเลือก CSS ของทริกเกอร์การคลิก (เช่น "a", "button" ฯลฯ) ใช้ได้กับทริกเกอร์การคลิก AMP เท่านั้น | เขียนได้ |
selector.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
selector.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
selector.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
selector.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
totalTimeMinMilliseconds |
nested object |
เวลาที่มองเห็นรวมขั้นต่ำของระดับการเข้าถึง (หน่วยเป็นมิลลิวินาที) ใช้ได้กับทริกเกอร์การเปิดเผย AMP เท่านั้น | เขียนได้ |
totalTimeMinMilliseconds.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
totalTimeMinMilliseconds.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
totalTimeMinMilliseconds.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
totalTimeMinMilliseconds.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
type |
string |
กำหนดเหตุการณ์ชั้นข้อมูลที่ทำให้เกิดทริกเกอร์นี้
ค่าที่ยอมรับมีดังนี้
|
เขียนได้ |
uniqueTriggerId |
nested object |
รหัสส่วนกลางที่ไม่ซ้ำกันของทริกเกอร์ที่จะสร้างรายการนี้โดยอัตโนมัติ (การส่งแบบฟอร์ม การคลิกลิงก์ หรือ Listener ตัวจับเวลา) หากมี ใช้เพื่อทำให้เหตุการณ์อัตโนมัติที่เข้ากันไม่ได้ทำงานร่วมกันกับการกรองทริกเกอร์ตามรหัสทริกเกอร์ ระบบจะสร้างค่านี้ระหว่างการสร้างเอาต์พุตเนื่องจากไม่มีแท็กโดยนัยโดยทริกเกอร์จนกว่าจะถึงวันดังกล่าว ใช้ได้กับทริกเกอร์การส่งแบบฟอร์ม การคลิกลิงก์ และตัวจับเวลาเท่านั้น | เขียนได้ |
uniqueTriggerId.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
uniqueTriggerId.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
uniqueTriggerId.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
uniqueTriggerId.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
verticalScrollPercentageList |
nested object |
รายการค่าเปอร์เซ็นต์จำนวนเต็มสำหรับทริกเกอร์การเลื่อน ทริกเกอร์จะเริ่มทำงานเมื่อถึงเปอร์เซ็นต์แต่ละเปอร์เซ็นต์เมื่อเลื่อนมุมมองในแนวตั้ง ใช้ได้กับทริกเกอร์การเลื่อน AMP เท่านั้น | เขียนได้ |
verticalScrollPercentageList.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
verticalScrollPercentageList.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
verticalScrollPercentageList.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
verticalScrollPercentageList.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
visibilitySelector |
nested object |
ตัวเลือก CSS ของทริกเกอร์ระดับการเข้าถึง (เช่น "#id") ใช้ได้กับทริกเกอร์การเปิดเผย AMP เท่านั้น | เขียนได้ |
visibilitySelector.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
visibilitySelector.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
visibilitySelector.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
visibilitySelector.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
visiblePercentageMax |
nested object |
เปอร์เซ็นต์การเปิดเผยสูงสุดจะทริกเกอร์การเปิดเผย ใช้ได้กับทริกเกอร์การเปิดเผย AMP เท่านั้น | เขียนได้ |
visiblePercentageMax.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
visiblePercentageMax.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
visiblePercentageMax.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
visiblePercentageMax.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
visiblePercentageMin |
nested object |
ระดับการมองเห็นเป็นเปอร์เซ็นต์ขั้นต่ำของการเปิดเผย ใช้ได้กับทริกเกอร์การเปิดเผย AMP เท่านั้น | เขียนได้ |
visiblePercentageMin.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
visiblePercentageMin.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
visiblePercentageMin.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
visiblePercentageMin.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
waitForTags |
nested object |
เราควรชะลอการส่งแบบฟอร์มหรือการเปิดลิงก์จนกว่าแท็กทั้งหมดจะเริ่มทำงานหรือไม่ (โดยป้องกันการดำเนินการเริ่มต้นและจำลองการทำงานเริ่มต้นในภายหลัง) ใช้ได้กับทริกเกอร์การส่งแบบฟอร์มและการคลิกลิงก์เท่านั้น | เขียนได้ |
waitForTags.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
waitForTags.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
waitForTags.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
waitForTags.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
waitForTagsTimeout |
nested object |
ระยะเวลารอ (เป็นมิลลิวินาที) ให้แท็กเริ่มทำงานเมื่อตัวเลือก "waits_for_tags" ด้านบนประเมินเป็น true ใช้ได้กับทริกเกอร์การส่งแบบฟอร์มและการคลิกลิงก์เท่านั้น |
เขียนได้ |
waitForTagsTimeout.key |
string |
คีย์ที่มีชื่อซึ่งระบุพารามิเตอร์โดยไม่ซ้ำกัน ต้องระบุสำหรับพารามิเตอร์ระดับบนสุดและค่าแมป ละเว้นสำหรับค่ารายการ | เขียนได้ |
waitForTagsTimeout.list[] |
list |
พารามิเตอร์ของพารามิเตอร์รายการนี้ (ระบบจะไม่สนใจคีย์) | เขียนได้ |
waitForTagsTimeout.map[] |
list |
พารามิเตอร์ของพารามิเตอร์แมปนี้ (ต้องมีคีย์ คีย์ต้องไม่ซ้ำกัน) | เขียนได้ |
waitForTagsTimeout.value |
string |
ค่าของพารามิเตอร์ (อาจมีการอ้างอิงตัวแปร เช่น "") ตามความเหมาะสมกับประเภทที่ระบุ | เขียนได้ |
คำตอบ
หากสำเร็จ เมธอดนี้จะแสดงผลทรัพยากรทริกเกอร์ในเนื้อหาการตอบสนอง
ตัวอย่าง
หมายเหตุ: ตัวอย่างโค้ดที่มีสำหรับวิธีการนี้ไม่ได้แสดงถึงภาษาโปรแกรมที่รองรับทั้งหมด (ดูรายการภาษาที่รองรับได้ในหน้าไลบรารีของไคลเอ็นต์)
Java
/* * Note: This code assumes you have an authorized tagmanager service object. */ /* * This request updates an existing trigger for the authorized user. */ // Create the condition parameters objects. Parameter arg0 = new Parameter(); arg0.setType("template"); arg0.setKey("arg0"); arg0.setValue("{{Page URL}}"); Parameter arg1 = new Parameter(); arg1.setType("template"); arg1.setKey("arg1"); arg1.setValue("timed.html"); // Create the auto event condition object. Condition condition = new Condition(); condition.setType("contains"); condition.setParameter(Arrays.asList(arg0, arg1)); // Create the event parameter. Parameter eventName = new Parameter(); eventName.setType("template"); eventName.setValue("gtm.timer"); // Create the interval parameter. Parameter interval = new Parameter(); interval.setType("template"); interval.setValue("10000"); // Create the limit parameter. Parameter limit = new Parameter(); limit.setType("template"); limit.setValue("10"); // Create the trigger object. Trigger trigger = new Trigger(); trigger.setName("Updated Timer Trigger"); trigger.setType("timer"); trigger.setAutoEventFilter(Arrays.asList(condition)); trigger.setEventName(eventName); trigger.setInterval(interval); trigger.setLimit(limit); try { Trigger response = tagmanager.accounts().containers(). triggers().update("123456", "54321", "1", trigger).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); } /* * The results of the update method are stored in the response object. * The following code shows how to access the updated name and fingerprint. */ System.out.println("Updated Name = " + response.getName()); System.out.println("Updated Fingerprint = " + response.getFingerprint());
Python
# Note: This code assumes you have an authorized tagmanager service object. # This request updates an existing trigger. try: response = tagmanager.accounts().containers().triggers().update( accountId='123456', containerId='54321', triggerId='3', body={ 'name': 'Updated Timed trigger', 'type': 'timer', 'autoEventFilter': [ { 'type': 'contains', 'parameter': [ { 'type': 'template', 'key': 'arg0', 'value': '{{Page URL}}' }, { 'type': 'template', 'key': 'arg1', 'value': 'timed.html' } ] } ], 'eventName': { 'type': 'template', 'value': 'gtm.timer' }, 'interval': { 'type': 'template', 'value': '10000' }, 'limit': { 'type': 'template', 'value': '10' } } ).execute() except TypeError, error: # Handle errors in constructing a query. print 'There was an error in constructing your query : %s' % error except HttpError, error: # Handle API errors. print ('There was an API error : %s : %s' % (error.resp.status, error.resp.reason)) # The results of the update method are stored in the response object. # The following code shows how to access the updated name and fingerprint. print 'Updated Name = %s' % response.get('name') print 'Updated Fingerprint = %s' % response.get('fingerprint')
ลองใช้เลย
ใช้ API Explorer ด้านล่างเพื่อเรียกใช้เมธอดนี้กับข้อมูลแบบเรียลไทม์และดูการตอบสนอง