ในฐานะนักพัฒนาซอฟต์แวร์ คุณจะใช้ 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 ลงในโปรเจ็กต์
เพิ่มแพ็กเกจ Tag Manager
CocoaPods
วิธีเพิ่ม Tag Manager ผ่าน CocoaPods
เรียกใช้คำสั่งต่อไปนี้ในเทอร์มินัล
$ sudo gem install cocoapods
เปลี่ยนเป็นไดเรกทอรีโปรเจ็กต์
เรียกใช้คำสั่งต่อไปนี้เพื่อสร้างไฟล์ชื่อ
Podfile
$ pod init
ใน
Podfile
ให้เพิ่มข้อมูลต่อไปนี้pod 'GoogleTagManager', '~> 6.0'
เรียกใช้คำสั่งต่อไปนี้เพื่อดาวน์โหลดและติดตั้งทรัพยากร Dependency ของ Tag Manager ในโปรเจ็กต์
$ pod install
เครื่องมือจัดการแพ็กเกจ Swift
วิธีเพิ่ม Tag Manager ผ่าน Swift Package Manager
- หากย้ายข้อมูลจากโปรเจ็กต์ที่ใช้ CocoaPods ให้เรียกใช้
pod deintegrate
เพื่อนำ CocoaPods ออกจากโปรเจ็กต์ Xcode ของคุณ คุณสามารถลบไฟล์ CocoaPods.xcworkspace
ที่ผู้ใช้สร้างขึ้นได้อย่างปลอดภัยหลังจากนั้น หากคุณกำลังเพิ่ม Firebase ไปยังโปรเจ็กต์เป็นครั้งแรก คุณก็ไม่ต้องสนใจขั้นตอนนี้ - ใน Xcode 12 ให้ติดตั้งไลบรารี Tag Manager โดยไปที่ ไฟล์ > แพ็กเกจ Tag Manager > เพิ่มการอ้างอิงแพ็กเกจ...
ในข้อความแจ้งที่ปรากฏขึ้น ให้ป้อนที่เก็บ GitHub ของ Tag Manager:
https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
เลือกเวอร์ชันของ Tag Manager ที่ต้องการใช้ สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ใช้ Tag Manager เวอร์ชันล่าสุด
เพิ่ม
-ObjC
ในแฟล็ก Linker อื่นๆ ในการตั้งค่าบิลด์ของโปรเจ็กต์
สร้างคอนเทนเนอร์ iOS หากบัญชี Tag Manager ไม่มีคอนเทนเนอร์
- ลงชื่อเข้าใช้บัญชี Tag Manager
- ในแท็บ Accounts ให้เลือกคอนเทนเนอร์ iOS
- คลิกผู้ดูแลระบบในแถบนำทางด้านบน
- ในคอลัมน์CONTAINER ให้คลิกไอคอน "+" เพื่อสร้างคอนเทนเนอร์
- ป้อนชื่อคอนเทนเนอร์
- เลือกคอนเทนเนอร์ iOS
- คลิกสร้าง
ดาวน์โหลดคอนเทนเนอร์ของคุณ:
- ลงชื่อเข้าใช้บัญชี Tag Manager
- ในแท็บ Accounts ให้เลือกคอนเทนเนอร์ iOS
- คลิกเวอร์ชันในแถบนำทางด้านบน
- เลือกเวอร์ชันของคอนเทนเนอร์ที่คุณต้องการดาวน์โหลด
คลิกดาวน์โหลด
เพิ่มคอนเทนเนอร์ที่ดาวน์โหลดไว้ในโปรเจ็กต์
- คัดลอกไฟล์ที่ดาวน์โหลดลงในโฟลเดอร์ชื่อ
container
ในรูทโปรเจ็กต์ XCode (โดยปกติคือPROJECT_ROOT/container/GTM-XXXXXX.json
) - เปิด Xcode
- จากเมนูไฟล์ ให้เลือกเพิ่มไฟล์ไปยัง...
- เลือกโฟลเดอร์
container
- คลิกตัวเลือก และตรวจสอบว่าได้เลือกสร้างการอ้างอิงโฟลเดอร์แล้ว
- คลิกเสร็จสิ้น
- คัดลอกไฟล์ที่ดาวน์โหลดลงในโฟลเดอร์ชื่อ
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 โดยทำดังนี้
- ลงชื่อเข้าใช้บัญชี Tag Manager
- เลือกคอนเทนเนอร์อุปกรณ์เคลื่อนที่
- คลิกเวอร์ชันในแถบนำทางด้านบน
- คลิกการทำงาน > ดูตัวอย่างในเวอร์ชันคอนเทนเนอร์ที่ต้องการดูตัวอย่าง
- ป้อนชื่อแพ็กเกจของแอปพลิเคชัน
คลิกสร้างลิงก์เริ่มการแสดงตัวอย่าง
รูปที่ 1: รับ URL ตัวอย่างจากอินเทอร์เฟซเว็บของ Tag Manager บันทึก URL ตัวอย่างนี้ไว้ใช้ในขั้นตอนถัดไป
หากต้องการเปิดใช้การแสดงตัวอย่างคอนเทนเนอร์ คุณต้องกำหนดรูปแบบ URL การแสดงตัวอย่างของ Tag Manager ในรายการพร็อพเพอร์ตี้ของโปรเจ็กต์ ในส่วนประเภท URL ของไฟล์รายการพร็อพเพอร์ตี้ของแอปพลิเคชัน ให้ลงทะเบียนตัวระบุ URL และชุดรูปแบบ URL ต่อไปนี้
URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
![ลงทะเบียนรูปแบบ URL ตัวอย่างของ Tag Manager ในไฟล์รายการพร็อพเพอร์ตี้ของแอปพลิเคชัน](https://developers-dot-devsite-v2-prod.appspot.com/static/tag-platform/tag-manager/images/plist.png?authuser=4&hl=th)
หยุดแอปพลิเคชันและเปิด URL ตัวอย่างในโปรแกรมจำลองหรืออุปกรณ์จริงเพื่อแสดงตัวอย่างคอนเทนเนอร์แบบร่างในแอปพลิเคชัน
แก้ไขข้อบกพร่องของคอนเทนเนอร์
เมื่อเรียกใช้แอปในเครื่องมือจำลองหรือโหมดแสดงตัวอย่าง Tag Manager จะเปลี่ยนการบันทึกให้เป็นรายละเอียดโดยอัตโนมัติ
นำคอนเทนเนอร์ไปใช้จริง
หลังจากที่ดูตัวอย่างคอนเทนเนอร์และยืนยันว่าคอนเทนเนอร์ทำงานได้แล้ว คุณก็สามารถนำไปใช้จริงได้ หลังจากที่คุณนำคอนเทนเนอร์ไปใช้จริงแล้ว การกำหนดค่าแท็ก จะพร้อมใช้งานสำหรับผู้ใช้แอปบนอุปกรณ์เคลื่อนที่