การติดแท็กฝั่งเซิร์ฟเวอร์สําหรับแอปบนอุปกรณ์เคลื่อนที่

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

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

วิธีตั้งค่าการติดแท็กฝั่งเซิร์ฟเวอร์สำหรับแอปบนอุปกรณ์เคลื่อนที่

1. เตรียมแอปให้พร้อมสำหรับการติดแท็กฝั่งเซิร์ฟเวอร์
2. กำหนดค่าคอนเทนเนอร์ของเซิร์ฟเวอร์ให้รองรับการเข้าชมจากมือถือ
3. เปิดใช้การติดแท็กฝั่งเซิร์ฟเวอร์ในพร็อพเพอร์ตี้ Google Analytics

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

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

ขั้นตอนที่ 1: เตรียมแอปให้พร้อมสำหรับการติดแท็กฝั่งเซิร์ฟเวอร์

iOS

1. เปิดใช้ฟีเจอร์การอัปโหลดการติดแท็กฝั่งเซิร์ฟเวอร์และตั้งค่า URL Scheme ที่กำหนดเองสำหรับโหมดแก้ไขข้อบกพร่องของการติดแท็กฝั่งเซิร์ฟเวอร์ในไฟล์ Info.plist แทนที่ BUNDLE_ID ในรายการต่อไปนี้ด้วยรหัสชุดซอฟต์แวร์ของแอป

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
   ...
           <key>CFBundleURLTypes</key>
           <array>
                   <dict>
                           <key>CFBundleTypeRole</key>
                           <string>None</string>
                           <key>CFBundleURLName</key>
                           <string>BUNDLE_ID</string>
                           <key>CFBundleURLSchemes</key>
                           <array>
                                   <string>tagmanager.sgtm.c.BUNDLE_ID</string>
                           </array>
                   </dict>
           </array>
           <key>GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED</key>
           <true/>
   </dict>
   </plist>
   

2. หากต้องการเปิดใช้โหมดแก้ไขข้อบกพร่องหรือโหมดแสดงตัวอย่าง ให้เพิ่มการเรียก Analytics.handleOpen(_:) ในเมธอดวงจรการทำงานเพื่อส่ง URL การเปิดใช้

   SwiftUI

   @main
   struct MyApplication: App {
     var body: some Scene {
       WindowGroup {
         ContentView()
           .onOpenURL { url in
             Analytics.handleOpen(url)
           }
       }
     }
   }
   

   UIScene

   class SceneDelegate: UIResponder, UIWindowSceneDelegate {
   func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
           options connectionOptions: UIScene.ConnectionOptions) {
   ...
       if let urlContext = connectionOptions.urlContexts.first {
           let url = urlContext.url
           Analytics.handleOpen(url)
       }
     }
   }
   

   สำหรับแอปที่ไม่ได้ใช้ SwiftUI หรือ UIScene คุณไม่จำเป็นต้องดำเนินการใดๆ SDK จะรับ URL การเปิดใช้จาก ApplicationDidFinishLaunchingNotification

Android

1. ติดตั้ง Google Analytics สำหรับ Firebase SDK เวอร์ชันล่าสุด ที่เผยแพร่

2. เปิดใช้ sGTM โดยเพิ่มรายการต่อไปนี้ลงในไฟล์ AndroidManifest.xml ของแอปพลิเคชัน

   <!-- Preview Activity to enable preview mode -->
   <activity
       android:name="com.google.firebase.analytics.GoogleAnalyticsServerPreviewActivity"
       android:exported="true"
       android:noHistory="true" >
     <intent-filter>
       <action android:name="android.intent.action.VIEW" />
       <category android:name="android.intent.category.DEFAULT" />
       <category android:name="android.intent.category.BROWSABLE" />
       <data android:scheme="tagmanager.sgtm.c.<APP_PACKAGE_ID>" />
     </intent-filter>
   </activity>
   
   <!-- Meta-data that enables uploads to sGTM -->
   <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />
   

   หมายเหตุ: <APP_PACKAGE_ID> ควรเป็นตัวอักษรพิมพ์เล็กทั้งหมด การจับคู่ Scheme ในเฟรมเวิร์ก Android จะคำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ ซึ่งแตกต่างจาก RFC

ขั้นตอนที่ 2: กำหนดค่าคอนเทนเนอร์ของเซิร์ฟเวอร์ให้รองรับการเข้าชมจากมือถือ

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

ตั้งค่าไคลเอ็นต์ Google Analytics: GA4 (แอป)

ไคลเอ็นต์เป็นประเภททรัพยากร Tag Manager ที่ดักจับคำขอขาเข้าบางประเภทและสร้างเหตุการณ์ที่ส่งไปยังปลายทาง เช่น Google Analytics ได้ ในกรณีนี้ คำขอ HTTP เป็นเหตุการณ์ Google Analytics ดังนั้นคุณจึงต้องกำหนดค่าไคลเอ็นต์ Google Analytics: GA4 (แอป) ในตัว คุณต้องมีไคลเอ็นต์ Google Analytics เพียง 1 รายการต่อแหล่งข้อมูล เช่น GA SDK และเว็บไซต์ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีการทำงานของไคลเอ็นต์

1. ในคอนเทนเนอร์ของเซิร์ฟเวอร์ ให้ไปที่ไคลเอ็นต์ แล้วคลิกใหม่

2. คลิกการกำหนดค่าไคลเอ็นต์ แล้วเลือก Google Analytics: GA4 (แอป)

   

3. ป้อนชื่อไคลเอ็นต์แล้วคลิกบันทึก

กำหนดค่าแท็ก Google Analytics: GA4

หากต้องการส่งข้อมูลไปยัง Google Analytics คุณจะต้องสร้างแท็ก Google Analytics: GA4 ในคอนเทนเนอร์ของเซิร์ฟเวอร์ ไคลเอ็นต์จะแยกวิเคราะห์คำขอ HTTP ขาเข้าไปยังออบเจ็กต์ข้อมูลเหตุการณ์ แท็กจะใช้ออบเจ็กต์ข้อมูลเหตุการณ์นี้ แมปกับรูปแบบที่ถูกต้อง แล้วส่งไปยัง Google Analytics

1. ในคอนเทนเนอร์ของเซิร์ฟเวอร์ ให้ไปที่แท็ก แล้วคลิกใหม่

2. คลิกการกำหนดค่าแท็ก แล้วเลือก Google Analytics: GA4

   

โดยค่าเริ่มต้น แท็กจะรับค่าฟิลด์และพารามิเตอร์ที่เกี่ยวข้องทั้งหมดจากออบเจ็กต์ข้อมูลเหตุการณ์ที่ไคลเอ็นต์สร้างขึ้น

• หากคำขอ Google Analytics ขาเข้าผ่านไคลเอ็นต์ Google Analytics: GA4 (แอป) แท็กจะรับค่ารหัสแอปและพารามิเตอร์เหตุการณ์
• หากคำขอ Google Analytics ขาเข้าผ่านไคลเอ็นต์ Google Analytics: GA4 (เว็บ) แท็กจะรับค่ารหัสการวัดและพารามิเตอร์เหตุการณ์

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

ตั้งค่าทริกเกอร์สำหรับการเข้าชมจากมือถือ

จากนั้นคุณควรกำหนดเวลาที่แท็ก GA4 ควรเริ่มทำงาน ไคลเอ็นต์ Google Analytics: GA4 (แอป) จะแยกวิเคราะห์คำขอขาเข้าไปยังออบเจ็กต์ข้อมูลเหตุการณ์ และแท็กจะรับค่าของออบเจ็กต์ดังกล่าว ดังนั้น โดยทั่วไปคุณจึงต้องการให้แท็กเริ่มทำงานทุกครั้งที่ไคลเอ็นต์ GA4 อ้างสิทธิ์ในคำขอ

วิธีตั้งค่าทริกเกอร์

1. คลิกการเริ่มทำงาน ในการตั้งค่าแท็ก
2. หากต้องการสร้างทริกเกอร์ใหม่ ให้คลิกไอคอน + ที่มุมขวาบน
3. คลิกการกำหนดค่าทริกเกอร์ เพื่อเลือกประเภททริกเกอร์

4. เลือกกำหนดเอง หรือเหตุการณ์ที่กำหนดเอง จากรายการ

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

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

   1. คุณจะเห็นชื่อเหตุการณ์ เลือกไว้ล่วงหน้า คลิกตัวเลือกนั้น แล้วเลือกเลือกตัวแปรในตัว จากรายการ
   2. หากต้องการแสดงชื่อไคลเอ็นต์ที่สร้างเหตุการณ์โดยอัตโนมัติ ให้เลือกชื่อไคลเอ็นต์
   3. ใช้ชื่อไคลเอ็นต์ที่คุณกำหนดค่าไว้ก่อนหน้านี้เพื่อตั้งค่าเงื่อนไขตามความเหมาะสม ทริกเกอร์ควรมีลักษณะดังนี้

   

   หมายเหตุ: ชื่อไคลเอ็นต์คือชื่อที่คุณระบุไว้ในขั้นตอนก่อนหน้า ประเภทไคลเอ็นต์คือ Google Analytics: GA4 (แอป) ตัวแปรชื่อไคลเอ็นต์จะแสดงชื่อ ไม่ใช่ประเภทของไคลเอ็นต์

6. บันทึกทริกเกอร์และป้อนชื่อที่สื่อความหมาย เช่น คุณสามารถใช้ "เหตุการณ์แอป GA4 ทั้งหมด"

7. ตอนนี้คุณควรกลับไปที่การตั้งค่าแท็กโดยมีทริกเกอร์ใหม่แทนที่ บันทึกแท็กและป้อนชื่อที่สื่อความหมาย เช่น "GA4" แท็กควรมีลักษณะดังนี้

   

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

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

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

หากต้องการให้คำขอของแอปทริกเกอร์การกำหนดค่าการแสดงตัวอย่าง คุณต้องทำดังนี้

1. เลือกแสดงตัวอย่าง ขณะอยู่ในคอนเทนเนอร์ของเซิร์ฟเวอร์ Google Tag Manager
2. คลิกไอคอนการดำเนินการเพิ่มเติม ⋮ ที่ด้านขวาบน แล้วเลือกส่งคำขอจากแอป

3. ป้อนรหัสแอปแล้วคลิกสร้างคิวอาร์โค้ด

   หมายเหตุ: รหัสแอปต้องขึ้นต้นด้วยตัวอักษร หรือคุณจะใช้รหัสที่ไม่ซ้ำกันซึ่งขึ้นต้นด้วยตัวอักษรก็ได้ ตราบใดที่รหัสดังกล่าวตรงกับรหัสที่ใช้ในไฟล์ Info.plist หรือ AndroidManifest.xml

   

4. สแกนคิวอาร์โค้ดด้วยแอปกล้องของโทรศัพท์ แล้วใช้แอปตามปกติเพื่อสร้างเหตุการณ์ตัวอย่าง

5. คลิกตกลง เพื่อปิดกล่องโต้ตอบ

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

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

ขั้นตอนที่ 3: เปิดใช้การติดแท็กฝั่งเซิร์ฟเวอร์ในพร็อพเพอร์ตี้ Google Analytics

1. ในพร็อพเพอร์ตี้ Google Analytics ให้ไปที่ผู้ดูแลระบบ
2. เปิดสตรีมข้อมูล

3. เลือกการกำหนดค่าสตรีมของแอปพลิเคชันจากแท็บ iOS หรือ Android

   

4. คลิกกำหนดการตั้งค่า SDK แล้วคลิกกำหนดค่า Tag Manager ฝั่งเซิร์ฟเวอร์

   

5. วิธีเปิดใช้ SDK เพื่อส่งข้อมูลการวัดไปยัง URL คอนเทนเนอร์ของเซิร์ฟเวอร์

   1. สลับส่งข้อมูลไปยังคอนเทนเนอร์ Tag Manager ฝั่งเซิร์ฟเวอร์
   2. คัดลอก URL คอนเทนเนอร์เซิร์ฟเวอร์ คุณดู URL นี้ได้ใน Google Tag Manager โดยไปที่ผู้ดูแลระบบ > การตั้งค่าคอนเทนเนอร์ > URL คอนเทนเนอร์ของเซิร์ฟเวอร์

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

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

   

6. คลิกบันทึก SDK จะดึง URL คอนเทนเนอร์ของเซิร์ฟเวอร์ที่อัปเดตแล้วและส่งข้อมูลการวัดไปยัง URL นั้น

ข้อจำกัดที่ทราบ

• สำหรับแอปพลิเคชัน Android

  • การซื้อในแอปที่บันทึกโดยอัตโนมัติ จะขึ้นอยู่กับการผสานรวมกับแบ็กเอนด์ของ Google Play และจะไม่ส่งไปยัง คอนเทนเนอร์ของเซิร์ฟเวอร์
  • ระบบจะไม่รายงานเหตุการณ์ app_remove ใน Android

• คุณยังคงต้องเชื่อมต่อสตรีมข้อมูลแอปใน Google Analytics กับบัญชี Google Ads เพื่อให้แน่ใจว่าระบบจะนำเข้าข้อมูลและ Conversion ของ SDK ไปยัง Google Ads การติดแท็กฝั่งเซิร์ฟเวอร์ไม่มีการผสานรวมโดยธรรมชาติระหว่าง SDK กับ Google Ads

หมายเหตุ: Google Analytics สำหรับ Firebase SDK ได้รับการออกแบบและปรับให้เหมาะกับการส่ง ข้อมูลไปยัง Google Analytics จากนั้นคุณจะลิงก์ Google Analytics กับ Google Ads เพื่อใช้ในการรายงาน Conversion, การสร้างกลุ่มเป้าหมาย, การเพิ่มประสิทธิภาพแคมเปญ และการสร้างแบบจำลองได้ ซึ่งรวมถึงการติดแท็กฝั่งเซิร์ฟเวอร์สำหรับแอป และเราขอแนะนำให้ลูกค้าใช้ประโยชน์จากการผสานรวมระหว่าง Google Analytics กับการติดแท็กฝั่งเซิร์ฟเวอร์ใน Google Tag Manager

API

คุณสามารถใช้ Tag Manager REST API เพื่อเข้าถึงข้อมูลการกำหนดค่า Tag Manager ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับ API ได้ที่

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