diff --git a/src/content/docs/ja/sdk/migration/adobe-extension/android/index.mdoc b/src/content/docs/ja/sdk/migration/adobe-extension/android/index.mdoc new file mode 100644 index 000000000..780913966 --- /dev/null +++ b/src/content/docs/ja/sdk/migration/adobe-extension/android/index.mdoc @@ -0,0 +1,227 @@ +--- +title: "Android Adobe Extension v3移行ガイド" +description: "Extensionをv2からv3に移行するには、このガイドの手順に従ってください" +sidebar-label: "Android v3移行ガイド" +sidebar-position: 1 +--- +[Adobe Experience SDKのAdjust Extension](https://github.com/adjust/android_adobe_extension)がv3にアップデートされ、Adjust Android SDK v5のサポートが追加されました。Extensionをv2からv3に移行するには、このガイドに従ってください。 + +\{% callout type="important" %\} +移行する前に、[Android API 21](https://developer.android.com/tools/releases/platforms#5.0)以降をサポートするようにアプリを更新してください。 +\{% /callout %\} + +Adobe ExperienceのAdjust Android Extension v3をインストールするには、`build.gradle`のdependency宣言を以下の通り更新してください。 + +1. `com.adjust.adobeextension:adobeextension` を3\.0\.0以降に更新する必要があります。 +2. `com.adjust.sdk:adjust-android` を5\.0\.0以降に更新する必要があります。 + +```groovy +dependencies { + implementation 'com.adjust.adobeextension:adobeextension:{% $versions.android_adobe_extension.v3 %}' + implementation 'com.adjust.sdk:adjust-android:{% $versions.android.v5 %}' + implementation 'com.adobe.marketing.mobile:core:3.2.0' + implementation 'com.android.installreferrer:installreferrer:2.2' +} +``` + +Adobe ExperienceのAdjust Android Extensionを設定する方法については、 [連携ガイド](/en/sdk/adobe-extension/android/integration)を参照してください。 + +新規API \{% \#new\-apis %\} +----------------------------- + +\{% minorversion added="v3" size="large" /%\} + +Extension v3では、以下のAPIが追加されました。 + +### ショートブランドリンクを解析\{% \#resolve\-short\-branded\-links %\} + +Adobe Experience SDKのAdjust Extension v3では、[ショートブランドリンク](https://help.adjust.com/en/article/short-branded-links)の解決に対するサポートが追加されます。短縮リンクを解析するには、以下の引数を使用して `Adjust.processAndResolveDeeplink` メソッドを呼び出します。 + +\{% deflist %\} +`adjustDeeplink`: `AdjustDeeplink` + +: アプリを起動するディープリンク。 + +`context`: `Context` + +: アプリのコンテキスト。`getApplicationContext()` を呼び出して、この値を入力します。 + +`callback`: `OnDeeplinkResolvedListener` + +: 解析されたショートリンクを引数として受け取るコールバック関数。 +\{% /deflist %\} + +```java +Intent intent = getIntent(); +Uri data = intent.getData(); +AdjustDeeplink adjustDeeplink = new AdjustDeeplink(data); +Adjust.processAndResolveDeeplink(adjustDeeplink, getApplicationContext(), new OnDeeplinkResolvedListener() { + @Override + public void onDeeplinkResolved(String s) { + + } +}); +``` + +### グローバルコールバックパラメーター \{% \#global\-callback\-parameters %\} + +Adobe Experience SDKのAdjust Extension v3では、Android SDK v5によるグローバルコールバックパラメーターAPIのサポートが追加されます。セッションにグローバルバックコールを追加するには、次の引数を指定して `Adjust.addGlobalCallbackParameter` メソッドを呼び出します。 + +\{% deflist %\} +`key`: `String` + +: パラメーターのキー。 + +`value`: `String` + +: パラメーターの値。\{% /deflist %\} + +```java +Adjust.addGlobalCallbackParameter("key", "value"); +Adjust.addGlobalCallbackParameter("user_id", "855"); +``` + +[グローバルコールバックの設定方法](/en/sdk/adobe-extension/android/global-parameters#global-callback-parameters)をご確認ください。 + +### グローバルパートナーパラメーター \{% \#global\-partner\-parameters %\} + +Adobe Experience SDKのAdjust Extension v3では、Android SDK v5によるグローバルパートナーパラメーターAPIのサポートが追加されます。グローバルパートナーパラメーターを追加するには、以下の引数で`Adjust.addGlobalPartnerParameter`メソッドを呼び出します。 + +\{% deflist %\} +`key`: `String` + +: パラメーターのキー。 + +`value`: `String` + +: パラメーターの値。\{% /deflist %\} + +```java +Adjust.addGlobalPartnerParameter("key", "value"); +Adjust.addGlobalPartnerParameter("user_id", "855"); +``` + +[グローバルパートナーパラメーターの設定方法](/en/sdk/adobe-extension/android/global-parameters#global-partner-parameters)をご確認ください。 + +### 外部デバイスIDを設定する \{% \#set\-external\-device\-id %\} + +Adobe Experience SDKのAdjust Extension v3では、[外部デバイスID](https://help.adjust.com/en/article/external-device-identifiers)設定のサポートが追加されます。外部デバイスIDを設定するには、以下の引数で `AdjustAdobeExtensionConfig` の `setExternalDeviceId` メソッドを呼び出します。 + +\{% deflist %\} +`externalDeviceId`: `String` + +: 外部デバイスID。\{% /deflist %\} + +```java +String environment = AdjustAdobeExtensionConfig.ENVIRONMENT_SANDBOX; +AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment); +config.setExternalDeviceId("{YourExternalDeviceId}"); +AdjustAdobeExtension.setConfiguration(config); +``` + +[外部デバイスIDの設定方法](/en/sdk/adobe-extension/android/external-device-id)をご確認ください。 + +### プリインストールアプリのデフォルトリンクトークンの設定\{% \#set\-default\-link\-token\-preinstalled\-apps %\} + +Adobe Experience SDKのAdjust Extension v3では、プレインストールされたアプリインストールをデフォルトキャンペーンに記録するため、デフォルトの[リンクトークン](https://help.adjust.com/en/article/links)設定することができます。デフォルトのリンクトークンを設定するには、以下の引数で `AdjustAdobeExtensionConfig` インスタンスの `setDefaultTracker` メソッドを呼び出します。 + +\{% deflist %\} +`defaultTracker`: `String` + +: プリインストールキャンペーン用の英数字のリンクトークン。\{% /deflist %\} + +```java +String environment = AdjustAdobeExtensionConfig.ENVIRONMENT_SANDBOX; +AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment); +config.setDefaultTracker("{Token}"); +AdjustAdobeExtension.setConfiguration(config); +``` + +[プリインストールアプリのアクティビティを送信する方法](/en/sdk/adobe-extension/android/preinstalled)をご確認ください。 + +変更されたAPI \{% \#changed\-apis %\} +------------------------------------ + +\{% minorversion changed="v3" size="large" /%\} + +Extension v3では、以下のAPIが変更されました。 + +### デバイスADID \{% \#retrieve\-device\-adid %\}の取得 + +SDK v2では、`AdjustAttribution`クラスは`adid`というプロパティを持ちます。このプロパティは削除されました。デバイスのADIDを非同期的に取得するには、`Adjust.getAdid`を呼び出します。 + +```java +Adjust.getAdid(new OnAdidReadListener() { + @Override + public void onAdidRead(String adid) { + // Your callback function + } +}); +``` + +### ダイレクトディープリンク\{% \#direct\-deep\-linking %\} + +SDK v2では、ディープリンクデータを引数として`AdjustAdobeExtension.openUrl`メソッドを呼び出すことで、アトリビューションのディープリンクを開くことができます。 + +```java +Intent intent = getIntent(); +Uri data = intent.getData(); +AdjustAdobeExtension.openUrl(data, getApplicationContext()); +``` + +SDK v3では、Adjust Android SDKの`processDeeplink`メソッドを使用するように更新されました。ダイレクトディープリンクを開くには、以下の手順に従ってください。 + +1. ディープリンクURLを使用して新しい`AdjustDeeplink`インスタンスを作成します。 +2. `Adjust.processDeeplink` メソッドに`AdjustDeeplink`インスタンスをパスします。 + +```java +Intent intent = getIntent(); +Uri data = intent.getData(); +AdjustDeeplink adjustDeeplink = new AdjustDeeplink(data); +Adjust.processDeeplink(adjustDeeplink, getApplicationContext()); +``` + +[ダイレクトディープリンクでユーザーをリアトリビュートする方法](/en/sdk/adobe-extension/android/deep-linking#reattribute-users-with-direct-deep-links)をご確認ください。 + +### ディファードディープリンクのコールバック \{% \#deferred\-deep\-linking\-callback %\} + +SDK v2では、`AdjustAdobeExtensionConfig`インスタンスの`setOnDeeplinkResponseListener`メソッドに関数をパスするよう設定することで、ディファードディープリンクが開いた時にコールバック機能を起動させることができます。 + +```java +AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment); + +config.setOnDeeplinkResponseListener(new OnDeeplinkResponseListener() { + @Override + public boolean launchReceivedDeeplink(Uri deeplink) { + if (shouldAdjustSdkLaunchTheDeeplink(deeplink)) { + return true; + } else { + return false; + } + } +}); + +AdjustAdobeExtension.setConfiguration(config); +``` + +SDK v3では、このメソッドの名前が`setOnDeeplinkResponseListener`から`setOnDeferredDeeplinkResponseListener`に変更されました。 + +```java +AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment); + +config.setOnDeferredDeeplinkResponseListener(new OnDeferredDeeplinkResponseListener() { + @Override + public boolean launchReceivedDeeplink(Uri deeplink) { + if (shouldAdjustSdkLaunchTheDeeplink(deeplink)) { + return true; + } else { + return false; + } + } +}); + +AdjustAdobeExtension.setConfiguration(config); +``` + +[ディファードディープリンクコールバックとの利用方法](/en/sdk/adobe-extension/android/deep-linking#deferred-deep-link-callbacks)をご確認ください。 + diff --git a/src/content/docs/ja/sdk/migration/adobe-extension/index.mdoc b/src/content/docs/ja/sdk/migration/adobe-extension/index.mdoc new file mode 100644 index 000000000..d13959167 --- /dev/null +++ b/src/content/docs/ja/sdk/migration/adobe-extension/index.mdoc @@ -0,0 +1,9 @@ +--- +title: "Adobe Experience SDKのAdjust Extension" +sidebar-label: "Adobe Extension" +description: "SDKバージョン間の移行については、こちらのガイドをご覧ください" +type: "category" +sidebar-position: 7 +--- + + diff --git a/src/content/docs/ko/sdk/migration/adobe-extension/android/index.mdoc b/src/content/docs/ko/sdk/migration/adobe-extension/android/index.mdoc new file mode 100644 index 000000000..edc4df7f6 --- /dev/null +++ b/src/content/docs/ko/sdk/migration/adobe-extension/android/index.mdoc @@ -0,0 +1,231 @@ +--- +title: "Android Adobe Extension v3 마이그레이션 가이드" +description: "이 가이드에 따라 v2에서 v3로 마이그레이션" +sidebar-label: "Android v3 마이그레이션 가이드" +sidebar-position: 1 +--- +[Adobe Experience SDK용 Adjust 확장판](https://github.com/adjust/android_adobe_extension)이 v3로 업데이트되어 Adjust Android SDK v5를 지원합니다. 이 가이드에 따라 v2에서 v3로 마이그레이션하시기 바랍니다. + +\{% callout type="important" %\} +마이그레이션하기 전에 [Android API 21](https://developer.android.com/tools/releases/platforms#5.0) 이상을 지원하도록 앱을 업데이트해야 합니다. +\{% /callout %\} + +Adobe Experience용 Adjust Android 확장판 v3를 설치하려면 다음과 같이 `build.gradle`의 디펜던시 선언을 업데이트합니다. + +1. `com.adjust.adobeextension:adobeextension` 3\.0\.0 이상으로 업데이트해야 합니다. +2. `com.adjust.sdk:adjust-android` 5\.0\.0 이상으로 업데이트해야 합니다. + +```groovy +dependencies { + implementation 'com.adjust.adobeextension:adobeextension:{% $versions.android_adobe_extension.v3 %}' + implementation 'com.adjust.sdk:adjust-android:{% $versions.android.v5 %}' + implementation 'com.adobe.marketing.mobile:core:3.2.0' + implementation 'com.android.installreferrer:installreferrer:2.2' +} +``` + +Adobe Experience용 Adjust Android Extension 설정 통합 가이드는 [연동 가이드](/en/sdk/adobe-extension/android/integration)를 참조하시기 바랍니다. + +새 API \{% \#new\-apis %\} +----------------------------- + +\{% minorversion added="v3" size="large" /%\} + +다음 API가 v3에 추가되었습니다. + +### 숏 브랜드 링크 해석 \{% \#resolve\-short\-branded\-links %\} + +Adobe Experience SDK용 Adjust Extension v3는 [숏 브랜드 링크](https://help.adjust.com/en/article/short-branded-links) 해석 지원이 추가되었습니다. 단축된 링크를 해석하려면 다음 인수로 `Adjust.processAndResolveDeeplink` 메서드를 호출합니다. + +\{% deflist %\} +`adjustDeeplink`: `AdjustDeeplink` + +: 앱을 연 딥링크 + +`context`: `Context` + +: 앱 컨텍스트입니다. `getApplicationContext()`를 호출하여 이 값을 입력합니다. + +`callback`: `OnDeeplinkResolvedListener` + +: 해석된 단축 링크를 인수로 수신하는 콜백 함수입니다. +\{% /deflist %\} + +```java +Intent intent = getIntent(); +Uri data = intent.getData(); +AdjustDeeplink adjustDeeplink = new AdjustDeeplink(data); +Adjust.processAndResolveDeeplink(adjustDeeplink, getApplicationContext(), new OnDeeplinkResolvedListener() { + @Override + public void onDeeplinkResolved(String s) { + + } +}); +``` + +### 글로벌 콜백 파라미터 \{% \#global\-callback\-parameters %\} + +Adobe Experience SDK용 Adjust Extension v3에 Android SDK v5의 글로벌 콜백 파라미터 API 지원이 추가되었습니다. 세션에 글로벌 콜백을 추가하려면 다음 인수로 `Adjust.addGlobalCallbackParameter` 메서드를 호출합니다. + +\{% deflist %\} +`key`: `String` + +: 파라미터의 키 + +`value`: `String` + +: 파라미터의 값 +\{% /deflist %\} + +```java +Adjust.addGlobalCallbackParameter("key", "value"); +Adjust.addGlobalCallbackParameter("user_id", "855"); +``` + +[글로벌 콜백 설정](/en/sdk/adobe-extension/android/global-parameters#global-callback-parameters) 방법을 알아보시기 바랍니다. + +### 글로벌 파트너 파라미터 \{% \#global\-partner\-parameters %\} + +Adobe Experience SDK용 Adjust Extension v3에 Android SDK v5의 글로벌 파트너 파라미터 API 지원이 추가되었습니다. 글로벌 파트너 파라미터를 추가하려면 다음 인수로 `Adjust.addGlobalPartnerParameter` 메서드를 호출합니다. + +\{% deflist %\} +`key`: `String` + +: 파라미터의 키 + +`value`: `String` + +: 파라미터의 값 +\{% /deflist %\} + +```java +Adjust.addGlobalPartnerParameter("key", "value"); +Adjust.addGlobalPartnerParameter("user_id", "855"); +``` + +[글로벌 파트너 파라미터 설정](/en/sdk/adobe-extension/android/global-parameters#global-partner-parameters) 방법을 알아보시기 바랍니다. + +### 외부 기기 ID 전송 \{% \#set\-external\-device\-id %\} + +Adobe Experience SDK용 Adjust Extension v3는 [외부 기기 식별자](https://help.adjust.com/en/article/external-device-identifiers) 설정 지원이 추가되었습니다. 외부 기기 ID를 설정하려면 다음 인수로 `AdjustAdobeExtensionConfig` 인스턴스의 `setExternalDeviceId` 메서드를 호출합니다. + +\{% deflist %\} +`externalDeviceId`: `String` + +: 외부 기기 식별자 +\{% /deflist %\} + +```java +String environment = AdjustAdobeExtensionConfig.ENVIRONMENT_SANDBOX; +AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment); +config.setExternalDeviceId("{YourExternalDeviceId}"); +AdjustAdobeExtension.setConfiguration(config); +``` + +[외부 기기 ID 설정](/en/sdk/adobe-extension/android/external-device-id) 방법을 알아보시기 바랍니다. + +### 사전 설치 앱에 대한 기본 링크 토큰 설정 \{% \#set\-default\-link\-token\-preinstalled\-apps %\} + +Adobe Experience SDK용 Adjust Extension v3는 기본 캠페인에 사전 설치 앱의 설치를 기혹하기 위한 기본 [링크 토큰](https://help.adjust.com/en/article/links) 설정 지원이 추가되었습니다. 기본 링크 토큰을 설정하려면 다음 인수로 `AdjustAdobeExtensionConfig` 인스턴스의 `setDefaultTracker` 메서드를 호출합니다. + +\{% deflist %\} +`defaultTracker`: `String` + +: 사전 설치 캠페인의 영숫자 링크 토큰 +\{% /deflist %\} + +```java +String environment = AdjustAdobeExtensionConfig.ENVIRONMENT_SANDBOX; +AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment); +config.setDefaultTracker("{Token}"); +AdjustAdobeExtension.setConfiguration(config); +``` + +[사전 설치된 앱 활동 전송](/en/sdk/adobe-extension/android/preinstalled) 방법을 알아보시기 바랍니다. + +변경된 API \{% \#changed\-apis %\} +----------------------------------- + +\{% minorversion changed="v3" size="large" /%\} + +다음 API가 v3에서 변경되었습니다. + +### 기기 ADID 조회 \{% \#retrieve\-device\-adid %\} + +SDK v2에서는 `AdjustAttribution` 클래스에 `adid`라는 속성이 있습니다. 이 속성이 제거되었습니다. `Adjust.getAdid`를 호출하여 기기의 ADID를 비동기적으로 조회할 수 있습니다. + +```java +Adjust.getAdid(new OnAdidReadListener() { + @Override + public void onAdidRead(String adid) { + // Your callback function + } +}); +``` + +### 다이렉트 딥링크 \{% \#direct\-deep\-linking %\} + +SDK v2에서는 딥링크 데이터를 인수로 `AdjustAdobeExtension.openUrl` 메서드를 호출하여 어트리뷰션에 대한 딥링크를 열 수 있습니다. + +```java +Intent intent = getIntent(); +Uri data = intent.getData(); +AdjustAdobeExtension.openUrl(data, getApplicationContext()); +``` + +SDK v3가 Adjust Android SDK의 `processDeeplink` 메서드를 사용하도록 업데이트되었습니다. 다이렉트 딥링크를 여는 방법은 다음과 같습니다. + +1. 딥링크 URL로 새로운 `AdjustDeeplink` 인스턴스를 생성합니다. +2. `AdjustDeeplink` 인스턴스를 `Adjust.processDeeplink` 메서드에 전달합니다. + +```java +Intent intent = getIntent(); +Uri data = intent.getData(); +AdjustDeeplink adjustDeeplink = new AdjustDeeplink(data); +Adjust.processDeeplink(adjustDeeplink, getApplicationContext()); +``` + +[다이렉트 딥링크를 사용하여 사용자 리어트리뷰션](/en/sdk/adobe-extension/android/deep-linking#reattribute-users-with-direct-deep-links) 방법을 알아보시기 바랍니다. + +### 디퍼드 딥링크 콜백 \{% \#deferred\-deep\-linking\-callback %\} + +SDK v2에서는 `AdjustAdobeExtensionConfig` 인스턴스의 `setOnDeeplinkResponseListener` 메서드에 함수를 전달하여 디퍼드 딥링크가 열릴 때 콜백 함수를 실행하도록 SDK를 구성할 수 있습니다. + +```java +AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment); + +config.setOnDeeplinkResponseListener(new OnDeeplinkResponseListener() { + @Override + public boolean launchReceivedDeeplink(Uri deeplink) { + if (shouldAdjustSdkLaunchTheDeeplink(deeplink)) { + return true; + } else { + return false; + } + } +}); + +AdjustAdobeExtension.setConfiguration(config); +``` + +SDK v3에서는 `setOnDeeplinkResponseListener` 메서드의 이름이 `setOnDeferredDeeplinkResponseListener`으로 변경되었습니다. + +```java +AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment); + +config.setOnDeferredDeeplinkResponseListener(new OnDeferredDeeplinkResponseListener() { + @Override + public boolean launchReceivedDeeplink(Uri deeplink) { + if (shouldAdjustSdkLaunchTheDeeplink(deeplink)) { + return true; + } else { + return false; + } + } +}); + +AdjustAdobeExtension.setConfiguration(config); +``` + +[디퍼드 딥링크 콜백 처리](/en/sdk/adobe-extension/android/deep-linking#deferred-deep-link-callbacks) 방법을 알아보시기 바랍니다. + diff --git a/src/content/docs/ko/sdk/migration/adobe-extension/index.mdoc b/src/content/docs/ko/sdk/migration/adobe-extension/index.mdoc new file mode 100644 index 000000000..0f7ef444a --- /dev/null +++ b/src/content/docs/ko/sdk/migration/adobe-extension/index.mdoc @@ -0,0 +1,9 @@ +--- +title: "Adobe Experience SDK를 위한 Adjust 확장판" +sidebar-label: "Adobe Extension" +description: "이 가이드에 따라 SDK 버전 간 마이그레이션하시기 바랍니다." +type: "category" +sidebar-position: 7 +--- + + diff --git a/src/content/docs/zh/sdk/migration/adobe-extension/android/index.mdoc b/src/content/docs/zh/sdk/migration/adobe-extension/android/index.mdoc new file mode 100644 index 000000000..ed1b6ebf1 --- /dev/null +++ b/src/content/docs/zh/sdk/migration/adobe-extension/android/index.mdoc @@ -0,0 +1,231 @@ +--- +title: "Android Adobe Extension v3 迁移指南" +description: "按照本指南说明操作,从 v2 迁移至 v3" +sidebar-label: "Android v3 迁移指南" +sidebar-position: 1 +--- +[针对 Adobe Experience SDK 的 Adjust Extension](https://github.com/adjust/android_adobe_extension) 已更新至版本 v3。该版本加入了针对 Adjust Android SDK v5 的支持。请按照本指南说明操作,从 v2 迁移至 v3。 + +\{% callout type="important" %\} +请在迁移前更新您的应用,以支持 [Android API 21](https://developer.android.com/tools/releases/platforms#5.0)以及更高版本。 +\{% /callout %\} + +要按照版本 v3 的针对 Adobe Experience SDK 的 Adjust Android Extension,请按照下列方式更新您 `build.gradle` 中的依赖声明: + +1. `com.adjust.adobeextension:adobeextension` 必须至少更新到版本 3\.0\.0。 +2. `com.adjust.sdk:adjust-android` 必须至少更新刀版本 5\.0\.0。 + +```groovy +dependencies { + implementation 'com.adjust.adobeextension:adobeextension:{% $versions.android_adobe_extension.v3 %}' + implementation 'com.adjust.sdk:adjust-android:{% $versions.android.v5 %}' + implementation 'com.adobe.marketing.mobile:core:3.2.0' + implementation 'com.android.installreferrer:installreferrer:2.2' +} +``` + +要查看针对 Adobe Experience SDK 的 Adjust Android Extension 设置完整指南,请参阅[集成指南](/en/sdk/adobe-extension/android/integration)。 + +新 API \{% \#new\-apis %\} +----------------------------- + +\{% minorversion added="v3" size="large" /%\} + +版本 v3 中添加了下列 API。 + +### 解析品牌化短链接 \{% \#resolve\-short\-branded\-links %\} + +针对 Adobe Experience SDK 的 Adjust Extension 版本 v3 加入了[品牌化短链接](https://help.adjust.com/en/article/short-branded-links)的解析支持。要解析短链接,请使用下列参数调用 `Adjust.processAndResolveDeeplink` 方法: + +\{% deflist %\} +`adjustDeeplink`: `AdjustDeeplink` + +: 打开应用的深度链接。 + +`context`: `Context` + +: 应用 context。调用 `getApplicationContext()` 以填充该值。 + +`callback`: `OnDeeplinkResolvedListener` + +: 以参数形式接收已解析短链接的回传函数。 +\{% /deflist %\} + +```java +Intent intent = getIntent(); +Uri data = intent.getData(); +AdjustDeeplink adjustDeeplink = new AdjustDeeplink(data); +Adjust.processAndResolveDeeplink(adjustDeeplink, getApplicationContext(), new OnDeeplinkResolvedListener() { + @Override + public void onDeeplinkResolved(String s) { + + } +}); +``` + +### 统一回传参数\{% \#global\-callback\-parameters %\} + +针对 Adobe Experience SDK 的 Adjust Extension 版本 v3 加入了对来自 Android SDK v5 的统一回传参数 API 支持。要向会话添加统一回传,请使用下列参数调用 `Adjust.addGlobalCallbackParameter`: + +\{% deflist %\} +`key`: `String` + +: 参数的键。 + +`value`: `String` + +: 参数值。 +\{% /deflist %\} + +```java +Adjust.addGlobalCallbackParameter("key", "value"); +Adjust.addGlobalCallbackParameter("user_id", "855"); +``` + +了解[统一回传设置方法](/en/sdk/adobe-extension/android/global-parameters#global-callback-parameters)。 + +### 统一合作伙伴参数\{% \#global\-partner\-parameters %\} + +针对 Adobe Experience SDK 的 Adjust Extension 版本 v3 加入了对来自 Android SDK v5 的全局合作伙伴参数 API 支持。要添加全局合作伙伴参数,请使用下列参数调用 `Adjust.addGlobalPartnerParameter`方法: + +\{% deflist %\} +`key`: `String` + +: 参数的键。 + +`value`: `String` + +: 参数值。 +\{% /deflist %\} + +```java +Adjust.addGlobalPartnerParameter("key", "value"); +Adjust.addGlobalPartnerParameter("user_id", "855"); +``` + +了解[全局合作伙伴参数设置方法](/en/sdk/adobe-extension/android/global-parameters#global-partner-parameters)。 + +### 设置外部设备 ID \{% \#set\-external\-device\-id %\} + +针对 Adobe Experience SDK 的 Adjust Extension 版本 v3 加入了[外部设备标识符](https://help.adjust.com/en/article/external-device-identifiers)设置的支持。要设置外部设备 ID,请使用下列参数调用 `AdjustAdobeExtensionConfig` 实例上的 `setExternalDeviceId` 方法: + +\{% deflist %\} +`externalDeviceId`: `String` + +: 您的外部设备标识符。 +\{% /deflist %\} + +```java +String environment = AdjustAdobeExtensionConfig.ENVIRONMENT_SANDBOX; +AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment); +config.setExternalDeviceId("{YourExternalDeviceId}"); +AdjustAdobeExtension.setConfiguration(config); +``` + +了解[外部设备 ID 配置方法](/en/sdk/adobe-extension/android/external-device-id)。 + +### 为预安装应用设置默认链接识别码 \{% \#set\-default\-link\-token\-preinstalled\-apps %\} + +针对 Adobe Experience SDK 的 Adjust Extension 版本 v3 拓展了支持功能,现在允许您设置默认[链接识别码](https://help.adjust.com/en/article/links),以便将预安装应用的安装记录到默认推广活动中。要设置默认链接识别码,请使用下列参数调用 `AdjustAdobeExtensionConfig` 实例上的 `setDefaultTracker` 方法: + +\{% deflist %\} +`defaultTracker`: `String` + +: 预安装推广活动的、由英文字母和数字组成的链接识别码 +\{% /deflist %\} + +```java +String environment = AdjustAdobeExtensionConfig.ENVIRONMENT_SANDBOX; +AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment); +config.setDefaultTracker("{Token}"); +AdjustAdobeExtension.setConfiguration(config); +``` + +了解[发送预安装应用活动信息的方法](/en/sdk/adobe-extension/android/preinstalled)。 + +变更 API \{% \#changed\-apis %\} +---------------------------------- + +\{% minorversion changed="v3" size="large" /%\} + +版本 v3 中的以下 API 发生了变更。 + +### 调取设备 ADID \{% \#retrieve\-device\-adid %\} + +在 SDK v2 中,`AdjustAttribution` 类包含一个名为 `adid` 的属性。该属性已被移除。您可以调用 `Adjust.getAdid` 以异步调取设备 ADID。 + +```java +Adjust.getAdid(new OnAdidReadListener() { + @Override + public void onAdidRead(String adid) { + // Your callback function + } +}); +``` + +### 直接深度链接\{% \#direct\-deep\-linking %\} + +在 SDK v2 中,您可将深度链接数据座位参数调用 `AdjustAdobeExtension.openUrl` 方法,以此打开归因深度链接。 + +```java +Intent intent = getIntent(); +Uri data = intent.getData(); +AdjustAdobeExtension.openUrl(data, getApplicationContext()); +``` + +SDK v3 已更新,可以使用 Adjust Android SDK 的 `processDeeplink` 方法。要打开直接深度链接,请按照下列步骤操作: + +1. 使用深度链接 URL 创建新的 `AdjustDeeplink` 实例。 +2. 将您的 `AdjustDeeplink` 实例传递至 `Adjust.processDeeplink` 方法。 + +```java +Intent intent = getIntent(); +Uri data = intent.getData(); +AdjustDeeplink adjustDeeplink = new AdjustDeeplink(data); +Adjust.processDeeplink(adjustDeeplink, getApplicationContext()); +``` + +了解如何[使用直接深度链接进行用户再归因](/en/sdk/adobe-extension/android/deep-linking#reattribute-users-with-direct-deep-links)。 + +### 延迟深度链接回传 \{% \#deferred\-deep\-linking\-callback %\} + +在 SDK v2 中,您可以对 SDK 进行配置,向 `AdjustAdobeExtensionConfig` 实例的 `setOnDeeplinkResponseListener` 方法传递函数,以便在延迟深度链接被打开时启用回传函数。 + +```java +AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment); + +config.setOnDeeplinkResponseListener(new OnDeeplinkResponseListener() { + @Override + public boolean launchReceivedDeeplink(Uri deeplink) { + if (shouldAdjustSdkLaunchTheDeeplink(deeplink)) { + return true; + } else { + return false; + } + } +}); + +AdjustAdobeExtension.setConfiguration(config); +``` + +在 SDK v5 中,`setOnDeeplinkResponseListener` 方法已重命名为 `setOnDeferredDeeplinkResponseListener`。 + +```java +AdjustAdobeExtensionConfig config = new AdjustAdobeExtensionConfig(environment); + +config.setOnDeferredDeeplinkResponseListener(new OnDeferredDeeplinkResponseListener() { + @Override + public boolean launchReceivedDeeplink(Uri deeplink) { + if (shouldAdjustSdkLaunchTheDeeplink(deeplink)) { + return true; + } else { + return false; + } + } +}); + +AdjustAdobeExtension.setConfiguration(config); +``` + +学习如何[使用延迟深度链接回传](/en/sdk/adobe-extension/android/deep-linking#deferred-deep-link-callbacks) + diff --git a/src/content/docs/zh/sdk/migration/adobe-extension/index.mdoc b/src/content/docs/zh/sdk/migration/adobe-extension/index.mdoc new file mode 100644 index 000000000..4180226f8 --- /dev/null +++ b/src/content/docs/zh/sdk/migration/adobe-extension/index.mdoc @@ -0,0 +1,9 @@ +--- +title: "针对 Adobe Experience SDK 的 Adjust Extension" +sidebar-label: "Adobe Extension" +description: "按照以下指南在 SDK 版本之间迁移" +type: "category" +sidebar-position: 7 +--- + +