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 ของคุณ คุณสามารถลบไฟล์ CocoaPods .xcworkspace ที่ผู้ใช้สร้างขึ้นได้อย่างปลอดภัยหลังจากนั้น หากคุณกำลังเพิ่ม 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 ในแฟล็ก Linker อื่นๆ ในการตั้งค่าบิลด์ของโปรเจ็กต์

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

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

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

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

   5. คลิกดาวน์โหลด

      หมายเหตุ: ชื่อของไฟล์ที่ดาวน์โหลดจะเป็นรหัสคอนเทนเนอร์ที่มีส่วนขยาย .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 ชั่วโมง

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

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