เหตุการณ์ที่กำหนดเองของ Google Ads ที่มี Google Analytics สำหรับ Firebase - Unity

1. บทนำ

อัปเดตล่าสุด: 19-02-2021

สิ่งที่คุณจะสร้าง

ในโค้ดแล็บนี้ คุณจะได้เรียนรู้วิธีใช้เหตุการณ์ที่กําหนดเองกับ GA4F iOS ในสภาพแวดล้อม Unity และเปิดตัวแคมเปญเพื่อกระตุ้นการกระทําผ่าน Google Ads

ใน Codelab นี้ คุณจะได้สัมผัสกระบวนการทั้งหมดของธุรกิจแอปที่ลูกค้าของเรากำลังเผชิญ หากต้องการเรียนรู้ข้อมูลเบื้องต้นเกี่ยวกับ Firebase และ AdMob ใน iOS โปรดเริ่มจาก AdMob+Firebase 101 Unity: ข้อมูลเบื้องต้นเกี่ยวกับการตั้งค่าและการวิเคราะห์

สิ่งที่คุณจะได้เรียนรู้

• วิธีเริ่มต้น GA4F (Google Analytics สําหรับ Firebase) ใน Unity + iOS
• วิธีสร้างเหตุการณ์และพารามิเตอร์ที่กำหนดเอง
• วิธีนําเข้าเหตุการณ์จาก Firebase ไปยัง Google Ads
• เปิดตัวแคมเปญเพื่อกระตุ้นการกระทำด้วยเหตุการณ์ที่กำหนดเอง

สิ่งที่คุณต้องมี

• Xcode
• Unity
• บัญชี Firebase
• บัญชี Google Ads

2. เริ่มโปรเจ็กต์ Unity ใหม่

สร้างแอป Unity แบบเทมเพลตอย่างง่าย คุณจะแก้ไขแอปอย่างง่ายนี้เพื่อสร้างแอปที่เสร็จสมบูรณ์

เปิด Unity

1. หากไม่มีโปรเจ็กต์ที่เปิดอยู่ ให้เลือกสร้างโปรเจ็กต์ใหม่
2. เลือกเทมเพลต 3 มิติจากกล่องโต้ตอบ
3. กรอกชื่อโปรเจ็กต์ เช่น Unity Firebase Custom Event
4. เลือกตำแหน่งที่จะบันทึกโปรเจ็กต์ แล้วคลิกสร้าง
5. Unity จะเปิดโปรเจ็กต์ใหม่ในหน้าต่างพื้นที่ทำงาน

3. สร้างและตั้งค่าโปรเจ็กต์ Firebase

หากต้องการเริ่มต้นใช้งาน Firebase คุณจะต้องสร้างและตั้งค่าโปรเจ็กต์ Firebase

หากมีโปรเจ็กต์ Firebase เดิมที่ไม่ได้เปิดใช้ Google Analytics ให้เปิดใช้ Google Analytics ในแท็บการผสานรวมของการตั้งค่า > การตั้งค่าโปรเจ็กต์ ไปที่ขั้นตอนการกำหนดค่า Firebase

1. ลงชื่อเข้าใช้ Firebase

ในคอนโซล Firebase ให้คลิกเพิ่มโปรเจ็กต์(หรือสร้างโปรเจ็กต์) แล้วตั้งชื่อโปรเจ็กต์ Firebase ว่า Firebase-iOS-Ads

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับโปรเจ็กต์ Firebase ได้ที่ทําความเข้าใจโปรเจ็กต์ Firebase

4. การกำหนดค่า Unity

1. ใน Unity ให้ไปที่ File > Build Settings ค่าที่สำคัญคือการตั้งค่ารหัสแพ็กเกจ iOS ซึ่งคุณจะได้รับโดยใช้ขั้นตอนต่อไปนี้

คุณจะเห็นกล่องโต้ตอบที่แสดงในหน้าจอต่อไปนี้

2. ในโปรเจ็กต์ Unity สำหรับแอป iOS ให้เปิดกล่องโต้ตอบการตั้งค่าการสร้าง File > Build Settings (หากไม่ได้ตั้งค่าแพลตฟอร์มเป็น iOS คุณสามารถเลือกแพลตฟอร์ม iOS แล้วคลิกปุ่ม Switch Platform)

3. หลังจากเปลี่ยนแพลตฟอร์มแล้ว ให้คลิกปุ่มการตั้งค่าเพลเยอร์เพื่อตั้งค่า Bundle ID คุณจะเห็นช่องข้อความรอบพื้นที่การระบุตัวตน
4. ค่าของช่องตัวระบุชุดคือรหัสชุด iOS (เช่น com.yourcompany.yourproject) คัดลอกค่านี้หรือตั้งค่าของคุณแล้วคัดลอก
5. ในกล่องโต้ตอบ Firebase ให้วางรหัสแพ็กเกจที่คัดลอกไว้ลงในช่อง iOS bundle ID
6. คลิกลงทะเบียนแอป
7. ทำตามวิธีการใน Firebase เพื่อดาวน์โหลดไฟล์การกำหนดค่า GoogleService-Info.plist
8. เปิดหน้าต่างโปรเจ็กต์ของโปรเจ็กต์ Unity จากนั้นย้ายไฟล์การกำหนดค่าไปยังโฟลเดอร์ชิ้นงาน
9. ข้ามขั้นตอนที่เหลือและกลับไปที่หน้าหลักของคอนโซล Firebase

5. กําหนดค่า Firebase Analytics ใน Unity

ในขั้นตอนนี้ คุณจะเริ่มเพิ่ม Firebase SDK ลงในโปรเจ็กต์ Unity

1. ไปที่คอนโซล Firebase
2. ที่กึ่งกลางหน้าภาพรวมโปรเจ็กต์ ให้คลิกไอคอน Unity ( ) เพื่อเปิดเวิร์กโฟลว์การตั้งค่า หากเพิ่มแอปไปยังโปรเจ็กต์ Firebase แล้ว ให้คลิกเพิ่มแอปเพื่อแสดงตัวเลือกแพลตฟอร์ม
3. เลือกเป้าหมายของบิลด์โปรเจ็กต์ Unity ที่ต้องการลงทะเบียน หรือจะเลือกเพื่อลงทะเบียนทั้ง 2 เป้าหมายพร้อมกันเลยก็ได้

หมายเหตุ: หากลงทะเบียนเป้าหมายของบิลด์โปรเจ็กต์ Unity เพียงรายการเดียวในตอนนี้ คุณจะกลับไปที่เวิร์กโฟลว์การตั้งค่าในภายหลังเพื่อลงทะเบียนเป้าหมายของบิลด์อื่นได้เสมอ

4. ป้อนรหัสเฉพาะแพลตฟอร์มของโปรเจ็กต์ Unity

• สำหรับ iOS - ป้อนรหัส iOS ของโปรเจ็กต์ Unity ในช่องรหัสชุด iOS
• สำหรับ Android - ป้อนรหัส Android ของโปรเจ็กต์ Unity ในช่องชื่อแพ็กเกจ Android คำว่าชื่อแพ็กเกจและรหัสแอปพลิเคชันมักจะใช้แทนกันได้

5. คุณจะดูรหัสโปรเจ็กต์ Unity ได้จากที่ไหน

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

6. (ไม่บังคับ) ป้อนชื่อเล่นเฉพาะแพลตฟอร์มของโปรเจ็กต์ Unity ชื่อเล่นเหล่านี้เป็นตัวระบุภายในเพื่อความสะดวก และจะแสดงต่อคุณเท่านั้นในคอนโซล Firebase
7. คลิกลงทะเบียนแอป

เพิ่ม SDK ของ Firebase Analytics สำหรับ Unity

1. ในคอนโซล Firebase ให้คลิกดาวน์โหลด Firebase Unity SDK จากนั้นแยกไฟล์ SDK ไว้ที่ใดก็ได้ที่คุณสะดวก

• คุณดาวน์โหลด Firebase Unity SDK อีกครั้งได้ทุกเมื่อ
• Firebase Unity SDK ไม่ได้เจาะจงแพลตฟอร์ม

2. ในโปรเจ็กต์ Unity แบบเปิด ให้ไปที่เนื้อหา > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง
3. เลือกผลิตภัณฑ์ของ Firebase ที่รองรับซึ่งคุณต้องการใช้ในแอปจาก SDK ที่แยกไฟล์แล้ว

• เพิ่มแพ็กเกจ Firebase สำหรับ Google Analytics: FirebaseAnalytics.unitypackage
• เพิ่มแพ็กเกจสำหรับผลิตภัณฑ์อื่นๆ ของ Firebase ที่คุณต้องการใช้ในแอป เช่น หากต้องการใช้การตรวจสอบสิทธิ์ Firebase และฐานข้อมูลเรียลไทม์ของ Firebase ให้เพิ่ม FirebaseAuth.unitypackage และ FirebaseDatabase.unitypackage

Unity 5.x และเวอร์ชันก่อนหน้าใช้เฟรมเวิร์ก .NET 3.x ดังนั้นให้นำเข้าแพ็กเกจ dotnet3/ Unity 2017.x ขึ้นไปอนุญาตให้ใช้เฟรมเวิร์ก .NET 4.x หากโปรเจ็กต์ Unity ใช้ .NET 4.x ให้นำเข้าแพ็กเกจ dotnet4/ Unity 2019 ขึ้นไปไม่รองรับเฟรมเวิร์ก .NET 3.x อีกต่อไป ดังนั้นให้นำเข้าแพ็กเกจ dotnet4/

4. คลิกนำเข้า ในหน้าต่างนำเข้าแพ็กเกจ Unity
5. กลับไปที่คอนโซล Firebase แล้วคลิกถัดไปในเวิร์กโฟลว์การตั้งค่า

สำคัญ: เมื่อใช้ Firebase Unity SDK สำหรับ iOS อย่าปิดใช้การสลับเมธอด SDK กำหนดให้ต้องใช้ Swizzling หากไม่มีการใช้ Swizzling ฟีเจอร์หลักของ Firebase (เช่น การจัดการโทเค็น FCM) จะทำงานไม่ถูกต้อง

6. บันทึกเหตุการณ์ที่กําหนดเองด้วย Firebase Analytics

ในขั้นตอนนี้ คุณจะได้เรียนรู้วิธีบันทึกเหตุการณ์ที่กำหนดเองด้วย Firebase Analytics ในแอป Unity iOS

Firebase Analytics จะบันทึกเหตุการณ์บางอย่างให้คุณโดยอัตโนมัติ คุณจึงไม่ต้องเพิ่มโค้ดใดๆ เพื่อรับเหตุการณ์เหล่านั้น หากแอปต้องเก็บรวบรวมข้อมูลเพิ่มเติม คุณสามารถบันทึกประเภทเหตุการณ์ที่กําหนดเองของ Analytics ได้สูงสุด 500 ประเภทในแอป

บันทึกเหตุการณ์

หลังจากกำหนดค่าอินสแตนซ์ FirebaseApp แล้ว คุณจะเริ่มบันทึกเหตุการณ์ด้วยเมธอด logEvent() ได้

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

ดูเหตุการณ์ในคอนโซลดีบัก Xcode

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

คุณเปิดใช้การบันทึกแบบละเอียดได้ดังนี้

1. ใน Xcode ให้เลือกผลิตภัณฑ์ > รูปแบบ > แก้ไขรูปแบบ...
2. เลือกเรียกใช้จากเมนูด้านซ้าย
3. เลือกแท็บอาร์กิวเมนต์
4. ในส่วนอาร์กิวเมนต์ที่ส่งเมื่อตอนเริ่ม ให้เพิ่ม -FIRAnalyticsDebugEnabled

ครั้งถัดไปที่คุณเรียกใช้แอป เหตุการณ์จะแสดงในคอนโซลการแก้ไขข้อบกพร่องของ Xcode ซึ่งจะช่วยให้คุณยืนยันได้ทันทีว่าระบบได้ส่งเหตุการณ์แล้ว

ดูกิจกรรมในแดชบอร์ด

คุณจะเห็นเหตุการณ์ที่บันทึกไว้ในคอนโซล Firebase ในอีกไม่กี่ชั่วโมง โดยจะอยู่ใน Analytics → เหตุการณ์ คุณยังดูค่าพารามิเตอร์ได้โดยคลิกเหตุการณ์

คุณจะทําเครื่องหมาย "text_search" เป็น Conversion โดยเลื่อนสวิตช์ "ทําเครื่องหมายเป็น Conversion" ไปทางขวา

คุณสามารถตรวจสอบอีกครั้งว่าได้ทําเครื่องหมายเหตุการณ์เป็น Conversion สําเร็จหรือไม่ผ่านแท็บ Conversion ของ Firebase Analytics การทําเครื่องหมายเหตุการณ์เป็น Conversion จะช่วยให้ Google Ads นําเข้าเหตุการณ์เป็น Conversion ได้ด้วย

7. การนําเข้าเหตุการณ์ Analytics ใน Google Ads

การตั้งค่า Firebase-iOS เสร็จสมบูรณ์แล้ว และคุณพร้อมที่จะเปิดตัว App Campaign ด้วยเหตุการณ์การกระทําที่บันทึกไว้ คุณจะเริ่มต้นด้วยการลิงก์ Firebase กับ Google Ads การลิงก์ Firebase กับ Google Ads จะช่วยให้ App Campaign เรียนรู้เพิ่มเติมเกี่ยวกับกลุ่มเป้าหมายและเพิ่มการเรียนรู้ของ App Campaign ซึ่งมักจะส่งผลให้ประสิทธิภาพและ Conversion ดีขึ้น

1. ไปที่การตั้งค่า Firebase โดยคลิกปุ่มข้างภาพรวมโปรเจ็กต์
2. ในแท็บการผสานรวม คุณจะเห็น Google Ads และปุ่มลิงก์ คลิกลิงก์และดำเนินการต่อ

3. เลือกบัญชี Google Ads

ข้อควรระวัง: หากไม่ได้ทําเครื่องหมายเหตุการณ์เป้าหมายเป็น Conversion Google Ads จะนําเข้าไม่ได้ ตรวจสอบว่าได้ทําเครื่องหมายเหตุการณ์เป็น Conversion อย่างถูกต้อง

ตอนนี้ส่วนของ Firebase เสร็จแล้ว

ตอนนี้ ให้ไปที่ Google Ads แล้วเข้าสู่ระบบ

1. ไปที่ Google Ads แล้วเข้าสู่ระบบ จากนั้นไปที่เครื่องมือและการตั้งค่า → การวัด → Conversion เพื่อนำเข้าเหตุการณ์ที่กําหนดเองเป็น Conversion
2. คลิกปุ่ม + เพื่อเพิ่มการกระทำที่ถือเป็น Conversion ใหม่

3. เลือกพร็อพเพอร์ตี้ Google Analytics 4 (Firebase) แล้วคลิกดำเนินการต่อ

4. คุณจะเห็นเหตุการณ์ Analytics ทั้งหมดที่ทําเครื่องหมายเป็น Conversion ค้นหาclicked_counterเหตุการณ์ที่เราติดตั้งใช้งานก่อนหน้านี้

5. ตรวจสอบแล้วคลิกปุ่มนําเข้าและดำเนินการต่อ

หลังจากตั้งค่า text_search เป็นการกระทำที่ถือเป็น Conversion แล้ว ตอนนี้ก็ถึงเวลาเปิดตัวแคมเปญที่กำหนดเป้าหมายผู้ใช้ที่มีแนวโน้มจะทริกเกอร์เหตุการณ์ text_search

8. การเปิดตัวแคมเปญเพื่อกระตุ้นการกระทําในแอปด้วยเหตุการณ์ที่นําเข้า

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

6. ไปที่แท็บแคมเปญของบัญชีปัจจุบัน แล้วเริ่มแคมเปญใหม่โดยคลิกปุ่ม + คลิกแคมเปญใหม่แล้วดำเนินการต่อ
7. ในระหว่างนี้ เราจะเปิดตัวแคมเปญการโปรโมตแอปที่มีตัวเลือกการติดตั้งแอป

8. ค้นหาแอปโดยระบุชื่อแอป ชื่อแพ็กเกจ หรือผู้เผยแพร่
9. ในส่วนการเสนอราคา ให้เลือกการกระทำในแอปในดรอปบ็อกซ์เพื่อให้ Ads มุ่งเน้นที่การกระทำ
10. คุณจะเห็นเหตุการณ์ที่กำหนดเองในรายการที่ระบุ กำหนดต้นทุนต่อหนึ่งการกระทำเป้าหมาย และกรอกตัวเลือกอื่นๆ ด้วย

11. กำหนดการตั้งค่าแคมเปญ ซึ่งจะอยู่นอกขอบเขตของโค้ดแล็บ ดังนั้นโปรดดูเอกสารเหล่านี้หรือติดต่อผ่านช่องทางอื่นๆ เพื่อเพิ่มประสิทธิภาพการตั้งค่า

9. ขอแสดงความยินดี

ขอแสดงความยินดี คุณผสานรวม Firebase กับ Unity และ Google Ads เรียบร้อยแล้ว ซึ่งจะช่วยเพิ่มประสิทธิภาพแคมเปญ

คุณได้เรียนรู้

• วิธีกำหนดค่า Firebase สำหรับแพลตฟอร์ม Unity iOS
• วิธีบันทึกเหตุการณ์ที่กำหนดเองด้วย Unity และ Firebase Analytics
• วิธีนําเข้าเหตุการณ์และใช้กับแคมเปญเพื่อกระตุ้นการกระทํา

เอกสารอ้างอิง

• เพิ่ม Firebase ในโปรเจ็กต์ Unity
• Github: firebase/quickstart-unity