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

1. บทนำ

อัปเดตล่าสุด 14-12-2020

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

ใน Codelab นี้ คุณจะได้ศึกษาวิธีติดตั้งใช้งานเหตุการณ์ที่กำหนดเองด้วย GA4F iOS SDK และเปิดตัวแคมเปญเพื่อกระตุ้นการกระทำผ่าน Google Ads

ผ่าน Codelab นี้ คุณจะได้เห็นกระบวนการทั้งหมดของธุรกิจแอปที่ลูกค้าของเราพบ หากต้องการดูข้อมูลเบื้องต้นที่เข้าใจง่ายขึ้นเกี่ยวกับ Firebase iOS ให้เริ่มด้วย Firebase iOS Codelab Swift

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

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

สิ่งที่ต้องมี

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

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

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

ก่อนอื่น ให้เปิด Xcode

1. หากไม่มีโปรเจ็กต์ที่เปิดอยู่ ให้เลือกสร้างโปรเจ็กต์ Xcode ใหม่จากหน้าต้อนรับ
2. เลือก iOS ที่ด้านบนของกล่องโต้ตอบ
3. ในส่วนแอปพลิเคชัน ให้เลือก "แอป" แล้วคลิก "ถัดไป"
4. ในกล่องโต้ตอบที่ปรากฏขึ้น ให้ใช้ค่าต่อไปนี้เพื่อตั้งชื่อแอปของคุณและเลือกตัวเลือกเพิ่มเติมสำหรับโปรเจ็กต์ของคุณ แล้วคลิก ถัดไป :
5. ชื่อผลิตภัณฑ์: เช่น ios-app

Xcode จะใช้ชื่อผลิตภัณฑ์ที่คุณป้อนเพื่อตั้งชื่อโปรเจ็กต์และแอป

2. ทีม: หากระบบไม่ได้กรอกข้อมูลนี้โดยอัตโนมัติ ให้ตั้งค่าทีมเป็น "ไม่มี"
3. ชื่อองค์กร: ชื่อองค์กรหรือชื่อของคุณเอง
4. ตัวระบุกลุ่ม: ระบบจะสร้างค่านี้โดยอัตโนมัติตามชื่อผลิตภัณฑ์และตัวระบุองค์กร
5. ภาษา: Swift
6. เลือกตำแหน่งที่ตั้งเพื่อบันทึกโปรเจ็กต์ แล้วคลิกสร้าง
7. Xcode จะเปิดโปรเจ็กต์ใหม่ในหน้าต่างพื้นที่ทำงาน

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

หากต้องการเริ่มต้นใช้งาน 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. การกำหนดค่า Firebase

1. ในคอนโซล Firebase ให้เลือกภาพรวมโปรเจ็กต์ > การตั้งค่าโปรเจ็กต์ในการนําทางด้านซ้าย จากนั้นคลิกปุ่ม iOS ในส่วนทั่วไป > แอปของคุณ

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

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

8. ไปที่โปรเจ็กต์ Xcode แล้วย้ายไฟล์ GoogleService-Info.plist (ที่คุณเพิ่งดาวน์โหลด) ไปยังรูทของโปรเจ็กต์ Xcode
9. ข้ามขั้นตอนที่เหลือและกลับไปที่หน้าหลักของคอนโซล Firebase

5. กำหนดค่า Firebase Analytics ใน Xcode

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

หมายเหตุ: บริการของ Google จะใช้ CocoaPods ในการติดตั้งและจัดการทรัพยากร Dependency หากคุณไม่เคยใช้ CocoaPods มาก่อน คุณต้องติดตั้ง CocoaPods ก่อนโดยเรียกใช้คำสั่งนี้ในเทอร์มินัล

$ sudo gem install cocoapods

1. เปิดหน้าต่างเทอร์มินัลและไปที่ตำแหน่งของโปรเจ็กต์ Xcode สำหรับแอป
2. สร้าง Podfile หากคุณยังไม่มี:

$ pod init

3. เปิด Podfile และเพิ่ม :

$ vi Podfile

$ pod 'Firebase/Analytics'

4. บันทึกไฟล์และเรียกใช้คำสั่งต่อไปนี้

$ pod install

5. เพิ่มโค้ดการเริ่มต้น ดังนี้

หากต้องการเชื่อมต่อ Firebase เมื่อแอปของคุณเริ่มขึ้น ให้เพิ่มโค้ดการเริ่มต้นด้านล่างลงในคลาส AppDelegate หลัก

import UIKit
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
      [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    return true
  }
}

6. คุณพร้อมแล้ว ไปที่คอนโซล

ตอนนี้คุณพร้อมที่จะเริ่มบันทึกเหตุการณ์ที่กำหนดเองบางส่วนแล้ว

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

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

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

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

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

Analytics.logEvent("text_search", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

ตั้งค่าพารามิเตอร์เหตุการณ์เริ่มต้น

คุณบันทึกพารามิเตอร์ข้ามเหตุการณ์ได้โดยใช้ setDefaultEventParameters พารามิเตอร์เริ่มต้นจะเชื่อมโยงกับเหตุการณ์ในอนาคตทั้งหมดที่บันทึกไว้

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

ดูเหตุการณ์ในคอนโซลแก้ไขข้อบกพร่องของ Xcode

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

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

1. ใน Xcode ให้เลือก Product > Scheme > Edit Scheme...
2. เลือกเรียกใช้จากเมนูด้านซ้าย
3. เลือกแท็บอาร์กิวเมนต์
4. ในส่วน Arguments Passed On Launch ให้เพิ่ม -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 จึงจะเปิดตัว App Campaign ได้ หากยังไม่พร้อมที่จะเผยแพร่แอป ให้ออกจากขั้นตอนนี้ไปก่อน

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

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

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

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

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

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

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

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