بدء استخدام أحداث التطبيقات (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()

تعطيل تجميع معرفات المعلنين

لتعطيل تجميع 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 أشخاص عنصرًا واحدًا وكانت تكلفة كل عنصر 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);