Google Tag Manager สำหรับ iOS

ในฐานะนักพัฒนาซอฟต์แวร์ คุณสามารถใช้ Google Tag Manager เพื่อใช้งานและจัดการแท็กการวัดและพิกเซลในแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ โดยไม่ต้องสร้างและต้องส่งไบนารีแอปพลิเคชันไปยังตลาดกลางแอปอีกครั้ง นักพัฒนาซอฟต์แวร์ที่ทำงานกับ SDK ของ Google Analytics สำหรับ Firebase สามารถเพิ่ม Tag Manager ได้อย่างง่ายดายเพื่อช่วยจัดการและเปลี่ยนแปลงการติดตั้งใช้งาน แม้ว่าจะมีการส่งแอปไปแล้วก็ตาม

นักพัฒนาซอฟต์แวร์สามารถบันทึกเหตุการณ์สำคัญและตัดสินใจในภายหลังได้ว่าควรให้แท็กหรือพิกเซลใดเริ่มทำงาน

ข้อกำหนดเบื้องต้น

• ในคอนโซล Firebase เพิ่มแอปของคุณลงในโปรเจ็กต์ Firebase
• ตั้งค่า Google Analytics สำหรับแอป รวมถึงเปิดใช้ Google Analytics ในโปรเจ็กต์ Firebase และเพิ่ม SDK ของ Google Analytics สำหรับ Firebase ลงในแอป
• สร้างบัญชี Tag Manager
• กำหนดค่าคอนเทนเนอร์เครื่องจัดการแท็ก

ส่วนต่อไปนี้จะอธิบายขั้นตอนการกำหนดค่าและใช้ Google Tag Manager ในแอปพลิเคชัน iOS

1. เพิ่ม Tag Manager ลงในโปรเจ็กต์

1. เพิ่มแพ็กเกจ Tag Manager ดังนี้

   CocoaPods

   วิธีเพิ่ม Tag Manager ผ่าน CocoaPods

   1. เรียกใช้คำสั่งต่อไปนี้ในเทอร์มินัล

      $ sudo gem install cocoapods
      

   2. เปลี่ยนเป็นไดเรกทอรีโปรเจ็กต์

   3. เรียกใช้คำสั่งต่อไปนี้เพื่อสร้างไฟล์ชื่อ Podfile

      $ pod init
      

   4. ใน Podfile ให้เพิ่มข้อมูลต่อไปนี้

      pod 'GoogleTagManager', '~> 6.0'
      

   5. เรียกใช้คำสั่งต่อไปนี้เพื่อดาวน์โหลดและติดตั้งทรัพยากร Dependency ของ Tag Manager ในโปรเจ็กต์

      $ pod install
      

   ผู้จัดการแพ็กเกจของ Swift

   วิธีเพิ่ม Tag Manager ผ่าน Swift Package Manager

   1. หากย้ายข้อมูลจากโปรเจ็กต์ที่ใช้ CocoaPods ให้เรียกใช้ pod deintegrate เพื่อนำ CocoaPods ออกจากโปรเจ็กต์ Xcode หลังจากนั้นคุณจะลบไฟล์ .xcworkspace ที่ CocoaPods สร้างขึ้นได้อย่างปลอดภัย หากคุณกำลังเพิ่ม Firebase ในโปรเจ็กต์เป็นครั้งแรก คุณสามารถข้ามขั้นตอนนี้ได้
   2. ใน Xcode 12 ให้ติดตั้งไลบรารี Tag Manager โดยไปที่ ไฟล์ > แพ็กเกจ Tag Manager > เพิ่มการอ้างอิงแพ็กเกจ...

   3. ในข้อความแจ้งที่ปรากฏขึ้น ให้ป้อนที่เก็บ GitHub ของ Tag Manager:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
      

   4. เลือกเวอร์ชันของ Tag Manager ที่ต้องการใช้ สำหรับโครงการใหม่ๆ เราขอแนะนำให้ใช้ Tag Manager เวอร์ชันล่าสุด

   5. เพิ่ม -ObjC ใน Flager Flag อื่นๆ ในการตั้งค่าบิลด์ของโปรเจ็กต์

2. สร้างคอนเทนเนอร์ iOS หากบัญชี Tag Manager ยังไม่มี ดังนี้

   1. ลงชื่อเข้าใช้บัญชี Tag Manager
   2. คลิกผู้ดูแลระบบในแถบนำทางด้านบน
   3. ในคอลัมน์CONTAINER ให้คลิกเมนูแบบเลื่อนลงแล้วเลือกCONTAINER
   4. ป้อนชื่อคอนเทนเนอร์
   5. เลือกคอนเทนเนอร์ iOS
   6. เลือก Firebase (iOS) SDK
   7. คลิกสร้าง

3. ดาวน์โหลดคอนเทนเนอร์ของคุณ:

   1. ลงชื่อเข้าใช้บัญชี Tag Manager
   2. เลือกคอนเทนเนอร์ iOS
   3. คลิกเวอร์ชันในแถบนำทางด้านบน

   4. คลิกการทำงาน > ดาวน์โหลดในเวอร์ชันคอนเทนเนอร์ที่เลือก

      หมายเหตุ: ชื่อของไฟล์ที่ดาวน์โหลดคือรหัสคอนเทนเนอร์ที่มีส่วนขยาย .json

4. เพิ่มคอนเทนเนอร์ที่ดาวน์โหลดลงในโปรเจ็กต์ของคุณ ดังนี้

   1. คัดลอกไฟล์ที่ดาวน์โหลดลงในโฟลเดอร์ที่ชื่อ container ในรูทโปรเจ็กต์ XCode (โดยปกติจะเป็น PROJECT_ROOT/container/GTM-XXXXXX.json)
   2. เปิด Xcode
   3. จากเมนูไฟล์ ให้เลือกเพิ่มไฟล์ไปที่...
   4. เลือกโฟลเดอร์ container
   5. คลิกตัวเลือก และตรวจสอบว่าได้เลือกสร้างการอ้างอิงโฟลเดอร์แล้ว
   6. คลิกเสร็จ

2. เหตุการณ์และตัวแปรในบันทึก

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

อ่านเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ Firebase เพื่อดูวิธีบันทึกเหตุการณ์และตั้งค่าพร็อพเพอร์ตี้ผู้ใช้

กำหนดค่าตัวแปรใน Tag Manager

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

ตัวอย่างเช่น คุณสามารถบันทึกเหตุการณ์ที่กำหนดเองต่อไปนี้ในแอป

Analytics.logEvent("share_image", parameters: [
  "image_name": name,
  "full_text": text
])

จากนั้น คุณสามารถกําหนดค่าตัวแปรพารามิเตอร์เหตุการณ์ใหม่ใน Tag Manager ตามต่อไปนี้เพื่อบันทึกค่า image_name และ full_text parameter

• ชื่อตัวแปร: ชื่อรูปภาพ
• ประเภทตัวแปร: พารามิเตอร์เหตุการณ์
• ชื่อคีย์พารามิเตอร์เหตุการณ์: image_name

และ:

• ชื่อตัวแปร: ข้อความแบบเต็ม
• ประเภทตัวแปร: พารามิเตอร์เหตุการณ์
• ชื่อคีย์พารามิเตอร์เหตุการณ์: full_text

ในทำนองเดียวกัน คุณอาจตั้งค่าพร็อพเพอร์ตี้ผู้ใช้ต่อไปนี้ในแอปได้

Analytics.setUserProperty(food, forName: "favorite_food")

จากนั้นคุณกำหนดค่าตัวแปรพร็อพเพอร์ตี้ผู้ใช้ Firebase ใหม่ใน Google Tag Manager เพื่อบันทึกค่า favorite_food ดังนี้

• ชื่อตัวแปร: อาหารโปรด
• ประเภทตัวแปร: พร็อพเพอร์ตี้ผู้ใช้ Firebase
• ชื่อคีย์พารามิเตอร์เหตุการณ์: favorite_food

แก้ไขและบล็อกเหตุการณ์

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

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

3. ส่งกิจกรรม

ระบบจะใช้ตัวแปรชื่อเหตุการณ์ Firebase, ตัวแปรพารามิเตอร์เหตุการณ์ Firebase และตัวแปรอื่นๆ เพื่อตั้งค่าทริกเกอร์ เงื่อนไขทริกเกอร์จะได้รับการประเมิน เมื่อคุณบันทึกเหตุการณ์ Firebase โดยค่าเริ่มต้น เหตุการณ์ Google Analytics สำหรับ Firebase จะเริ่มทำงานโดยอัตโนมัติ คุณสามารถเพิ่มแท็ก Google Analytics สำหรับ Firebase ใน Tag Manager เพื่อบล็อกไม่ให้ระบบส่งเหตุการณ์ไปยัง Google Analytics ได้

4. แสดงตัวอย่าง แก้ไขข้อบกพร่อง และนำคอนเทนเนอร์ไปใช้จริง

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

แสดงตัวอย่างคอนเทนเนอร์

หากต้องการดูตัวอย่างคอนเทนเนอร์ ให้สร้าง URL ตัวอย่างในอินเทอร์เฟซเว็บของ Tag Manager โดยทำดังนี้

1. ลงชื่อเข้าใช้บัญชี Tag Manager
2. เลือกคอนเทนเนอร์บนอุปกรณ์เคลื่อนที่
3. คลิกเวอร์ชันในแถบนำทางด้านบน
4. คลิกการทำงาน > แสดงตัวอย่างในเวอร์ชันคอนเทนเนอร์ที่คุณต้องการดูตัวอย่าง
5. ป้อนชื่อแพ็กเกจของแอปพลิเคชัน

6. คลิกสร้างลิงก์เริ่มแสดงตัวอย่าง

   

   รูปที่ 1: การรับ URL ตัวอย่างจากอินเทอร์เฟซเว็บของ Tag Manager

   บันทึก URL หน้าตัวอย่างนี้ไว้สำหรับขั้นตอนถัดไป

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

URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_

ภาพที่ 2: เพิ่มรูปแบบ URL ตัวอย่างของ Tag Manager ลงในไฟล์รายการพร็อพเพอร์ตี้ของแอปพลิเคชัน

หมายเหตุ: your.package.name ต้องตรงกับชื่อแอปที่ใช้สร้าง URL ตัวอย่าง (ดูรูปที่ 1)

หยุดแอปพลิเคชันและเปิด URL ตัวอย่างในโปรแกรมจำลองหรืออุปกรณ์จริงเพื่อดูตัวอย่างคอนเทนเนอร์ฉบับร่างในแอปพลิเคชัน

คอนเทนเนอร์แก้ไขข้อบกพร่อง

เมื่อคุณเรียกใช้แอปในเครื่องมือจำลองหรือในโหมดแสดงตัวอย่าง Tag Manager จะเปลี่ยนการบันทึกเป็นแบบละเอียดโดยอัตโนมัติ

นำคอนเทนเนอร์ไปใช้จริง

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

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

แหล่งข้อมูลที่เกี่ยวข้อง

โปรดอ่านการกำหนดค่าขั้นสูง