เหตุการณ์ในแอพที่ไม่ใช้โค้ด

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

Android

ข้อกำหนด

คุณต้องมีข้อใดข้อหนึ่งต่อไปนี้:

โปรดดูคู่มือการเริ่มต้นใช้งานเหตุการณ์ในแอพสำหรับ Android เพื่อติดตั้ง Facebook SDK สำหรับ Android เวอร์ชั่นล่าสุด และดูคู่มือการอัพเกรดเพื่ออัพเกรด SDK เป็นเวอร์ชั่นล่าสุด หรือหากคุณติดตั้งเวอร์ชั่น 4.34 ถึง 4.37 แล้ว ให้เพิ่มชุดเครื่องมือการตลาดโดยเปิด <your_app> | Gradle Scripts | build.gradle (Module: app) และเพิ่มรายการต่อไปนี้ลงในส่วน dependencies{}

implementation 'com.facebook.android:facebook-marketing:[4,5)' 

อย่าลืมสร้างโปรเจ็กต์ของคุณใหม่

นำฟีเจอร์เหตุการณ์ในแอพที่ไม่ใช้โค้ดไปใช้

หากต้องการเปิดเหตุการณ์การแก้ไขจุดบกพร่อง ให้เพิ่มบรรทัดต่อไปนี้ใน AndroidManifest.xml:

<meta-data
    android:name="com.facebook.sdk.CodelessDebugLogEnabled"
    android:value="true" />

เพิ่มเหตุการณ์ในแอพของคุณ

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

  1. ในตัวจัดการเหตุการณ์ ให้คลิก "เพิ่มแหล่งข้อมูลใหม่" และเลือก "เหตุการณ์ในแอพ" จากเมนูดร็อปดาวน์
  2. คลิก "ใช้เครื่องมือการตั้งค่าเหตุการณ์โดยไม่ใช้โค้ดของเรา" แล้วเลือกแอพที่คุณต้องการเพิ่มเหตุการณ์ลงไป
  3. เลือกแพลตฟอร์มโดยคลิกที่ "เริ่มการตั้งค่า"
  4. หากคุณมาที่ลำดับขั้นตอนแบบไม่ใช้โค้ดเป็นครั้งแรก คุณจะเห็นบทแนะนำการใช้งานสั้นๆ หลังจากจบบทแนะนำการใช้งานแล้ว ให้เปิดเซสชั่นใหม่ของแอพของคุณบนอุปกรณ์มือถือ
  5. เขย่าโทรศัพท์จนกระทั่งเวอร์ชั่นของแอพของคุณปรากฏขึ้น
  6. คลิกที่องค์ประกอบใดก็ได้เพื่อเพิ่มเหตุการณ์ในแอพ ไปที่หน้าต่างอื่นของแอพเพื่อเลือกองค์ประกอบต่างๆ ในแอพ
  7. คลิก "บันทึก" ในเมนูป๊อปอัพ หรือ "ยกเลิก" หากไม่ต้องการเพิ่มเหตุการณ์
  8. เมื่อคุณเพิ่มเหตุการณ์ทั้งหมดแล้ว ให้คลิก "ตรวจสอบและเสร็จสิ้น"
  9. คลิก "ทดสอบเหตุการณ์" หรือ "บันทึกและออก"

หมายเหตุ: เหตุการณ์อาจใช้เวลาถึง 30 นาทีก่อนที่จะปรากฏในตัวจัดการเหตุการณ์ของคุณ

ตรวจสอบยืนยันการผสานการทำงานของคุณ

ไปที่ตัวช่วยเหลือในการลงโฆษณาแอพ

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

หมายเหตุ: ใช้งานได้กับ Facebook SDK เวอร์ชั่น 4.35 ขึ้นไปเท่านั้น

iOS

ข้อกำหนด

  • Facebook SDK เต็มสำหรับ iOS เวอร์ชั่น 4.34 ถึง 7.1.1
  • Facebook SDK หลักสำหรับ iOS เวอร์ชั่น 4.38 ถึง 7.1.1
  • Facebook SDK หลักสำหรับ iOS เวอร์ชั่น 4.34-4.37 ถึงเวอร์ชั่น 7.1.1 และชุดเครื่องมือการตลาด

ข้อจำกัด

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

pod 'FBSDKMarketingKit' 

อย่าลืมเรียกใช้ pod update ตามด้วย pod install --repo-update

นำฟีเจอร์เหตุการณ์ในแอพที่ไม่ใช้โค้ดไปใช้

เปิดใช้งานการลงบันทึกเหตุการณ์การแก้ไขจุดบกพร่องที่ไม่ใช้โค้ดโดยเปิด Info.plist ของแอพพลิเคชั่นให้เป็นโค้ดใน Xcode และเพิ่ม XML ต่อไปนี้ลงในพจนานุกรมคุณสมบัติ ดังนี้

<key>FacebookCodelessDebugLogEnabled</key>
<true/>

เพิ่มเหตุการณ์ในแอพของคุณ

App Store Connect สำหรับ iOS 14

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

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

  1. ในตัวจัดการเหตุการณ์ ให้คลิก "เพิ่มแหล่งข้อมูลใหม่" และเลือก "เหตุการณ์ในแอพ" จากเมนูดร็อปดาวน์
  2. คลิก "ใช้เครื่องมือการตั้งค่าเหตุการณ์โดยไม่ใช้โค้ดของเรา" แล้วเลือกแอพที่คุณต้องการเพิ่มเหตุการณ์ลงไป
  3. เลือกแพลตฟอร์มโดยคลิกที่ "เริ่มการตั้งค่า"
  4. หากคุณมาที่ลำดับขั้นตอนแบบไม่ใช้โค้ดเป็นครั้งแรก คุณจะเห็นบทแนะนำการใช้งานสั้นๆ หลังจากจบบทแนะนำการใช้งานแล้ว ให้เปิดเซสชั่นใหม่ของแอพของคุณบนอุปกรณ์มือถือ
  5. เขย่าโทรศัพท์จนกระทั่งเวอร์ชั่นของแอพของคุณปรากฏขึ้น
  6. คลิกที่องค์ประกอบใดก็ได้เพื่อเพิ่มเหตุการณ์ในแอพ ไปที่หน้าต่างอื่นของแอพเพื่อเลือกองค์ประกอบต่างๆ ในแอพ
  7. คลิก "บันทึก" ในเมนูป๊อปอัพ หรือ "ยกเลิก" หากไม่ต้องการเพิ่มเหตุการณ์
  8. เมื่อคุณเพิ่มเหตุการณ์ทั้งหมดแล้ว ให้คลิก "ตรวจสอบและเสร็จสิ้น"
  9. คลิก "ทดสอบเหตุการณ์" หรือ "บันทึกและออก"

หมายเหตุ: เหตุการณ์อาจใช้เวลาถึง 30 นาทีก่อนที่จะปรากฏในตัวจัดการเหตุการณ์ของคุณ

ตรวจสอบยืนยันการผสานการทำงานของคุณ

ไปที่ตัวช่วยเหลือในการลงโฆษณาแอพ

  • เลือกแอพ แล้วคลิก "ส่ง"
  • ไปที่ด้านล่างสุดแล้วเลือกผู้ทดสอบเหตุการณ์ในแอพ
  • หากแอพของคุณส่งเหตุการณ์ fb_codeless_debug เหตุการณ์จะแสดงอยู่ในตาราง

Unity

เรากำหนดให้ใช้ Facebook SDK สำหรับ Unity เวอร์ชั่น 4.34 ขึ้นไป

ดูที่การเริ่มต้นใช้งาน Facebook SDK สำหรับ Unity เพื่อติดตั้ง Facebook SDK สำหรับ Unity เวอร์ชั่นล่าสุด และทำตามการตั้งค่าเฉพาะแพลตฟอร์มสำหรับ Unity iOS หรือ Unity Android

เปิดใช้งานเหตุการณ์ในแอพที่ไม่ใช้โค้ด

หากต้องการเปิดใช้งานตัวเลือกนี้ ใน Unity Editor ให้เลือก Facebook | Edit Settings แล้วเลือก Auto Logging App Events:

เพิ่มเหตุการณ์ในแอพ

ตอนนี้คุณจะสามารถเพิ่มเหตุการณ์ในแอพได้ด้วยตัวจัดการเหตุการณ์:

  1. ใต้ Add Data Source ให้เลือก App Events

  2. คลิก User our codeless event setup tool

  3. เลือกแอพที่คุณต้องการเพิ่มเหตุการณ์ในแอพ

  4. คลิก Start Setup เพื่อเลือกแพลตฟอร์มของคุณ หากนี่เป็นครั้งแรกที่คุณเข้าดูลำดับขั้นตอนแบบไม่ใช้โค้ด คุณจะเห็นบทแนะนำการใช้งานสั้นๆ

  5. หลังจากจบบทแนะนำการใช้งานแล้ว ให้เปิดเซสชั่นใหม่ของแอพของคุณบนอุปกรณ์มือถือ

  6. เขย่าอุปกรณ์มือถือจนกระทั่งเวอร์ชั่นของแอพของคุณปรากฏขึ้น

  7. คลิกที่องค์ประกอบใดก็ได้ในแอพของคุณเพื่อเพิ่มเหตุการณ์ในแอพ ไปที่หน้าต่างอื่นของแอพเพื่อเลือกองค์ประกอบต่างๆ ในแอพ

  8. ใน Unity Editor ให้คลิก Save เพื่อเพิ่มเหตุการณ์

  9. หลังจากที่คุณเพิ่มเหตุการณ์ทั้งหมดแล้ว ให้คลิก Review and Finish

  10. คลิก Test Events หรือ Save and Exit

เหตุการณ์อาจใช้เวลาถึง 30 นาทีก่อนที่จะปรากฏในตัวจัดการเหตุการณ์ของคุณ ทำตามขั้นตอนเหล่านี้ซ้ำอีกครั้งสำหรับแต่ละแพลตฟอร์ม เช่น iOS หรือ Android ที่เกมของคุณรองรับ

ตรวจสอบยืนยันการผสานการทำงานของคุณ

ไปที่ตัวช่วยเหลือในการลงโฆษณาแอพ

  • ใต้ Select an App ให้คลิก Submit

  • เลือก App Events Tester

  • หากแอพของคุณส่งเหตุการณ์ fb_codeless_debug เหตุการณ์จะแสดงอยู่ในตาราง

คำถามที่พบบ่อย

ทั่วไป

1. ฉันจะตรวจสอบว่าได้อย่างไรว่าฟีเจอร์ที่ไม่ใช้โค้ดผสานการทำงานอย่างถูกต้อง

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

2. ฉันจะปิดฟีเจอร์ที่ไม่ใช้โค้ดได้อย่างไร

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


Android

1. ฉันควรทำอย่างไรหากเห็นข้อผิดพลาดในบิลด์ต่อไปนี้:
Android SDK build Error:Execution failed for task ':app:processDebugManifest'.> Manifest merger failed : 
Attribute activity#com.facebook.FacebookActivity@theme value=(@android:style/Theme.Translucent.NoTitleBar) 
from AndroidManifest.xml:69:13-72is also present at [com.facebook.android:facebook-android-sdk:4.16.0] 
AndroidManifest.xml:32:13-63 value=(@style/com_facebook_activity_theme).Suggestion: add
'tools:replace="android:theme"' to <activity> element at AndroidManifest.xml:66:9-70:47 to override.
เพิ่มรายการต่อไปนี้ไปยังองค์ประกอบ manifest ในไฟล์ AndroidManifest.xml:
<manifest>
  ...
  xmlns:tools="http://schemas.android.com/tools"
  ...
</manifest>
และเพิ่มรายการต่อไปนี้ไปยังองค์ประกอบ activity:
<activity>
  ...
  tools:replace="android:theme"
  ...
</activity>

iOS

1. ฉันควรทำอย่างไรหากเห็นคำเตือนต่อไปนี้:
[!] Unable to find a specification for FBSDKMarketingKit
เรียกใช้ pod update ตามด้วย pod install --repo-update