Uygulama içi yorumları entegre edin (Yerel)

Bu kılavuzda, yerel reklamları kullanarak uygulama içi yorumları uygulamanıza nasıl entegre edeceğiniz açıklanmaktadır (C veya C++) kodunu ekleyebilirsiniz. Kotlin kullanıyorsanız ayrı entegrasyon kılavuzları vardır. veya Java ya da Unity.

Yerel SDK'ya genel bakış

Play Core Yerel SDK'sı, Google Play Core kitaplıklarının bir parçasıdır. aile. Play Core Yerel SDK'sı, C başlık dosyası (review.h) içerir. sarma ReviewManager Google Play In-App Review kitaplıklarındaki Bu başlık dosyası, uygulamanızın şunu yapmasına olanak tanır: API'yi doğrudan yerel kodunuzdan çağırın. Genel bilgiler için özellikleri görmek için Play İnceleme yerel modülüne dokümanlarına göz atın.

ReviewManager_requestReviewFlow açılış sayfası için gereken bilgileri toplayan bir istek inceleme akışını takip edebilir. İsteğin sonucunu ReviewManager_getReviewStatus. ReviewManager_getReviewStatus dönebilir. (bkz. ReviewErrorCode.)

Hem istek hem de başlatma işlevleri REVIEW_NO_ERROR değerini döndürürse işlevi başarılı olur.

Geliştirme ortamınızı ayarlama

İndir Play Core Native SDK

İndirmeden önce aşağıdaki şartlar ve koşulları kabul etmeniz gerekir.

Hükümler ve Koşullar

Last modified: September 24, 2020
  1. By using the Play Core Software Development Kit, you agree to these terms in addition to the Google APIs Terms of Service ("API ToS"). If these terms are ever in conflict, these terms will take precedence over the API ToS. Please read these terms and the API ToS carefully.
  2. For purposes of these terms, "APIs" means Google's APIs, other developer services, and associated software, including any Redistributable Code.
  3. “Redistributable Code” means Google-provided object code or header files that call the APIs.
  4. Subject to these terms and the terms of the API ToS, you may copy and distribute Redistributable Code solely for inclusion as part of your API Client. Google and its licensors own all right, title and interest, including any and all intellectual property and other proprietary rights, in and to Redistributable Code. You will not modify, translate, or create derivative works of Redistributable Code.
  5. Google may make changes to these terms at any time with notice and the opportunity to decline further use of the Play Core Software Development Kit. Google will post notice of modifications to the terms at https://developer.android.com/guide/playcore/license. Changes will not be retroactive.
İndirin: Play Core Native SDK

play-core-native-sdk-1.14.0.zip

  1. Aşağıdakilerden birini yapın:

    • Android Studio'nun 4.0 veya sonraki bir sürümünü yükleyin. SDK'yı kullanma Android SDK Platformu 10.0 (API düzeyi 29) sürümünü yüklemek için Yönetici kullanıcı arayüzü.
    • Android SDK komut satırı araçlarını yükleme ve yüklemek için sdkmanager'ı kullanın Android SDK Platform 10.0 sürümü (API düzeyi 29).

  2. Şunu kullanarak Android Studio'yu yerel geliştirme için hazırlayın: En yeni sürümü yüklemek için SDK Yöneticisi CMake ve Android Yerel Geliştirme Kiti (NDK). Daha fazla bilgi için yerel projeler oluşturmayı veya içe aktarmayı öğrenmek için NDK'yı Kullanmaya Başlama.

  3. ZIP dosyasını indirin ve projenizle birlikte çıkarın.

    Bağlantıyı İndir Boyut SHA-256 Sağlaması
    36 MiB 782a8522d937848c83a715c9a258b95a3ff2879a7cd71855d137b41c00786a5e

  4. Uygulamanızın build.gradle dosyasını aşağıda gösterildiği gibi güncelleyin:

    Eski

        // 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. Uygulamanızın CMakeLists.txt dosyalarını aşağıda gösterildiği gibi güncelleyin:

    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
        ...)

Veri Toplama

Play Core Yerel SDK'sı, Google'ın şunları yapmasına izin vermek için sürümle ilgili verileri toplayabilir: Aşağıdakiler dahil olmak üzere ürünü iyileştirmek için:

  • Uygulamanın paket adı
  • Uygulamanın paket sürümü
  • Play Core Yerel SDK sürümü

Bu veriler, uygulama paketinizi yüklediğinizde toplanır. Play Console'a yükleyebilirsiniz. Bu veri toplama işlemini devre dışı bırakmak için Build.gradle dosyasında $playcoreDir/playcore-native-metadata.jar içe aktarması yapın.

Bu veri toplama işlemi, Play Core Yerel SDK ve Google'ın toplanan verileri kullanımı Google'ın uygulamanızı yüklediğinizde Gradle'da tanımlanan kitaplık bağımlılıkları koleksiyonu Play Console'a geri yükleyebilirsiniz.

Play Core Yerel SDK'sını projenize entegre ettikten sonra API çağrıları içeren dosyalarda aşağıdaki satırı ekleyin:

Review.h

Play Core Yerel SDK'sını projenize entegre ettikten sonra, API çağrıları içerecek dosyalarda aşağıdaki satırı ekleyin:

#include "play/review.h"

Review API'yi başlatma

API'yi kullanmak istediğinizde ReviewManager_init aşağıdaki örnekte gösterildiği gibi, 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.
  }
}

Uygulama içi inceleme akışı isteğinde bulunma

Ne zaman uygulama içi istekte bulunacağınızla ilgili talimatları uygulayın. incelemeden yararlanarak iyi puanları kullanıcının inceleme yapmasını istemek için (örneğin, Kullanıcı oyundaki bir seviyenin sonunda özet ekranını kapatır. bu noktalardan birine yaklaştığında ReviewManager_requestReviewFlow uygulamanızın bir istek başlatabilmesi için gereken bilgileri inceleyebilirsiniz. Çağrı yaparak ReviewManager_requestReviewFlow işlemi ReviewManager_getReviewStatus, örneğin her karede bir kez. Bu işlem birkaç saniye kadar sürebilir. Bu nedenle Bu işlemi, uygulamanız istediğiniz noktaya gelmeden önce başlatmalı uygulama içi inceleme akışını gösterir.

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.
}

Durumları yönetme ve uygulama içi inceleme akışını başlatma

Bir istek başlatıldığında veya uygulama içi inceleme akışı başlatıldığında durumu kontrol etmek için ReviewManager_getReviewStatus. Bu sayede API durumuna bağlı olarak mantığı tanımlayabilirsiniz. Paydaşların ihtiyaçlarını durumu genel değişken olarak tutmak ve kullanıcı belirli bir işlem gerçekleştirdiğinde durum REVIEW_REQUEST_FLOW_COMPLETED olur aşağıdaki adımları izleyerek bir oyunda "Sonraki Seviye" düğmesine dokunmak gibi şu örneği inceleyin:

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;
}

Durum REVIEW_REQUEST_FLOW_COMPLETED olduğunda ve uygulamanız hazır olduğunda başlatın inceleyebilirsiniz:

// 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;
}

Uygulama içi inceleme akışını başlattıktan sonra tamamlanma durumunu kontrol etmeye devam edin ve uygulama akışınıza devam edin. Bunu yönetmenin yaygın bir yolu, Oyun Döngüsü kalıbına uygun şekilde.

Ücretsiz kaynaklar

ReviewManager_destroy numaralı telefonu arayarak ücretsiz kaynakları edinmeyi unutmayın işlevini kullanarak (örneğin, uygulama içi API'dan sonra inceleme akışı tamamlanır).

void ReviewManager_destroy();

Sonraki adımlar

Uygulamanızın uygulama içi inceleme akışını test ederek entegrasyonunuzun düzgün çalıştığını doğrulayın.