In-app purchases

In-App purchase tracking will work only in connection with Adjust or Appsflyer. To connect them, follow this guide for Adjust and this guide for Appsflyer.

It's possible to track in-app purchase information and send info to Appodeal servers for analytics. It allows to group users by the fact of purchasing in-apps. This will help you to adjust the ads for such users or simply turn it off, if needed. To make this setting work correctly, please submit the purchase info via the Appodeal SDK.

Step 1. Validate In-App Purchases

To make this setting work correctly, please submit the purchase info via Appodeal SDK.

#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

For Android:
Please make sure if you have created in-app product in Google Play Console → Monetize section to use:

  • PlayStorePurchaseType.InApp for purchase type
  • PlayStorePurchaseType.Subs for subscription

For iOS:

Please make sure if you have created in-app product in App Store Connect to use:

  • AppStorePurchaseType.Consumable or AppStorePurchaseType.NonConsumable for purchase type,
  • AppStorePurchaseType.AutoRenewableSubscription or AppStorePurchaseType.NonRenewingSubscription for subscription.

ParameterDescriptionUsage
purchaseTypePurchase type must be InApp or SubsAdjust/AppsFlyer
publicKeyPublic key from Google Developer Console.AppsFlyer
signatureTransaction signature (returned from Google API when the purchase is completed).Adjust/AppsFlyer
purchaseDataProduct purchased in JSON format (returned from Google API when the purchase is completed).AppsFlyer
purchaseTokenProduct purchased token (returned from Google API when the purchase is completed).Adjust
purchaseTimestampProduct purchased timestamp (returned from Google API when the purchase is completed).Adjust
developerPayloadProduct purchased developer payload (returned from Google API when the purchase is completed).Adjust
orderIdProduct purchased unique order id for the transaction (returned from Google API when the purchase is completed).Adjust
skuStock keeping unit id.Adjust
priceIn-app event revenue.Adjust/AppsFlyer/Appodeal
currencyIn-app event currency.Adjust/AppsFlyer/Appodeal
additionalParametersAdditional parameters of the in-app event.
transactionIdsome transaction idAdjust/AppsFlyer
productIdsome product idAdjust/AppsFlyer

All parameters are required for iOS.

Required parameters for Android:

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

If you are using your own Adjust account you need to complete Step 2 from our Event Tracking guide and create some required events on Adjust side.

Step 2. Callbacks

The callbacks are used to track successful and failed in-app purchases. To implement them, you need to follow below steps:

  1. Subscribe to the desired In-App Purchase event using one of the options from this guide. (you can subscribe to any event you want)
  2. You can use callbacks as shown below after:

public void YourMethod()
{
	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

Step 3. Generate Json File In Google Cloud (Android Only)

  1. Login to Google Cloud with your credentials.
  2. Select Google Play Console Developer project on the top left corner as shown below.

    Please make sure to select Google Play Console Developer project at this step instead of your exact app project. Google Play Console only allows to link Google Play Console Developer cloud projects (later on step 3).

  3. Select Credentials →  Create Credentials →  select Service Account.


  4. Select Viewer as a role for Service Account and press Done.


  5. Go to your service account and press keys →  Add key →  choose JSON → and send us the JSON file via email support@appodeal.com or a live chat.

Step 4. Add Required Permissions In Google Play Console (Android Only)

  1. Go to the Google Play Console and log in.
  2. Go to Google Play Console->Manage developer accounts->Choose developer account-> Setup->API Access and choose your Google Play Console Developer project from step 2 where you have created your Service Account. 

    If you are not able to see Google Play Console Developer project in the list then please update the webpage.

    If the issue persists, make sure that your Google Play developer account(email) is the owner of the Google Cloud project. You can read more here.

  3. At the bottom there will be a list of service accounts that are available in this Google Cloud project. Select the one from which the JSON was sent. 

    Press Refresh if you are not able to see your Service Account.



  4. Press View Play Console permissions. In the App Permissions section select the necessary applications where in-app events will be used.


  5. Go to Account Permissions section and select all Financial Data permissions:
    • View financial data
    • Manage Orders and subscriptions.

Step 5. Contact Us

After all completed steps contact our support team via email support@appodeal.com or a live chat with the following information :

  1. Service account JSON file.(Android only)
  2. Purchases implementation logic in your app (when and where you call validate method and validate purchases).
  3. Send us the purchase testing access through Google Developer console to email support@appodeal.com.(Android only)
  4. Your apk in zip for testing.(Android only)
  5. Allow us to test purchases in your app and send us the testflight to email support@appodeal.com.(iOS only)