Бескодовые события в приложении

Бескодовые события в приложении появились в версии 4.34. Теперь вы можете добавлять и удалять события в приложении с помощью Events Manager, не реализуя для этого специальный код и не выпуская новую версию приложения.

Android

Требования

У вас должен быть один компонент из этого списка:

• Facebook SDK для Android — версия Full 4.34 или более поздняя;
• Facebook SDK для Android — версия Core 4.38 или более поздняя;
• Facebook SDK для Android — версия Core 4.34–4.37 и Marketing Kit.

Обратитесь к руководству по началу работы с событиями в приложении на Android, чтобы установить последнюю версию Facebook SDK для Android, или к руководству по обновлению, чтобы обновить SDK. Если у вас установлена версия 4.34–4.37, добавьте Marketing Kit. Для этого откройте <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" />

Добавление событий в приложении

Чтобы без использования кода добавить события в приложении, которые вы хотите отслеживать, перейдите в Events Manager.

1. В Events Manager нажмите Добавить новый источник данных и в раскрывающемся меню выберите пункт События в приложении.
2. Нажмите Используйте наш новый инструмент настройки событий, а затем выберите приложение, в которое хотите добавить события.
3. Выберите платформу, нажав Начать настройку.
4. Если вы впервые добавляете бескодовые события, появится небольшое руководство. Просмотрев его, откройте новый сеанс приложения на мобильном устройстве.
5. Несколько раз встряхните телефон, пока не появится версия вашего приложения.
6. Чтобы добавить событие в приложении, нажмите любой элемент. Переходите по страницам приложения, чтобы выбрать элементы.
7. Во всплывающем меню нажмите Сохранить. Чтобы не добавлять событие, нажмите "Отмена".
8. Добавив все события, нажмите Проверить и завершить.
9. Нажмите Тестировать события или "Сохранить и выйти".

Примечание. Может пройти до 30 минут, прежде чем события появятся в Events Manager.

Проверка интеграции

Перейдите в Помощник по рекламе приложений.

• Выберите приложение и нажмите Отправить.
• Прокрутите страницу вниз и в разделе Инструменты для разработчика нажмите Тестировать события в приложении.
• Если приложение отправляет события fb_codeless_debug, выбранные тестовые события будут перечислены в таблице.

Примечание. Эти инструкции подходят только для Facebook SDK 4.35 и более поздних версий.

iOS

Требования

• Facebook iOS Full SDK версии 4.34–7.1.1
• Facebook iOS Core SDK версии 4.38–7.1.1
• Facebook iOS Core SDK версии 4.34–4.37 до 7.1.1 и Marketing Kit

Ограничения

• Эта функция недоступна для версии 8.0.0 или боле поздних. Подробнее.

Перейдите к руководству по началу работы с событиями в приложении на iOS, чтобы установить последнюю версию SDK для iOS, или на страницу руководства по обновлению, чтобы обновить SDK. Если у вас установлена только версия Core SDK 4.34–4.37, добавьте Marketing Kit. Для этого добавьте в Podfile следующий код:

pod 'FBSDKMarketingKit' 

Не забудьте запустить pod update, а затем pod install --repo-update.

Применение бескодовых событий в приложении

Включите регистрацию бескодовых событий отладки. Для этого откройте файл .plist вашего приложения как код в Xcode и добавьте в словарь свойств следующие XML-строки:

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

Добавление событий в приложении

Чтобы без использования кода добавить события в приложении, которые вы хотите отслеживать, перейдите в Events Manager.

1. В Events Manager нажмите Добавить источник данных и выберите в раскрывающемся меню пункт События в приложении.
2. Нажмите Используйте наш новый инструмент настройки событий, а затем выберите приложение, в которое хотите добавить события.
3. Выберите платформу, нажав Начать настройку.
4. Если вы впервые добавляете бескодовые события, появится небольшое руководство. Просмотрев его, откройте новый сеанс приложения на мобильном устройстве.
5. Несколько раз встряхните телефон, пока не появится версия вашего приложения.
6. Чтобы добавить событие в приложении, нажмите любой элемент. Переходите по страницам приложения, чтобы выбрать элементы.
7. Во всплывающем меню нажмите Сохранить. Чтобы не добавлять событие, нажмите "Отмена".
8. Добавив все события, нажмите Проверить и завершить.
9. Нажмите Тестировать события или "Сохранить и выйти".

Примечание. Может пройти до 30 минут, прежде чем события появятся в Events Manager.

Проверка интеграции

Перейдите в Помощник по рекламе приложений.

• Выберите приложение и нажмите Отправить.
• Прокрутите страницу вниз и выберите Тестирование событий в приложении.
• Если приложение отправляет события fb_codeless_debug, они будут перечислены в таблице.

Unity

Нам требуется Facebook Unity SDK версии 4.34 или более поздней.

См. статью Начало работы с Facebook Unity SDK, чтобы установить последнюю версию Facebook Unity SDK, а затем используйте настройки, специально предусмотренные для платформы Unity iOS или Unity Android.

Активация бескодовых событий в приложении

Чтобы задействовать эту функцию, в Unity Editor выберите Facebook | Edit Settings, а затем выберите Auto Logging App Events:

Добавление событий в приложении

На этом этапе вы можете добавить события в приложении с использованием Events Manager:

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 минут, прежде чем события появятся в Events Manager. Повторите эти шаги для каждой платформы, например iOS или Android, которая поддерживается вашей игрой.

Проверка интеграции

Перейдите в Помощник по рекламе приложений.

• В Select an App нажмите Submit.

• Выберите App Events Tester.

• Если приложение отправляет события fb_codeless_debug, они появятся в таблице.

Часто задаваемые вопросы

ОБЩИЕ ВОПРОСЫ

Android

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>
  ...
  xmlns:tools="http://schemas.android.com/tools"
  ...
</manifest>

<activity>
  ...
  tools:replace="android:theme"
  ...
</activity>

iOS

[!] Unable to find a specification for FBSDKMarketingKit