เริ่มต้นใช้งานเหตุการณ์ในแอพ (iOS)

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

ก่อนเริ่มต้น

คุณจะต้องดำเนินการดังต่อไปนี้

• บัญชีผู้พัฒนาสำหรับ Facebook
• บัญชีโฆษณาสำหรับ Facebook
• บัญชีธุรกิจ Facebook (ให้สร้างบัญชีธุรกิจใหม่หากคุณยังไม่มี)
• แอพ Facebook

ขั้นตอนที่1: กำหนดค่าแอพ Facebook ของคุณ

ไปที่แดชบอร์ดของแอพ คลิกแอพของฉัน และสร้างแอพใหม่ขึ้นมาหากคุณยังไม่มีแอพ ไปที่การตั้งค่า > พื้นฐาน เพื่อดูแผงรายละเอียดของแอพที่มี ID ของแอพ, ข้อมูลลับของแอพ และรายละเอียดอื่นๆ เกี่ยวกับแอพของคุณ

เลื่อนลงไปที่ด้านล่างของหน้า แล้วคลิกเพิ่มแพลตฟอร์ม เลือก iOS เพิ่มรายละเอียดแอพของคุณ แล้วบันทึกการเปลี่ยนแปลง

ตั้งค่าแอพของคุณเพื่อการโฆษณาโดยเพิ่มรายละเอียดต่อไปนี้

• โดเมนของแอพ - ระบุ URL สำหรับ Apple App Store ของแอพของคุณ
• URL ของนโยบายความเป็นส่วนตัว - ระบุ URL ของนโยบายความเป็นส่วนตัวจำเป็นต้องตั้งค่าแอพของคุณให้เป็นสาธารณะ
• URL ของข้อกำหนดในการใช้บริการ - ระบุ URL ของข้อกำหนดในการใช้บริการ
• แพลตฟอร์ม - เลื่อนลงไปที่ส่วนล่างสุดของแผงการตั้งค่าเพื่อเพิ่มแพลตฟอร์ม iOS

เรียนรู้เพิ่มเติมเกี่ยวกับการเพิ่มรายละเอียดลงในแอพของคุณ เช่น ไอคอนหรือหมวดหมู่ ได้ที่เอกสารเกี่ยวกับการพัฒนาแอพ

ขั้นตอนที่ 2: เชื่อมโยงบัญชีโฆษณาและบัญชีธุรกิจ

หากต้องการแสดงโฆษณาและวัดผลการติดตั้งในตัวจัดการโฆษณา ให้เชื่อมโยงบัญชีโฆษณาและบัญชีธุรกิจอย่างน้อย 1 บัญชีกับแอพของคุณ

1. ในแดชบอร์ดของแอพ ให้คลิกการตั้งค่า > ขั้นสูง
2. ใน ID บัญชีโฆษณาที่ได้รับอนุญาต ให้เพิ่ม ID บัญชีโฆษณาของคุณ โดยคุณสามารถรับ ID บัญชีโฆษณาได้จากตัวจัดการโฆษณา
3. ในแผงควบคุมบัญชีโฆษณา ให้คลิกเริ่มต้นใช้งาน และทำตามคำแนะนำในการเชื่อมต่อแอพกับธุรกิจ

ขั้นตอนที่ 3: ตั้งค่าสภาพแวดล้อมการพัฒนาของคุณ

ขั้นตอนต่อไปนี้จะใช้โปรแกรมจัดการแพ็คเกจ Swift ในการตั้งค่าสภาพแวดล้อมการพัฒนาของคุณใน Xcode

1. ใน Xcode ให้คลิกไฟล์ > เพิ่มแพ็คเกจ...
2. ในช่องค้นหาที่ปรากฏขึ้นมา ให้ป้อน URL ที่เก็บข้อมูล: https://github.com/facebook/facebook-ios-sdk
3. ในกฎของการขึ้นต่อกัน ให้เลือก “จนกว่าจะถึงเวอร์ชั่นใหญ่ถัดไป” และป้อนเวอร์ชั่นล่าสุด รุ่นล่าสุดจะระบุไว้ใน https://github.com/facebook/facebook-ios-sdk/releases/
4. เลือกไลบรารีที่คุณจะใช้และเป้าหมายที่คุณต้องการเพิ่มไลบรารีดังกล่าวเข้าไป
5. คลิกที่เพิ่มแพ็คเกจเพื่อตั้งค่าให้เสร็จสมบูรณ์

ขั้นตอนที่ 4: ลงทะเบียนและกำหนดค่าแอพของคุณกับ Facebook

เพิ่มตัวระบุชุดรวมของคุณและเปิดใช้งานการลงชื่อเข้าใช้แบบครั้งเดียวสำหรับแอพของคุณ

ขั้นตอนที่ 5: กำหนดค่าโปรเจ็กต์ของคุณ

ขั้นตอนที่ 6: เชื่อมต่อ App Delegate และ Scene Delegate ของคุณ

    
// AppDelegate.swift
import UIKit
import FacebookCore

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {    
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {          
        ApplicationDelegate.shared.application(
            application,
            didFinishLaunchingWithOptions: launchOptions
        )

        return true
    }
          
    func application(
        _ app: UIApplication,
        open url: URL,
        options: [UIApplication.OpenURLOptionsKey : Any] = [:]
    ) -> Bool {
        ApplicationDelegate.shared.application(
            app,
            open: url,
            sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String,
            annotation: options[UIApplication.OpenURLOptionsKey.annotation]
        )
    }  
}

// SceneDelegate.swift
import FacebookCore
  ...
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else {
        return
    }

    ApplicationDelegate.shared.application(
        UIApplication.shared,
        open: url,
        sourceApplication: nil,
        annotation: [UIApplication.OpenURLOptionsKey.annotation]
    )
}

ขั้นตอนที่ 7: เพิ่มเหตุการณ์ในแอพ

เหตุการณ์ในแอพของคุณจะได้รับการติดตามด้วย 3 วิธี ดังนี้

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

เหตุการณ์ที่ลงบันทึกโดยอัตโนมัติ

รับการยินยอมสำหรับอุปกรณ์

ตั้งแต่ iOS 14.5 เป็นต้นไป คุณจะต้องตั้งค่า isAdvertiserTrackingEnabled และลงบันทึกแต่ละครั้งที่อนุญาตให้อุปกรณ์แชร์ข้อมูลกับ Facebook

หากอุปกรณ์ให้การยินยอม ให้ตั้งค่า Settings.shared.isAdvertiserTrackingEnabled = true

หากอุปกรณ์ไม่อนุญาตให้ติดตาม ให้ตั้งค่า Settings.shared.isAdvertiserTrackingEnabled = false

<key>FacebookAutoLogAppEventsEnabled</key>
<false/>

<key>FacebookAdvertiserIDCollectionEnabled</key>
<false/>

เหตุการณ์แบบลงบันทึกด้วยตนเอง

หากต้องการลงบันทึกเหตุการณ์ที่กำหนดเอง ให้ทำเพียงส่งชื่อของเหตุการณ์นั้นในรูปแบบ AppEvents.Name ดังนี้

AppEvents.shared.logEvent(AppEvents.Name("battledAnOrc"))

พารามิเตอร์เหตุการณ์

Facebook ได้สร้างชุดพารามิเตอร์เหตุการณ์ที่เป็นประโยชน์สำหรับการรวมเข้ากับเหตุการณ์แบบมาตรฐานหรือกับเหตุการณ์ที่คุณกำหนดเอง คุณยังสามารถระบุพารามิเตอร์ของคุณเองได้อีกด้วย

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

พารามิเตอร์จะส่งผ่านพจนานุกรมซึ่งมีคีย์ที่มีชื่อพารามิเตอร์อยู่ในรูปแบบ AppEvents.ParameterName และค่าจะต้องอยู่ในรูปแบบ String หรือตัวเลข (Int, Double ฯลฯ)

ขั้นตอนที่ 8: ทดสอบเหตุการณ์ของคุณ

ตัวช่วยเหลือในการลงโฆษณาแอพช่วยให้คุณสามารถทดสอบเหตุการณ์ในแอพภายในแอพของคุณได้ เพื่อให้แน่ใจว่าแอพของคุณจะส่งเหตุการณ์ไปยัง Facebook

1. เปิดตัวช่วยเหลือในการลงโฆษณาแอพ
2. ในเลือกแอพ ให้เลือกแอพของคุณ จากนั้นเลือกส่ง
3. เลื่อนลงไปที่ด้านล่างสุดแล้วเลือกทดสอบเหตุการณ์
4. เปิดแอพของคุณแล้วส่งเหตุการณ์ เหตุการณ์จะปรากฏบนหน้า

เรียนรู้เพิ่มเติม

• คู่มือเกี่ยวกับหลักปฏิบัติที่ดีที่สุด - ดูแอพตัวอย่างต่างๆ มากมาย รวมถึงวิธีที่แต่ละแอพจัดการกับเหตุการณ์ในแอพ
• คำถามที่พบบ่อย - ดูคำถามที่พบบ่อยของเรา
• หลักสูตร Blueprints ของ Meta: กำหนดค่า SDK และเหตุการณ์ในแอพสำหรับ iOS
• หลักสูตร Blueprints ของ Meta: ใช้เหตุการณ์ในแอพเพื่อกำหนดเป้าหมาย ปรับให้เหมาะสม และวัดผล

แอพตัวอย่าง

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