In-App-Rezensionen einbinden (Unreal Engine)

In diesem Leitfaden wird beschrieben, wie Sie In-App-Rezensionen mit Unreal Engine in Ihre App einbinden. Für Kotlin oder Java, nativen Code oder Unity gibt es separate Integrationsanleitungen.

Unreal Engine SDK – Übersicht

Die Play In-App Reviews API ist Teil der Play Core SDK-Familie. Die API für die Unreal Engine bietet eine UInAppReviewsManager-Klasse, mit der der Ablauf mithilfe der Methoden RequestReviewFlow und LaunchReviewFlow angefordert und gestartet werden kann. Nach einer Anfrage kann Ihre App den Status der Anfrage mit EInAppReviewErrorCode prüfen.

Unterstützte Unreal Engine-Versionen

Das Plug-in unterstützt Unreal Engine 5.0 und alle nachfolgenden Versionen.

Entwicklungsumgebung einrichten

1. Lade das Play Unreal Engine-Plug-in aus dem GitHub-Repository herunter.

2. Kopieren Sie den Ordner GooglePlay in den Ordner Plugins in Ihrem Unreal Engine-Projekt.

3. Öffnen Sie Ihr Unreal Engine-Projekt und klicken Sie auf Bearbeiten → Plug-ins.

4. Suchen Sie nach Google Play und klicken Sie das Kästchen Aktiviert an.

5. Starten Sie das Spielprojekt neu und lösen Sie einen Build aus.

6. Öffnen Sie die Build.cs-Datei Ihres Projekts und fügen Sie PublicDependencyModuleNames das PlayInAppReviews-Modul hinzu:

   using UnrealBuildTool;
   
   public class MyGame : ModuleRules
   {
     public MyGame(ReadOnlyTargetRules Target) : base(Target)
     {
       // ...
   
       PublicDependencyModuleNames.Add("PlayInAppReviews");
   
       // ...
     }
   }
   

In-App-Überprüfung beantragen

Folgen Sie der Anleitung unter Wann Sie In-App-Rezensionen anfordern sollten, um geeignete Stellen im Nutzerfluss Ihrer App zu ermitteln, an denen Sie Nutzer um eine Rezension bitten können (z. B. nachdem ein Nutzer den Zusammenfassungsbildschirm am Ende eines Levels in einem Spiel geschlossen hat). Wenn sich Ihre App einem dieser Punkte nähert, verwenden Sie den Vorgang UInAppReviewsManager create, wie im folgenden Beispiel gezeigt:

MyClass.h

void MyClass::OnReviewOperationCompleted(EInAppReviewErrorCode ErrorCode)
{
  // ...
}

MyClass.cpp

void MyClass::RequestReviewFlow()
{
  // Create a delegate to bind the callback function.
  FReviewOperationCompletedDelegate Delegate;

  // Bind the completion handler (OnReviewOperationCompleted) to the delegate.
  Delegate.BindDynamic(this, &MyClass::OnReviewOperationCompleted);

  // Initiate the review flow, passing the delegate to handle the result.
  GetGameInstance()
    ->GetSubsystem<UInAppReviewsManager>()
    ->RequestReviewFlow(Delegate);
}

1. Die Methode erstellt eine FRreviewOperationCompletedDelegate, um den Abschluss des Überprüfungsvorgangs zu verwalten.

2. Der Delegate ist an die Methode OnReviewOperationCompleted gebunden, die aufgerufen wird, sobald der Vorgang abgeschlossen ist.

3. Die Funktion BindDynamic sorgt dafür, dass der Delegate ordnungsgemäß mit dem Rückruf verknüpft ist.

4. Die Methode RequestReviewFlow(Delegate) startet den Überprüfungsprozess und übergibt den Delegaten, um das Ergebnis zu verarbeiten.

5. Der Überprüfungsvorgang wird asynchron ausgeführt, sodass andere Aufgaben in der App fortgesetzt werden können, während er abgeschlossen wird.

6. Nach Abschluss des Vorgangs wird das Ergebnis (Erfolg oder Fehler) über den OnReviewOperationCompleted-Callback verarbeitet.

In-App-Überprüfung starten

Sobald der Vorgang RequestReviewFlow abgeschlossen ist, können Sie die In-App-Überprüfung starten. Dazu wird ein Delegat für die Verarbeitung des Abschlussereignisses gebunden, damit die App auf das Ergebnis (Erfolg oder Fehlschlag) der Überprüfungsanfrage reagiert.

MyClass.h

void MyClass::OnReviewOperationCompleted(EInAppReviewErrorCode ErrorCode)
{
  // ...
}

MyClass.cpp

void MyClass::LaunchReviewFlow()
{
  // Create a delegate to bind the callback function.
  FReviewOperationCompletedDelegate Delegate;

  // Bind the completion handler (OnReviewOperationCompleted) to the delegate.
  Delegate.BindDynamic(this, &MyClass::OnReviewOperationCompleted);

  // Launch the review flow, passing the delegate to handle the result.
  GetGameInstance()
    ->GetSubsystem<UInAppReviewsManager>()
    ->LaunchReviewFlow(Delegate);
}

Nächste Schritte

Testen Sie den In-App-Überprüfungsablauf Ihrer App, um zu prüfen, ob Ihre Integration ordnungsgemäß funktioniert.