ในฐานะนักพัฒนาซอฟต์แวร์ คุณสามารถใช้ Google Tag Manager เพื่อติดตั้งใช้งานและจัดการได้ แท็กการวัดและพิกเซลในแอปพลิเคชันบนอุปกรณ์เคลื่อนที่ได้โดยไม่ต้อง สร้างไบนารีของแอปพลิเคชันและส่งไปยังตลาดแอปอีกครั้ง นักพัฒนาแอปที่ SDK ของ Google Analytics สำหรับ Firebase ช่วยจัดการและทำการเปลี่ยนแปลงกับการติดตั้งใช้งาน ถึงแม้ว่าแอปจะ จัดส่งแล้ว
นักพัฒนาแอปสามารถบันทึกเหตุการณ์ที่สำคัญและตัดสินใจในภายหลังว่าแท็กหรือพิกเซลใดควร ถูกไล่ออก
ข้อกำหนดเบื้องต้น
ก่อนเริ่มต้นใช้งาน ให้ทำดังนี้
- ในคอนโซล Firebase เพิ่มแอปของคุณลงในโปรเจ็กต์ Firebase
- ตั้งค่า Google Analytics สําหรับแอป รวมถึงเปิดใช้ Google Analytics ในโปรเจ็กต์ Firebase และเพิ่ม SDK ของ Google Analytics สําหรับ Firebase ลงใน แอปของคุณ
- สร้างบัญชี Tag Manager
- กำหนดค่าคอนเทนเนอร์ Google Tag Manager
ส่วนต่อไปนี้จะแนะนำคุณตลอดขั้นตอนการกำหนดค่าและใช้ Google Tag Manager ในแอปพลิเคชัน Android ของคุณ
1. เพิ่ม Google Tag Manager ลงในโปรเจ็กต์
ในไฟล์ Gradle โมดูล (ปกติจะเป็น
app/build.gradle
) ให้เพิ่มค่าต่อไปนี้ การอ้างอิงไลบรารี Tag Manager ดังนี้dependencies { // ... compile 'com.google.android.gms:play-services-tagmanager:18.1.0' }
ลงชื่อเข้าใช้บัญชี Tag Manager
เลือกคอนเทนเนอร์อุปกรณ์เคลื่อนที่
คลิกเวอร์ชันในแถบนำทางด้านบน
คลิกเวอร์ชันคอนเทนเนอร์ที่ต้องการใช้
คลิกดาวน์โหลด
สร้างโฟลเดอร์
app/src/main/assets/containers
หากยังไม่มี คัดลอก คอนเทนเนอร์ที่ดาวน์โหลดไว้ไปยังโฟลเดอร์
2. เหตุการณ์และตัวแปรในบันทึก
Tag Manager ใช้เหตุการณ์ พารามิเตอร์ และพร็อพเพอร์ตี้ผู้ใช้ที่ Google บันทึกไว้ Analytics สําหรับ Firebase SDK เพื่อทริกเกอร์และสร้างแท็กที่คุณกําหนดค่าไว้ Google Tag Manager
อ่านเอกสารสำหรับนักพัฒนาซอฟต์แวร์ Firebase เพื่อดูวิธีการ เหตุการณ์ในบันทึกและตั้งค่าพร็อพเพอร์ตี้ผู้ใช้
กำหนดค่าตัวแปรใน Tag Manager
บันทึกค่าของพารามิเตอร์เหตุการณ์และพร็อพเพอร์ตี้ผู้ใช้ใน Google Tag Manager คุณสามารถกำหนดค่าตัวแปรในอินเทอร์เฟซ Tag Manager ได้
เช่น คุณอาจบันทึกเหตุการณ์ที่กำหนดเองต่อไปนี้ในแอปได้
Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);
จากนั้น คุณจะกําหนดค่าตัวแปรพารามิเตอร์เหตุการณ์ใหม่ใน Tag Manager เป็น
ทำตามเพื่อบันทึกค่า image_name
และ full_text parameter
- ชื่อตัวแปร: ชื่อรูปภาพ
- ประเภทตัวแปร: พารามิเตอร์เหตุการณ์
- ชื่อคีย์พารามิเตอร์เหตุการณ์:
image_name
และ:
- ชื่อตัวแปร: ข้อความทั้งหมด
- ประเภทตัวแปร: พารามิเตอร์เหตุการณ์
- ชื่อคีย์พารามิเตอร์เหตุการณ์:
full_text
ในทำนองเดียวกัน คุณก็สามารถตั้งค่าพร็อพเพอร์ตี้ผู้ใช้ต่อไปนี้ในแอปได้
mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);
จากนั้น คุณจะกำหนดค่าตัวแปรพร็อพเพอร์ตี้ผู้ใช้ Firebase ใหม่ในแท็ก Google ได้
เครื่องมือจัดการที่จะบันทึกค่า favorite_food
:
- ชื่อตัวแปร: อาหารที่ชอบ
- ประเภทตัวแปร: พร็อพเพอร์ตี้ผู้ใช้ของ Firebase
- ชื่อคีย์พารามิเตอร์เหตุการณ์:
favorite_food
แก้ไขและบล็อกเหตุการณ์
เครื่องจัดการแท็กช่วยให้คุณแก้ไขและบล็อกเหตุการณ์ได้ก่อนที่เหตุการณ์ดังกล่าวจะได้รับการบันทึกโดย SDK ของ Google Analytics สําหรับ Firebase การแก้ไขเหตุการณ์จะช่วยให้คุณเพิ่ม นำออก หรือ เปลี่ยนค่าของพารามิเตอร์เหตุการณ์หรือปรับชื่อเหตุการณ์โดยไม่ต้องอัปเดตแอป Google Analytics สำหรับ Firebase จะบันทึกเหตุการณ์ที่ไม่ถูกบล็อก SDK
นอกจากนี้ SDK ของ Google Analytics สําหรับ Firebase ยังบันทึกเหตุการณ์บางอย่างโดยอัตโนมัติและ พร็อพเพอร์ตี้ผู้ใช้ คุณสามารถใช้เหตุการณ์และพร็อพเพอร์ตี้ที่รวบรวมโดยอัตโนมัติได้ใน Tag Manager โดยไม่ต้องเพิ่มโค้ดใดๆ แต่จะบล็อกไม่ได้
3. ส่งกิจกรรม
ตัวแปรชื่อเหตุการณ์ Firebase, ตัวแปรพารามิเตอร์เหตุการณ์ Firebase และอื่นๆ จะใช้ตัวแปรเพื่อตั้งค่าทริกเกอร์ ประเมินเงื่อนไขทริกเกอร์แล้ว เมื่อใดก็ตามที่คุณบันทึกเหตุการณ์ Firebase โดยค่าเริ่มต้น Google Analytics สำหรับ Firebase เหตุการณ์จะเริ่มทำงานโดยอัตโนมัติ คุณจะเพิ่ม Google Analytics สำหรับ Firebase ได้ ใน Tag Manager เพื่อบล็อกไม่ให้ส่งเหตุการณ์ไปยัง Google Analytics
4. แสดงตัวอย่าง แก้ไขข้อบกพร่อง และนำคอนเทนเนอร์ไปใช้จริง
ก่อนที่จะเผยแพร่เวอร์ชันของคอนเทนเนอร์ คุณควรดูตัวอย่างเพื่อ เพื่อให้แน่ใจว่าทำงานได้ตามที่ต้องการ Google Tag Manager ช่วยให้คุณสามารถดูตัวอย่าง เวอร์ชันคอนเทนเนอร์ของคุณโดยสร้างลิงก์และคิวอาร์โค้ดในเว็บอินเทอร์เฟซ และใช้ส่วนขยายนั้นในการเปิดแอปพลิเคชัน และคุณยังเปิดใช้การบันทึกแบบละเอียดได้ด้วย เพื่อแก้ไขข้อบกพร่องของลักษณะการทำงานที่ไม่คาดคิด
แสดงตัวอย่างคอนเทนเนอร์
ก่อนที่จะแสดงตัวอย่างคอนเทนเนอร์ ให้สร้าง URL ตัวอย่างใน Google Tag Manager อินเทอร์เฟซเว็บโดยเลือกเวอร์ชันของคอนเทนเนอร์ที่คุณต้องการดูตัวอย่าง จากนั้นเลือกแสดงตัวอย่าง บันทึก URL ตัวอย่างนี้ไว้ใช้ในขั้นตอนถัดไป
![URL ตัวอย่างจะอยู่ในหน้าต่างตัวอย่างของแท็ก
อินเทอร์เฟซเว็บของผู้จัดการ](https://developers-dot-devsite-v2-prod.appspot.com/static/tag-platform/tag-manager/images/preview_example.png?authuser=5&hl=th)
วิธีแสดงตัวอย่างคอนเทนเนอร์ (หากใช้ Android Studio ให้ข้ามไปยังขั้นตอนที่ 3)
เพิ่มกิจกรรมการแสดงตัวอย่างนี้ลงในไฟล์
AndroidManifest
:<!-- Add preview activity. --> <activity android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity" android:noHistory="true"> <!-- optional, removes previewActivity from activity stack. --> <intent-filter> <data android:scheme="tagmanager.c.com.example.app" /> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE"/> </intent-filter> </activity>
เปลี่ยนบรรทัดนี้เพื่อรวมชื่อแพ็กเกจของแอปพลิเคชันของคุณ:
<data android:scheme="tagmanager.c.com.example.app"/>
ในอินเทอร์เฟซเว็บของ Google Tag Manager ให้สร้างลิงก์แสดงตัวอย่าง
- ลงชื่อเข้าใช้บัญชี Tag Manager
- เลือกคอนเทนเนอร์อุปกรณ์เคลื่อนที่
- คลิกเวอร์ชันในแถบนำทางด้านบน
- คลิกการทำงาน > แสดงตัวอย่างเวอร์ชันคอนเทนเนอร์ที่คุณต้องการ เวอร์ชันตัวอย่าง
- ป้อนชื่อแพ็กเกจของแอปพลิเคชัน
- คลิกสร้างลิงก์เริ่มการแสดงตัวอย่าง
หยุดแอปพลิเคชันของคุณและใช้ลิงก์ดูตัวอย่างหรือคิวอาร์โค้ดที่สร้างขึ้นเพื่อ เปิดแอปพลิเคชันของคุณ
คุณสามารถออกจากโหมดแสดงตัวอย่างได้ โดยคลิกลิงก์ที่สร้างโดย ตัวเลือกสร้างลิงก์สิ้นสุดการแสดงตัวอย่างในเว็บอินเทอร์เฟซ
แก้ไขข้อบกพร่องของคอนเทนเนอร์
หากต้องการแก้ปัญหาการใช้งานคอนเทนเนอร์ ให้เปิดใช้การบันทึกแบบละเอียด ดังนี้
$ adb shell setprop log.tag.GoogleTagManager VERBOSE
นำคอนเทนเนอร์ไปใช้จริง
หลังจากดูตัวอย่างคอนเทนเนอร์ และยืนยันว่าคอนเทนเนอร์ทำงานได้แล้ว คุณจะทำสิ่งต่อไปนี้ได้ เผยแพร่ หลังจากที่นำคอนเทนเนอร์ไปใช้จริงแล้ว การกำหนดค่าแท็ก จะพร้อมใช้งานสำหรับผู้ใช้แอปบนอุปกรณ์เคลื่อนที่