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

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

หากต้องการปิดใช้งานเหตุการณ์ที่ลงบันทึกโดยอัตโนมัติ ให้เพิ่มโค้ดต่อไปนี้ลงในไฟล์ AndroidManifest.xml ของคุณ

<application>
  ...
  <meta-data android:name="com.facebook.sdk.AutoLogAppEventsEnabled"
           android:value="false"/>
  ...
</application>

ในบางกรณี คุณอาจต้องการทำให้การเก็บรวบรวมเหตุการณ์ที่ลงบันทึกโดยอัตโนมัติล่าช้าลง เช่น เพื่อขอการยินยอมจากผู้ใช้หรือดำเนินการตามข้อผูกพันทางกฎหมาย แทนที่จะปิดใช้งาน ในกรณีนี้ ให้เรียกใช้เมธอด setAutoLogAppEventsEnabled() ของคลาส FacebookSDK และตั้งค่าเป็น true เพื่อเปิดใช้งานการลงบันทึกเหตุการณ์อีกครั้งหลังจากผู้ใช้ปลายทางให้การยินยอมแล้ว

setAutoLogAppEventsEnabled(true);

ในการระงับการลงบันทึกอีกครั้งไม่ว่าจะด้วยเหตุผลใดๆ ให้ตั้งค่าเมธอด setAutoLogAppEventsEnabled() เป็น false

setAutoLogAppEventsEnabled(false);

คุณสามารถปิดใช้งานการลงบันทึกเหตุการณ์การซื้อในแอพแบบอัตโนมัติโดยใช้แดชบอร์ดของแอพได้อีกด้วย ให้ไปที่การ์ด Android ในส่วน “พื้นฐาน” > “การตั้งค่า” และสลับสวิตช์เป็นไม่

ปิดใช้งานการเริ่มต้นใช้งาน SDK แบบอัตโนมัติ

หากต้องการปิดใช้งานการเริ่มต้นใช้งาน SDK แบบอัตโนมัติ ให้เพิ่มโค้ดต่อไปนี้ลงในไฟล์ AndroidManifest.xml ของคุณ

<application>
  ...
  <meta-data android:name="com.facebook.sdk.AutoInitEnabled"
           android:value="false"/>
  ...
</application>

ในบางกรณี คุณอาจต้องการทำให้การเริ่มต้นใช้งาน SDK ล่าช้าลง เช่น เพื่อขอการยินยอมจากผู้ใช้หรือดำเนินการตามข้อผูกพันทางกฎหมาย แทนที่จะปิดใช้งาน ในกรณีนี้ ให้เรียกใช้เมธอดคลาส setAutoInitEnabled และตั้งค่าเป็น true เพื่อเริ่มต้นใช้งาน SDK ด้วยตนเองหลังจากผู้ใช้ปลายทางให้การยินยอมแล้ว

FacebookSdk.setAutoInitEnabled(true)
FacebookSdk.fullyInitialize()

ปิดใช้งานการเก็บรวบรวม ID ผู้ลงโฆษณา

หากต้องการปิดใช้งานการเก็บรวบรวม advertiser-id ให้เพิ่มโค้ดต่อไปนี้ลงในไฟล์ AndroidManifest.xml ของคุณ

<application>
  ...
  <meta-data android:name="com.facebook.sdk.AdvertiserIDCollectionEnabled"
           android:value="false"/>
  ...
</application>

ในบางกรณี คุณอาจต้องการทำให้การเก็บรวบรวม advertiser_id ล่าช้าลง เช่น เพื่อขอการยินยอมจากผู้ใช้หรือดำเนินการตามข้อผูกพันทางกฎหมาย แทนที่จะปิดใช้งาน ในกรณีนี้ ให้เรียกใช้เมธอด setAdvertiserIDCollectionEnabled() ของคลาส FacebookSDK และตั้งค่าเป็น true เพื่อเปิดใช้งานการเก็บรวบรวม advertiser_id อีกครั้งหลังจากผู้ใช้ปลายทางให้การยินยอมแล้ว

setAdvertiserIDCollectionEnabled(true);

ในการระงับการเก็บบันทึกไม่ว่าจะด้วยเหตุผลใดๆ ให้ตั้งค่าเมธอด setAdvertiserIDCollectionEnabled() เป็น false

setAdvertiserIDCollectionEnabled(false);

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

สร้างอ็อบเจ็กต์ AppEventsLogger โดยใช้เมธอดตัวช่วยเพื่อลงบันทึกเหตุการณ์ของคุณ โดยที่ this จะเป็น Activity ที่มีเมธอดของคุณอยู่

AppEventsLogger logger = AppEventsLogger.newLogger(this);

จากนั้น คุณสามารถลงบันทึกเหตุการณ์ไปยัง logger ได้ โดยที่ AppEventConstants.EVENT_NAME_X จะเป็นค่าคงที่ค่าใดค่าหนึ่งที่แสดงอยู่ในตารางเหตุการณ์มาตรฐาน หรือเป็นค่าคงที่จากโค้ดของตัวสร้างโค้ด

logger.logEvent(AppEventsConstants.EVENT_NAME_X);

นอกจากนี้ คุณสามารถกำหนดชุดพารามิเตอร์ใน Bundle และคุณสมบัติ valueToSum ได้ ซึ่งเป็นตัวเลขแบบกำหนดเองที่สามารถแสดงถึงค่าใดๆ ก็ได้ เช่น ราคาหรือจำนวน ทั้งนี้ ระบบจะรวมค่าของคุณสมบัติ valueToSum ทั้งหมดเข้าด้วยกันเมื่อมีการรายงาน ตัวอย่างเช่น หากผู้ใช้ 10 ราย ได้ซื้อสินค้า 1 รายการ และสินค้าแต่ละชิ้นมีราคา $10 (และส่งไว้ใน valueToSum) ระบบจะรวมค่าทั้งหมดเข้าด้วยกันแล้วรายงานออกมาเป็น $100

หมายเหตุ ทั้ง valueToSum และ parameters เป็นส่วนที่จะระบุหรือไม่ก็ได้

Bundle params = new Bundle();
params.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT, "[{\"id\": \"1234\", \"quantity\": 2}, {\"id\": \"5678\", \"quantity\": 1}]");

logger.logEvent(AppEventsConstants.EVENT_NAME_PURCHASE,
                54.23,
                params);
Bundle params = new Bundle();
params.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
params.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "HDFU-8452");

logger.logEvent(AppEventsConstants.EVENT_NAME_ADDED_TO_CART,
                54.23,
                params);