Перейти к основному содержимому
Версия: 3.4.0-beta.2

Покупки В Приложении

к сведению

Отслеживание покупок в приложении будет работать только при подключении к Adjust или AppsFlyer. Чтобы подключить их, следуйте этому руководству для Adjust и этому руководству для AppsFlyer.

Можно отслеживать информацию о покупках в приложении и отправлять информацию на серверы Appodeal для аналитики. Это позволяет группировать пользователей по факту покупки. Это поможет вам настроить рекламу для таких пользователей или просто отключить ее, если это необходимо. Чтобы эта настройка работала правильно, отправьте информацию о покупке через Appodeal SDK.


Шаг 1. Отслеживание Покупок В Приложении

к сведению

Если вы используете собственный Adjust аккаунт, вам нужно выполнить шаг 2 из нашей Event Tracking инструкции и создать обязательные события на стороне Adjust.

Чтобы все работало правильно, отправьте информацию о покупке через Appodeal SDK.

к сведению

Следуйте официальной инструкции Unity IAP чтобы настроить покупки и получать информацию о покупках.

#if UNITY_ANDROID
var additionalParams = new Dictionary<string, string> { { "key1", "value1" }, { "key2", "value2" } };

var purchase = new PlayStoreInAppPurchase.Builder(PlayStorePurchaseType.Subs)
.WithAdditionalParameters(additionalParams)
.WithPurchaseTimestamp(793668600)
.WithDeveloperPayload("payload")
.WithPurchaseToken("token")
.WithPurchaseData("data")
.WithPublicKey("key")
.WithSignature("signature")
.WithCurrency("USD")
.WithOrderId("orderId")
.WithPrice("1.99")
.WithSku("sku")
.Build();

Appodeal.ValidatePlayStoreInAppPurchase(purchase, this);
#elif UNITY_IOS
var additionalParams = new Dictionary<string, string> { { "key1", "value1" }, { "key2", "value2" } };

var purchase = new AppStoreInAppPurchase.Builder(AppStorePurchaseType.Consumable)
.WithAdditionalParameters(additionalParams)
.WithTransactionId("transactionId")
.WithProductId("productId")
.WithCurrency("USD")
.WithPrice("2.89")
.Build();

Appodeal.ValidateAppStoreInAppPurchase(purchase, this);
#endif
примечание

Для Android:

Убедитесь, что если вы создали продукт в приложении в разделе Google Play Console → Monetize, то используйте:

  • PlayStorePurchaseType.InApp для внутриигровых покупок.
  • PlayStorePurchaseType.Subs для подписок.

Для iOS:

Убедитесь, что если вы создали продукт в приложении в App Store Connect, то используйте:

  • AppStorePurchaseType.Consumable или AppStorePurchaseType.NonConsumable для внутриигровых покупок.
  • AppStorePurchaseType.AutoRenewableSubscription или AppStorePurchaseType.NonRenewingSubscription для подписок.
ПараметрОписаниеИспользование
purchaseTypeТип покупки. Должен быть InApp или SubsAdjust/AppsFlyer
publicKeyПубличный ключ из Google Developer ConsoleAppsFlyer
signatureПодпись транзакции (возвращается из Google API после завершения покупки)Adjust/AppsFlyer
purchaseDataПродукт, приобретенный в формате JSON (возвращается из Google API после завершения покупки)AppsFlyer
purchaseTokenТокен приобретенного продукта (возвращается из Google API после завершения покупки)Adjust
purchaseTimestampОтметка времени покупки продукта (возвращается из Google API после завершения покупки)Adjust
developerPayloadПолезная нагрузка разработчика в приобретенном продукте (возвращается из Google API после завершения покупки)Adjust
orderIdУникальный идентификатор заказа для транзакции приобретенного продукта (возвращается из Google API после завершения покупки)Adjust
skuУникальный идентификатор единицы товараAdjust
priceДоход от события в приложенииAdjust/AppsFlyer/Appodeal
currencyВалюта события в приложенииAdjust/AppsFlyer/Appodeal
additionalParametersДопольнительные параметры in-app события-
transactionIdНекоторый идентификатор транзакцииAdjust/AppsFlyer
productIdНекоторый идентификатор продуктаAdjust/AppsFlyer
Обязательные Параметры:

Для iOS

  • Все параметры являются обязательными

Для Android

  • purchaseType
  • purchaseToken
  • developerPayload
  • sku
  • price
  • currency
  • additionalParameters

Шаг 2. Методы Обратного Вызова

Методы обратного вызова позволяют отслеживать успешные и неудачные покупки в приложении. Для использования этих методов выполните следующие действия:

  1. Подпишитесь на желаемое событие In-App Purchase, используя один из методов из нашей инструкции. (вы можете подписаться к любому событию, которому захотите)
  2. Вы можете использовать методы обратного вызова как показано ниже:
public void SomeMethod()
{
AppodealCallbacks.InAppPurchase.OnValidationSucceeded += OnInAppPurchaseValidationSucceeded;
AppodealCallbacks.InAppPurchase.OnValidationFailed += OnInAppPurchaseValidationFailed;
}

#region InAppPurchaseValidation Callbacks

private void OnInAppPurchaseValidationSucceeded(object sender, InAppPurchaseEventArgs e)
{
Debug.Log("In-App Purchase Validation Succeeded");
}

private void OnInAppPurchaseValidationFailed(object sender, InAppPurchaseEventArgs e)
{
Debug.Log("In-App Purchase Validation Failed");
}

#endregion

Шаг 3. Создайте Файл Json В Google Cloud (Только Для Android)

  1. Войдите в Google Cloud со своими учетными данными.
  2. Выберите Google Play Console Developer проект в левом верхнем углу, как показано ниже.
примечание

Убедитесь, что на этом шаге выбран Google Play Console Developer, а не конкретный проект вашего приложения. Google Play Console позволяет связывать только облачные проекты Google Play Console Developer (позже на шаге 3).

  1. Выберите Credentials → Create Credentials → Service Account.
  1. Выберите Viewer в качестве роли для Service Account и нажмите Done.
  1. Перейдите в ваш service account и нажмите keys → Add key → choose JSON and отправьте нам файл JSON на электронную почту support@appodeal.com или в чате.

Шаг 4. Добавьте Необходимые Разрешения В Google Play Console (Только Для Android)

  1. Перейдите в Google Play Console и авторизируйтесь.
  2. Перейдите в Google Play Console → Manage developer accounts → Choose developer account → Setup → API Access и выберите свой проект Google Play Console Developer из шага 2, где вы создали свой Service Account.
примечание

Если вы не видите Google Play Console Developer проект в списке, обновите веб-страницу.

Если проблема не устранена, убедитесь, что ваша учетная запись разработчика Google Play (адрес электронной почты) является владельцем проекта Google Cloud. Вы можете прочитать больше здесь.

  1. Внизу будет список ваших Service Accounts, которые доступны в этом проекте Google Cloud. Выберите тот, с которого был отправлен JSON.
Нажмите Refresh, если вы не видите свою учетную запись Service Account.
  1. Выберите View Play Console permissions. В разделе App Permissions выберите необходимые приложения, в которых будут использоваться внутренние события.
  1. Перейдите в раздел Account Permissions и выберите все разрешения для Financial Data:
  • View financial data
  • Manage Orders and subscriptions

Шаг 5. Свяжитесь С Нами

После выполнения всех шагов свяжитесь с нашей службой поддержки по электронной почте support@appodeal.com или в чате со следующей информацией:

  1. JSON-файл вашего Service Account. (Только для Android)
  2. Логика реализации покупок в вашем приложении (когда и где вы вызываете метод валидации покупок и валидируете покупки)
  3. Предоставьте нам доступ для тестирования покупки через Google Developer console по электронной почте support@appodeal.com. (Только для Android)
  4. Ваш apk файл в архиве zip для тестирования. (Только для Android)
  5. Предоставьте нам доступ для тестирования покупки в приложении и отправьте testflight по электронной почте support@appodeal.com. (Только для iOS)

Шаг 6. Тестирование

После того, как вы связались с нашей службой поддержки и предоставили всю необходимую информацию, вы можете протестировать свое приложение, чтобы убедиться, что покупки валидированы.

  1. Перейдите по пути App Settings → Attribution Settings и измените Adjust Environment с Production на Sandbox, чтобы протестировать валидацию покупок и не забудьте нажать Save в конце страницы.
  1. Подключите ваше устройство к компьютеру с открытой консолью (Android Studio logcat или iOS Console) и отсортируйте логи по слову purchase.
  2. Теперь вы можете открыть свое приложение и совершить пробную покупку. Если в консоли отображается надпись Valid Purchase, значит, валидация прошла успешно.
  3. Если валидация не прошла успешно, то повторите все шаги, описанные выше, и убедитесь, что все шаги выполнены.
  4. После тестирования, смените ваш Adjust Environment на Production по пути App Settings → Attribution Settings.