Google Tag Manager สำหรับ Android

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

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

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

ก่อนที่จะเริ่มต้น

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

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

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

1. ในไฟล์ Gradle ของโมดูล (โดยปกติคือ app/build.gradle) ให้เพิ่มทรัพยากร Dependency ต่อไปนี้ในไลบรารี Tag Manager

   dependencies {
     // ...
     compile 'com.google.android.gms:play-services-tagmanager:18.3.0'
   }
   

2. ลงชื่อเข้าใช้บัญชี Tag Manager

3. เลือกคอนเทนเนอร์บนอุปกรณ์เคลื่อนที่

4. คลิกเวอร์ชันในแถบนำทางด้านบน

5. คลิกเวอร์ชันคอนเทนเนอร์ที่ต้องการใช้

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

7. สร้างโฟลเดอร์ app/src/main/assets/containers หากยังไม่มี คัดลอกคอนเทนเนอร์ที่ดาวน์โหลดไปยังโฟลเดอร์

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

Tag Manager ใช้เหตุการณ์ พารามิเตอร์ และพร็อพเพอร์ตี้ผู้ใช้ที่บันทึกโดย SDK ของ Google Analytics สำหรับ Firebase เพื่อทริกเกอร์และสร้างแท็กที่คุณกำหนดค่าไว้ใน 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
• ประเภทตัวแปร: พารามิเตอร์เหตุการณ์
• ชื่อคีย์พารามิเตอร์เหตุการณ์: image_name

และ:

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

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

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

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

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

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

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

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

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

ก่อนแสดงตัวอย่างคอนเทนเนอร์ ให้สร้าง URL ตัวอย่างในอินเทอร์เฟซเว็บของ Google Tag Manager โดยเลือกเวอร์ชันของคอนเทนเนอร์ที่ต้องการแสดงตัวอย่าง แล้วเลือกแสดงตัวอย่าง บันทึก URL ตัวอย่างนี้ไว้สำหรับขั้นตอนถัดไป

วิธีดูตัวอย่างคอนเทนเนอร์ (หากใช้ Android Studio ให้ข้ามไปยังขั้นตอนที่ 3)

1. เพิ่มกิจกรรมตัวอย่างนี้ลงในไฟล์ 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>
   

2. เปลี่ยนบรรทัดนี้ให้รวมชื่อแพ็กเกจของแอปพลิเคชันของคุณ

   <data android:scheme="tagmanager.c.com.example.app"/>
   

3. สร้างลิงก์ตัวอย่างในอินเทอร์เฟซเว็บของ Google Tag Manager โดยทำดังนี้

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

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

5. คุณออกจากโหมดแสดงตัวอย่างได้โดยคลิกลิงก์ที่สร้างโดยตัวเลือกสร้างลิงก์สิ้นสุดการแสดงตัวอย่างในอินเทอร์เฟซเว็บ

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

หากต้องการแก้ปัญหาการติดตั้งใช้งานคอนเทนเนอร์ ให้เปิดใช้การบันทึกแบบละเอียดโดยทำดังนี้

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

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

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

ขั้นตอนถัดไป

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