ส่งเทมเพลตไปยังแกลเลอรีเทมเพลตชุมชน

แกลเลอรีเทมเพลตชุมชนของ Google Tag Manager ช่วยให้องค์กรของคุณสร้างและจัดการเทมเพลตตัวแปรและแท็กที่ผสานรวมกับ Google Tag Manager ได้อย่างราบรื่น องค์กรของคุณสามารถสร้างเทมเพลต เผยแพร่ที่เก็บเทมเพลตไปยัง GitHub แล้วส่งเทมเพลตไปยังแกลเลอรีเทมเพลตชุมชนเพื่อให้ผู้ใช้ทั่วโลกใช้งานได้ สิทธิประโยชน์ที่องค์กรจะได้รับมีดังนี้

  • ลูกค้าจะเพิ่มและใช้เทมเพลตของคุณได้อย่างง่ายดาย
  • ผู้ใช้ Tag Manager จะได้เห็นแบรนด์ขององค์กรคุณ
  • ลูกค้าจะติดตั้งใช้งานแท็กของคุณได้ภายในไม่กี่นาที ไม่ใช่เป็นเดือน
  • คุณสามารถเผยแพร่การอัปเดตเทมเพลตและทำให้การอัปเดตเหล่านั้นพร้อมใช้งานสำหรับลูกค้าโดยอัตโนมัติ

กระบวนการส่งเทมเพลตใหม่ไปยังแกลเลอรีเทมเพลตชุมชนมีขั้นตอนหลักๆ ดังนี้

  1. สร้างเทมเพลต
  2. เตรียมไฟล์โปรเจ็กต์
  3. อัปโหลดไฟล์ไปยัง GitHub
  4. ส่งเทมเพลต

สร้างเทมเพลต

เริ่มต้นด้วยการสร้างเทมเพลตใน Google Tag Manager เป็นเทมเพลตที่กำหนดเอง ตรวจสอบว่าได้ทดสอบเทมเพลตอย่างละเอียดแล้ว เนื้อหาของเทมเพลตเป็นไปตาม คู่มือสไตล์ และคุณมีแผนหรือกระบวนการในการดูแลรักษาและอัปเดตเทมเพลตหากจำเป็นในอนาคต

ข้อกำหนดในการให้บริการ

การส่งเทมเพลตใหม่ทุกครั้งต้องยอมรับข้อกำหนดในการให้บริการของแกลเลอรีเทมเพลตชุมชนของ Google Tag Manager วิธียืนยันการยอมรับข้อกำหนดในการให้บริการสำหรับเทมเพลต

  1. อ่านข้อกำหนดในการให้บริการของแกลเลอรีเทมเพลตชุมชนของ Google Tag Manager
  2. ในเครื่องมือแก้ไขเทมเพลต ให้เปิดเทมเพลตเพื่อแก้ไข แล้วเลือกช่องในแท็บข้อมูล ที่มีป้ายกำกับว่า "ยอมรับข้อกำหนดในการให้บริการของแกลเลอรีเทมเพลตชุมชน"

ส่งออกเทมเพลต

เมื่อสร้างเทมเพลตเสร็จแล้ว ให้ส่งออกไฟล์เทมเพลตไปยังเครื่องในเครื่องของคุณและเปลี่ยนชื่อไฟล์เป็น template.tpl

เตรียมไฟล์โปรเจ็กต์

ขั้นตอนถัดไปคือการเตรียมที่เก็บเพื่อเผยแพร่บน GitHub ที่เก็บแต่ละรายการควรมีไฟล์ต่อไปนี้

  1. ไฟล์เทมเพลตที่ส่งออกชื่อ template.tpl คุณต้องอัปเดตไฟล์นี้เพื่อเพิ่มรายการ categories
  2. ไฟล์ metadata.yaml
  3. ไฟล์ LICENSE ชื่อไฟล์ต้องเป็นตัวพิมพ์ใหญ่ทั้งหมดและเนื้อหาของไฟล์ใบอนุญาตต้องเป็น เท่านั้น Apache 2.0
  4. เพิ่มไฟล์ README.md (ไม่บังคับ แต่แนะนำ)

เพิ่มหมวดหมู่ลงใน template.tpl

อัปเดตไฟล์ template.tpl ด้วยรายการ categories ในส่วน INFO และระบุค่าหมวดหมู่ที่เกี่ยวข้องอย่างน้อย 1 ค่าที่เลือกจากตารางต่อไปนี้ หากมีหมวดหมู่ที่เหมาะสมมากกว่า 1 หมวดหมู่ คุณสามารถระบุค่าหมวดหมู่ได้สูงสุด 3 ค่า โดยเรียงจากเกี่ยวข้องมากที่สุดไปน้อยที่สุด

ตัวอย่างเช่น

___INFO___

{
  "displayName": "Example Template",
  "categories": ["AFFILIATE_MARKETING", "ADVERTISING"],
  // additional template properties, etc...
}

ตารางค่าหมวดหมู่ที่รองรับ

หมวดหมู่ คำอธิบาย
โฆษณา โฆษณา
AFFILIATE_MARKETING การตลาดแบบแอฟฟิลิเอต
ข้อมูลวิเคราะห์ ข้อมูลวิเคราะห์
การระบุแหล่งที่มา การระบุแหล่งที่มา
แชท แชท
Conversion การวัด Conversion
DATA_WAREHOUSING คลังข้อมูล
EMAIL_MARKETING การตลาดทางอีเมล
การทดลอง การทดสอบ A/B และการเพิ่มประสิทธิภาพเนื้อหา
HEAT_MAP ฮีตแมป
LEAD_GENERATION การสร้างผู้มีโอกาสเป็นลูกค้า
การตลาด การตลาด
PERSONALIZATION การปรับเปลี่ยนในแบบของผู้ใช้
รีมาร์เก็ตติ้ง รีมาร์เก็ตติ้ง
ยอดขาย ฝ่ายขายและ CRM
SESSION_RECORDING การบันทึกเซสชัน
SOCIAL โซเชียล
แบบสำรวจ แบบสำรวจ
TAG_MANAGEMENT ระบบการจัดการแท็ก
อรรถประโยชน์ อรรถประโยชน์ของ Google Tag Manager

metadata.yaml

ไฟล์ metadata.yaml มีข้อมูลเกี่ยวกับเทมเพลต ซึ่งรวมถึงลิงก์ไปยังหน้าแรกขององค์กร เอกสารประกอบของเทมเพลต และข้อมูลเวอร์ชัน แต่ละเวอร์ชันจะระบุด้วยหมายเลขการเปลี่ยนแปลง หรือที่เรียกว่าหมายเลข SHA ซึ่งเป็นหมายเลขการเปลี่ยนแปลงที่เชื่อมโยงกับการคอมมิต Git ช่อง changeNotes ไม่บังคับ แต่แนะนำให้ใช้เพื่อแจ้งให้ผู้ใช้ทราบถึงการเปลี่ยนแปลงที่รวมอยู่ในเวอร์ชัน

วิธีตั้งค่าไฟล์ metadata.yaml

  1. เพิ่มรายการ homepage ซึ่งควรเป็น URL ที่ชี้ไปยังหน้าแรกขององค์กร
  2. เพิ่มรายการสำหรับ documentation ซึ่งควรเป็น URL ที่ชี้ไปยังเอกสารประกอบสำหรับเทมเพลต
  3. ใน GitHub ให้ค้นหาการคอมมิตที่มีการเปลี่ยนแปลงที่คุณต้องการพุชสำหรับเทมเพลตเวอร์ชันเริ่มต้น แล้วคัดลอกหมายเลข SHA วิธีง่ายๆ ในการรับหมายเลข SHA ใน GitHub คือไปที่มุมมองการคอมมิต แล้วคลิกไอคอนคลิปบอร์ด (ไอคอนคลิปบอร์ด) ซึ่งจะคัดลอกหมายเลข SHA ทั้งหมดไปยังคลิปบอร์ด วางหมายเลขดังกล่าวเป็นค่าสำหรับรายการ sha เป็นโหนดย่อยของโหนด versions ดังที่แสดงด้านล่าง
  4. เพิ่มรายการ changeNotes ลงในโหนด versions เพื่ออธิบายการเปลี่ยนแปลงที่รวมอยู่ในเวอร์ชันใหม่นี้โดยย่อ
homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

อัปโหลดไปยัง GitHub

ขั้นตอนถัดไปคือการอัปโหลดไฟล์ไปยัง GitHub สร้างที่เก็บ GitHub ที่มีไฟล์และโครงสร้างที่เหมาะสมตามที่ระบุไว้ ข้างต้น

ที่เก็บเทมเพลตต้องมีไฟล์ * template.tpl, metadata.yaml และ LICENSE อยู่ที่ระดับรากของที่เก็บ Git ที่เก็บ Git แต่ละรายการควรมีไฟล์ template.tpl เพียงไฟล์เดียว ทรัพยากรทั้งหมดต้องอยู่ในสาขาหลักในที่เก็บ GitHub ระบบจะนำที่เก็บเทมเพลตที่ไม่ตรงกับโครงสร้างนี้ออกจากแกลเลอรี

แต่ละรายการในแกลเลอรีเทมเพลตชุมชนจะลิงก์ไปยังส่วนปัญหา ของที่เก็บ GitHub ของเทมเพลตเพื่อให้ผู้ใช้แจ้งให้คุณทราบหากพบข้อบกพร่อง

ส่งเทมเพลต

เมื่อโฮสต์ที่เก็บเทมเพลตใน GitHub แล้ว คุณก็ดำเนินการส่งเทมเพลตไปยังแกลเลอรีเทมเพลตชุมชนได้ หากต้องการส่งเทมเพลต ให้ทำตามขั้นตอนต่อไปนี้

  1. ตรวจสอบว่าคุณได้ลงชื่อเข้าใช้ GitHub ด้วยบัญชีที่มีสิทธิ์เข้าถึงที่เก็บเทมเพลตที่ต้องการเพิ่มลงในแกลเลอรี
  2. ไปที่แกลเลอรีเทมเพลตชุมชนที่ tagmanager.google.com/gallery
  3. คลิก แล้วเลือก ส่งเทมเพลต
  4. ระบุ URL ของที่เก็บ ในช่องที่ให้ไว้ แล้วคลิกส่ง

อัปเดตเทมเพลต

หลังจากเผยแพร่เทมเพลตแล้ว คุณอาจต้องการอัปเดตเทมเพลตเป็นครั้งคราว ผู้ใช้เทมเพลตจะได้รับการแจ้งเตือนหากมีการอัปเดตเทมเพลต และจะมีตัวเลือกให้อัปเดตเทมเพลตเป็นเวอร์ชันล่าสุด

ระบบจะใช้ไฟล์ metadata.yaml เพื่อกำหนดเวอร์ชันของเทมเพลตที่จะใช้ในแกลเลอรี หากต้องการเผยแพร่เวอร์ชันใหม่ คุณต้องเพิ่มหมายเลขการเปลี่ยนแปลง (หมายเลข SHA) ลงในส่วน versions ของไฟล์ metadata.yaml

  1. ค้นหาการคอมมิตที่มีการเปลี่ยนแปลงที่คุณต้องการพุช แล้วคัดลอกหมายเลข SHA วิธีง่ายๆ ในการทำเช่นนี้ใน GitHub คือไปที่มุมมองการคอมมิต แล้วคลิกไอคอนคลิปบอร์ด (ไอคอนคลิปบอร์ด) ซึ่งจะคัดลอกหมายเลข SHA ทั้งหมดไปยังคลิปบอร์ด
  2. เพิ่มรายการ sha ใหม่ที่ด้านบนของรายการ versions ใน metadata.yaml (ดูตัวอย่างด้านล่าง)
  3. เพิ่ม changeNotes เพื่ออธิบายการเปลี่ยนแปลงที่รวมอยู่ในเวอร์ชันใหม่นี้โดยย่อ คุณสามารถสร้างความคิดเห็นหลายบรรทัดได้หากต้องการ (ดูตัวอย่างด้านล่าง)
  4. คอมมิตการเปลี่ยนแปลงไปยัง metadata.yaml และการอัปเดตจะปรากฏในแกลเลอรีภายใน 2-3 วันโดยปกติ

ตัวอย่างนี้แสดงวิธีเพิ่มข้อมูลเวอร์ชันใหม่ ซึ่งรวมถึงหมายเลข SHA และบันทึกการเปลี่ยนแปลง

homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  # Latest version
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874c
    changeNotes: |2
      Fix bug with the whatsamajig.
      Improve menu options.
      Update API calls.
  # Older versions
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874b
    changeNotes: Adds eject button.
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

ย้ายที่เก็บ

หากต้องการเปลี่ยนเจ้าของหรือชื่อที่เก็บ คุณสามารถใช้กระบวนการโอนที่เก็บ GitHub ได้ ระบบจะตรวจหาตำแหน่งใหม่และส่งต่อผู้ใช้ไปยังที่เก็บใหม่โดยอัตโนมัติในครั้งถัดไปที่อัปเดตเทมเพลต

นำเทมเพลตออก

หากต้องการนำเทมเพลตออกจากแกลเลอรี ให้ลบไฟล์ LICENSE หรือไฟล์ metadata.yaml ออกจากที่เก็บ ระบบการตรวจสอบแกลเลอรีจะตรวจพบการเปลี่ยนแปลงนี้และนำเทมเพลตออกโดยอัตโนมัติ