Meta-App-Events

Codeless App Events

Codeless App Events ist ein Feature, das mit v4.34 eingeführt wurde. Hiermit kannst du über den Events Manager App-Events hinzufügen oder entfernen, ohne Code implementieren oder eine neue Version der App veröffentlichen zu müssen.

Android

Anforderungen

Du musst über eines der folgenden SDKs verfügen:

Rufe den Leitfaden Erste Schritte mit App-Events für Android auf, um die neueste Version des Facebook-SDK für Android zu installieren, den Upgrade-Leitfaden, um auf die neueste Version des SDK zu aktualisieren, bzw., sofern du v4.34–4.37 installiert hast, füge das Marketing-Kit hinzu, indem du <your_app> | Gradle Scripts | build.gradle (Module: app) öffnest und im Abschnitt dependencies{} Folgendes hinzufügst.

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

Vergiss nicht, dein Projekt neu zu erstellen.

Das Codeless App Events-Feature implementieren

Aktiviere das Codeless-Debugging-Event, indem du in AndroidManifest.xml die folgenden Zeilen hinzufügst:

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

Deine App-Events hinzufügen

Nutze den Events Manager, um App-Events, die du verfolgen möchtest, ohne Code hinzuzufügen.

  1. Klicke im Events Manager auf Neue Datenquelle hinzufügen und wähle App-Events aus dem Dropdown-Menü aus.
  2. Klicke auf Unser Event-Setup-Tool ohne Code verwenden und wähle dann die App aus, der du Events hinzufügen möchtest.
  3. Wähle die Plattform aus, indem du auf Setup starten klickst.
  4. Wenn du den Ablauf ohne Code zum ersten Mal verwendest, wird ein kurzes Tutorial angezeigt. Öffne im Anschluss an das Tutorial eine neue Sitzung deiner App auf dem Mobilgerät.
  5. Schüttele das Telefon, bis eine Version deiner App angezeigt wird.
  6. Klicke auf ein beliebiges Element, um ein App-Event hinzuzufügen. Navigiere zu verschiedenen Seiten deiner App, um über die App Elemente auszuwählen.
  7. Klicke im Popup-Menü auf Speichern bzw. „Abbrechen“, um kein Event hinzuzufügen.
  8. Wenn alle Events hinzugefügt sind, klicke auf Prüfen und Fertigstellen.
  9. Klicke auf Events testen bzw. „Speichern“ und „Beenden“.

Hinweis: Es kann bis zu 30 Minuten dauern, bis Events im Events Manager erscheinen.

Integration bestätigen

Gehe zum App Ads-Hilfstool.

  • Wähle eine App aus und klicke auf Senden.
  • Scrolle nach unten zum Abschnitt Entwicklertools und klicke auf App-Events testen.
  • Wenn deine App fb_codeless_debug-Events sendet, werden die ausgewählten Test-Events in der Tabelle aufgeführt.

Hinweis: Funktioniert nur bei Facebook SDK v4.35 und höher.

iOS

Anforderungen

  • Facebook iOS Full SDK v4.34 bis v7.1.1
  • Facebook iOS Core SDK v4.38 bis v7.1.1
  • Facebook iOS Core SDK v4.34–4.37 bis v7.1.1 und das Marketing-Kit

Einschränkungen

  • Dieses Feature ist nicht verfügbar für Version v8.0.0 oder neuer. Mehr dazu

Rufe den Leitfaden Erste Schritte mit App-Events für iOS auf, um die neueste Version des iOS-SDK zu installieren, den Upgrade-Leitfaden, um auf die neueste Version des SDK zu aktualisieren, bzw., nur wenn du v4.34–4.37 des Core SDK installiert hast, füge das Marketing-Kit hinzu, indem du deinem Podfile Folgendes hinzufügst.

pod 'FBSDKMarketingKit'

Vergiss nicht, pod update und dann pod install --repo-update auszuführen.

Das Codeless App Events-Feature implementieren

Aktiviere die Protokollierung von Codeless-Debugging-Events, indem du die .plist der Anwendung als Code in Xcode öffnest und dem Eigenschafts-Dictionary den folgenden XML-Code hinzufügst:

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

Deine App-Events hinzufügen

App Store Connect für iOS 14

Weil deine App Events erfasst und an Facebook sendet, musst du eventuell diese Datentypen im Fragebogen zu App Store Connect angeben. Du bist dafür verantwortlich, die Datenschutzrichtlinie deiner Anwendung entsprechend zu gestalten. Im Artikel zum Datenschutz im Apple App Store erfährst du mehr über die Datentypen, die du angeben musst.

Nutze den Events Manager, um App-Events, die du verfolgen möchtest, ohne Code hinzuzufügen.

  1. Klicke im Events Manager auf Datenquelle hinzufügen und wähle App-Events aus dem Dropdown-Menü aus.
  2. Klicke auf Unser Event-Setup-Tool ohne Code verwenden und wähle dann die App aus, der du Events hinzufügen möchtest.
  3. Wähle die Plattform aus, indem du auf Setup starten klickst.
  4. Wenn du den Ablauf ohne Code zum ersten Mal verwendest, wird ein kurzes Tutorial angezeigt. Öffne im Anschluss an das Tutorial eine neue Sitzung deiner App auf dem Mobilgerät.
  5. Schüttele das Telefon, bis eine Version deiner App angezeigt wird.
  6. Klicke auf ein beliebiges Element, um ein App-Event hinzuzufügen. Navigiere zu verschiedenen Seiten deiner App, um über die App Elemente auszuwählen.
  7. Klicke im Popup-Menü auf Speichern bzw. „Abbrechen“, um kein Event hinzuzufügen.
  8. Wenn alle Events hinzugefügt sind, klicke auf Prüfen und Fertigstellen.
  9. Klicke auf Events testen bzw. „Speichern“ und „Beenden“.

Hinweis: Es kann bis zu 30 Minuten dauern, bis Events im Events Manager erscheinen.

Integration bestätigen

Gehe zum App Ads-Hilfstool.

  • Wähle eine App aus und klicke auf Senden.
  • Gehe nach unten und wähle App-Events-Tester.
  • Wenn deine App fb_codeless_debug-Events sendet, werden sie in der Tabelle aufgeführt.

Unity

Das Facebook Unity SDK v4.34 oder höher ist erforderlich.

Rufe Erste Schritte mit dem Facebook Unity-SDK auf, um die neueste Version des Facebook Unity-SDK zu installieren, und befolge die plattformeigenen Einstellungen für Unity iOS oder Unity Android.

Codeless App Events aktivieren

Um diese Option im Unity Editor zu aktivieren, wähle Facebook | Edit Settings und dann Auto Logging App Events aus:

App-Events hinzufügen

Jetzt kannst du App-Events über den Events Manager hinzufügen:

  1. Wähle unter Add Data SourceApp Events aus.

  2. Klicke auf User our codeless event setup tool

  3. Wähle die App aus, zu der du Events hinzufügen möchtest.

  4. Klicke auf Start Setup, um deine Plattform auszuwählen. Wenn du den Ablauf ohne Code zum ersten Mal verwendest, wird ein kurzes Tutorial angezeigt.

  5. Öffne im Anschluss an das Tutorial eine neue Sitzung deiner App auf dem Mobilgerät.

  6. Schüttele dein Mobilgerät, bis eine Version deiner App angezeigt wird.

  7. Klicke auf ein beliebiges Element in deiner App, um ein App-Event hinzuzufügen. Navigiere zu verschiedenen Seiten deiner App, um über die App Elemente auszuwählen.

  8. Klicke im Unity Editor auf Save, um das Event hinzuzufügen.

  9. Wenn alle Events hinzugefügt sind, klicke auf Review and Finish.

  10. Klicke auf Test Events oder Save and Exit.

Es kann bis zu 30 Minuten dauern, bis Events im Events Manager erscheinen. Wiederhole diese Schritte für jede Plattform wie iOS oder Android, die dein Spiel unterstützt.

Integration bestätigen

Gehe zum App Ads-Hilfstool.

  • Klicke unter Select an App auf Submit.

  • Wähle App Events Tester aus.

  • Wenn deine App fb_codeless_debug-Events sendet, werden sie in der Tabelle aufgeführt.

FAQ

ALLGEMEINES

1. Wie kann ich prüfen, ob das Codeless-Feature richtig integriert ist?

Wenige Minuten nachdem du deine App auf dem Testgerät gestartet hast, siehst du Events mit dem Namen fb_codeless_debug im Events Manager.

2. Wie deaktiviere ich das Codeless-Feature?

Verwende zum Deaktivieren der Protokollierung von Codeless App Events das Event-Setup-Tool und entferne alle Events.

Android

1. Wie gehe ich vor, wenn die folgende Fehlermeldung angezeigt wird?
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.
Füge dem Element manifest in deiner Datei AndroidManifest.xml Folgendes hinzu: 
<manifest>
  ...
  xmlns:tools="http://schemas.android.com/tools"
  ...
</manifest>
Füge dem Element activity Folgendes hinzu: 
<activity>
  ...
  tools:replace="android:theme"
  ...
</activity>

iOS

1. Wie gehe ich vor, wenn die folgende Warnung angezeigt wird?
[!] Unable to find a specification for FBSDKMarketingKit
Führe zuerst pod update und anschließend pod install --repo-update aus.