Skip to content

Commit

Permalink
[signature] [unity] Leverage the v4 & v5 SDK tabs to more accurately …
Browse files Browse the repository at this point in the history
…reflect content
  • Loading branch information
dimim committed Jan 23, 2025
1 parent 8cdc887 commit 9d07e63
Show file tree
Hide file tree
Showing 2 changed files with 18 additions and 12 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,19 @@ redirects:
v5: /en/sdk/unity/integrations/signature-library
---

<Callout type="note">

This page refers to integration steps for the Adjust SDK v4. If you're using the Adjust SDK v5, please select the appropriate tab on the dropdown menu to your left.

</Callout>

Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected.

## Before you begin {#before-you-begin}

<Callout type="note">

The SDK Signature library is configured to use [16KB page sizes](https://developer.android.com/guide/practices/page-sizes) in [version 3.32.0 or greater](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0).
The Signature library is configured to use [16KB page sizes](https://developer.android.com/guide/practices/page-sizes) in [version 3.32.0 or greater](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0).

</Callout>

Expand All @@ -45,12 +51,6 @@ If you previously used Signature v1 or Signature v2, you first need to remove th

## Integrate the signature library {#integrate-the-signature-library}

<Callout type="note">

This step can be skipped if using SDK v5 and [External Dependency Manager for Unity (EDM4U)](https://github.com/googlesamples/unity-jar-resolver).

</Callout>

Follow these steps to integrate the Signature library in your Unity project.

1. Fetch from GitHub the [latest Stable](https://github.com/adjust/adjust_signature_sdk/releases/latest) or [Beta](https://github.com/adjust/adjust_signature_sdk/releases) version.
Expand Down Expand Up @@ -238,7 +238,7 @@ In Unity Editor 2018 and later, you may receive an error message containing **Un

## Updating the Signature Library {#updating-the-signature-library}

To update the Adjust Signature library, replace the existing Signature library by integrating a new version or updating SDK v5's version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust as long as your [certificates are configured and haven't been altered](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints). Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids):
Updating the Signature library consists of replacing the existing library with a newer version and rerunning your tests. You don't need to make any immediate changes to your app logic or settings in Adjust. Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids):

- They're no longer contributing to your install reporting.
- You've fully released a new version of your app (across all app platforms and stores).
Original file line number Diff line number Diff line change
Expand Up @@ -14,20 +14,26 @@ redirects:
v4: /en/sdk/unity/v4/integrations/signature-library
---

<Callout type="note">

This page refers to integration steps for the Adjust SDK v5. If you're using the Adjust SDK v4, please select the appropriate tab on the dropdown menu to your left.

</Callout>

Adjust's SDK Signature library is designed to be a standalone plugin for the Adjust SDK. This means you don’t need to change any of your code or change how you use the Adjust SDK in your app. Once you install the plugin, all requests made by the Adjust SDK will continue to work as expected.

## Before you begin {#before-you-begin}

<Callout type="note">

The SDK Signature library is configured to use [16KB page sizes](https://developer.android.com/guide/practices/page-sizes) in [version 3.32.0 or greater](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0).
The Signature library is configured to use [16KB page sizes](https://developer.android.com/guide/practices/page-sizes) in [version 3.32.0 or greater](https://github.com/adjust/adjust_signature_sdk/releases/tag/v3.32.0).

</Callout>

To integrate the Signature library into your Unity app, ensure the following:

- The Android API version in use is **21 or greater**.
- The Adjust SDK version in use is **4.37.2 or greater**. This requirement applies even when the Adjust SDK is used indirectly.
- The Adjust SDK version in use is **5.0.0 or greater**. This requirement applies even when the Adjust SDK is used indirectly.
- If you use Proguard, you must use the exact same Proguard configuration for both the Signature library and the Adjust SDK.

<Callout type="important">
Expand All @@ -47,7 +53,7 @@ If you previously used Signature v1 or Signature v2, you first need to remove th

<Callout type="note">

This step can be skipped if using SDK v5 and [External Dependency Manager for Unity (EDM4U)](https://github.com/googlesamples/unity-jar-resolver).
This step can be skipped if you use [External Dependency Manager for Unity (EDM4U)](https://github.com/googlesamples/unity-jar-resolver).

</Callout>

Expand Down Expand Up @@ -238,7 +244,7 @@ In Unity Editor 2018 and later, you may receive an error message containing **Un

## Updating the Signature Library {#updating-the-signature-library}

To update the Adjust Signature library, replace the existing Signature library by integrating a new version or updating SDK v5's version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust as long as your [certificates are configured and haven't been altered](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints). Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids):
The Signature library is automatically updated along with any Adjust SDK v5 update. If a specific Signature library version is required, replace the existing library with a newer version and rerun your tests. You don't need to make any immediate changes to your app logic or settings in Adjust as long as your [certificates are configured and haven't been altered](https://help.adjust.com/en/article/sdk-signature#manage-your-certificate-fingerprints). Remember to [deactivate your secret IDs if they meet the following criteria](https://help.adjust.com/en/article/sdk-signature#manage-your-secret-ids):

- They're no longer contributing to your install reporting.
- You've fully released a new version of your app (across all app platforms and stores).

0 comments on commit 9d07e63

Please sign in to comment.