Bevor Sie anfangen
Anforderungen
Das Vungle Unity-Plugin unterstützt Unity Editor Version 2017 und höher und enthält folgende Vungle SDK-Versionen.
iOS SDK v6.8.0
- iOS 9 oder höher
Android SDK v6.8.0
- Android 4.0 (Ice Cream Sandwich – API-Version 14 und höher)
- Amazon OS 5.4 und höher
- Benötigt Java 1.7 oder höher für Android
Windows SDK v6.8.0
- Windows 10 UWP und Universal 8.1
Laden Sie das Plugin herunter
Laden Sie das Vungle-Plugin für Unity hier herunter: https://publisher.vungle.com/sdk/plugins/unity
Referenz: Beispiel-App
Unterstützende Hinweise für die Integration liefert Ihnen unsere Beispiel-App: https://github.com/Vungle/Unity-Plugin
Schritt 1. Richten Sie Ihr Unity Projekt mit dem Vungle Unity Plugin ein
Fügen Sie das Vungle Unity Plugin Ihrem Unity Projekt hinzu
Doppelklicken Sie bei geöffnetem Projekt unter Unity auf die heruntergeladene Datei VunglePlugin.unitypackage, um das Vungle Unity Plugin Ihrer Anwendung hinzuzufügen. Wenn sich das Fenster Unity Paket importieren öffnet, klicken Sie auf alle, um vor dem Import alles auszuwählen.
Adressieren Sie in Ihren Build Settings die richtige Plattform
Um Kompilierungsfehler während des nächsten Schrittes zu vermeiden, müssen Sie überprüfen, ob die Build Settings (Cmd + Shift + B) Ihres Projekts für eine iOS-, Android- oder Universal-Windows-Plattform eingerichtet sind.
Amazon Appstore
Vungle Android SDK unterstützt Amazon OS 5.4 und höher. Sie können Android APK an den Amazon Appstore mit der zusätzlichen Einstellung der Unity Amazon Appstore-Konfiguration übermitteln. Weitere Informationen finden Sie in den Unity-Anleitungen.
Google Play Services
Wenn Sie Google Play-Dienste in Ihr Projekt integrieren, kann Vungle besser auf die Endbenutzer zugeschnittene Werbung bereitstellen. Dies ist aber nicht zwingend erforderlich. Wir empfehlen Version 16.0.0 oder höher.
Zur Integration der Google Play Services empfehlen wir Google's Setup Guide im Entwicklerportal. Stellen Sie in Ihrer App sicher, dass das Gerät über eine ausreichend aktuelle Version von Google Play Services verfügt.
Android-Abhängigkeiten
Vungle SDK für Android erfordert die Aufnahme der folgenden Abhängigkeiten in Ihren Build. Fügen Sie sie entweder manuell oder über eine Gradle-Vorlage ein, sofern Sie Gradle verwenden.
implementation 'androidx.appcompat:appcompat:1.2.0'
// When appcompat is not used, core and localbroadcastmanager can be used instead
// implementation "androidx.core:core:1.3.1"
// implementation "androidx.localbroadcastmanager:localbroadcastmanager:1.0.0" hardwareAccelerated für Android hinzufügen (Unity 2018.1 und niedriger)
hardwareAccelerated ist erforderlich, damit das Vungle SDK MREC-Anzeigen korrekt anzeigen kann. Unity zwingt diese Eigenschaft auf false, auch wenn sie in AndroidManifest.xml innerhalb Ihres Unity-Projekts auf true gesetzt ist. Das Vungle-Plugin setzt sie mit Hilfe des Gradle-Postprozessor-Skripts, das für 2018.2 und höher verfügbar ist, auf true. Bei Publishern, die 2018.1 und niedriger, einschließlich 2017, verwenden, muss das Projekt in Android Studio exportiert und die Konfiguration hardwareAccelerated mit dem Wert true hinzugefügt werden.
Beispielcode:
<application android:hardwareAccelerated="true" ...>Projektkonfiguration Universelle Windows-Plattform
Befolgen Sie die Anweisungen in unserem Artikel Vungle Unity Plugin für Windows SDK vorbereiten, um ein UWP-Projekt zu konfigurieren.
Schritt 2: Fügen Sie Programmcode ein
In dieser Anleitung initialisieren wir den gesamten Vungle-bezogenen Code in einem Skript, das dem Haupt-SpielObjekt beigefügt ist. Sie können das Vungle Unity Plugin aus allen Skripten heraus aufrufen, die Sie als geeignet ansehen.
Initialisieren Sie das SDK
Initialisieren Sie das SDK, sobald Ihre App startet, damit dem SDK ausreichend Zeit zum Cachen einer Werbeanzeige bleibt. Sie benötigen zur Initialisierung des SDK die App-ID für alle Plattformen, die unterstützt werden sollen. Diese IDs finden Sie im Vungle Dashboard (weitere Informationen unter "Einrichtung von und Berichte über Platzierungen").
Eine Standard-Platzierung wird automatisch für jede App erstellt. Sie müssen die Platzierungs-ID der jeweiligen App in diesem Initialisierungsschritt bereitstellen, auch wenn Sie nicht von der Platzierungsfunktion Gebrauch machen möchten. Bei der Erstellung mehrerer Platzierungen müssen Sie alle Platzierungs-IDs angeben.
Beispielcode:
public class VungleScript : MonoBehaviour {
string appID = "";
string iosAppID = "ios_app_id";
string androidAppID = "android_app_id";
string windowsAppID = "windows_app_id";
#if UNITY_IPHONE
appID = iosAppID;
#elif UNITY_ANDROID
appID = androidAppID;
#elif UNITY_WSA_10_0 || UNITY_WINRT_8_1 || UNITY_METRO
appID = windowsAppID;
#endif
Vungle.init(appID);
}Sobald das SDK erfolgreich initialisiert wurde, ruft es das folgende Event auf:
public static event Action onInitializeEvent;Sehen Sie im Abschnitt "Event Handling“ des Anzeigenformat Artikels Ihrer Wahl nach.
Wenden Sie sich an Ihren Kontomanager, um Informationen zu Cache-optimierten Platzierungen zu erhalten und die Caching-Leistung zu maximieren.
Sobald eine Werbung erfolgreich gecacht wurde, wird das Ereignis adPlayableEvent mit der Referenz-ID der Platzierung aufgerufen, die zu Ihrer Platzierung passt. Im Anzeigenformat-Artikel Ihrer Wahl finden Sie weitere Einzelheiten.
Anzeigenformate integrieren
Schließen Sie Ihre Plugin-Integration für jedes Anzeigenformat ab, das Sie in Ihrer Anwendung anzeigen möchten. Beachten Sie unsere Anweisungen für jedes Anzeigenformat:
Passen Sie Ihre Anzeigen weiter an
Folgen Sie den Anweisungen in unserem Artikel Erweiterte Einstellungen , um die Integration Ihrer Anwendung mit zusätzlichen Konfigurationsoptionen, wie DSGVO, CCPA-Implementierung und vielen anderen Einstellungen, genauer abzustimmen.