In-App-Überprüfungen einbinden (nativ)

In diesem Leitfaden wird beschrieben, wie Sie In-App-Rezensionen mithilfe von nativen Anzeigen in Ihre App einbinden. C oder C++ Code. Wenn Sie Kotlin verwenden, finden Sie separate Anleitungen zur Integration. oder Java oder Unity:

Native SDK – Übersicht

Das Play Core Native SDK ist Teil der Google Play Core-Bibliotheken. Familie. Das Play Core Native SDK enthält die C-Headerdatei review.h, die umfängt ReviewManager aus den Java Play In-App-Rezensionsbibliotheken. Mit dieser Headerdatei kann Ihre App können Sie die API direkt aus Ihrem nativen Code aufrufen. Einen Überblick über die Öffentlichkeit verfügbaren Funktionen finden Sie im Artikel Play Review-Native-Modul Dokumentation.

ReviewManager_requestReviewFlow startet eine Anfrage, mit der die Informationen erfasst werden, die zum Starten der den In-App-Überprüfungsprozess durchlaufen. Sie können das Ergebnis der Anfrage ReviewManager_getReviewStatus Weitere Informationen zu den Status, die ReviewManager_getReviewStatus zurückzugeben, siehe ReviewErrorCode.

Sowohl die Anfrage- als auch die Startfunktion geben REVIEW_NO_ERROR zurück, wenn erfolgreich ist.

Entwicklungsumgebung einrichten

1. Sie haben folgende Möglichkeiten:

   • Installieren Sie Android Studio Version 4.0 oder höher. SDK verwenden Manager-UI zur Installation der Android SDK Platform Version 10.0 (API-Level 29)
   • Installieren Sie die Android SDK-Befehlszeilentools. und verwende sdkmanager zum Installieren Android SDK Platform Version 10.0 (API-Level 29):

2. Bereiten Sie Android Studio für die native Entwicklung mit der SDK-Manager, um die neueste CMake und Android Native Development Kit (NDK) Weitere Informationen zu native Projekte erstellen oder importieren, finden Sie unter Erste Schritte mit dem NDK

3. Lade die ZIP-Datei herunter und entpacke sie zusammen mit deinem Projekt.

   Downloadlink	Größe	SHA-256-Prüfsumme
   play-core-native-sdk-1.14.0.zip	36 MiB	782a8522d937848c83a715c9a258b95a3ff2879a7cd71855d137b41c00786a5e

4. Aktualisieren Sie die Datei build.gradle Ihrer App wie unten gezeigt:

   Cool

       // App build.gradle
   
       plugins {
         id 'com.android.application'
       }
   
       // Define a path to the extracted Play Core SDK files.
       // If using a relative path, wrap it with file() since CMake requires absolute paths.
       def playcoreDir = file('../path/to/playcore-native-sdk')
   
       android {
           defaultConfig {
               ...
               externalNativeBuild {
                   cmake {
                       // Define the PLAYCORE_LOCATION directive.
                       arguments "-DANDROID_STL=c++_static",
                                 "-DPLAYCORE_LOCATION=$playcoreDir"
                   }
               }
               ndk {
                   // Skip deprecated ABIs. Only required when using NDK 16 or earlier.
                   abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
               }
           }
           buildTypes {
               release {
                   // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.
                   proguardFile '$playcoreDir/proguard/common.pgcfg'
                   proguardFile '$playcoreDir/proguard/gms_task.pgcfg'
                   proguardFile '$playcoreDir/proguard/per-feature-proguard-files'
                   ...
               }
               debug {
                   ...
               }
           }
           externalNativeBuild {
               cmake {
                   path 'src/main/CMakeLists.txt'
               }
           }
       }
   
       dependencies {
           // Import these feature-specific AARs for each Google Play Core library.
           implementation 'com.google.android.play:app-update:2.1.0'
           implementation 'com.google.android.play:asset-delivery:2.2.2'
           implementation 'com.google.android.play:integrity:1.4.0'
           implementation 'com.google.android.play:review:2.0.1'
   
           // Import these common dependencies.
           implementation 'com.google.android.gms:play-services-tasks:18.0.2'
           implementation files("$playcoreDir/playcore-native-metadata.jar")
           ...
       }
       

   Kotlin

   // App build.gradle
   
   plugins {
       id("com.android.application")
   }
   
   // Define a path to the extracted Play Core SDK files.
   // If using a relative path, wrap it with file() since CMake requires absolute paths.
   val playcoreDir = file("../path/to/playcore-native-sdk")
   
   android {
       defaultConfig {
           ...
           externalNativeBuild {
               cmake {
                   // Define the PLAYCORE_LOCATION directive.
                   arguments += listOf("-DANDROID_STL=c++_static", "-DPLAYCORE_LOCATION=$playcoreDir")
               }
           }
           ndk {
               // Skip deprecated ABIs. Only required when using NDK 16 or earlier.
               abiFilters.clear()
               abiFilters += listOf("armeabi-v7a", "arm64-v8a", "x86", "x86_64")
           }
       }
       buildTypes {
           release {
               // Include Play Core Library proguard config files to strip unused code while retaining the Java symbols needed for JNI.
               proguardFile("$playcoreDir/proguard/common.pgcfg")
               proguardFile("$playcoreDir/proguard/gms_task.pgcfg")
               proguardFile("$playcoreDir/proguard/per-feature-proguard-files")
               ...
           }
           debug {
               ...
           }
       }
       externalNativeBuild {
           cmake {
               path = "src/main/CMakeLists.txt"
           }
       }
   }
   
   dependencies {
       // Import these feature-specific AARs for each Google Play Core library.
       implementation("com.google.android.play:app-update:2.1.0")
       implementation("com.google.android.play:asset-delivery:2.2.2")
       implementation("com.google.android.play:integrity:1.4.0")
       implementation("com.google.android.play:review:2.0.1")
   
       // Import these common dependencies.
       implementation("com.google.android.gms:play-services-tasks:18.0.2")
       implementation(files("$playcoreDir/playcore-native-metadata.jar"))
       ...
   }
   

5. Aktualisieren Sie die CMakeLists.txt-Dateien Ihrer App wie unten gezeigt:

   cmake_minimum_required(VERSION 3.6)
   
   ...
   
   # Add a static library called “playcore” built with the c++_static STL.
   include(${PLAYCORE_LOCATION}/playcore.cmake)
   add_playcore_static_library()
   
   // In this example “main” is your native code library, i.e. libmain.so.
   add_library(main SHARED
           ...)
   
   target_include_directories(main PRIVATE
           ${PLAYCORE_LOCATION}/include
           ...)
   
   target_link_libraries(main
           android
           playcore
           ...)
   

Datenerhebung

Das Play Core Native SDK kann versionsbezogene Daten erheben, damit Google Folgendes tun kann: das Produkt zu verbessern, einschließlich:

• Paketname der App
• Paketversion der App
• Version des Core Native SDK

Diese Daten werden erhoben, wenn Sie Ihr App-Paket hochladen in der Play Console. Wenn Sie die Datenerhebung deaktivieren möchten, entfernen Sie die $playcoreDir/playcore-native-metadata.jar-Import in der build.gradle-Datei.

Die Datenerhebung bezieht sich auf deine Nutzung des Play Core Native SDK und Die Verwendung der erhobenen Daten durch Google erfolgt getrennt und unabhängig vom Sammlung von Bibliotheksabhängigkeiten, die beim Hochladen Ihrer App in Gradle deklariert wurden an die Play Console zu senden.

Nachdem du das Play Core Native SDK in dein Projekt integriert hast, füge das Feld folgende Zeile in Dateien mit API-Aufrufen:

"review.h" einschließen

Füge nach der Integration des Play Core Native SDK in dein Projekt den folgende Zeile in den Dateien, die API-Aufrufe enthalten:

#include "play/review.h"

Review API initialisieren

Wann immer Sie die API verwenden möchten, müssen Sie sie zuerst initialisieren, indem Sie die Methode ReviewManager_init aus, wie im folgenden Beispiel gezeigt, das mit android_native_app_glue.h:

void android_main(android_app* app) {
  app->onInputEvent = HandleInputEvent;

  ReviewErrorCode error_code = ReviewManager_init(app->activity->vm, app->activity->clazz);
  if (error_code == REVIEW_NO_ERROR) {
    // You can use the API.
  }
}

In-App-Überprüfungsprozess anfordern

Folgen Sie der Anleitung zum Anfordern einer In-App-Anfrage. Rezensionen, um die besten Punkte zu ermitteln. im User Flow Ihrer App, um den Nutzer zu einer Rezension aufzufordern (z. B. nach einer Der Nutzer schließt die Zusammenfassung am Ende eines Levels in einem Spiel. Wenn Ihr und die App an einem dieser Punkte nah dran ist, rufen Sie ReviewManager_requestReviewFlow um die Informationen asynchron anzufordern, die Ihre App zum Starten eines den In-App-Überprüfungsprozess. Überwachen Sie den Fortschritt der ReviewManager_requestReviewFlow-Vorgang durch Aufrufen von ReviewManager_getReviewStatus, zum Beispiel einmal pro Frame. Dies kann einige Sekunden dauern. sollte diesen Prozess beginnen, bevor Ihre App den Punkt erreicht, an dem Sie den In-App-Überprüfungsablauf zeigen.

ReviewErrorCode error_code = ReviewManager_requestReviewFlow();
if (error_code == REVIEW_NO_ERROR) {
    // The request has successfully started, check the status using
    // ReviewManager_getReviewStatus.
} else {
    // Error such as REVIEW_PLAY_STORE_NOT_FOUND indicating that the in-app
    // review isn't currently possible.
}

Status bearbeiten und In-App-Überprüfungsprozess starten

Sobald eine Anfrage begonnen oder der In-App-Überprüfungsprozess gestartet wird, haben Sie folgende Möglichkeiten: überprüfen Sie den Status mit ReviewManager_getReviewStatus So können Sie die Logik abhängig vom API-Status definieren. Eine Möglichkeit, um besteht darin, den Status als globale Variable beizubehalten und zu prüfen, ob der Der Status ist REVIEW_REQUEST_FLOW_COMPLETED, wenn der Nutzer eine bestimmte (z. B. das Tippen auf die Schaltfläche „Nächstes Level“ in einem Spiel), wie in den folgendes Beispiel:

ReviewStatus status;
ReviewErrorCode error_code = ReviewManager_getReviewStatus(&status);
if (error_code != REVIEW_NO_ERROR) {
    // There was an error with the most recent operation.
    return;
}

switch (status) {
    case REVIEW_REQUEST_FLOW_PENDING:
        // Request is ongoing. The flow can't be launched yet.
        break;
    case REVIEW_REQUEST_FLOW_COMPLETED:
        // Request completed. The flow can be launched now.
        break;
    case REVIEW_LAUNCH_FLOW_PENDING:
        // The review flow is ongoing, meaning the dialog might be displayed.
        break;
    case REVIEW_LAUNCH_FLOW_COMPLETED:
        // The review flow has finished. Continue with your app flow (for
        // example, move to the next screen).
        break;
    default:
        // Unknown status.
        break;
}

Wenn der Status REVIEW_REQUEST_FLOW_COMPLETED lautet und Ihre App bereit ist, starten In-App-Überprüfungsprozess:

// This call uses android_native_app_glue.h.
ReviewErrorCode error_code = ReviewManager_launchReviewFlow(app->activity->clazz);
if (error_code != REVIEW_NO_ERROR) {
    // There was an error while launching the flow.
    return;
}

Nachdem du den In-App-Überprüfungsprozess gestartet hast, solltest du den Status regelmäßig prüfen, um den Vorgang abzuschließen und fahre mit dem App-Flow fort. Eine gängige Methode zur Behebung dieses Problems besteht darin, gemäß dem Game Loop-Muster.

Kostenlose Ressourcen

Vergessen Sie nicht, Ressourcen über den Aufruf der ReviewManager_destroy kostenlos bereitzustellen. sobald Ihre App die API nicht mehr verwendet (z. B. nach der In-App- Überprüfungsvorgang abgeschlossen ist).

void ReviewManager_destroy();

Nächste Schritte

Teste den In-App-Überprüfungsprozess deiner App, um prüfen, ob die Integration korrekt funktioniert.