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

แกลเลอรีเทมเพลตชุมชนของ 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 การตลาดแบบแอฟฟิลิเอต
ข้อมูลวิเคราะห์ Analytics
การระบุแหล่งที่มา การระบุแหล่งที่มา
แชท แชท
Conversion การวัด Conversion
DATA_WAREHOUSING คลังข้อมูล
EMAIL_MARKETING การตลาดทางอีเมล
การทดสอบ การทดสอบ A/B และการเพิ่มประสิทธิภาพเนื้อหา
HEAT_MAP ฮีตแมป
LEAD_GENERATION การสร้างความสนใจในตัวสินค้า
การตลาด การตลาด
การปรับเปลี่ยนในแบบของผู้ใช้ การปรับเปลี่ยนในแบบของคุณ
รีมาร์เก็ตติ้ง รีมาร์เก็ตติ้ง
ลดราคา ฝ่ายขายและ CRM
SESSION_RECORDING การบันทึกเซสชัน
โซเชียล โซเชียล
แบบสํารวจ แบบสำรวจ
TAG_MANAGEMENT ระบบจัดการแท็ก
ยูทิลิตี ยูทิลิตีของ Google Tag Manager

metadata.yaml

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

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

  1. เพิ่มรายการ homepage URL นี้ควรเป็น URL ที่ชี้ไปยังหน้าแรกขององค์กร
  2. เพิ่มรายการสำหรับ documentation URL นี้ควรเป็น 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 ของเทมเพลตเพื่อให้คุณตรวจสอบและแก้ไขปัญหาที่อาจเกิดขึ้นได้

ส่งเทมเพลตของคุณ

เมื่อโฮสต์ที่เก็บเทมเพลตใน 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 ออกจากที่เก็บ ระบบตรวจสอบแกลเลอรีจะตรวจพบการเปลี่ยนแปลงนี้และนำเทมเพลตออกโดยอัตโนมัติ