เหตุการณ์ที่กำหนดเองของ 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. เริ่มโปรเจ็กต์ Swift ใหม่ใน iOS

สร้างแอป iOS Swift ที่ใช้เทมเพลตแบบง่าย คุณแก้ไขแอปเริ่มต้นนี้เพื่อสร้างแอปที่เสร็จแล้วได้

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

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

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

2. ทีม: หากระบบไม่กรอกข้อมูลนี้โดยอัตโนมัติ ให้ตั้งค่าทีมเป็น "ไม่มี"
3. ชื่อองค์กร: ชื่อองค์กรหรือชื่อของคุณเอง
4. ตัวระบุชุดผลิตภัณฑ์: ระบบจะสร้างค่านี้โดยอัตโนมัติตามชื่อผลิตภัณฑ์และตัวระบุองค์กรของคุณ
5. ภาษา: สวิฟต์
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 > รูปแบบ > แก้ไขรูปแบบ...
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 เพื่อเปิดตัว App Campaign หากยังไม่พร้อมที่จะเผยแพร่แอป ให้ออกจากขั้นตอนนี้ไปก่อน

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

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

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

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

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

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

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

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