From 3383ef9c831c5638953d868dc95bace61a64fbf5 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 08:15:42 +0000 Subject: [PATCH 01/13] File src/content/docs/en/api/deep-link-generator-api.mdx was translated to ko-KR locale --- .../docs/ko/api/deep-link-generator-api.mdx | 166 +++++++++--------- 1 file changed, 80 insertions(+), 86 deletions(-) diff --git a/src/content/docs/ko/api/deep-link-generator-api.mdx b/src/content/docs/ko/api/deep-link-generator-api.mdx index 172335d09..bd87ad075 100644 --- a/src/content/docs/ko/api/deep-link-generator-api.mdx +++ b/src/content/docs/ko/api/deep-link-generator-api.mdx @@ -1,62 +1,59 @@ --- -title: 딥링크 생성기 API -description: 딥링크 생성기 API를 사용하여 앱에 대한 긴/단축 딥링크를 개별 또는 일괄로 생성할 수 있습니다. -category-title: 딥링크 생성기 API -slug: ko/api/deep-link-generator-api +title: "딥링크 생성기 API" +description: "딥링크 생성기 API를 사용하여 앱에 대한 긴/단축 딥링크를 개별 또는 일괄로 생성할 수 있습니다." +category-title: "딥링크 생성기 API" +slug: "en/api/deep-link-generator-api" sidebar-position: 8 --- - 딥링크 생성기 API를 사용하여 앱에 대한 긴/단축 딥링크를 개별 또는 일괄로 생성할 수 있습니다. 이러한 맞춤형 딥링크는 다양한 플랫폼에서 사용자 경험을 향상시킵니다. -## 시작에 앞서 {#before-you-begin} +시작에 앞서 \{\#before\-you\-begin\} +------------------------------------ 시작하기 전에 알아야 할 사항은 다음과 같습니다. -### 가용성 {#availability} +### 가용성 \{\#availability\} - + 딥링크 생성기 API는 초당 200개의 요청으로 제한됩니다. 이 제한을 초과하면 429 오류가 발생합니다. + - - -- 딥링크 생성기 API에 액세스하려면 TrueLink Core 또는 Enterprise 패키지를 사용해야 합니다. -- 딥링크 생성기 API를 사용하여 생성된 링크는 [Campaign Lab](https://help.adjust.com/ko/article/campaign-setup) 에 표시되지 않습니다. -- 딥링크 생성기 API를 사용하여 생성된 단축 링크의 TTL\(time\-to\-live\)은 120일입니다. - -### 요구 사항 {#requirements} - -- 관리자, 편집자 또는 사용자 지정 편집자 [권한](https://help.adjust.com/ko/article/permission-levels). -- iOS와 Android 앱에 대해 [동일한 브랜드 도메인을 설정](https://help.adjust.com/ko/article/set-up-branded-domain)합니다. - - - iOS 앱의 경우 브랜드 도메인을 [Associated Domain](https://help.adjust.com/ko/article/set-up-branded-domain#ios-only-update)으로 추가하시기 바랍니다. 이렇게 하면 도메인이 유니버셜 링크로 구성되도록 설정됩니다. - - Android 앱의 경우 브랜드 도메인을 [Android 앱 링크](https://help.adjust.com/ko/article/set-up-android-app-links)로 정의하시기 바랍니다. +* 딥링크 생성기 API에 액세스하려면 TrueLink Base, Core 또는 Enterprise 패키지를 사용해야 합니다. +* 딥링크 생성기 API를 사용하여 생성된 링크는 [Campaign Lab](https://help.adjust.com/en/article/campaign-setup) 에 표시되지 않습니다. +* 딥링크 생성기 API를 사용하여 생성된 단축 링크의 TTL\(time\-to\-live\)은 120일입니다. -- 앱에 대한 커스텀 링크. +### 요구 사항 \{\#requirements\} - - 단일 플랫폼 앱, 멀티 플랫폼 앱 \- [Campaign Lab에서 커스텀 링크를 생성](https://help.adjust.com/ko/article/custom-link-setup) 하여 단일 링크 토큰을 받을 수 있습니다. - - 여러 개의 단일 플랫폼 앱 \- [Campaign Lab](https://help.adjust.com/ko/article/custom-link-setup#combined-custom-links) 에서 여러 개의 단일 플랫폼 앱으로부터 결합된 커스텀 링크를 생성하여, 여러 개의 링크 토큰이 '\_'로 구분된 단일 결합된 커스텀 링크를 생성할 수 있습니다. 자세한 정보는 [복합 커스텀 링크에 대한 플랫폼별 링크 토큰](https://help.adjust.com/ko/article/manage-custom-link-setup#link-tokens-combined-custom-link)을 참조하시기 바랍니다. +* 관리자, 편집자 또는 사용자 지정 편집자 [권한](https://help.adjust.com/en/article/permission-levels). +* iOS와 Android 앱에 대해 [동일한 브랜드 도메인을 설정](https://help.adjust.com/en/article/set-up-branded-domain)합니다. + * iOS 앱의 경우 브랜드 도메인을 [Associated Domain](https://help.adjust.com/en/article/set-up-branded-domain#ios-only-update)으로 추가하시기 바랍니다. 이렇게 하면 도메인이 유니버셜 링크로 구성되도록 설정됩니다. + * Android 앱의 경우 브랜드 도메인을 [Android 앱 링크](https://help.adjust.com/en/article/set-up-android-app-links)로 정의하시기 바랍니다. -- 단축 링크 해석을 위한 Adjust SDK 설정 +* 앱에 대한 커스텀 링크. + * 단일 플랫폼 앱, 멀티 플랫폼 앱 \- [Campaign Lab에서 커스텀 링크를 생성](https://help.adjust.com/en/article/custom-link-setup) 하여 단일 링크 토큰을 받을 수 있습니다. + * 여러 개의 단일 플랫폼 앱 \- [Campaign Lab](https://help.adjust.com/en/article/custom-link-setup#combined-custom-links) 에서 여러 개의 단일 플랫폼 앱으로부터 결합된 커스텀 링크를 생성하여, 여러 개의 링크 토큰이 '\_'로 구분된 단일 결합된 커스텀 링크를 생성할 수 있습니다. 자세한 정보는 [복합 커스텀 링크에 대한 플랫폼별 링크 토큰](https://help.adjust.com/en/article/manage-custom-link-setup#link-tokens-combined-custom-link)을 참조하시기 바랍니다. - - [iOS](/ko/sdk/ios/features/short-links) \| [Android](/ko/sdk/android/features/short-links) \| [Unity](/ko/sdk/unity/features/short-links) \| [React Native](/ko/sdk/react-native/features/short-links) \| [Flutter](/ko/sdk/flutter/features/short-links) \| [Cordova](/ko/sdk/cordova/features/short-links) \| [Cocos2d\-x](/ko/sdk/cocos2dx/features/short-links) +* 단축 링크 해석을 위해 Adjust SDK를 업데이트 하시기 바랍니다. + * [iOS](/en/sdk/ios/features/short-links) \| [Android](/en/sdk/android/features/short-links) \| [Unity](/en/sdk/unity/features/short-links) \| [React Native](/en/sdk/react-native/features/short-links) \| [Flutter](/en/sdk/flutter/features/short-links) \| [Cordova](/en/sdk/cordova/features/short-links) \| [Cocos2d\-x](/en/sdk/cocos2dx/features/short-links) -- [데이터 레지던시를 설정](https://help.adjust.com/ko/article/data-residency-setup)한 경우, iOS와 Android 앱에 동일한 지역을 사용해야 합니다. +* [데이터 레지던시를 설정](https://help.adjust.com/en/article/data-residency-setup)한 경우, iOS와 Android 앱에 동일한 지역을 사용해야 합니다. -## 인증 {#authentication} +인증 \{\#authentication\} +-------------------------- 캠페인 API는 인증을 위해 [베어러 토큰](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) 을 사용합니다. 반드시 캠페인 API에 대한 각 요청과 함께 `Authorization` 헤더에 Adjust API 토큰을 포함해야 합니다. Single Sign\-On \(SSO\)를 활성화한 경우, Adjust 담당자에게 연락하거나 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 API를 찾는 데 도움을 받으시기 바랍니다. -비 SSO 계정의 경우, API는 사용자의 **프로필** 에서 확인하실 수 있습니다. Adjust API 토큰을 확인하려면 다음 단계를 따르시기 바랍니다. +비 SSO 계정의 경우, API는 사용자의 **프로필** 에서 확인하실 수 있습니다. Adjust API 토큰을 확인하려면 다음 단계를 따르시기 바랍니다. 1. 계정\(사용자\) 아이콘을 선택합니다. 2. **계정 설정** 을 선택합니다. 3. **내 프로필** 탭을 선택합니다. 4. **API 토큰** 은 **사용자 세부 사항** 과 함께 표시됩니다. 시스템 클립보드에 토큰을 복사하기 위해 복사를 선택합니다. -### Adjust API 토큰 재설정 {#reset-your-adjust-api-token} +### Adjust API 토큰 재설정 \{\#reset\-your\-adjust\-api\-token\} Adjust API 토큰은 언제든지 재설정할 수 있습니다. 토큰을 재설정하면 이전의 토큰은 무효화됩니다. Adjust API 토큰을 재설정한 경우 기존 토큰이 사용되는 모든 곳에서 교체해야 합니다. 무효화된 토큰에 대한 요청은 Adjust에 의해 거부됩니다. @@ -65,46 +62,47 @@ Adjust API 토큰 재설정 1. 계정\(사용자\) 아이콘을 선택합니다. 2. **계정 설정** 을 선택합니다. 3. **내 프로필** 탭을 선택합니다. -4. **API 토큰** 은 **사용자 세부 사항** 과 함께 표시됩니다. +4. **API 토큰** 은 **사용자 세부 사항** 과 함께 표시됩니다. 5. **API 토큰 재설정** 을 선택합니다. 6. 모달에 계정 비밀번호를 입력한 후 API 토큰 재설정을 위해 **재설정** 을 선택합니다. 화면 우측 상단에 확인 메시지가 나타납니다. 7. 시스템 클립보드에 **API 토큰** 을 복사하기 위해 복사를 선택합니다. -## 파라미터 {#parameters} - -| 파라미터 | 데이터 유형 | In | 설명 | -| ------------------------ | -------------------- | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `adjust_auth_token` | `String` | 헤더 | Adjust API 토큰 | -| `link_token` | `String` | Body | 커스텀 링크의 링크 토큰. 결합된 링크에서 딥링크를 생성하는 경우, Campaign Lab에서 결합된 커스텀 링크로부터의 올바른 링크 토큰을 사용해야 합니다. | -| `shorten_url` | `Boolean` | Body | 링크 단축 여부. 링크는 기본 설정에 따라 단축되지 않습니다. 기본값 \- false | -| `campaign` | `String` 또는 `null` | Body | 캠페인의 이름 | -| `adgroup` | `String` 또는 `null` | Body | 광고그룹의 이름 | -| `creative` | `String` 또는 `null` | Body | 크리에이티브의 이름 | -| `deep_link_path` | `String` | Body | 사용자가 이동되는 인앱 목적지를 지정합니다. 단일 플랫폼 앱에 사용하시기 바랍니다. | -| `ios_deep_link_path` | `String` | Body | 사용자가 이동되는 iOS 인앱 목적지를 지정합니다. 멀티 플랫폼 iOS 앱 또는 복합 링크에 사용하시기 바랍니다. | -| `android_deep_link_path` | `String` | Body | 사용자가 이동되는 Android 인앱 목적지를 지정합니다. 멀티 플랫폼 Android 앱 또는 복합 링크에 사용하시기 바랍니다. | -| `fallback` | `String` | Body | 오프 플랫폼 사용자를 보내는 랜딩 페이지. 폴백 URL을 지정할 때 macOS 사용자에 대해 `redirect_macos` 를 지정하는 것을 권장합니다. | -| `redirect_macos` | `String` | Body | macOS에 대한 Adjust의 디폴트 리다이렉트를 오버라이드하기 위한 리다이렉트 URL. `fallback` 를 지정할 때, macOS 사용자를 위해 이 파라미터를 지정하는 것을 권장합니다. | -| `label` | `String` | Body | 링크에 커스텀 데이터를 추가합니다. 이 파라미터를 사용하여 사용자가 앱에서 짧은 링크를 공유할 때 자동으로 입력되는 고유한 [사용자 리퍼러 ID](https://help.adjust.com/ko/article/set-up-user-referrals) 를 추가할 수 있습니다. | -| `og_title` | `String` | Body | 링크의 소셜 공유 미리보기 제목. | -| `og_description` | `String` | Body | 링크의 소셜 공유 미리보기에 대한 설명. | -| `og_image` | `String` | Body | 링크의 소셜 공유 미리보기를 위한 최소 200 x 200 픽셀 크기의 JPG 또는 PNG 이미지 URL. | - -## 단일 딥링크 {#generate-a-single-deep-link} 생성 +파라미터 \{\#parameters\} +------------------------ + +| 파라미터 | 데이터 유형 | In | 설명 | +|--------------------------|--------------------|------|-----------------------------------------------------------------------------------------------------------------------------------------------------------| +| `adjust_auth_token` | `String` | 헤더 | Adjust API 토큰 | +| `link_token` | `String` | Body | 커스텀 링크의 링크 토큰. 결합된 링크에서 딥링크를 생성하는 경우, Campaign Lab에서 결합된 커스텀 링크로부터의 올바른 링크 토큰을 사용해야 합니다. | +| `shorten_url` | `Boolean` | Body | 링크 단축 여부. 기본값은 단축하지 않은 링크로 설정되어 있습니다. 기본값 \- false | +| `campaign` | `String` 또는 `null` | Body | 캠페인의 이름 | +| `adgroup` | `String` 또는 `null` | Body | 광고그룹 이름 | +| `creative` | `String` 또는 `null` | Body | 크리에이티브의 이름 | +| `deep_link_path` | `String` | Body | 사용자가 이동되는 인앱 목적지를 지정합니다. 단일 플랫폼 앱에 사용하시기 바랍니다. | +| `ios_deep_link_path` | `String` | Body | 사용자가 이동되는 iOS 인앱 목적지를 지정합니다. 멀티 플랫폼 iOS 앱 또는 복합 링크에 사용하시기 바랍니다. | +| `android_deep_link_path` | `String` | Body | 사용자가 이동되는 Android 인앱 목적지를 지정합니다. 멀티 플랫폼 Android 앱 또는 복합 링크에 사용하시기 바랍니다. | +| `fallback` | `String` | Body | 오프 플랫폼 사용자를 보내는 랜딩 페이지. 폴백 URL을 지정할 때 macOS 사용자에 대해 \`redirect\_macos\`를 지정하는 것을 권장합니다. | +| `redirect_macos` | `String` | Body | macOS에 대한 Adjust의 디폴트 리다이렉트를 오버라이드하기 위한 리다이렉트 URL. `fallback`을 지정할 때 macOS 사용자에 대해 이 파라미터를 설정하는 것을 권장합니다. | +| `label` | `String` | Body | 링크에 커스텀 데이터를 추가합니다. 이 파라미터를 사용하여 사용자가 앱에서 단축 링크를 공유할 때 자동으로 입력되는 고유한 [사용자 리퍼러 ID](https://help.adjust.com/en/article/set-up-user-referrals) 를 추가할 수 있습니다. | +| `og_title` | `String` | Body | 링크의 소셜 공유 미리보기 제목. | +| `og_description` | `String` | Body | 링크의 소셜 공유 미리보기에 대한 설명. | +| `og_image` | `String` | Body | 링크의 소셜 공유 미리보기를 위한 최소 200 x 200 픽셀 크기의 JPG 또는 PNG 이미지에 대한 URL. | + +단일 딥링크 \{\#generate\-a\-single\-deep\-link\} 생성 +------------------------------------------------------ `POST` 요청을 전송하여 단일 또는 멀티 플랫폼 앱에 대해 긴/단축 딥링크를 생성합니다. -### 엔드포인트 {#endpoint-single} +### 엔드포인트 \{\#endpoint\-single\} ```http https://automate.adjust.com/engage/deep-links ``` -### 예 {#examples-single} +### 예 \{\#examples\-single\} -**단일 플랫폼 앱** - - +**단일 플랫폼 앱** + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -119,18 +117,16 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - - + ```http {"url": "https://insights.go.link/fryYl"} ``` - - -**멀티 플랫폼 앱** + - +**멀티 플랫폼 앱** + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -146,20 +142,18 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - - + ```json { "url": "https://insights.go.link/jlbKj" } ``` - - -**복합 링크** + -딥링크 생성기 API를 사용하여 딥링크를 생성하기 전에 [Campaign Lab에서 복합 커스텀 링크](https://help.adjust.com/ko/article/custom-link-setup) 를 생성해야 합니다. +**복합 링크** - +딥링크 생성기 API를 사용하여 딥링크를 생성하기 전에 [Campaign Lab에서 복합 커스텀 링크](https://help.adjust.com/en/article/custom-link-setup) 를 생성해야 합니다. + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -176,28 +170,28 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - - + ```http {"url": "https://insights.go.link/6JtQx"} ``` - + -## 딥링크 일괄 생성 {#generate-deep-links-in-bulk} +딥링크 일괄 생성 \{\#generate\-deep\-links\-in\-bulk\} +------------------------------------------------------ `POST` 요청을 전송하여 단일 또는 멀티 플랫폼 앱에 대해 긴/단축 딥링크를 일괄 생성합니다. -### 엔드포인트 {#endpoint-bulk} +### 엔드포인트 \{\#endpoint\-bulk\} ```http https://automate.adjust.com/engage/deep-links/bulk ``` -### 예 {#example-bulk} +### 예 \{\#example\-bulk\} - + ```bash curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ @@ -231,8 +225,7 @@ curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ }' ``` - - + ```json { @@ -250,21 +243,22 @@ curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ } ``` - + -## 단축 링크 토큰 업데이트 {#update-short-link-token} +단축 링크 토큰 업데이트 \{\#update\-short\-link\-token\} +---------------------------------------------------- `PUT` 요청을 전송하여 딥링크의 기존 단축 링크 토큰을 긴 링크로 업데이트합니다. -### 엔드포인트 {#endpoint-update} +### 엔드포인트 \{\#endpoint\-update\} ```http https://automate.adjust.com/engage/deep-links/{short_token} ``` -### 예 {#example-update} +### 예 \{\#example\-update\} - + ```bash curl --location --request PUT 'https://automate.adjust.com/engage/deep-links/4IlkC' \ @@ -278,11 +272,11 @@ curl --location --request PUT 'https://automate.adjust.com/engage/deep-links/4Il }' ``` - - + ```http 204 No Content ``` + From f218b0dd64615d50241daee8af5fa1e15bf38b08 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 08:15:46 +0000 Subject: [PATCH 02/13] File src/content/docs/en/api/deep-link-generator-api.mdx was translated to zh-CN locale --- .../docs/zh/api/deep-link-generator-api.mdx | 162 +++++++++--------- 1 file changed, 78 insertions(+), 84 deletions(-) diff --git a/src/content/docs/zh/api/deep-link-generator-api.mdx b/src/content/docs/zh/api/deep-link-generator-api.mdx index afbd7cc3d..b181227d6 100644 --- a/src/content/docs/zh/api/deep-link-generator-api.mdx +++ b/src/content/docs/zh/api/deep-link-generator-api.mdx @@ -1,49 +1,46 @@ --- -title: 深度链接生成器 API -description: 使用深度链接生成器 API，您可以单独或批量创建应用定制深度链接。 -category-title: 深度链接生成器 API -slug: zh/api/deep-link-generator-api +title: "深度链接生成器 API" +description: "使用深度链接生成器 API，您可以单独或批量创建应用定制深度链接。" +category-title: "深度链接生成器 API" +slug: "en/api/deep-link-generator-api" sidebar-position: 8 --- - 使用深度链接生成器 API，您可以单独或批量创建应用定制深度链接。这些深度链接可长可短，能改善各个平台的用户体验。 -## 操作前须知 {#before-you-begin} +操作前须知 \{\#before\-you\-begin\} +----------------------------------- 以下是您在操作前需要了解的内容。 -### 可用性{#availability} +### 可用性\{\#availability\} - + 深度链接生成器 API 的速率限制为每秒 200 个请求。如果超过此限制，您将收到 429 报错。 + - - -- 您需要使用 TrueLink Core 或 Enterprise 套餐才能使用深度链接生成器 API。 -- 使用深度链接生成器 API 创建的链接不会出现在 [Campaign Lab](https://help.adjust.com/zh/article/campaign-setup)中。 -- 使用深度链接生成器 API 创建的短链接的 TTL \(生存时间\) 为 120 天。 - -### 要求{#requirements} - -- 管理员、编辑员或自定义编辑员[权限](https://help.adjust.com/zh/article/permission-levels)。 -- 为您的 iOS 和安卓应用[设置相同的品牌化域名](https://help.adjust.com/zh/article/set-up-branded-domain)。 - - - 对于 iOS 应用，请确保将您的品牌化域名添加为[Associated Domain \(关联域名\)](https://help.adjust.com/zh/article/set-up-branded-domain#ios-only-update)。此操作会将域名设置为通用链接。 - - 对于安卓应用，请确保将品牌化域名定义为[Android App Link \(安卓应用链接\)](https://help.adjust.com/zh/article/set-up-android-app-links)。 +* 您需要使用 TrueLink Core 或 Enterprise 套餐才能使用深度链接生成器 API。 +* 使用深度链接生成器 API 创建的链接不会出现在 [Campaign Lab](https://help.adjust.com/en/article/campaign-setup)中。 +* 使用深度链接生成器 API 创建的短链接的 TTL \(生存时间\) 为 120 天。 -- 应用的自定义链接。 +### 要求\{\#requirements\} - - 单一平台应用、多平台应用 \- [在 Campaign Lab 中创建自定义链接](https://help.adjust.com/zh/article/custom-link-setup)，获得单个链接识别码。 - - 多个单一平台应用 \-[在 Campaign Lab](https://help.adjust.com/zh/article/custom-link-setup#combined-custom-links)中使用多个单一平台应用创建单个复合自定义链接，其中包含以“\_”分隔的多个链接识别码。要了解更多信息，请查看[复合自定义链接的平台特定链接识别码](https://help.adjust.com/zh/article/manage-custom-link-setup#link-tokens-combined-custom-link)。 +* 管理员、编辑员或自定义编辑员[权限](https://help.adjust.com/en/article/permission-levels)。 +* 为您的 iOS 和安卓应用[设置相同的品牌化域名](https://help.adjust.com/en/article/set-up-branded-domain)。 + * 对于 iOS 应用，请确保将您的品牌化域名添加为[Associated Domain \(关联域名\)](https://help.adjust.com/en/article/set-up-branded-domain#ios-only-update)。此操作会将域名设置为通用链接。 + * 对于安卓应用，请确保将品牌化域名定义为[Android App Link \(安卓应用链接\)](https://help.adjust.com/en/article/set-up-android-app-links)。 -- 更新 Adjust SDK 来解析短链接。 +* 应用的自定义链接。 + * 单一平台应用、多平台应用 \- [在 Campaign Lab 中创建自定义链接](https://help.adjust.com/en/article/custom-link-setup)，获得单个链接识别码。 + * 多个单一平台应用 \-[在 Campaign Lab](https://help.adjust.com/en/article/custom-link-setup#combined-custom-links)中使用多个单一平台应用创建单个复合自定义链接，其中包含以“\_”分隔的多个链接识别码。要了解更多信息，请查看[复合自定义链接的平台特定链接识别码](https://help.adjust.com/en/article/manage-custom-link-setup#link-tokens-combined-custom-link)。 - - [iOS](/zh/sdk/ios/features/short-links) \|[安卓](/zh/sdk/android/features/short-links)\| [Unity](/zh/sdk/unity/features/short-links) \| [React Native](/zh/sdk/react-native/features/short-links) \| [Flutter](/zh/sdk/flutter/features/short-links) \| [Cordova](/zh/sdk/cordova/features/short-links) \| [Cocos2d\-x](/zh/sdk/cocos2dx/features/short-links) +* 更新 Adjust SDK 来解析短链接。 + * [iOS](/en/sdk/ios/features/short-links) \|[安卓](/en/sdk/android/features/short-links)\| [Unity](/en/sdk/unity/features/short-links) \| [React Native](/en/sdk/react-native/features/short-links) \| [Flutter](/en/sdk/flutter/features/short-links) \| [Cordova](/en/sdk/cordova/features/short-links) \| [Cocos2d\-x](/en/sdk/cocos2dx/features/short-links) -- 如果您已[设置数据驻留](https://help.adjust.com/zh/article/data-residency-setup)，请确保 iOS 和安卓应用使用同一地区。 +* 如果您已[设置数据驻留](https://help.adjust.com/en/article/data-residency-setup)，请确保 iOS 和安卓应用使用同一地区。 -## 认证{#authentication} +认证\{\#authentication\} +------------------------- 深度链接生成器 API 使用 [Bearer 识别码](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication)进行认证。您必须在向深度链接生成器 API 发出的每个请求的 `Authorization` 标头中包含您的 Adjust API 识别码。 @@ -56,7 +53,7 @@ sidebar-position: 8 3. 选择 **个人档案** 标签页。 4. 您的 **API 识别码** 会显示在 **用户详细信息** 中。选择复制按钮来将识别码复制到您的系统剪贴板。 -### 重置 Adjust API 识别码{#reset-your-adjust-api-token} +### 重置 Adjust API 识别码\{\#reset\-your\-adjust\-api\-token\} 您可以随时重置 Adjust API 识别码。重置后，旧的识别码将失效。如果您重置了 Adjust API 识别码，请务必在所有使用识别码的位置进行替换。使用无效识别码发送的请求会被 Adjust 拒绝。 @@ -70,41 +67,42 @@ sidebar-position: 8 6. 在窗口中输入账户密码并选择 **重置** 来重置您的 API 识别码。屏幕右上角会显示确认信息。 7. 选择 **API 识别码** 旁的复制按钮来将识别码复制到您的系统剪贴板。 -## 参数{#parameters} - -| 参数 | 数据类型 | 位置 | 描述 | -| ------------------------ | ------------------ | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `adjust_auth_token` | `String` | 标头 | Adjust API 识别码 | -| `link_token` | `String` | 正文 \(Body\) | 自定义链接的链接识别码。如果您是从复合链接生成深度链接，请务必在 Campaign Lab 中使用复合自定义链接的正确链接识别码。 | -| `shorten_url` | `Boolean` | 正文 \(Body\) | 链接是否会被缩短。默认情况下链接不会被缩短。默认值 \- false | -| `campaign` | `String` 或 `null` | 正文 \(Body\) | 推广活动名称 | -| `adgroup` | `String` 或 `null` | 正文 \(Body\) | 广告组名称 | -| `creative` | `String` 或 `null` | 正文 \(Body\) | 素材名称 | -| `deep_link_path` | `String` | 正文 \(Body\) | 指定用户被转至的应用内位置。适用于单一平台应用。 | -| `ios_deep_link_path` | `String` | 正文 \(Body\) | 指定用户被转至的 iOS 应用内位置。适用于多平台 iOS 应用或复合链接。 | -| `android_deep_link_path` | `String` | 正文 \(Body\) | 指定用户被转至的安卓应用内位置。适用于多平台安卓应用或复合链接。 | -| `fallback` | `String` | 正文 \(Body\) | 非默认平台用户被转到的登陆页。在指定后备 URL 时，我们建议为 macOS 用户指定 `redirect_macos`。 | -| `redirect_macos` | `String` | 正文 \(Body\) | 重定向 URL，用于覆盖 Adjust 针对 macOS 的默认重定向。在指定 `fallback` 时，我们建议为 macOS 用户指定该参数。 | -| `label` | `String` | 正文 \(Body\) | 向链接附加自定义数据。使用该参数，添加唯一的[用户推荐 ID](https://help.adjust.com/zh/article/set-up-user-referrals)。用户分享来自应用的短链接时，该 ID 会自动填充。 | -| `og_title` | `String` | 正文 \(Body\) | 链接在社交媒体上分享的预览标题。 | -| `og_description` | `String` | 正文 \(Body\) | 链接社交平台分享预览的描述。 | -| `og_image` | `String` | 正文 \(Body\) | JPG 或 PNG 图片的 URL，大小至少为 200 x 200 像素，用于链接的社交分享预览。 | - -## 生成单个深度链接{#generate-a-single-deep-link} +参数\{\#parameters\} +--------------------- + +| 参数 | 数据类型 | 位置 | 描述 | +|--------------------------|-------------------|---------------|---------------------------------------------------------------------------------------------------------------------| +| `adjust_auth_token` | `String` | 标头 | Adjust API 识别码 | +| `link_token` | `String` | 正文 \(Body\) | 自定义链接的链接识别码。如果您是从复合链接生成深度链接，请务必在 Campaign Lab 中使用复合自定义链接的正确链接识别码。 | +| `shorten_url` | `Boolean` | 正文 \(Body\) | 链接是否会被缩短。默认情况下链接不会被缩短。默认值 \- false | +| `campaign` | `String` 或 `null` | 正文 \(Body\) | 推广活动名称 | +| `adgroup` | `String` 或 `null` | 正文 \(Body\) | 广告组名称 | +| `creative` | `String` 或 `null` | 正文 \(Body\) | 素材名称 | +| `deep_link_path` | `String` | 正文 \(Body\) | 指定用户被转至的应用内位置。适用于单一平台应用。 | +| `ios_deep_link_path` | `String` | 正文 \(Body\) | 指定用户被转至的 iOS 应用内位置。适用于多平台 iOS 应用或复合链接。 | +| `android_deep_link_path` | `String` | 正文 \(Body\) | 指定用户被转至的安卓应用内位置。适用于多平台安卓应用或复合链接。 | +| `fallback` | `String` | 正文 \(Body\) | 非默认平台用户被转到的登陆页。在指定后备 URL 时，我们建议为 macOS 用户指定 `redirect_macos`。 | +| `redirect_macos` | `String` | 正文 \(Body\) | 重定向 URL，用于覆盖 Adjust 针对 macOS 的默认重定向。在指定 `fallback` 时，我们建议为 macOS 用户指定该参数。 | +| `label` | `String` | 正文 \(Body\) | 向链接附加自定义数据。使用该参数，添加唯一的[用户推荐 ID](https://help.adjust.com/en/article/set-up-user-referrals)。用户分享来自应用的短链接时，该 ID 会自动填充。 | +| `og_title` | `String` | 正文 \(Body\) | 链接在社交媒体上分享的预览标题。 | +| `og_description` | `String` | 正文 \(Body\) | 链接社交平台分享预览的描述。 | +| `og_image` | `String` | 正文 \(Body\) | JPG 或 PNG 图片的 URL，大小至少为 200 x 200 像素，用于链接的社交分享预览。 | + +生成单个深度链接\{\#generate\-a\-single\-deep\-link\} +---------------------------------------------------- 发送 `POST` 请求，为单一或多平台应用生成长或短深度链接。 -### 终端{#endpoint-single} +### 终端\{\#endpoint\-single\} ```http https://automate.adjust.com/engage/deep-links ``` -### 示例 {#examples-single} +### 示例 \{\#examples\-single\} -**单一平台应用** - - +**单一平台应用** + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -119,18 +117,16 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - - + ```http {"url": "https://insights.go.link/fryYl"} ``` - - -**多平台应用** + - +**多平台应用** + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -146,20 +142,18 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - - + ```json { "url": "https://insights.go.link/jlbKj" } ``` - - -**复合链接** + -在使用深度链接生成器 API 生成深度链接之前，请务必[在 Campaign Lab 中创建复合自定义链接](https://help.adjust.com/zh/article/custom-link-setup)。 +**复合链接** - +在使用深度链接生成器 API 生成深度链接之前，请务必[在 Campaign Lab 中创建复合自定义链接](https://help.adjust.com/en/article/custom-link-setup)。 + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -176,28 +170,28 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - - + ```http {"url": "https://insights.go.link/6JtQx"} ``` - + -## 批量生成深度链接{#generate-deep-links-in-bulk} +批量生成深度链接\{\#generate\-deep\-links\-in\-bulk\} +---------------------------------------------------- 发送`POST` 请求，为单一或多平台应用批量生成长或短深度链接。 -### 终端{#endpoint-bulk} +### 终端\{\#endpoint\-bulk\} ```http https://automate.adjust.com/engage/deep-links/bulk ``` -### 示例 {#example-bulk} +### 示例 \{\#example\-bulk\} - + ```bash curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ @@ -231,8 +225,7 @@ curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ }' ``` - - + ```json { @@ -250,21 +243,22 @@ curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ } ``` - + -## 更新短链接识别码{#update-short-link-token} +更新短链接识别码\{\#update\-short\-link\-token\} +---------------------------------------------- 发送 `PUT` 请求，将深度链接中的现有短链接识别码更新为长链接识别码。 -### 终端{#endpoint-update} +### 终端\{\#endpoint\-update\} ```http https://automate.adjust.com/engage/deep-links/{short_token} ``` -### 示例 {#example-update} +### 示例 \{\#example\-update\} - + ```bash curl --location --request PUT 'https://automate.adjust.com/engage/deep-links/4IlkC' \ @@ -278,11 +272,11 @@ curl --location --request PUT 'https://automate.adjust.com/engage/deep-links/4Il }' ``` - - + ```http 204 No Content ``` + From cc42817f901cd184726c0d94a798870a2b6d6438 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 08:15:49 +0000 Subject: [PATCH 03/13] File src/content/docs/en/api/deep-link-generator-api.mdx was translated to ja-JP locale --- .../docs/ja/api/deep-link-generator-api.mdx | 162 +++++++++--------- 1 file changed, 78 insertions(+), 84 deletions(-) diff --git a/src/content/docs/ja/api/deep-link-generator-api.mdx b/src/content/docs/ja/api/deep-link-generator-api.mdx index 60dc73bf7..45e8c4420 100644 --- a/src/content/docs/ja/api/deep-link-generator-api.mdx +++ b/src/content/docs/ja/api/deep-link-generator-api.mdx @@ -1,49 +1,46 @@ --- -title: ディープリンクジェネレーター API -description: ディープリンクジェネレーターAPIを使用して、アプリ用に短縮および長いディープリンクを個別あるいは一括で作成できます。 -category-title: ディープリンクジェネレーター API -slug: ja/api/deep-link-generator-api +title: "ディープリンクジェネレーター API" +description: "ディープリンクジェネレーターAPIを使用して、アプリ用に短縮および長いディープリンクを個別あるいは一括で作成できます。" +category-title: "ディープリンクジェネレーター API" +slug: "en/api/deep-link-generator-api" sidebar-position: 8 --- - ディープリンクジェネレーターAPIを使用して、アプリ用の短いおよび長いディープリンクを個別または一括で作成できます。これらのカスタマイズされたディープリンクは、さまざまなプラットフォームでユーザー体験を向上させます。 -## 事前準備 {#before-you-begin} +事前準備 \{\#before\-you\-begin\} +---------------------------------- はじめに、以下の設定手順をご覧ください。 -### ご利用の条件 {#availability} +### ご利用の条件 \{\#availability\} - + ディープリンクジェネレーターAPIには、1秒あたり200リクエストのレート制限があります。この制限を超えると、429エラーが発生します。 + - - -- ディープリンクジェネレーターAPIは、TrueLinkのCoreまたはEnterpriseのパッケージにご契約のお客様にご利用いただけます。 -- ディープリンクジェネレーターAPIを使用して作成されたリンクは、 [Campaign Lab](https://help.adjust.com/ja/article/campaign-setup)に表示されません。 -- ディープリンクジェネレーターAPIを使用して作成されたショートリンクのTTL（有効期間）は120日です。 - -### 要件 {#requirements} - -- 管理者、編集者およびカスタムの編集者の[アクセス権限](https://help.adjust.com/ja/article/permission-levels)。 -- iOSアプリとAndroidアプリに[同じブランドドメインを設定](https://help.adjust.com/ja/article/set-up-branded-domain)していること。 - - - iOSアプリの場合、ブランドドメインを[関連ドメイン（Associated Domain）](https://help.adjust.com/ja/article/set-up-branded-domain#ios-only-update)として追加するようにしてください。これにより、ドメインがユニバーサルリンクとして設定されるようになります。 - - Androidアプリの場合、ブランドドメインを[Android アプリリンク（Android App Link）](https://help.adjust.com/ja/article/set-up-android-app-links)として定義するようにしてください。 +* ディープリンクジェネレーターAPIは、TrueLinkのCoreまたはEnterpriseのパッケージにご契約のお客様にご利用いただけます。 +* ディープリンクジェネレーターAPIを使用して作成されたリンクは、 [Campaign Lab](https://help.adjust.com/en/article/campaign-setup)に表示されません。 +* ディープリンクジェネレーターAPIを使用して作成されたショートリンクのTTL（有効期間）は120日です。 -- アプリのカスタムリンク。 +### 要件 \{\#requirements\} - - シングルプラットフォームアプリ、マルチプラットフォームアプリ \- [Campaign Labでカスタムリンクを作成して](https://help.adjust.com/ja/article/custom-link-setup)、単一のリンクトークンを取得します。 - - 複数のシングルプラットフォームアプリ \- 複数のシングルプラットフォームアプリから[Campaign Labでカスタムリンク](https://help.adjust.com/ja/article/custom-link-setup#combined-custom-links)を作成し、「\_」で区切られた複数のリンクトークンを含む、1つの複合カスタムリンクを作成します。詳細については、[複合カスタムリンク向けプラットフォーム固有のリンクトークンを](https://help.adjust.com/ja/article/manage-custom-link-setup#link-tokens-combined-custom-link)参照してください。 +* 管理者、編集者およびカスタムの編集者の[アクセス権限](https://help.adjust.com/en/article/permission-levels)。 +* iOSアプリとAndroidアプリに[同じブランドドメインを設定](https://help.adjust.com/en/article/set-up-branded-domain)していること。 + * iOSアプリの場合、ブランドドメインを[関連ドメイン（Associated Domain）](https://help.adjust.com/en/article/set-up-branded-domain#ios-only-update)として追加するようにしてください。これにより、ドメインがユニバーサルリンクとして設定されるようになります。 + * Androidアプリの場合、ブランドドメインを[Android アプリリンク（Android App Link）](https://help.adjust.com/en/article/set-up-android-app-links)として定義するようにしてください。 -- Adjust SDKを更新して、短縮リンクを解決すること。 +* アプリのカスタムリンク。 + * シングルプラットフォームアプリ、マルチプラットフォームアプリ \- [Campaign Labでカスタムリンクを作成して](https://help.adjust.com/en/article/custom-link-setup)、単一のリンクトークンを取得します。 + * 複数のシングルプラットフォームアプリ \- 複数のシングルプラットフォームアプリから[Campaign Labでカスタムリンク](https://help.adjust.com/en/article/custom-link-setup#combined-custom-links)を作成し、「\_」で区切られた複数のリンクトークンを含む、1つの複合カスタムリンクを作成します。詳細については、[複合カスタムリンク向けプラットフォーム固有のリンクトークンを](https://help.adjust.com/en/article/manage-custom-link-setup#link-tokens-combined-custom-link)参照してください。 - - [iOS](/ja/sdk/ios/features/short-links) \| [Android](/ja/sdk/android/features/short-links) \| [Unity](/ja/sdk/unity/features/short-links) \| [React Native](/ja/sdk/react-native/features/short-links) \| [Flutter](/ja/sdk/flutter/features/short-links) \| [Cordova](/ja/sdk/cordova/features/short-links) \| [Cocos2d\-x](/ja/sdk/cocos2dx/features/short-links) +* Adjust SDKを更新して、短縮リンクを解決すること。 + * [iOS](/en/sdk/ios/features/short-links) \| [Android](/en/sdk/android/features/short-links) \| [Unity](/en/sdk/unity/features/short-links) \| [React Native](/en/sdk/react-native/features/short-links) \| [Flutter](/en/sdk/flutter/features/short-links) \| [Cordova](/en/sdk/cordova/features/short-links) \| [Cocos2d\-x](/en/sdk/cocos2dx/features/short-links) -- [データレジデンシーを設定](https://help.adjust.com/ja/article/data-residency-setup)している場合、iOSアプリとAndroidアプリで同じ地域を使用していることを確認してください。 +* [データレジデンシーを設定](https://help.adjust.com/en/article/data-residency-setup)している場合、iOSアプリとAndroidアプリで同じ地域を使用していることを確認してください。 -## 認証 {#authentication} +認証 \{\#authentication\} +-------------------------- ディープリンクジェネレーターは、[ベアラートークン](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication)を使用して認証します。ディープリンクジェネレーターAPIへの各リクエストには、Adjust APIトークンを`Authorization`ヘッダーに必ず含める必要があります。 @@ -56,7 +53,7 @@ SSO以外のアカウントの場合、APIガイドはユーザーの **プロ 3. **マイプロフィール（My Profile）** を選択します。 4. **APIトークン** が **ユーザー情報（User details）** に表示されます。コピーボタンを選択して、トークンをクリップボードにコピーします。 -### Adjust APIトークンをリセットする {#reset-your-adjust-api-token} +### Adjust APIトークンをリセットする \{\#reset\-your\-adjust\-api\-token\} Adjust APIトークンはいつでもリセットできます。トークンをリセットすると、古いトークンは無効になります。Adjust APIトークンをリセットした場合、使用中の古いトークンを新しいトークンに置き換える必要があります。無効になったトークンを使用したリクエストは、Adjustによって拒否されます。 @@ -70,41 +67,42 @@ Adjust APIトークンをリセットする方法： 6. 表示されたモーダルにアカウントのパスワードを入力し、 **リセット** を選択してAPIトークンをリセットします。画面の右上に確認メッセージが表示されます。 7. **APIトークン** の横にあるコピーボタンを選択して、トークンをクリップボードにコピーします。 -## パラメーター {#parameters} - -| パラメーター | データタイプ | 入力する値 | 説明 | -| ------------------------ | ---------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `adjust_auth_token` | `String` | 説明 | Adjust APIトークン | -| `link_token` | `String` | ボディ | カスタムリンクのリンクトークン。複合リンクからディープリンクを生成している場合、Campaign Labで組み合わせたカスタムリンクの正しいリンクトークンを使用していることを確認してください。 | -| `shorten_url` | `Boolean` | ボディ | リンクが短縮されるかどうか。リンクはデフォルトでは短縮されません。デフォルト値 \- false | -| `campaign` | `String` または `null` | ボディ | キャンペーンの名前 | -| `adgroup` | `String` または `null` | ボディ | アドグループの名前 | -| `creative` | `String` または `null` | ボディ | クリエイティブの名前 | -| `deep_link_path` | `String` | ボディ | ユーザーが遷移するアプリ内の遷移先を指定。シングルプラットフォームアプリにはこれを使用してください。 | -| `ios_deep_link_path` | `String` | ボディ | ユーザーが遷移するiOSのアプリ内の遷移先を指定。マルチプラットフォームのiOSアプリまたは複合リンクにはこれを使用してください。 | -| `android_deep_link_path` | `String` | ボディ | ユーザーが遷移するiOSのアプリ内の遷移先を指定。マルチプラットフォームのiOSアプリまたは複合リンクにはこれを使用してください。 | -| `fallback` | `String` | ボディ | オフプラットフォームのユーザーを送るランディングページ。フォールバックURLを指定する際には、macOSユーザー向けに`redirect_macos`を指定することをお勧めします。 | -| `redirect_macos` | `String` | ボディ | macOSのAdjustのデフォルトリダイレクトを上書きするリダイレクトURL。\`fallback\` を指定する場合は、macOSユーザー向けに`fallback`を指定することをお勧めします。 | -| `label` | `String` | ボディ | リンクにカスタムデータを追加します。このパラメーターを使用して、ユーザーがアプリからショートリンクを共有した際に自動入力される一意の[ユーザー紹介ID](https://help.adjust.com/ja/article/set-up-user-referrals)を追加できます。 | -| `og_title` | `String` | ボディ | リンクのソーシャル共有プレビューのタイトル。 | -| `og_description` | `String` | ボディ | リンクのソーシャル共有プレビューの説明。 | -| `og_image` | `String` | ボディ | ソーシャル共有プレビューに使用する、200 x 200 ピクセル以上のJPGまたはPNG形式の画像のURLを指定。 | - -## 単一のディープリンクを生成{#generate-a-single-deep-link} +パラメーター \{\#parameters\} +-------------------------- + +| パラメーター | データタイプ | 入力する値 | 説明 | +|--------------------------|---------------------|-------|------------------------------------------------------------------------------------------------------------------------------------------------| +| `adjust_auth_token` | `String` | 説明 | Adjust APIトークン | +| `link_token` | `String` | ボディ | カスタムリンクのリンクトークン。複合リンクからディープリンクを生成している場合、Campaign Labで組み合わせたカスタムリンクの正しいリンクトークンを使用していることを確認してください。 | +| `shorten_url` | `Boolean` | ボディ | リンクが短縮されるかどうか。リンクはデフォルトでは短縮されません。デフォルト値 \- false | +| `campaign` | `String` または `null` | ボディ | キャンペーンの名前 | +| `adgroup` | `String` または `null` | ボディ | アドグループの名前 | +| `creative` | `String` または `null` | ボディ | クリエイティブの名前 | +| `deep_link_path` | `String` | ボディ | ユーザーが遷移するアプリ内の遷移先を指定。シングルプラットフォームアプリにはこれを使用してください。 | +| `ios_deep_link_path` | `String` | ボディ | ユーザーが遷移するiOSのアプリ内の遷移先を指定。マルチプラットフォームのiOSアプリまたは複合リンクにはこれを使用してください。 | +| `android_deep_link_path` | `String` | ボディ | ユーザーが遷移するiOSのアプリ内の遷移先を指定。マルチプラットフォームのiOSアプリまたは複合リンクにはこれを使用してください。 | +| `fallback` | `String` | ボディ | オフプラットフォームのユーザーを送るランディングページ。フォールバックURLを指定する際には、macOSユーザー向けに`redirect_macos`を指定することをお勧めします。 | +| `redirect_macos` | `String` | ボディ | macOSのAdjustのデフォルトリダイレクトを上書きするリダイレクトURL。\`fallback\` を指定する場合は、macOSユーザー向けに`fallback`を指定することをお勧めします。 | +| `label` | `String` | ボディ | リンクにカスタムデータを追加します。このパラメーターを使用して、ユーザーがアプリからショートリンクを共有した際に自動入力される一意の[ユーザー紹介ID](https://help.adjust.com/en/article/set-up-user-referrals)を追加できます。 | +| `og_title` | `String` | ボディ | リンクのソーシャル共有プレビューのタイトル。 | +| `og_description` | `String` | ボディ | リンクのソーシャル共有プレビューの説明。 | +| `og_image` | `String` | ボディ | ソーシャル共有プレビューに使用する、200 x 200 ピクセル以上のJPGまたはPNG形式の画像のURLを指定。 | + +単一のディープリンクを生成\{\#generate\-a\-single\-deep\-link\} +--------------------------------------------------------- シングルまたはマルチプラットフォームのアプリ用に、長いまたは短縮ディープリンクを生成するには、`POST`リクエストを送信します。 -### エンドポイント {#endpoint-single} +### エンドポイント \{\#endpoint\-single\} ```http https://automate.adjust.com/engage/deep-links ``` -### 例 {#examples-single} +### 例 \{\#examples\-single\} -**シングルプラットフォームアプリ** - - +**シングルプラットフォームアプリ** + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -119,18 +117,16 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - - + ```http {"url": "https://insights.go.link/fryYl"} ``` - - -**マルチプラットフォームアプリ** + - +**マルチプラットフォームアプリ** + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -146,20 +142,18 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - - + ```json { "url": "https://insights.go.link/jlbKj" } ``` - - -**複合リンク** + -ディープリンクジェネレーターAPIを使用してディープリンクを生成する前に、[Campaign Labで複合カスタムリンクを作成](https://help.adjust.com/ja/article/custom-link-setup)してください。 +**複合リンク** - +ディープリンクジェネレーターAPIを使用してディープリンクを生成する前に、[Campaign Labで複合カスタムリンクを作成](https://help.adjust.com/en/article/custom-link-setup)してください。 + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -176,28 +170,28 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - - + ```http {"url": "https://insights.go.link/6JtQx"} ``` - + -## ディープリンクを一括で生成{#generate-deep-links-in-bulk} +ディープリンクを一括で生成\{\#generate\-deep\-links\-in\-bulk\} +--------------------------------------------------------- シングルまたはマルチプラットフォームのアプリ用に、長いまたは短縮ディープリンクを一括で生成するには、`POST`リクエストを送信します。 -### エンドポイント {#endpoint-bulk} +### エンドポイント \{\#endpoint\-bulk\} ```http https://automate.adjust.com/engage/deep-links/bulk ``` -### 例 {#example-bulk} +### 例 \{\#example\-bulk\} - + ```bash curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ @@ -231,8 +225,7 @@ curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ }' ``` - - + ```json { @@ -250,21 +243,22 @@ curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ } ``` - + -## ショートリンクトークンを更新{#update-short-link-token} +ショートリンクトークンを更新\{\#update\-short\-link\-token\} +---------------------------------------------------- `PUT`リクエストを送信して、ディープリンク内の既存のショートリンクトークンを長いリンクに更新します。 -### エンドポイント {#endpoint-update} +### エンドポイント \{\#endpoint\-update\} ```http https://automate.adjust.com/engage/deep-links/{short_token} ``` -### 例 {#example-update} +### 例 \{\#example\-update\} - + ```bash curl --location --request PUT 'https://automate.adjust.com/engage/deep-links/4IlkC' \ @@ -278,11 +272,11 @@ curl --location --request PUT 'https://automate.adjust.com/engage/deep-links/4Il }' ``` - - + ```http 204 No Content ``` + From 42285117351b3ecb892402a89bf1b5e8929c854e Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 08:15:52 +0000 Subject: [PATCH 04/13] File src/content/docs/en/sdk/ios/v4/features/deep-links/resolution.mdx was translated to ko-KR locale --- .../ios/v4/features/deep-links/resolution.mdx | 105 ++++++++---------- 1 file changed, 47 insertions(+), 58 deletions(-) diff --git a/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx b/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx index 7b7151b39..642b07994 100644 --- a/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx +++ b/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx @@ -1,27 +1,27 @@ --- -title: 링크 해석(resolution) -description: 이메일, SMS, QR 코드 또는 링크 단축 플랫폼을 통한 딥링킹의 경우, 링크 해석(link resolution)을 설정합니다. -slug: ko/sdk/ios/v4/features/deep-links/resolution +title: "링크 해석(resolution)" +description: "이메일, SMS, QR 코드 또는 링크 단축 플랫폼을 통한 딥링킹의 경우, 링크 해석(link resolution)을 설정합니다." +slug: "en/sdk/ios/v4/features/deep-links/resolution" sidebar-position: 5 -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ko/sdk/ios/features/deep-links/resolution +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/features/deep-links/resolution" --- - 이메일, SMS, QR 코드 또는 링크 단축 플랫폼을 통한 딥링킹의 경우, 링크 해석\(link resolution\)을 설정해야 합니다. 링크 해석이 없다면, 유니버설 링크에 의한 리다이렉트가 모든 사용자\(앱 설치 사용자 포함\)를 앱 스토어로 이동시키게 됩니다. 링크 해석이 설정되면 유니버설 링크로의 리다이렉트가 앱 내에서 작동하여, 기존 사용자는 앱 스토어로 이동되지 않습니다. - - + 마케팅팀과 확인하여 앱에 링크 해석이 필요한지 확인하시기 바랍니다. 다양한 시나리오에 맞게 링크 해석을 설정할 수 있습니다. + - - -## 작동 방식 {#how-it-works} +작동 방식 \{\#how\-it\-works\} +------------------------------- 앱을 설치한 사용자가 리다이렉트 URL을 클릭하는 경우에만 링크 해석이 필요하며, 리다이렉트 URL의 도메인을 앱에서의 유니버설 링크 도메인으로써 구성해야 합니다. @@ -33,44 +33,41 @@ redirects: 3. Adjust SDK의 링크 해석 메서드는 리다이렉트 URL의 도메인을 개발자가 Adjust SDK에서 설정한 링크 해석 도메인과 비교하고, 다음 중 하나의 결과가 발생합니다. - - 도메인이 일치하지 않음 \- 메서드가 딥링크 URL을 그대로 전달합니다. - - 도메인이 일치함 \- 메서드가 링크를 해석하고, 결과 딥링크를 반환합니다. - - Adjust SDK는 URL을 해석하려고 시도할 때 최대 10개의 리다이렉트를 따릅니다. 10개 이상의 리다이렉트가 있는 경우 SDK는 10번째 리다이렉트 URL을 반환합니다. + * 도메인이 일치하지 않음 \- 메서드가 딥링크 URL을 그대로 전달합니다. + * 도메인이 일치함 \- 메서드가 링크를 해석하고, 결과 딥링크를 반환합니다. + Adjust SDK는 URL을 해석할 때 최대 10개의 리다이렉트를 따릅니다. 10개 이상의 리다이렉트가 있는 경우 SDK는 10번째 리다이렉트 URL을 반환합니다. 4. 앱은 반환된 URL을 수신하고, 딥링크 내용을 실행하여 사용자에게 표시합니다. 앱은 또한 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. 이는 해석된 URL을 기록을 위해 Adjust 서버로 전송합니다. - + 앱을 설치하지 않은 사용자가 리다이렉트 URL을 클릭하면, iOS는 이를 일반적인 웹 URL로 처리하여, 사용자를 앱 스토어로 리다이렉트합니다. 이 경우, 링크 해석이 적용되지 않습니다. + - - -## 사용 사례 {#use-cases} +활용법 \{\#use\-cases\} +------------------------ 링크 해석은 다음에 적용될 수 있습니다. -- [이메일 마케팅](#email-marketing) -- [URL을 단축한 플랫폼](#url-shorteners) +* [이메일 마케팅](#email-marketing) +* [URL을 단축한 플랫폼](#url-shorteners) -### 이메일 마케팅 {#email-marketing} +### 이메일 마케팅 \{\#email\-marketing\} 이메일 마케터가 캠페인을 진행할 때, 이메일 마케팅 플랫폼은 일반적으로 자체 클릭 측정 리다이렉트 URL을 사용하여 이메일의 모든 링크를 래핑합니다. 이를 통해 이메일 마케터는 이메일 마케팅 플랫폼에서 클릭률 통계를 볼 수 있습니다. 하지만 이메일에 Adjust 유니버셜 링크가 포함된 경우, 리다이렉트 URL은 iOS가 Adjust 유니버셜 링크를 해석하는 것을 방해합니다. -- 이메일 마케팅 플랫폼: 이메일 마케터가 캠페인 구축을 위해 사용하는 소프트웨어. 일반적으로 이메일 템플릿이나 오디언스 타겟팅과 같은 기능을 포함합니다. **예:** Braze, Iterable, SendGrid -- ESP\(이메일 서비스 제공자\): 이메일을 전송하고 ISP\(인터넷 서비스 제공자\) 이메일 서버로의 전달률을 관리하는 기저 인프라. **예:** SendGrid, SparkPost -- 이메일 파트너: 이메일 마케팅 플랫폼 또는 ESP\(이메일 서비스 제공자\)를 지칭하는 일반적인 용어. 이메일 파트너는 이메일 마케팅 플랫폼이나 ESP 또는 둘 다가 될 수 있습니다. **예:** SendGrid는 이메일 마케팅 플랫폼이자 ESP입니다. 이메일 마케팅에서 ESP를 또다른 파트너로 이용할 수 있습니다. **예:** Braze와 Iterable은 둘 다 SendGrid, SparkPost를 ESP로 이용합니다. +* 이메일 마케팅 플랫폼: 이메일 마케터가 캠페인 구축을 위해 사용하는 소프트웨어. 일반적으로 이메일 템플릿이나 오디언스 타겟팅과 같은 기능을 포함합니다. **예:** Braze, Iterable, SendGrid +* ESP\(이메일 서비스 제공자\): 이메일을 전송하고 ISP\(인터넷 서비스 제공자\) 이메일 서버로의 전달률을 관리하는 기저 인프라. **예:** SendGrid, SparkPost +* 이메일 파트너: 이메일 마케팅 플랫폼 또는 ESP\(이메일 서비스 제공자\)를 지칭하는 일반적인 용어. 이메일 파트너는 이메일 마케팅 플랫폼이나 ESP 또는 둘 다가 될 수 있습니다. **예:** SendGrid는 이메일 마케팅 플랫폼이자 ESP입니다. 이메일 마케팅에서 ESP를 또다른 파트너로 이용할 수 있습니다. **예:** Braze와 Iterable은 둘 다 SendGrid, SparkPost를 ESP로 이용합니다. -#### 설정 {#setup} +#### 설정 \{\#setup\} 1. 도메인을 생성하거나, 이메일 측정에 사용될 도메인에 하위 도메인을 생성합니다. 이메일 측정에 사용할 도메인/하위 도메인이 이미 있는 경우, 기존의 캠페인에 대한 영향 없이 이 구현을 완료할 수 있도록 새로운 도메인/하위 도메인을 생성해야 합니다. 구현 과정이 완료되고 테스트 된 이후, 다시 이 구현을 기존 이메일 리다이렉트 도메인으로 전환할 수 있습니다. **예시:** `email.example.com` - 2. Xcode의 **Associated Domains** 구성에 이메일 리다이렉트 도메인을 추가합니다. **예시:** `applinks:email.example.com` - 3. 유니버설 링크를 설정합니다. 4. 이메일 리다이렉트 도메인을 `resolveLinkWithUrl` 링크 해석 메서드의 `resolveUrlSuffixArray`에 추가했는지 확인합니다. @@ -82,38 +79,35 @@ redirects: 1. **SSL 인증서** : iOS에서는 유니버설 링크가 HTTPS만 사용할 수 있습니다. 따라서 이메일 리다이렉트 도메인에 SSL 인증서가 필요합니다. 2. **AASA\(Apple\-App\-Site\-Association\) 파일** : 이메일 파트너에 따라 AASA 파일을 직접 호스트하거나, AASA 파일을 이메일 파트너 시스템에 업로드해야 합니다. AASA 파일 호스트에 관한 정보는, 이메일 파트너의 관련 문서를 참조하시기 바랍니다. - 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. + 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` + 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. **예시:** `redirect.example.net` - 7. 이메일 리다이렉트 도메인에 대해 DNS를 구성하여 CDN으로 전달되도록 합니다. - - -위 설명에 상응하는 파트너별 설명의 경우, Adjust 헬프 센터의 [ESP 연동](https://help.adjust.com/ko/marketer/esp-integrations)을 참조하시기 바랍니다. + - +위 설명에 상응하는 파트너별 설명의 경우, Adjust 헬프 센터의 [ESP 연동](https://help.adjust.com/en/marketer/esp-integrations)을 참조하시기 바랍니다. + -##### 이메일 파트너 지원 {#support-for-email-partners} +##### 이메일 파트너 지원 \{\#support\-for\-email\-partners\} 링크 해석을 사용하려면 리다이렉트 도메인\(또는 하위 도메인\)을 유니버설 링크 도메인으로 설정할 수 있도록 이메일 파트너의 허용이 필요합니다. 이 경우, 이메일 파트너의 리다이렉션 서비스를 자체 맞춤 도메인으로 전달할 수 있습니다. -**예시:** +**예시:** -- Braze: Braze가 할당된 ESP에 따라, SendGrid 또는 SparkPost에서 리다이렉트 도메인을 설정하고 커스텀 도메인을 지정합니다. 이후 커스텀 도메인을 유니버설 링크 도메인으로 설정할 수 있습니다. -- Iterable: Iterable은 커스텀 도메인을 지원하는 URL 리다이렉트 서비스를 제공합니다. -- Mailchimp: Mailchimp은 리다이렉트 도메인을 유니버설 링크로 구성하도록 허용하지 않기 때문에 링크 해석을 이용할 수 없습니다. +* Braze: Braze가 할당된 ESP에 따라, SendGrid 또는 SparkPost에서 리다이렉트 도메인을 설정하고 커스텀 도메인을 지정합니다. 이후 커스텀 도메인을 유니버설 링크 도메인으로 설정할 수 있습니다. +* Iterable: Iterable은 커스텀 도메인을 지원하는 URL 리다이렉트 서비스를 제공합니다. +* Mailchimp: Mailchimp은 리다이렉트 도메인을 유니버설 링크로 구성하도록 허용하지 않기 때문에 링크 해석을 이용할 수 없습니다. -#### 예시 {#example} +#### 예 \{\#example\} 1. 이메일 마케터는 템플릿을 사용해 이메일을 빌드합니다. 템플릿은 링크 또는 유니버설 링크가 있는 이미지를 포함합니다. **예시:** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` - 2. 이메일 마케터가 수신인에게 이메일을 발송합니다. 이메일이 발송되기 전, 이메일 마케팅 플랫폼은 유니버설 링크를 자체 리다이렉트 URL로 래핑합니다. **예시:** `https://email.example.com/2wuTnQvU` - 3. 앱을 설치한 사용자가 이메일의 리다이렉트 URL을 클릭합니다. 4. iOS가 앱을 실행하고, 리다이렉트 URL을 앱에 전달합니다. @@ -124,18 +118,17 @@ redirects: 따라서 `https://email.example.com/2wuTnQvU` 은/는 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 으로 리다이렉트됩니다. - 7. 링크 해석 메서드는 해석된 URL을 반환합니다. 8. 앱이 반환된 URL을 처리합니다. 이 경우 앱은 사용자에게 `summer-clothes` 페이지를 `beach promo` 모달과 함께 표시합니다. 9. 앱은 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. -### URL 단축하기 {#url-shorteners} +### URL 단축기 \{\#url\-shorteners\} 특정 유형의 캠페인의 경우, URL을 단축해야 할 때가 있습니다. 예를 들어, SMS에는 160자의 글자 수 제한이 있으며, 소비자들이 단축 링크를 Slack과 같은 협업툴에 공유하길 원할 수 있습니다. 하지만 단축 URL이 유니버셜 링크로 리다이렉트 될 경우, iOS는 Adjust 유니버셜 링크를 해석하지 못합니다. -#### 설정 {#setup-1} +#### 설정 \{\#setup\-1\} 1. 도메인을 생성하거나, URL 단축에 사용될 도메인에 하위 도메인을 생성합니다. 이미 URL 단축에 사용할 도메인/하위 도메인이 있는 경우, 기존의 캠페인에 대한 영향 없이 이 구현을 완료할 수 있도록 새로운 도메인/하위 도메인을 생성해야 합니다. 이 구현 과정이 완료되고 테스트되면, 이 구현을 기존 URL 단축 도메인으로 전환할 수 있습니다. @@ -143,7 +136,6 @@ redirects: 2. Xcode의 **Associated Domains** 구성에 URL 단축 도메인을 추가합니다. **예시:** `applinks:short.example.com` - 3. 유니버설 링크를 설정합니다. 4. 이메일 리다이렉트 도메인을 `resolveLinkWithUrl` 링크 해석 메서드의 `resolveUrlSuffixArray`에 추가했는지 확인합니다. @@ -151,21 +143,18 @@ redirects: 5. 유니버설 링크를 지원하는 URL 단축 서비스를 설정합니다. Adjust는 URL 단축 서비스를 제공하지 않습니다. **예:** [`short.io`](http://short.io) - 6. URL 단축 도메인을 URL 단축 서비스의 맞춤 도메인으로 구성합니다. URL 단축 도메인에 대해 DNS를 구성하여 URL 단축 서비스의 서버로 전달되도록 해야 합니다. \([short.io에 커스텀 도메인을 추가하기 위한 참고 문서](https://help.short.io/en/articles/9991681-how-can-i-add-a-domain)\). 7. URL 단축 서비스에서 유니버설 링크를 구성합니다. \([short.io에 유니버설 링크를 구성하기 위한 참고 문서](https://help.short.io/en/articles/4065870-how-to-set-up-deep-links-for-ios)\). -#### 예시 {#example-1} +#### 예 \{\#example\-1\} 1. 마케터가 유니버설 링크를 생성합니다. **예시:** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` - 2. 마케터가 URL 단축 서비스를 사용하여 단축 링크를 생성합니다. **예시:** `https://short.example.com/2wuTnQvU` - 3. 마케터가 단축 링크를 캠페인\(예: SMS\)에 사용합니다. 4. 앱을 설치한 사용자가 SMS 메시지에서 단축 링크를 클릭합니다. @@ -178,9 +167,9 @@ redirects: 따라서 `https://short.example.com/2wuTnQvU` 은/는 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 으로 리다이렉트됩니다. - 8. 링크 해석 메서드는 해석된 URL을 반환합니다. 9. 앱이 반환된 URL을 처리합니다. 이 경우 앱은 사용자에게 `summer-clothes` 페이지를 `beach promo` 모달과 함께 표시합니다. -10. 앱은 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. +10. 앱은 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. + From bf81ec91969c33133d34052f0097f07393be3a3e Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 08:15:55 +0000 Subject: [PATCH 05/13] File src/content/docs/en/sdk/ios/v4/features/deep-links/resolution.mdx was translated to zh-CN locale --- .../ios/v4/features/deep-links/resolution.mdx | 113 ++++++++---------- 1 file changed, 51 insertions(+), 62 deletions(-) diff --git a/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx b/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx index a49a84ca1..733cfb2f2 100644 --- a/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx +++ b/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx @@ -1,27 +1,27 @@ --- -title: 链接解析 -description: 对于通过电邮、短信、二维码和短链接生成平台的深度链接，请设置链接解析。 -slug: zh/sdk/ios/v4/features/deep-links/resolution +title: "链接解析" +description: "对于通过电邮、短信、二维码和短链接生成平台的深度链接，请设置链接解析。" +slug: "en/sdk/ios/v4/features/deep-links/resolution" sidebar-position: 5 -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /zh/sdk/ios/features/deep-links/resolution +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/features/deep-links/resolution" --- - -对于通过电邮、短信、二维码和短链接生成平台的深度链接，请务必设置链接解析，否则，通用链接重定向会将所有用户转到 App Store，其中包括已安装应用的用户。设置连接解析后，通用链接重定向会在您的应用内发生，现有用户不会被转到 App Store。 - - +对于通过电邮、短信、二维码和短链接生成平台的深度链接，请务必设置链接解析，否则，通用链接重定向会将所有用户转到 App Store，其中包括已安装应用的用户。设置链接解析后，通用链接重定向会在您的应用内发生，现有用户不会被转到 App Store。 + 请咨询您的营销团队，决定应用是否需要链接解析。随后，您就可以针对不同用例设置链接解析域了。 + - - -## 工作原理 {#how-it-works} +工作原理\{\#how\-it\-works\} +----------------------------- 仅在已安装应用的用户点击重定向 URL 时，链接解析才适用。请在应用中将重定向 URL 域配置为通用链接域。 @@ -31,46 +31,43 @@ redirects: 2. 您的应用会将重定向 URL 传送至 Adjust SDK 中的 `resolveLinkWithUrl` 链接解析方法 。 -3. Adjust SDK 中的连接解析方法会参考开发者在 Adjust SDK 中设置的链接解析域，对比重定向 URL 中的域。对比结果分两种： +3. Adjust SDK 中的链接解析方法会参考开发者在 Adjust SDK 中设置的链接解析域，对比重定向 URL 中的域。对比结果分两种： - - 域不匹配 \- 方法会按原样转发深度链接 URL。 - - 域匹配 \- 方法解析链接并返回解析所得的深度链接 - - 在尝试解析 URL 时，Adjust SDK 会追溯最多 10 个重定向 \(redirect\)，也就是说，如果要追溯的重定向超过 10 个，那么 SDK 就会返回第 10 个重定向 URL。 + * 域不匹配 \- 方法会按原样转发深度链接 URL。 + * 域匹配 \- 方法解析链接并返回解析所得的深度链接。 + 在尝试解析 URL 时，Adjust SDK 会追溯最多 10 个重定向，也就是说，如果要追溯的重定向超过 10 个，那么 SDK 就会返回第 10 个重定向 URL。 4. 应用收到返回的 URL，打开展示深度链接内容并将其展示给用户。您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。此操作会将已解析的 URL 发送给 Adjust 服务器用于记录。 - + 如果未安装应用的用户点击了重定向 URL，那么 iOS 就会以正常网页 URL 方式进行处理，将用户重定向至 App Store。链接解析不适用这种情况。 + - - -## 使用案例 {#use-cases} +使用案例\{\#use\-cases\} +------------------------ 下列情况中适用链接解析： -- [电子邮件营销](#email-marketing) -- [短 URL 生成平台](#url-shorteners) +* [电子邮件营销](#email-marketing) +* [短 URL 生成平台](#url-shorteners) -### 电子邮件营销 {#email-marketing} +### 电子邮件营销\{\#email\-marketing\} 电邮营销人员开展推广时，电邮营销平台会通过其自有的点击监测重定向 URL 包装邮件中的所有链接。这样，电邮营销人员就能在平台上看到点击数据。不过，如果电邮中包含通用链接，那么重定向 URL 会导致 iOS 无法解析通用链接。 -- 电子邮件营销平台：电邮营销人员用来打造推广活动的软件，其中包括电邮模板、受众定向等功能。 **示例：** Braze，Iterable，SendGrid -- 电邮服务提供商 \(ESP\)：能发送电邮、管理对互联网服务提供商 \(ISP\) 电邮服务器交付活动的底层基础架构。 **示例：** SendGrid，SparkPost。 -- 电子邮件合作伙伴：用来指代电子邮件营销平台或电子邮件服务提供商 \(ESP\) 的一般术语。电子邮件合作伙伴可以是电邮营销平台或 ESP，也可以两者皆是。 **示例：** SendGrid 既是电邮营销平台，也是ESP。电邮营销可能使用其他 ESP 合作伙伴。 **示例：** Graze 和 Iterable 的 ESP 都是 SendGrid 和 SparkPost。 +* 电子邮件营销平台：电邮营销人员用来打造推广活动的软件，其中包括电邮模板、受众定向等功能。 **示例：** Braze，Iterable，SendGrid +* 电邮服务提供商 \(ESP\)：能发送电邮、管理对互联网服务提供商 \(ISP\) 电邮服务器交付活动的底层基础架构。 **示例：** SendGrid，SparkPost。 +* 电子邮件合作伙伴：用来指代电子邮件营销平台或电子邮件服务提供商 \(ESP\) 的一般术语。电子邮件合作伙伴可以是电邮营销平台或 ESP，也可以两者皆是。 **示例：** SendGrid 既是电邮营销平台，也是ESP。电邮营销可能使用其他 ESP 合作伙伴。 **示例：** Graze 和 Iterable 的 ESP 都是 SendGrid 和 SparkPost。 -#### 设置 {#setup} +#### 设置 \{\#setup\} 1. 在您的域上创建专门用于电子邮件监测的域或子域。如果您已经拥有专门用于电子邮件监测的域或子域，您应当重新创建，以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后，您就可以换用自己现有的电邮重定向域。 **示例：** `email.example.com` - 2. 在 Xcode 中向您的 **Associated Domain** \(关联域\) 配置添加电邮重定向域。 **示例：** `applinks:email.example.com` - 3. 设置您的通用链接。 4. 确保已将您的电邮重定向域添加到 `resolveLinkWithUrl` 链接解析方法的 `resolveUrlSuffixArray` 中。 @@ -82,38 +79,35 @@ redirects: 1. **SSL 证书** ：iOS 要求所有通用链接只能使用 HTTPS。因此，您的电邮重定向域必须拥有 SSL 证书。 2. **AASA \(Apple\-App\-Site\-Association\) 文件** ：您需要自行托管 AASA 文件，或将 AASA 文件上传至电邮合作伙伴的系统中，具体视您的电邮合作伙伴情况而定。请查看电邮合作伙伴的文档，了解 AASA 文件托管信息。 - 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件，那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 + 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件，那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` + 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 **示例：** `redirect.example.net` - 7. 进行 DNS 配置，让电邮重定向域指向 CDN。 - - -请访问帮助中心的 [ESP 集成](https://help.adjust.com/zh/marketer/esp-integrations)版面，了解与上述操作对应的具体合作伙伴操作说明。 + - +请访问帮助中心的 [ESP 集成](https://help.adjust.com/en/marketer/esp-integrations)版面，了解与上述操作对应的具体合作伙伴操作说明。 + -##### 电邮服务合作伙伴支持 {#support-for-email-partners} +##### 电邮服务合作伙伴支持\{\#support\-for\-email\-partners\} 要使用链接解析，您的电邮服务合作伙伴需要允许您将通用链接域设为重定向域 \(或子域\)。在这种情况下，您可以将合作伙伴的重定向服务指向您自己的自定义域。 -**示例：** +**示例：** -- Braze：根据 Braze 指定的 ESP，设置 SendGrid 或 SparkPost 的重定向域，并将您的自定义域指向该重定向域。随后就可以将自定义域设置为通用链接域了。 -- Iterable：Iterable 的 URL 重定向服务支持自定义域。 -- Mailchimp：Mailchimp 不允许您将其重定向域配置为通用链接，因此您无法采用链接解析。 +* Braze：根据 Braze 指定的 ESP，设置 SendGrid 或 SparkPost 的重定向域，并将您的自定义域指向该重定向域。随后就可以将自定义域设置为通用链接域了。 +* Iterable：Iterable 的 URL 重定向服务支持自定义域。 +* Mailchimp：Mailchimp 不允许您将其重定向域配置为通用链接，因此您无法采用链接解析。 -#### 示例 {#example} +#### 示例 \{\#example\} 1. 电邮营销人员使用模板创建电子邮件。该模板包含链接或带有通用链接的图片。 **示例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` - 2. 电邮营销人员将邮件发送给收件人。在发送邮件前，电邮营销平台会用自己的重定向 URL 包装通用链接。 **示例：** `https://email.example.com/2wuTnQvU` - 3. 已安装应用的用户点击电子邮件中的重定向 URL。 4. iOS 打开您的应用，将重定向 URL 发送至应用。 @@ -124,25 +118,23 @@ redirects: 因此，`https://email.example.com/2wuTnQvU` 会重定向至 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 。 - 7. 链接解析方法返回已解析的 URL。 8. 您的应用处理返回的 URL。在这种情况下，您的应用将在应用中显示 `summer-clothes` 页面，用户会看到 `beach promo` 弹窗。 9. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。 -### URL 缩短服务 {#url-shorteners} +### URL 缩短服务\{\#url\-shorteners\} -有时，营销人员需要在特定类型的推广活动用到短 URL。例如：短信文本长度上限为 160 个字符。有时，客户需要缩短链接，好在 Slack 等团队通讯平台上分享。不过，如果短 URL 重定向到通用链接，那么 iOS 就不会解析通用链接。 +有时，营销人员需要在特定类型的推广活动中用到短 URL。例如：短信文本长度上限为 160 个字符。有时，客户需要缩短链接，以便在 Slack 等团队通讯平台上分享。不过，如果短 URL 重定向到通用链接，那么 iOS 就不会解析通用链接。 -#### 设置 {#setup-1} +#### 设置 \{\#setup\-1\} -1. 在您的域上创建专门用于缩短 URL 的域或子域。如果您已经拥有专门用于缩短 URL 的域或子域，您还是应当重新创建，以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后，您就可以换用自己现有的 URL 缩短域。 +1. 在您的域上创建专门用于缩短 URL 的域或子域。如果您已经拥有专门用于缩短 URL 的域或子域，也还是应当重新创建，以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后，您就可以换用自己现有的 URL 缩短域。 2. 在 Xcode 中向您的 **Associated Domain** \(关联域\) 配置添加短 URL 域。 **示例：** `applinks:short.example.com` - 3. 设置您的通用链接。 4. 确保已将您的电邮重定向域添加到 `resolveLinkWithUrl` 链接解析方法的 `resolveUrlSuffixArray` 中。 @@ -150,21 +142,18 @@ redirects: 5. 设置支持通用链接的 URL 缩短服务。请注意：Adjust 不提供任何 URL 缩短服务。 **示例** ：[`short.io`](http://short.io) - 6. 在短 URL 生成服务平台上，将短 URL 生成域配置为自定义域。您需要进行 DNS 配置，才能让短 URL 生成域指向短 URL 生成服务的服务器。\([在 short.io 中添加自定义域的参考文档](https://help.short.io/en/articles/9991681-how-can-i-add-a-domain)\)。 7. 在 URL 缩短服务中配置通用链接。\([在 short.io 中设置通用链接的参考文档](https://help.short.io/en/articles/4065870-how-to-set-up-deep-links-for-ios)\)。 -#### 示例 {#example-1} +#### 示例 \{\#example\-1\} 1. 营销人员创建通用链接。 **示例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` - 2. 营销人员使用 URL 缩短服务生成短链接。 **示例：** `https://short.example.com/2wuTnQvU` - 3. 营销人员在推广活动中使用短链接，例如短信推广活动。 4. 已安装应用的用户点击短信中的短 URL。 @@ -177,9 +166,9 @@ redirects: 因此，`https://short.example.com/2wuTnQvU` 会重定向至 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 。 - 8. 链接解析方法返回已解析的 URL。 9. 您的应用处理返回的 URL。在这种情况下，您的应用将在应用中显示 `summer-clothes` 页面，用户会看到 `beach promo` 弹窗。 -10. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。 +10. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。 + From fe8916a1fac7cf8f178279ea630ac88cfcd1e03b Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 08:15:58 +0000 Subject: [PATCH 06/13] File src/content/docs/en/sdk/ios/v4/features/deep-links/resolution.mdx was translated to ja-JP locale --- .../ios/v4/features/deep-links/resolution.mdx | 105 ++++++++---------- 1 file changed, 47 insertions(+), 58 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx b/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx index 30327a66f..6da819a6b 100644 --- a/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx +++ b/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx @@ -1,27 +1,27 @@ --- -title: リンクのresolution（解析と変換） -description: メール、SMS、QRコード、リンクを短縮するプラットフォームを介したディープリンクのリンク解析を設定します。 -slug: ja/sdk/ios/v4/features/deep-links/resolution +title: "リンクのresolution（解析と変換）" +description: "メール、SMS、QRコード、リンクを短縮するプラットフォームを介したディープリンクのリンク解析を設定します。" +slug: "en/sdk/ios/v4/features/deep-links/resolution" sidebar-position: 5 -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v5: /ja/sdk/ios/features/deep-links/resolution +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v5: "/en/sdk/ios/features/deep-links/resolution" --- - メール、SMS、QRコード、リンクを短縮するプラットフォームを介したディープリンクのリンク解析を設定する必要があります。そのようなケースのためにリンク解析を設定しない場合、ユニバーサルリンクからのリダイレクトでは、アプリをインストールしているユーザーを含めた全てのユーザーがApp Storeに誘導されます。リンク解析が有効な場合、ユニバーサルリンクへのリダイレクトはアプリ内で発生し、既存のユーザーはApp Storeに誘導されません。 - - + リンク解析がアプリに必要かどうか、マーケティングチームに確認してください。その後、各ユースケースに合わせてリンク解析ドメインを設定できます。 + - - -## 仕組み {#how-it-works} +仕組み \{\#how\-it\-works\} +----------------------------- リンク解析は、アプリをインストールしているユーザーがリダイレクトURLをクリックしたときにのみ実行されます。リダイレクトURL内のドメインを、アプリ内のユニバーサルリンクドメインとして設定する必要があります。 @@ -33,44 +33,41 @@ redirects: 3. Adjust SDKのリンク解析メソッドで、リダイレクトURL内のドメインと開発者がAdjust SDKで設定したリンク解析ドメインが比較され、次のいずれかが実行されます。 - - ドメインが一致しない \- メソッドはディープリンクURLをそのまま転送します。 - - ドメインが一致する \- メソッドはリンクを解析し、結果のディープリンクを返します。 - - URLの解析と変換が行われると、Adjust SDKは最大10のリダイレクトをフォローアップします。リダイレクトが10以上ある場合は、10番目のリダイレクトURLが返されます。 + * ドメインが一致しない \- メソッドはディープリンクURLをそのまま転送します。 + * ドメインが一致する \- メソッドはリンクを解析し、結果のディープリンクを返します。 + URLの解析を試みると、Adjust SDKは最大10のリダイレクトをフォローアップします。リダイレクトが10以上ある場合は、10番目のリダイレクトURLが返されます。 4. アプリは返されたURLを受け取り、ディープリンクコンテンツを開いてユーザーに表示します。またアプリは、返されたURLを使用してAdjust SDKの`appWillOpenUrl`メソッドを呼び出します。これにより、解析されたURLが記録のためにAdjustサーバーに送られます。 - + アプリをインストールしていないユーザーがリダイレクトURLをクリックした場合、iOSはこれを通常のWeb URLとして処理し、ユーザーをApp Storeにリダイレクトします。この場合、リンク解析は実行されません。 + - - -## ユース ケース {#use-cases} +ユースケース \{\#use\-cases\} +--------------------------- リンク解析は、次の場合に実行されます。 -- [Eメールマーケティング](#email-marketing) -- [URLを短縮するプラットフォーム](#url-shorteners) +* [Eメールマーケティング](#email-marketing) +* [URLを短縮するプラットフォーム](#url-shorteners) -### Eメールマーケティング {#email-marketing} +### Eメールマーケティング \{\#email\-marketing\} メールマーケターがキャンペーンを実施する際、メールマーケティングプラットフォームでは通常、独自のクリック計測用リダイレクトURLを使用してメール内の全てのリンクをラップします。これによりメールマーケターは、メールマーケティングプラットフォームでクリック率を確認できます。ただし、メールにユニバーサルリンクが含まれている場合、リダイレクトURLが原因でiOSはユニバーサルリンクを解析できません。 -- メールマーケティングプラットフォーム：メールマーケターがキャンペーンを構築するために使用するソフトウェア。これには、メールテンプレートやオーディエンスターゲティングなどの機能が含まれます。 **例：** Braze、Iterable、SendGrid -- メールサービスプロバイダー（ESP）：メールを送信し、ISP（インターネットサービスプロバイダー）のメールサーバーへの送達可能性を管理する基盤インフラストラクチャー。 **例：** SendGrid、SparkPost -- メールパートナー：メールマーケティングプラットフォームまたはメールサービスプロバイダー（ESP）のいずれかを表す一般的な用語。メールパートナーとは、メールマーケティングプラットフォーム、ESP、またはその両方を指します。 **例：** SendGridはメールマーケティングプラットフォームであり、ESPでもあります。メールマーケティングでは、他のパートナーをESPとして使用することができます。 **例：** BrazeとIterableはどちらもSendGridとSparkPostをESPとして使用しています。 +* メールマーケティングプラットフォーム：メールマーケターがキャンペーンを構築するために使用するソフトウェア。これには、メールテンプレートやオーディエンスターゲティングなどの機能が含まれます。 **例：** Braze、Iterable、SendGrid +* メールサービスプロバイダー（ESP）：メールを送信し、ISP（インターネットサービスプロバイダー）のメールサーバーへの送達可能性を管理する基盤インフラストラクチャー。 **例：** SendGrid、SparkPost +* メールパートナー：メールマーケティングプラットフォームまたはメールサービスプロバイダー（ESP）のいずれかを表す一般的な用語。メールパートナーとは、メールマーケティングプラットフォーム、ESP、またはその両方を指します。 **例：** SendGridはメールマーケティングプラットフォームであり、ESPでもあります。メールマーケティングでは、他のパートナーをESPとして使用することができます。 **例：** BrazeとIterableはどちらもSendGridとSparkPostをESPとして使用しています。 -#### 設定 {#setup} +#### \{\#setup\} の設定 1. 使用しているドメイン上に、メール計測専用のドメインまたはサブドメインを作成します。メール計測用のドメインまたはサブドメインがすでにある場合は、既存のキャンペーンを妨げることなくこの実装を完了できるよう、新たに作成することをお勧めします。この実装を完了してテストした後に、この実装を既存のメールリダイレクトドメインに切り替えることができます。 **例：** `email.example.com` - 2. Xcodeで、メールリダイレクトドメインを **Associated Domains** 設定に追加します。 **例：** `applinks:email.example.com` - 3. ユニバーサルリンクを設定します。 4. `resolveLinkWithUrl`リンク解析メソッドの`resolveUrlSuffixArray`にメールリダイレクトドメインが追加されていることを確認します。 @@ -82,38 +79,35 @@ redirects: 1. **SSL証明書** ：iOSでは、ユニバーサルリンクでHTTPSのみを使用する必要があります。そのため、メールリダイレクトドメインにはSSL証明書が必要です。 2. **AASA（Apple\-App\-Site\-Association）ファイル** ：メールパートナーによっては、独自のAASAファイルをホストするか、AASAファイルをメールパートナーシステムにアップロードする必要があります。AASAファイルのホスティングについては、メールパートナーのドキュメントを参照してください。 - 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます：`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` 3. （該当する場合、AASAファイルを除いた）メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 + 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます：`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` + 3. （該当する場合、AASAファイルを除いた）メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 **例：** `redirect.example.net` - 7. CDNをポイントするようにメールリダイレクトドメインのDNSを設定します。 - - -上記の指示に対応するパートナー固有の指示については、ヘルプセンターの[ESP連携に関するセクション](https://help.adjust.com/ja/marketer/esp-integrations)を参照してください。 + - +上記の指示に対応するパートナー固有の指示については、ヘルプセンターの[ESP連携に関するセクション](https://help.adjust.com/en/marketer/esp-integrations)を参照してください。 + -##### メールパートナーのサポート {#support-for-email-partners} +##### メールパートナーのサポート \{\#support\-for\-email\-partners\} リンク解析を使用するには、リダイレクトドメイン（またはサブドメイン）をユニバーサルリンクドメインとして設定することをメールパートナーが許可している必要があります。許可されている場合、それらのリダイレクトサービスを独自のカスタムドメインにポイントできます。 -**例：** +**例：** -- Braze：割り当てられているESP Brazeに応じて、SendGridまたはSparkPostでリダイレクトドメインを設定し、独自のカスタムドメインをそれにポイントします。その後、カスタムドメインをユニバーサルリンクドメインとして設定できます。 -- Iterable：Iterableでは、カスタムドメインをサポートするURLリダイレクトサービスが提供されています。 -- Mailchimp：Mailchimpでは、リダイレクトドメインをユニバーサルリンクとして設定することが許可されていないため、リンク解析は利用できません。 +* Braze：割り当てられているESP Brazeに応じて、SendGridまたはSparkPostでリダイレクトドメインを設定し、独自のカスタムドメインをそれにポイントします。その後、カスタムドメインをユニバーサルリンクドメインとして設定できます。 +* Iterable：Iterableでは、カスタムドメインをサポートするURLリダイレクトサービスが提供されています。 +* Mailchimp：Mailchimpでは、リダイレクトドメインをユニバーサルリンクとして設定することが許可されていないため、リンク解析は利用できません。 -#### 例 {#example} +#### 例 \{\#example\} 1. メールマーケターが、テンプレートを使用してメールを作成します。このテンプレートには、ユニバーサルリンクを使用したリンクまたは画像が含まれています。 **例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` - 2. 受信者リストに対して、メールを送信します。メールが送信される前に、メールマーケティングプラットフォームは、独自のリダイレクトURLを使用してユニバーサルリンクをラップします。 **例：** `https://email.example.com/2wuTnQvU` - 3. アプリをインストールしたユーザーが、メール内のリダイレクトURLをクリックします。 4. iOSがアプリを開き、リダイレクトURLをアプリにパスします。 @@ -124,18 +118,17 @@ redirects: したがって、 `https://email.example.com/2wuTnQvU` は `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123`にリダイレクトされます。 - 7. リンク解析メソッドが、解析されたURLを返します。 8. アプリが、返されたURLを処理します。この場合、アプリは`summer-clothes`ページをアプリ内に`beach promo`モーダルでユーザーに表示します。 9. アプリは返されたURLでAdjust SDKの`appWillOpenUrl`メソッドを呼び出します。 -### URL短縮 {#url-shorteners} +### URL短縮 \{\#url\-shorteners\} マーケターが特定の種類のキャンペーンを実施する際、短いURLが必要になる場合があります。例えば、SMSには160文字の制限がありますが、リンクを短縮してSlackなどのチームコミュニケーションプラットフォームで共有することを顧客が望む場合があります。ただし、短縮URLがユニバーサルリンクにリダイレクトされる場合、iOSはユニバーサルリンクを解析できません。 -#### 設定 {#setup-1} +#### \{\#setup\-1\} の設定 1. 使用しているドメイン上に、URL短縮専用のドメインまたはサブドメインを作成します。 URL短縮用のドメインまたはサブドメインがすでにある場合は、既存のキャンペーンを妨げることなくこの実装を完了できるよう、新たに作成することをお勧めします。この実装を完了してテストした後に、この実装を既存のURL短縮ドメインに切り替えることができます。 @@ -143,7 +136,6 @@ redirects: 2. XcodeでURL短縮ドメインを **Associated Domains** 設定に追加します。 **例：** `applinks:short.example.com` - 3. ユニバーサルリンクを設定します。 4. `resolveLinkWithUrl`リンク解析メソッドの`resolveUrlSuffixArray`にメールリダイレクトドメインが追加されていることを確認します。 @@ -151,21 +143,18 @@ redirects: 5. ユニバーサルリンクをサポートするURL短縮サービスを設定します。AdjustではURL短縮サービスを提供していません。 **例：** [`short.io`](http://short.io) - 6. URL短縮サービスで、URL短縮ドメインをカスタムドメインとして設定します。URL短縮サービスのサーバーをポイントするように、URL短縮ドメインのDNSを設定してください（[short.ioにカスタムドメインを追加する参照ドキュメント](https://help.short.io/en/articles/9991681-how-can-i-add-a-domain)）。 7. URL短縮サービスでユニバーサルリンクを設定します（[short.ioのユニバーサルリンクを設定する参照ドキュメント](https://help.short.io/en/articles/4065870-how-to-set-up-deep-links-for-ios)）。 -#### 例 {#example-1} +#### 例 \{\#example\-1\} 1. マーケターがユニバーサルリンクを作成します。 **例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` - 2. URL短縮サービスを使用して、短縮リンクを生成します。 **例：** `https://short.example.com/2wuTnQvU` - 3. SMSキャンペーンなどのキャンペーンで短縮リンクを使用します。 4. アプリをインストールしたユーザーが、SMSメッセージ内の短縮URLをクリックします。 @@ -178,9 +167,9 @@ redirects: したがって、 `https://short.example.com/2wuTnQvU` は `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123`にリダイレクトされます。 - 8. リンク解析メソッドが、解析されたURLを返します。 9. アプリが、返されたURLを処理します。この場合、アプリは`summer-clothes`ページをアプリ内に`beach promo`モーダルでユーザーに表示します。 -10. アプリは返されたURLでAdjust SDKの`appWillOpenUrl`メソッドを呼び出します。 +10. アプリは返されたURLでAdjust SDKの`appWillOpenUrl`メソッドを呼び出します。 + From c6c60ffc2b8274a9f5bb0de5fb46dbb75639c463 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 08:16:01 +0000 Subject: [PATCH 07/13] File src/content/docs/en/sdk/ios/v5/features/deep-links/resolution.mdx was translated to ko-KR locale --- .../ios/v5/features/deep-links/resolution.mdx | 109 ++++++++---------- 1 file changed, 49 insertions(+), 60 deletions(-) diff --git a/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx b/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx index 35f9ff2d1..a8bdeb6b7 100644 --- a/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx +++ b/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx @@ -1,27 +1,27 @@ --- -title: 링크 해석(resolution) -description: 이메일, SMS, QR 코드 또는 링크 단축 플랫폼을 통한 딥링킹의 경우, 링크 해석(link resolution)을 설정합니다. -slug: ko/sdk/ios/features/deep-links/resolution +title: "링크 해석(resolution)" +description: "이메일, SMS, QR 코드 또는 링크 단축 플랫폼을 통한 딥링킹의 경우, 링크 해석(link resolution)을 설정합니다." +slug: "en/sdk/ios/features/deep-links/resolution" sidebar-position: 5 -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ko/sdk/ios/v4/features/deep-links/resolution +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/ko/sdk/ios/v4/features/deep-links/resolution" --- - 이메일, SMS, QR 코드 또는 링크 단축 플랫폼을 통한 딥링킹의 경우, 링크 해석\(link resolution\)을 설정해야 합니다. 링크 해석이 없다면, 유니버설 링크에 의한 리다이렉트가 모든 사용자\(앱 설치 사용자 포함\)를 앱 스토어로 이동시키게 됩니다. 링크 해석이 설정되면 유니버설 링크로의 리다이렉트가 앱 내에서 작동하여, 기존 사용자는 앱 스토어로 이동되지 않습니다. - - + 마케팅팀과 확인하여 앱에 링크 해석이 필요한지 확인하시기 바랍니다. 다양한 시나리오에 맞게 링크 해석을 설정할 수 있습니다. + - - -## 작동 방식 {#how-it-works} +작동 방식 \{\#how\-it\-works\} +------------------------------- 앱을 설치한 사용자가 리다이렉트 URL을 클릭하는 경우에만 링크 해석이 필요하며, 리다이렉트 URL의 도메인을 앱에서의 유니버설 링크 도메인으로써 구성해야 합니다. @@ -33,44 +33,41 @@ redirects: 3. Adjust SDK의 링크 해석 메서드는 리다이렉트 URL의 도메인을 개발자가 Adjust SDK에서 설정한 링크 해석 도메인과 비교하고, 다음 중 하나의 결과가 발생합니다. - - 도메인이 일치하지 않음 \- 메서드가 딥링크 URL을 그대로 전달합니다. - - 도메인이 일치함 \- 메서드가 링크를 해석하고, 결과 딥링크를 반환합니다. + * 도메인이 일치하지 않음 \- 메서드가 딥링크 URL을 그대로 전달합니다. + * 도메인이 일치함 \- 메서드가 링크를 해석하고, 결과 딥링크를 반환합니다. - Adjust SDK는 URL을 해석하려고 시도할 때 최대 10개의 리다이렉트를 따릅니다. 10개 이상의 리다이렉트가 있는 경우 SDK는 10번째 리다이렉트 URL을 반환합니다. + Adjust SDK는 URL을 해석할 때 최대 10개의 리다이렉트를 따릅니다. 10개 이상의 리다이렉트가 있는 경우 SDK는 10번째 리다이렉트 URL을 반환합니다. +4. 앱은 반환된 URL을 수신하고, 딥링크 내용을 실행하여 사용자에게 표시합니다. 앱은 또한 Adjust SDK에서 `processDeeplink` 메서드를 반환된 URL과 함께 호출합니다. 이는 해석된 URL을 기록을 위해 Adjust 서버로 전송합니다. -4. 앱은 반환된 URL을 수신하고, 딥링크 내용을 실행하여 사용자에게 표시합니다. 앱은 또한 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. 이는 해석된 URL을 기록을 위해 Adjust 서버로 전송합니다. - - + 앱을 설치하지 않은 사용자가 리다이렉트 URL을 클릭하면, iOS는 이를 일반적인 웹 URL로 처리하여, 사용자를 앱 스토어로 리다이렉트합니다. 이 경우, 링크 해석이 적용되지 않습니다. + - - -## 사용 사례 {#use-cases} +활용법 \{\#use\-cases\} +------------------------ 링크 해석은 다음에 적용될 수 있습니다. -- [이메일 마케팅](#email-marketing) -- [URL을 단축한 플랫폼](#url-shorteners) +* [이메일 마케팅](#email-marketing) +* [URL을 단축한 플랫폼](#url-shorteners) -### 이메일 마케팅 {#email-marketing} +### 이메일 마케팅 \{\#email\-marketing\} 이메일 마케터가 캠페인을 진행할 때, 이메일 마케팅 플랫폼은 일반적으로 자체 클릭 측정 리다이렉트 URL을 사용하여 이메일의 모든 링크를 래핑합니다. 이를 통해 이메일 마케터는 이메일 마케팅 플랫폼에서 클릭률 통계를 볼 수 있습니다. 하지만 이메일에 Adjust 유니버셜 링크가 포함된 경우, 리다이렉트 URL은 iOS가 Adjust 유니버셜 링크를 해석하는 것을 방해합니다. -- 이메일 마케팅 플랫폼: 이메일 마케터가 캠페인 구축을 위해 사용하는 소프트웨어. 일반적으로 이메일 템플릿이나 오디언스 타겟팅과 같은 기능을 포함합니다. **예:** Braze, Iterable, SendGrid -- ESP\(이메일 서비스 제공자\): 이메일을 전송하고 ISP\(인터넷 서비스 제공자\) 이메일 서버로의 전달률을 관리하는 기저 인프라. **예:** SendGrid, SparkPost -- 이메일 파트너: 이메일 마케팅 플랫폼 또는 ESP\(이메일 서비스 제공자\)를 지칭하는 일반적인 용어. 이메일 파트너는 이메일 마케팅 플랫폼이나 ESP 또는 둘 다가 될 수 있습니다. **예:** SendGrid는 이메일 마케팅 플랫폼이자 ESP입니다. 이메일 마케팅에서 ESP를 또다른 파트너로 이용할 수 있습니다. **예:** Braze와 Iterable은 둘 다 SendGrid, SparkPost를 ESP로 이용합니다. +* 이메일 마케팅 플랫폼: 이메일 마케터가 캠페인 구축을 위해 사용하는 소프트웨어. 일반적으로 이메일 템플릿이나 오디언스 타겟팅과 같은 기능을 포함합니다. **예:** Braze, Iterable, SendGrid +* ESP\(이메일 서비스 제공자\): 이메일을 전송하고 ISP\(인터넷 서비스 제공자\) 이메일 서버로의 전달률을 관리하는 기저 인프라. **예:** SendGrid, SparkPost +* 이메일 파트너: 이메일 마케팅 플랫폼 또는 ESP\(이메일 서비스 제공자\)를 지칭하는 일반적인 용어. 이메일 파트너는 이메일 마케팅 플랫폼이나 ESP 또는 둘 다가 될 수 있습니다. **예:** SendGrid는 이메일 마케팅 플랫폼이자 ESP입니다. 이메일 마케팅에서 ESP를 또다른 파트너로 이용할 수 있습니다. **예:** Braze와 Iterable은 둘 다 SendGrid, SparkPost를 ESP로 이용합니다. -#### 설정 {#setup} +#### 설정 \{\#setup\} 1. 도메인을 생성하거나, 이메일 측정에 사용될 도메인에 하위 도메인을 생성합니다. 이메일 측정에 사용할 도메인/하위 도메인이 이미 있는 경우, 기존의 캠페인에 대한 영향 없이 이 구현을 완료할 수 있도록 새로운 도메인/하위 도메인을 생성해야 합니다. 구현 과정이 완료되고 테스트 된 이후, 다시 이 구현을 기존 이메일 리다이렉트 도메인으로 전환할 수 있습니다. **예시:** `email.example.com` - 2. Xcode의 **Associated Domains** 구성에 이메일 리다이렉트 도메인을 추가합니다. **예시:** `applinks:email.example.com` - 3. 유니버설 링크를 설정합니다. 4. 이메일 리다이렉트 도메인을 `resolveLinkWithUrl` 링크 해석 메서드의 `resolveUrlSuffixArray`에 추가했는지 확인합니다. @@ -82,38 +79,35 @@ redirects: 1. **SSL 인증서** : iOS에서는 유니버설 링크가 HTTPS만 사용할 수 있습니다. 따라서 이메일 리다이렉트 도메인에 SSL 인증서가 필요합니다. 2. **AASA\(Apple\-App\-Site\-Association\) 파일** : 이메일 파트너에 따라 AASA 파일을 직접 호스트하거나, AASA 파일을 이메일 파트너 시스템에 업로드해야 합니다. AASA 파일 호스트에 관한 정보는, 이메일 파트너의 관련 문서를 참조하시기 바랍니다. - 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. + 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` + 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. **예시:** `redirect.example.net` - 7. 이메일 리다이렉트 도메인에 대해 DNS를 구성하여 CDN으로 전달되도록 합니다. - - -위 설명에 상응하는 파트너별 설명의 경우, Adjust 헬프 센터의 [ESP 연동](https://help.adjust.com/ko/marketer/esp-integrations)을 참조하시기 바랍니다. + - +위 설명에 상응하는 파트너별 설명의 경우, Adjust 헬프 센터의 [ESP 연동](https://help.adjust.com/en/marketer/esp-integrations)을 참조하시기 바랍니다. + -##### 이메일 파트너 지원 {#support-for-email-partners} +##### 이메일 파트너 지원 \{\#support\-for\-email\-partners\} 링크 해석을 사용하려면 리다이렉트 도메인\(또는 하위 도메인\)을 유니버설 링크 도메인으로 설정할 수 있도록 이메일 파트너의 허용이 필요합니다. 이 경우, 이메일 파트너의 리다이렉션 서비스를 자체 맞춤 도메인으로 전달할 수 있습니다. -**예시:** +**예시:** -- Braze: Braze가 할당된 ESP에 따라, SendGrid 또는 SparkPost에서 리다이렉트 도메인을 설정하고 커스텀 도메인을 지정합니다. 이후 커스텀 도메인을 유니버설 링크 도메인으로 설정할 수 있습니다. -- Iterable: Iterable은 커스텀 도메인을 지원하는 URL 리다이렉트 서비스를 제공합니다. -- Mailchimp: Mailchimp은 리다이렉트 도메인을 유니버설 링크로 구성하도록 허용하지 않기 때문에 링크 해석을 이용할 수 없습니다. +* Braze: Braze가 할당된 ESP에 따라, SendGrid 또는 SparkPost에서 리다이렉트 도메인을 설정하고 커스텀 도메인을 지정합니다. 이후 커스텀 도메인을 유니버설 링크 도메인으로 설정할 수 있습니다. +* Iterable: Iterable은 커스텀 도메인을 지원하는 URL 리다이렉트 서비스를 제공합니다. +* Mailchimp: Mailchimp은 리다이렉트 도메인을 유니버설 링크로 구성하도록 허용하지 않기 때문에 링크 해석을 이용할 수 없습니다. -#### 예시 {#example} +#### 예 \{\#example\} 1. 이메일 마케터는 템플릿을 사용해 이메일을 빌드합니다. 템플릿은 링크 또는 유니버설 링크가 있는 이미지를 포함합니다. **예시:** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` - 2. 이메일 마케터가 수신인에게 이메일을 발송합니다. 이메일이 발송되기 전, 이메일 마케팅 플랫폼은 유니버설 링크를 자체 리다이렉트 URL로 래핑합니다. **예시:** `https://email.example.com/2wuTnQvU` - 3. 앱을 설치한 사용자가 이메일의 리다이렉트 URL을 클릭합니다. 4. iOS가 앱을 실행하고, 리다이렉트 URL을 앱에 전달합니다. @@ -124,18 +118,17 @@ redirects: 따라서 `https://email.example.com/2wuTnQvU` 은/는 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 으로 리다이렉트됩니다. - 7. 링크 해석 메서드는 해석된 URL을 반환합니다. 8. 앱이 반환된 URL을 처리합니다. 이 경우 앱은 사용자에게 `summer-clothes` 페이지를 `beach promo` 모달과 함께 표시합니다. -9. 앱은 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. +9. 앱은 Adjust SDK에서 `processDeeplink` 메서드를 반환된 URL과 함께 호출합니다. -### URL 단축하기 {#url-shorteners} +### URL 단축기 \{\#url\-shorteners\} 특정 유형의 캠페인의 경우, URL을 단축해야 할 때가 있습니다. 예를 들어, SMS에는 160자의 글자 수 제한이 있으며, 소비자들이 단축 링크를 Slack과 같은 협업툴에 공유하길 원할 수 있습니다. 하지만 단축 URL이 유니버셜 링크로 리다이렉트 될 경우, iOS는 Adjust 유니버셜 링크를 해석하지 못합니다. -#### 설정 {#setup-1} +#### 설정 \{\#setup\-1\} 1. 도메인을 생성하거나, URL 단축에 사용될 도메인에 하위 도메인을 생성합니다. 이미 URL 단축에 사용할 도메인/하위 도메인이 있는 경우, 기존의 캠페인에 대한 영향 없이 이 구현을 완료할 수 있도록 새로운 도메인/하위 도메인을 생성해야 합니다. 이 구현 과정이 완료되고 테스트되면, 이 구현을 기존 URL 단축 도메인으로 전환할 수 있습니다. @@ -143,7 +136,6 @@ redirects: 2. Xcode의 **Associated Domains** 구성에 URL 단축 도메인을 추가합니다. **예시:** `applinks:short.example.com` - 3. 유니버설 링크를 설정합니다. 4. 이메일 리다이렉트 도메인을 `resolveLinkWithUrl` 링크 해석 메서드의 `resolveUrlSuffixArray`에 추가했는지 확인합니다. @@ -151,21 +143,18 @@ redirects: 5. 유니버설 링크를 지원하는 URL 단축 서비스를 설정합니다. Adjust는 URL 단축 서비스를 제공하지 않습니다. **예:** [`short.io`](http://short.io) - 6. URL 단축 도메인을 URL 단축 서비스의 맞춤 도메인으로 구성합니다. URL 단축 도메인에 대해 DNS를 구성하여 URL 단축 서비스의 서버로 전달되도록 해야 합니다. \([short.io에 커스텀 도메인을 추가하기 위한 참고 문서](https://help.short.io/en/articles/9991681-how-can-i-add-a-domain)\). 7. URL 단축 서비스에서 유니버설 링크를 구성합니다. \([short.io에 유니버설 링크를 구성하기 위한 참고 문서](https://help.short.io/en/articles/4065870-how-to-set-up-deep-links-for-ios)\). -#### 예시 {#example-1} +#### 예 \{\#example\-1\} 1. 마케터가 유니버설 링크를 생성합니다. **예시:** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` - 2. 마케터가 URL 단축 서비스를 사용하여 단축 링크를 생성합니다. **예시:** `https://short.example.com/2wuTnQvU` - 3. 마케터가 단축 링크를 캠페인\(예: SMS\)에 사용합니다. 4. 앱을 설치한 사용자가 SMS 메시지에서 단축 링크를 클릭합니다. @@ -178,9 +167,9 @@ redirects: 따라서 `https://short.example.com/2wuTnQvU` 은/는 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 으로 리다이렉트됩니다. - 8. 링크 해석 메서드는 해석된 URL을 반환합니다. 9. 앱이 반환된 URL을 처리합니다. 이 경우 앱은 사용자에게 `summer-clothes` 페이지를 `beach promo` 모달과 함께 표시합니다. -10. 앱은 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. +10. 앱은 Adjust SDK에서 `processDeeplink` 메서드를 반환된 URL과 함께 호출합니다. + From c51026c3033e6f59b37b46f912d74687f397e3f9 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 08:16:04 +0000 Subject: [PATCH 08/13] File src/content/docs/en/sdk/ios/v5/features/deep-links/resolution.mdx was translated to zh-CN locale --- .../ios/v5/features/deep-links/resolution.mdx | 117 ++++++++---------- 1 file changed, 53 insertions(+), 64 deletions(-) diff --git a/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx b/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx index 2284c06b2..f8aac2a73 100644 --- a/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx +++ b/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx @@ -1,27 +1,27 @@ --- -title: 链接解析 -description: 对于通过电邮、短信、二维码和短链接生成平台的深度链接，请设置链接解析。 -slug: zh/sdk/ios/features/deep-links/resolution +title: "链接解析" +description: "对于通过电邮、短信、二维码和短链接生成平台的深度链接，请设置链接解析。" +slug: "en/sdk/ios/features/deep-links/resolution" sidebar-position: 5 -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /zh/sdk/ios/v4/features/deep-links/resolution +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/ios/v4/features/deep-links/resolution" --- - -对于通过电邮、短信、二维码和短链接生成平台的深度链接，请务必设置链接解析，否则，通用链接重定向会将所有用户转到 App Store，其中包括已安装应用的用户。设置连接解析后，通用链接重定向会在您的应用内发生，现有用户不会被转到 App Store。 - - +对于通过电邮、短信、二维码和短链接生成平台的深度链接，请务必设置链接解析，否则，通用链接重定向会将所有用户转到 App Store，其中包括已安装应用的用户。设置链接解析后，通用链接重定向会在您的应用内发生，现有用户不会被转到 App Store。 + 请咨询您的营销团队，决定应用是否需要链接解析。随后，您就可以针对不同用例设置链接解析域了。 + - - -## 工作原理 {#how-it-works} +工作原理\{\#how\-it\-works\} +----------------------------- 仅在已安装应用的用户点击重定向 URL 时，链接解析才适用。请在应用中将重定向 URL 域配置为通用链接域。 @@ -31,46 +31,43 @@ redirects: 2. 您的应用会将重定向 URL 传送至 Adjust SDK 中的 `resolveLinkWithUrl` 链接解析方法 。 -3. Adjust SDK 中的连接解析方法会参考开发者在 Adjust SDK 中设置的链接解析域，对比重定向 URL 中的域。对比结果分两种： +3. Adjust SDK 中的链接解析方法会参考开发者在 Adjust SDK 中设置的链接解析域，对比重定向 URL 中的域。对比结果分两种： - - 域不匹配 \- 方法会按原样转发深度链接 URL。 - - 域匹配 \- 方法解析链接并返回解析所得的深度链接 + * 域不匹配 \- 方法会按原样转发深度链接 URL。 + * 域匹配 \- 方法解析链接并返回解析所得的深度链接。 - 在尝试解析 URL 时，Adjust SDK 会追溯最多 10 个重定向 \(redirect\)，也就是说，如果要追溯的重定向超过 10 个，那么 SDK 就会返回第 10 个重定向 URL。 + 在尝试解析 URL 时，Adjust SDK 会追溯最多 10 个重定向，也就是说，如果要追溯的重定向超过 10 个，那么 SDK 就会返回第 10 个重定向 URL。 +4. 应用收到返回的 URL，打开展示深度链接内容并将其展示给用户。您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `processDeeplink` 方法 。此操作会将已解析的 URL 发送给 Adjust 服务器用于记录。 -4. 应用收到返回的 URL，打开展示深度链接内容并将其展示给用户。您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。此操作会将已解析的 URL 发送给 Adjust 服务器用于记录。 - - + 如果未安装应用的用户点击了重定向 URL，那么 iOS 就会以正常网页 URL 方式进行处理，将用户重定向至 App Store。链接解析不适用这种情况。 + - - -## 使用案例 {#use-cases} +使用案例\{\#use\-cases\} +------------------------ 下列情况中适用链接解析： -- [电子邮件营销](#email-marketing) -- [短 URL 生成平台](#url-shorteners) +* [电子邮件营销](#email-marketing) +* [短 URL 生成平台](#url-shorteners) -### 电子邮件营销 {#email-marketing} +### 电子邮件营销\{\#email\-marketing\} 电邮营销人员开展推广时，电邮营销平台会通过其自有的点击监测重定向 URL 包装邮件中的所有链接。这样，电邮营销人员就能在平台上看到点击数据。不过，如果电邮中包含通用链接，那么重定向 URL 会导致 iOS 无法解析通用链接。 -- 电子邮件营销平台：电邮营销人员用来打造推广活动的软件，其中包括电邮模板、受众定向等功能。 **示例：** Braze，Iterable，SendGrid -- 电邮服务提供商 \(ESP\)：能发送电邮、管理对互联网服务提供商 \(ISP\) 电邮服务器交付活动的底层基础架构。 **示例：** SendGrid，SparkPost。 -- 电子邮件合作伙伴：用来指代电子邮件营销平台或电子邮件服务提供商 \(ESP\) 的一般术语。电子邮件合作伙伴可以是电邮营销平台或 ESP，也可以两者皆是。 **示例：** SendGrid 既是电邮营销平台，也是ESP。电邮营销可能使用其他 ESP 合作伙伴。 **示例：** Graze 和 Iterable 的 ESP 都是 SendGrid 和 SparkPost。 +* 电子邮件营销平台：电邮营销人员用来打造推广活动的软件，其中包括电邮模板、受众定向等功能。 **示例：** Braze，Iterable，SendGrid +* 电邮服务提供商 \(ESP\)：能发送电邮、管理对互联网服务提供商 \(ISP\) 电邮服务器交付活动的底层基础架构。 **示例：** SendGrid，SparkPost。 +* 电子邮件合作伙伴：用来指代电子邮件营销平台或电子邮件服务提供商 \(ESP\) 的一般术语。电子邮件合作伙伴可以是电邮营销平台或 ESP，也可以两者皆是。 **示例：** SendGrid 既是电邮营销平台，也是ESP。电邮营销可能使用其他 ESP 合作伙伴。 **示例：** Graze 和 Iterable 的 ESP 都是 SendGrid 和 SparkPost。 -#### 设置 {#setup} +#### 设置 \{\#setup\} 1. 在您的域上创建专门用于电子邮件监测的域或子域。如果您已经拥有专门用于电子邮件监测的域或子域，您应当重新创建，以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后，您就可以换用自己现有的电邮重定向域。 **示例：** `email.example.com` - 2. 在 Xcode 中向您的 **Associated Domain** \(关联域\) 配置添加电邮重定向域。 **示例：** `applinks:email.example.com` - 3. 设置您的通用链接。 4. 确保已将您的电邮重定向域添加到 `resolveLinkWithUrl` 链接解析方法的 `resolveUrlSuffixArray` 中。 @@ -82,38 +79,35 @@ redirects: 1. **SSL 证书** ：iOS 要求所有通用链接只能使用 HTTPS。因此，您的电邮重定向域必须拥有 SSL 证书。 2. **AASA \(Apple\-App\-Site\-Association\) 文件** ：您需要自行托管 AASA 文件，或将 AASA 文件上传至电邮合作伙伴的系统中，具体视您的电邮合作伙伴情况而定。请查看电邮合作伙伴的文档，了解 AASA 文件托管信息。 - 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件，那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 + 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件，那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` + 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 **示例：** `redirect.example.net` - 7. 进行 DNS 配置，让电邮重定向域指向 CDN。 - - -请访问帮助中心的 [ESP 集成](https://help.adjust.com/zh/marketer/esp-integrations)版面，了解与上述操作对应的具体合作伙伴操作说明。 + - +请访问帮助中心的 [ESP 集成](https://help.adjust.com/en/marketer/esp-integrations)版面，了解与上述操作对应的具体合作伙伴操作说明。 + -##### 电邮服务合作伙伴支持 {#support-for-email-partners} +##### 电邮服务合作伙伴支持\{\#support\-for\-email\-partners\} 要使用链接解析，您的电邮服务合作伙伴需要允许您将通用链接域设为重定向域 \(或子域\)。在这种情况下，您可以将合作伙伴的重定向服务指向您自己的自定义域。 -**示例：** +**示例：** -- Braze：根据 Braze 指定的 ESP，设置 SendGrid 或 SparkPost 的重定向域，并将您的自定义域指向该重定向域。随后就可以将自定义域设置为通用链接域了。 -- Iterable：Iterable 的 URL 重定向服务支持自定义域。 -- Mailchimp：Mailchimp 不允许您将其重定向域配置为通用链接，因此您无法采用链接解析。 +* Braze：根据 Braze 指定的 ESP，设置 SendGrid 或 SparkPost 的重定向域，并将您的自定义域指向该重定向域。随后就可以将自定义域设置为通用链接域了。 +* Iterable：Iterable 的 URL 重定向服务支持自定义域。 +* Mailchimp：Mailchimp 不允许您将其重定向域配置为通用链接，因此您无法采用链接解析。 -#### 示例 {#example} +#### 示例 \{\#example\} 1. 电邮营销人员使用模板创建电子邮件。该模板包含链接或带有通用链接的图片。 **示例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` - 2. 电邮营销人员将邮件发送给收件人。在发送邮件前，电邮营销平台会用自己的重定向 URL 包装通用链接。 **示例：** `https://email.example.com/2wuTnQvU` - 3. 已安装应用的用户点击电子邮件中的重定向 URL。 4. iOS 打开您的应用，将重定向 URL 发送至应用。 @@ -124,25 +118,23 @@ redirects: 因此，`https://email.example.com/2wuTnQvU` 会重定向至 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 。 - 7. 链接解析方法返回已解析的 URL。 8. 您的应用处理返回的 URL。在这种情况下，您的应用将在应用中显示 `summer-clothes` 页面，用户会看到 `beach promo` 弹窗。 -9. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。 +9. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `processDeeplink` 方法 。 -### URL 缩短服务 {#url-shorteners} +### URL 缩短服务\{\#url\-shorteners\} -有时，营销人员需要在特定类型的推广活动用到短 URL。例如：短信文本长度上限为 160 个字符。有时，客户需要缩短链接，好在 Slack 等团队通讯平台上分享。不过，如果短 URL 重定向到通用链接，那么 iOS 就不会解析通用链接。 +有时，营销人员需要在特定类型的推广活动中用到短 URL。例如：短信文本长度上限为 160 个字符。有时，客户需要缩短链接，以便在 Slack 等团队通讯平台上分享。不过，如果短 URL 重定向到通用链接，那么 iOS 就不会解析通用链接。 -#### 设置 {#setup-1} +#### 设置 \{\#setup\-1\} -1. 在您的域上创建专门用于缩短 URL 的域或子域。如果您已经拥有专门用于缩短 URL 的域或子域，您还是应当重新创建，以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后，您就可以换用自己现有的 URL 缩短域。 +1. 在您的域上创建专门用于缩短 URL 的域或子域。如果您已经拥有专门用于缩短 URL 的域或子域，也还是应当重新创建，以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后，您就可以换用自己现有的 URL 缩短域。 2. 在 Xcode 中向您的 **Associated Domain** \(关联域\) 配置添加短 URL 域。 **示例：** `applinks:short.example.com` - 3. 设置您的通用链接。 4. 确保已将您的电邮重定向域添加到 `resolveLinkWithUrl` 链接解析方法的 `resolveUrlSuffixArray` 中。 @@ -150,21 +142,18 @@ redirects: 5. 设置支持通用链接的 URL 缩短服务。请注意：Adjust 不提供任何 URL 缩短服务。 **示例** ：[`short.io`](http://short.io) - 6. 在短 URL 生成服务平台上，将短 URL 生成域配置为自定义域。您需要进行 DNS 配置，才能让短 URL 生成域指向短 URL 生成服务的服务器。\([在 short.io 中添加自定义域的参考文档](https://help.short.io/en/articles/9991681-how-can-i-add-a-domain)\)。 7. 在 URL 缩短服务中配置通用链接。\([在 short.io 中设置通用链接的参考文档](https://help.short.io/en/articles/4065870-how-to-set-up-deep-links-for-ios)\)。 -#### 示例 {#example-1} +#### 示例 \{\#example\-1\} 1. 营销人员创建通用链接。 **示例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` - 2. 营销人员使用 URL 缩短服务生成短链接。 **示例：** `https://short.example.com/2wuTnQvU` - 3. 营销人员在推广活动中使用短链接，例如短信推广活动。 4. 已安装应用的用户点击短信中的短 URL。 @@ -177,9 +166,9 @@ redirects: 因此，`https://short.example.com/2wuTnQvU` 会重定向至 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 。 - 8. 链接解析方法返回已解析的 URL。 9. 您的应用处理返回的 URL。在这种情况下，您的应用将在应用中显示 `summer-clothes` 页面，用户会看到 `beach promo` 弹窗。 -10. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。 +10. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `processDeeplink` 方法 。 + From 66c70642b4471ca845636635686e9bfd3e90fab3 Mon Sep 17 00:00:00 2001 From: "smartling-github-connector[bot]" <165276057+smartling-github-connector[bot]@users.noreply.github.com> Date: Tue, 10 Dec 2024 08:16:07 +0000 Subject: [PATCH 09/13] File src/content/docs/en/sdk/ios/v5/features/deep-links/resolution.mdx was translated to ja-JP locale --- .../ios/v5/features/deep-links/resolution.mdx | 109 ++++++++---------- 1 file changed, 49 insertions(+), 60 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx b/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx index 247486774..18078c3c6 100644 --- a/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx +++ b/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx @@ -1,27 +1,27 @@ --- -title: リンクのresolution（解析と変換） -description: メール、SMS、QRコード、リンクを短縮するプラットフォームを介したディープリンクのリンク解析を設定します。 -slug: ja/sdk/ios/features/deep-links/resolution +title: "リンクのresolution（解析と変換）" +description: "メール、SMS、QRコード、リンクを短縮するプラットフォームを介したディープリンクのリンク解析を設定します。" +slug: "en/sdk/ios/features/deep-links/resolution" sidebar-position: 5 -versions: - - label: v5 - value: v5 - default: true - - label: v4 - value: v4 -redirects: - v4: /ja/sdk/ios/v4/features/deep-links/resolution +versions: + - + label: "v5" + value: "v5" + default: true + - + label: "v4" + value: "v4" +redirects: + v4: "/en/sdk/ios/v4/features/deep-links/resolution" --- - メール、SMS、QRコード、リンクを短縮するプラットフォームを介したディープリンクのリンク解析を設定する必要があります。そのようなケースのためにリンク解析を設定しない場合、ユニバーサルリンクからのリダイレクトでは、アプリをインストールしているユーザーを含めた全てのユーザーがApp Storeに誘導されます。リンク解析が有効な場合、ユニバーサルリンクへのリダイレクトはアプリ内で発生し、既存のユーザーはApp Storeに誘導されません。 - - + リンク解析がアプリに必要かどうか、マーケティングチームに確認してください。その後、各ユースケースに合わせてリンク解析ドメインを設定できます。 + - - -## 仕組み {#how-it-works} +仕組み \{\#how\-it\-works\} +----------------------------- リンク解析は、アプリをインストールしているユーザーがリダイレクトURLをクリックしたときにのみ実行されます。リダイレクトURL内のドメインを、アプリ内のユニバーサルリンクドメインとして設定する必要があります。 @@ -33,44 +33,41 @@ redirects: 3. Adjust SDKのリンク解析メソッドで、リダイレクトURL内のドメインと開発者がAdjust SDKで設定したリンク解析ドメインが比較され、次のいずれかが実行されます。 - - ドメインが一致しない \- メソッドはディープリンクURLをそのまま転送します。 - - ドメインが一致する \- メソッドはリンクを解析し、結果のディープリンクを返します。 + * ドメインが一致しない \- メソッドはディープリンクURLをそのまま転送します。 + * ドメインが一致する \- メソッドはリンクを解析し、結果のディープリンクを返します。 - URLの解析と変換が行われると、Adjust SDKは最大10のリダイレクトをフォローアップします。リダイレクトが10以上ある場合は、10番目のリダイレクトURLが返されます。 + URLの解析を試みると、Adjust SDKは最大10のリダイレクトをフォローアップします。リダイレクトが10以上ある場合は、10番目のリダイレクトURLが返されます。 +4. アプリは返されたURLを受け取り、ディープリンクコンテンツを開いてユーザーに表示します。またアプリは、返されたURLを使用してAdjust SDKの`processDeeplink`メソッドを呼び出します。これにより、解析されたURLが記録のためにAdjustサーバーに送られます。 -4. アプリは返されたURLを受け取り、ディープリンクコンテンツを開いてユーザーに表示します。またアプリは、返されたURLを使用してAdjust SDKの`appWillOpenUrl`メソッドを呼び出します。これにより、解析されたURLが記録のためにAdjustサーバーに送られます。 - - + アプリをインストールしていないユーザーがリダイレクトURLをクリックした場合、iOSはこれを通常のWeb URLとして処理し、ユーザーをApp Storeにリダイレクトします。この場合、リンク解析は実行されません。 + - - -## ユース ケース {#use-cases} +ユースケース \{\#use\-cases\} +--------------------------- リンク解析は、次の場合に実行されます。 -- [Eメールマーケティング](#email-marketing) -- [URLを短縮するプラットフォーム](#url-shorteners) +* [Eメールマーケティング](#email-marketing) +* [URLを短縮するプラットフォーム](#url-shorteners) -### Eメールマーケティング {#email-marketing} +### Eメールマーケティング \{\#email\-marketing\} メールマーケターがキャンペーンを実施する際、メールマーケティングプラットフォームでは通常、独自のクリック計測用リダイレクトURLを使用してメール内の全てのリンクをラップします。これによりメールマーケターは、メールマーケティングプラットフォームでクリック率を確認できます。ただし、メールにユニバーサルリンクが含まれている場合、リダイレクトURLが原因でiOSはユニバーサルリンクを解析できません。 -- メールマーケティングプラットフォーム：メールマーケターがキャンペーンを構築するために使用するソフトウェア。これには、メールテンプレートやオーディエンスターゲティングなどの機能が含まれます。 **例：** Braze、Iterable、SendGrid -- メールサービスプロバイダー（ESP）：メールを送信し、ISP（インターネットサービスプロバイダー）のメールサーバーへの送達可能性を管理する基盤インフラストラクチャー。 **例：** SendGrid、SparkPost -- メールパートナー：メールマーケティングプラットフォームまたはメールサービスプロバイダー（ESP）のいずれかを表す一般的な用語。メールパートナーとは、メールマーケティングプラットフォーム、ESP、またはその両方を指します。 **例：** SendGridはメールマーケティングプラットフォームであり、ESPでもあります。メールマーケティングでは、他のパートナーをESPとして使用することができます。 **例：** BrazeとIterableはどちらもSendGridとSparkPostをESPとして使用しています。 +* メールマーケティングプラットフォーム：メールマーケターがキャンペーンを構築するために使用するソフトウェア。これには、メールテンプレートやオーディエンスターゲティングなどの機能が含まれます。 **例：** Braze、Iterable、SendGrid +* メールサービスプロバイダー（ESP）：メールを送信し、ISP（インターネットサービスプロバイダー）のメールサーバーへの送達可能性を管理する基盤インフラストラクチャー。 **例：** SendGrid、SparkPost +* メールパートナー：メールマーケティングプラットフォームまたはメールサービスプロバイダー（ESP）のいずれかを表す一般的な用語。メールパートナーとは、メールマーケティングプラットフォーム、ESP、またはその両方を指します。 **例：** SendGridはメールマーケティングプラットフォームであり、ESPでもあります。メールマーケティングでは、他のパートナーをESPとして使用することができます。 **例：** BrazeとIterableはどちらもSendGridとSparkPostをESPとして使用しています。 -#### 設定 {#setup} +#### \{\#setup\} の設定 1. 使用しているドメイン上に、メール計測専用のドメインまたはサブドメインを作成します。メール計測用のドメインまたはサブドメインがすでにある場合は、既存のキャンペーンを妨げることなくこの実装を完了できるよう、新たに作成することをお勧めします。この実装を完了してテストした後に、この実装を既存のメールリダイレクトドメインに切り替えることができます。 **例：** `email.example.com` - 2. Xcodeで、メールリダイレクトドメインを **Associated Domains** 設定に追加します。 **例：** `applinks:email.example.com` - 3. ユニバーサルリンクを設定します。 4. `resolveLinkWithUrl`リンク解析メソッドの`resolveUrlSuffixArray`にメールリダイレクトドメインが追加されていることを確認します。 @@ -82,38 +79,35 @@ redirects: 1. **SSL証明書** ：iOSでは、ユニバーサルリンクでHTTPSのみを使用する必要があります。そのため、メールリダイレクトドメインにはSSL証明書が必要です。 2. **AASA（Apple\-App\-Site\-Association）ファイル** ：メールパートナーによっては、独自のAASAファイルをホストするか、AASAファイルをメールパートナーシステムにアップロードする必要があります。AASAファイルのホスティングについては、メールパートナーのドキュメントを参照してください。 - 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます：`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` 3. （該当する場合、AASAファイルを除いた）メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 + 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます：`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` + 3. （該当する場合、AASAファイルを除いた）メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 **例：** `redirect.example.net` - 7. CDNをポイントするようにメールリダイレクトドメインのDNSを設定します。 - - -上記の指示に対応するパートナー固有の指示については、ヘルプセンターの[ESP連携に関するセクション](https://help.adjust.com/ja/marketer/esp-integrations)を参照してください。 + - +上記の指示に対応するパートナー固有の指示については、ヘルプセンターの[ESP連携に関するセクション](https://help.adjust.com/en/marketer/esp-integrations)を参照してください。 + -##### メールパートナーのサポート {#support-for-email-partners} +##### メールパートナーのサポート \{\#support\-for\-email\-partners\} リンク解析を使用するには、リダイレクトドメイン（またはサブドメイン）をユニバーサルリンクドメインとして設定することをメールパートナーが許可している必要があります。許可されている場合、それらのリダイレクトサービスを独自のカスタムドメインにポイントできます。 -**例：** +**例：** -- Braze：割り当てられているESP Brazeに応じて、SendGridまたはSparkPostでリダイレクトドメインを設定し、独自のカスタムドメインをそれにポイントします。その後、カスタムドメインをユニバーサルリンクドメインとして設定できます。 -- Iterable：Iterableでは、カスタムドメインをサポートするURLリダイレクトサービスが提供されています。 -- Mailchimp：Mailchimpでは、リダイレクトドメインをユニバーサルリンクとして設定することが許可されていないため、リンク解析は利用できません。 +* Braze：割り当てられているESP Brazeに応じて、SendGridまたはSparkPostでリダイレクトドメインを設定し、独自のカスタムドメインをそれにポイントします。その後、カスタムドメインをユニバーサルリンクドメインとして設定できます。 +* Iterable：Iterableでは、カスタムドメインをサポートするURLリダイレクトサービスが提供されています。 +* Mailchimp：Mailchimpでは、リダイレクトドメインをユニバーサルリンクとして設定することが許可されていないため、リンク解析は利用できません。 -#### 例 {#example} +#### 例 \{\#example\} 1. メールマーケターが、テンプレートを使用してメールを作成します。このテンプレートには、ユニバーサルリンクを使用したリンクまたは画像が含まれています。 **例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` - 2. 受信者リストに対して、メールを送信します。メールが送信される前に、メールマーケティングプラットフォームは、独自のリダイレクトURLを使用してユニバーサルリンクをラップします。 **例：** `https://email.example.com/2wuTnQvU` - 3. アプリをインストールしたユーザーが、メール内のリダイレクトURLをクリックします。 4. iOSがアプリを開き、リダイレクトURLをアプリにパスします。 @@ -124,18 +118,17 @@ redirects: したがって、 `https://email.example.com/2wuTnQvU` は `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123`にリダイレクトされます。 - 7. リンク解析メソッドが、解析されたURLを返します。 8. アプリが、返されたURLを処理します。この場合、アプリは`summer-clothes`ページをアプリ内に`beach promo`モーダルでユーザーに表示します。 -9. アプリは返されたURLでAdjust SDKの`appWillOpenUrl`メソッドを呼び出します。 +9. アプリは返されたURLでAdjust SDKの`processDeeplink`メソッドを呼び出します。 -### URL短縮 {#url-shorteners} +### URL短縮 \{\#url\-shorteners\} マーケターが特定の種類のキャンペーンを実施する際、短いURLが必要になる場合があります。例えば、SMSには160文字の制限がありますが、リンクを短縮してSlackなどのチームコミュニケーションプラットフォームで共有することを顧客が望む場合があります。ただし、短縮URLがユニバーサルリンクにリダイレクトされる場合、iOSはユニバーサルリンクを解析できません。 -#### 設定 {#setup-1} +#### \{\#setup\-1\} の設定 1. 使用しているドメイン上に、URL短縮専用のドメインまたはサブドメインを作成します。 URL短縮用のドメインまたはサブドメインがすでにある場合は、既存のキャンペーンを妨げることなくこの実装を完了できるよう、新たに作成することをお勧めします。この実装を完了してテストした後に、この実装を既存のURL短縮ドメインに切り替えることができます。 @@ -143,7 +136,6 @@ redirects: 2. XcodeでURL短縮ドメインを **Associated Domains** 設定に追加します。 **例：** `applinks:short.example.com` - 3. ユニバーサルリンクを設定します。 4. `resolveLinkWithUrl`リンク解析メソッドの`resolveUrlSuffixArray`にメールリダイレクトドメインが追加されていることを確認します。 @@ -151,21 +143,18 @@ redirects: 5. ユニバーサルリンクをサポートするURL短縮サービスを設定します。AdjustではURL短縮サービスを提供していません。 **例：** [`short.io`](http://short.io) - 6. URL短縮サービスで、URL短縮ドメインをカスタムドメインとして設定します。URL短縮サービスのサーバーをポイントするように、URL短縮ドメインのDNSを設定してください（[short.ioにカスタムドメインを追加する参照ドキュメント](https://help.short.io/en/articles/9991681-how-can-i-add-a-domain)）。 7. URL短縮サービスでユニバーサルリンクを設定します（[short.ioのユニバーサルリンクを設定する参照ドキュメント](https://help.short.io/en/articles/4065870-how-to-set-up-deep-links-for-ios)）。 -#### 例 {#example-1} +#### 例 \{\#example\-1\} 1. マーケターがユニバーサルリンクを作成します。 **例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` - 2. URL短縮サービスを使用して、短縮リンクを生成します。 **例：** `https://short.example.com/2wuTnQvU` - 3. SMSキャンペーンなどのキャンペーンで短縮リンクを使用します。 4. アプリをインストールしたユーザーが、SMSメッセージ内の短縮URLをクリックします。 @@ -178,9 +167,9 @@ redirects: したがって、 `https://short.example.com/2wuTnQvU` は `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123`にリダイレクトされます。 - 8. リンク解析メソッドが、解析されたURLを返します。 9. アプリが、返されたURLを処理します。この場合、アプリは`summer-clothes`ページをアプリ内に`beach promo`モーダルでユーザーに表示します。 -10. アプリは返されたURLでAdjust SDKの`appWillOpenUrl`メソッドを呼び出します。 +10. アプリは返されたURLでAdjust SDKの`processDeeplink`メソッドを呼び出します。 + From a40f6b17e73528529e1c1c064b6f018c64f371be Mon Sep 17 00:00:00 2001 From: github-actions <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 8 Jan 2025 09:34:26 +0000 Subject: [PATCH 10/13] Fix translated and formatted files --- .../docs/ja/api/deep-link-generator-api.mdx | 162 +++++++++-------- .../ios/v4/features/deep-links/resolution.mdx | 103 ++++++----- .../ios/v5/features/deep-links/resolution.mdx | 103 ++++++----- .../docs/ko/api/deep-link-generator-api.mdx | 166 +++++++++--------- .../ios/v4/features/deep-links/resolution.mdx | 103 ++++++----- .../ios/v5/features/deep-links/resolution.mdx | 103 ++++++----- .../docs/zh/api/deep-link-generator-api.mdx | 162 +++++++++-------- .../ios/v4/features/deep-links/resolution.mdx | 103 ++++++----- .../ios/v5/features/deep-links/resolution.mdx | 103 ++++++----- 9 files changed, 596 insertions(+), 512 deletions(-) diff --git a/src/content/docs/ja/api/deep-link-generator-api.mdx b/src/content/docs/ja/api/deep-link-generator-api.mdx index 45e8c4420..509d82e05 100644 --- a/src/content/docs/ja/api/deep-link-generator-api.mdx +++ b/src/content/docs/ja/api/deep-link-generator-api.mdx @@ -1,46 +1,49 @@ --- -title: "ディープリンクジェネレーター API" -description: "ディープリンクジェネレーターAPIを使用して、アプリ用に短縮および長いディープリンクを個別あるいは一括で作成できます。" -category-title: "ディープリンクジェネレーター API" -slug: "en/api/deep-link-generator-api" +title: ディープリンクジェネレーター API +description: ディープリンクジェネレーターAPIを使用して、アプリ用に短縮および長いディープリンクを個別あるいは一括で作成できます。 +category-title: ディープリンクジェネレーター API +slug: ja/api/deep-link-generator-api sidebar-position: 8 --- + ディープリンクジェネレーターAPIを使用して、アプリ用の短いおよび長いディープリンクを個別または一括で作成できます。これらのカスタマイズされたディープリンクは、さまざまなプラットフォームでユーザー体験を向上させます。 -事前準備 \{\#before\-you\-begin\} ----------------------------------- +## 事前準備 \{\#before\-you\-begin\} はじめに、以下の設定手順をご覧ください。 -### ご利用の条件 \{\#availability\} +### ご利用の条件 {#availability} - + ディープリンクジェネレーターAPIには、1秒あたり200リクエストのレート制限があります。この制限を超えると、429エラーが発生します。 - -* ディープリンクジェネレーターAPIは、TrueLinkのCoreまたはEnterpriseのパッケージにご契約のお客様にご利用いただけます。 -* ディープリンクジェネレーターAPIを使用して作成されたリンクは、 [Campaign Lab](https://help.adjust.com/en/article/campaign-setup)に表示されません。 -* ディープリンクジェネレーターAPIを使用して作成されたショートリンクのTTL（有効期間）は120日です。 + + +- ディープリンクジェネレーターAPIは、TrueLinkのCoreまたはEnterpriseのパッケージにご契約のお客様にご利用いただけます。 +- ディープリンクジェネレーターAPIを使用して作成されたリンクは、 [Campaign Lab](https://help.adjust.com/ja/article/campaign-setup)に表示されません。 +- ディープリンクジェネレーターAPIを使用して作成されたショートリンクのTTL（有効期間）は120日です。 + +### 要件 {#requirements} + +- 管理者、編集者およびカスタムの編集者の[アクセス権限](https://help.adjust.com/ja/article/permission-levels)。 +- iOSアプリとAndroidアプリに[同じブランドドメインを設定](https://help.adjust.com/ja/article/set-up-branded-domain)していること。 + + - iOSアプリの場合、ブランドドメインを[関連ドメイン（Associated Domain）](https://help.adjust.com/ja/article/set-up-branded-domain#ios-only-update)として追加するようにしてください。これにより、ドメインがユニバーサルリンクとして設定されるようになります。 + - Androidアプリの場合、ブランドドメインを[Android アプリリンク（Android App Link）](https://help.adjust.com/ja/article/set-up-android-app-links)として定義するようにしてください。 -### 要件 \{\#requirements\} +- アプリのカスタムリンク。 -* 管理者、編集者およびカスタムの編集者の[アクセス権限](https://help.adjust.com/en/article/permission-levels)。 -* iOSアプリとAndroidアプリに[同じブランドドメインを設定](https://help.adjust.com/en/article/set-up-branded-domain)していること。 - * iOSアプリの場合、ブランドドメインを[関連ドメイン（Associated Domain）](https://help.adjust.com/en/article/set-up-branded-domain#ios-only-update)として追加するようにしてください。これにより、ドメインがユニバーサルリンクとして設定されるようになります。 - * Androidアプリの場合、ブランドドメインを[Android アプリリンク（Android App Link）](https://help.adjust.com/en/article/set-up-android-app-links)として定義するようにしてください。 + - シングルプラットフォームアプリ、マルチプラットフォームアプリ \- [Campaign Labでカスタムリンクを作成して](https://help.adjust.com/ja/article/custom-link-setup)、単一のリンクトークンを取得します。 + - 複数のシングルプラットフォームアプリ \- 複数のシングルプラットフォームアプリから[Campaign Labでカスタムリンク](https://help.adjust.com/ja/article/custom-link-setup#combined-custom-links)を作成し、「\_」で区切られた複数のリンクトークンを含む、1つの複合カスタムリンクを作成します。詳細については、[複合カスタムリンク向けプラットフォーム固有のリンクトークンを](https://help.adjust.com/ja/article/manage-custom-link-setup#link-tokens-combined-custom-link)参照してください。 -* アプリのカスタムリンク。 - * シングルプラットフォームアプリ、マルチプラットフォームアプリ \- [Campaign Labでカスタムリンクを作成して](https://help.adjust.com/en/article/custom-link-setup)、単一のリンクトークンを取得します。 - * 複数のシングルプラットフォームアプリ \- 複数のシングルプラットフォームアプリから[Campaign Labでカスタムリンク](https://help.adjust.com/en/article/custom-link-setup#combined-custom-links)を作成し、「\_」で区切られた複数のリンクトークンを含む、1つの複合カスタムリンクを作成します。詳細については、[複合カスタムリンク向けプラットフォーム固有のリンクトークンを](https://help.adjust.com/en/article/manage-custom-link-setup#link-tokens-combined-custom-link)参照してください。 +- Adjust SDKを更新して、短縮リンクを解決すること。 -* Adjust SDKを更新して、短縮リンクを解決すること。 - * [iOS](/en/sdk/ios/features/short-links) \| [Android](/en/sdk/android/features/short-links) \| [Unity](/en/sdk/unity/features/short-links) \| [React Native](/en/sdk/react-native/features/short-links) \| [Flutter](/en/sdk/flutter/features/short-links) \| [Cordova](/en/sdk/cordova/features/short-links) \| [Cocos2d\-x](/en/sdk/cocos2dx/features/short-links) + - [iOS](/ja/sdk/ios/features/short-links) \| [Android](/ja/sdk/android/features/short-links) \| [Unity](/ja/sdk/unity/features/short-links) \| [React Native](/ja/sdk/react-native/features/short-links) \| [Flutter](/ja/sdk/flutter/features/short-links) \| [Cordova](/ja/sdk/cordova/features/short-links) \| [Cocos2d\-x](/ja/sdk/cocos2dx/features/short-links) -* [データレジデンシーを設定](https://help.adjust.com/en/article/data-residency-setup)している場合、iOSアプリとAndroidアプリで同じ地域を使用していることを確認してください。 +- [データレジデンシーを設定](https://help.adjust.com/ja/article/data-residency-setup)している場合、iOSアプリとAndroidアプリで同じ地域を使用していることを確認してください。 -認証 \{\#authentication\} --------------------------- +## 認証 \{\#authentication\} ディープリンクジェネレーターは、[ベアラートークン](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication)を使用して認証します。ディープリンクジェネレーターAPIへの各リクエストには、Adjust APIトークンを`Authorization`ヘッダーに必ず含める必要があります。 @@ -53,7 +56,7 @@ SSO以外のアカウントの場合、APIガイドはユーザーの **プロ 3. **マイプロフィール（My Profile）** を選択します。 4. **APIトークン** が **ユーザー情報（User details）** に表示されます。コピーボタンを選択して、トークンをクリップボードにコピーします。 -### Adjust APIトークンをリセットする \{\#reset\-your\-adjust\-api\-token\} +### Adjust APIトークンをリセットする {#reset-your-adjust-api-token} Adjust APIトークンはいつでもリセットできます。トークンをリセットすると、古いトークンは無効になります。Adjust APIトークンをリセットした場合、使用中の古いトークンを新しいトークンに置き換える必要があります。無効になったトークンを使用したリクエストは、Adjustによって拒否されます。 @@ -67,42 +70,41 @@ Adjust APIトークンをリセットする方法： 6. 表示されたモーダルにアカウントのパスワードを入力し、 **リセット** を選択してAPIトークンをリセットします。画面の右上に確認メッセージが表示されます。 7. **APIトークン** の横にあるコピーボタンを選択して、トークンをクリップボードにコピーします。 -パラメーター \{\#parameters\} --------------------------- - -| パラメーター | データタイプ | 入力する値 | 説明 | -|--------------------------|---------------------|-------|------------------------------------------------------------------------------------------------------------------------------------------------| -| `adjust_auth_token` | `String` | 説明 | Adjust APIトークン | -| `link_token` | `String` | ボディ | カスタムリンクのリンクトークン。複合リンクからディープリンクを生成している場合、Campaign Labで組み合わせたカスタムリンクの正しいリンクトークンを使用していることを確認してください。 | -| `shorten_url` | `Boolean` | ボディ | リンクが短縮されるかどうか。リンクはデフォルトでは短縮されません。デフォルト値 \- false | -| `campaign` | `String` または `null` | ボディ | キャンペーンの名前 | -| `adgroup` | `String` または `null` | ボディ | アドグループの名前 | -| `creative` | `String` または `null` | ボディ | クリエイティブの名前 | -| `deep_link_path` | `String` | ボディ | ユーザーが遷移するアプリ内の遷移先を指定。シングルプラットフォームアプリにはこれを使用してください。 | -| `ios_deep_link_path` | `String` | ボディ | ユーザーが遷移するiOSのアプリ内の遷移先を指定。マルチプラットフォームのiOSアプリまたは複合リンクにはこれを使用してください。 | -| `android_deep_link_path` | `String` | ボディ | ユーザーが遷移するiOSのアプリ内の遷移先を指定。マルチプラットフォームのiOSアプリまたは複合リンクにはこれを使用してください。 | -| `fallback` | `String` | ボディ | オフプラットフォームのユーザーを送るランディングページ。フォールバックURLを指定する際には、macOSユーザー向けに`redirect_macos`を指定することをお勧めします。 | -| `redirect_macos` | `String` | ボディ | macOSのAdjustのデフォルトリダイレクトを上書きするリダイレクトURL。\`fallback\` を指定する場合は、macOSユーザー向けに`fallback`を指定することをお勧めします。 | -| `label` | `String` | ボディ | リンクにカスタムデータを追加します。このパラメーターを使用して、ユーザーがアプリからショートリンクを共有した際に自動入力される一意の[ユーザー紹介ID](https://help.adjust.com/en/article/set-up-user-referrals)を追加できます。 | -| `og_title` | `String` | ボディ | リンクのソーシャル共有プレビューのタイトル。 | -| `og_description` | `String` | ボディ | リンクのソーシャル共有プレビューの説明。 | -| `og_image` | `String` | ボディ | ソーシャル共有プレビューに使用する、200 x 200 ピクセル以上のJPGまたはPNG形式の画像のURLを指定。 | - -単一のディープリンクを生成\{\#generate\-a\-single\-deep\-link\} ---------------------------------------------------------- +## パラメーター \{\#parameters\} + +| パラメーター | データタイプ | 入力する値 | 説明 | +| ------------------------ | ---------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `adjust_auth_token` | `String` | 説明 | Adjust APIトークン | +| `link_token` | `String` | ボディ | カスタムリンクのリンクトークン。複合リンクからディープリンクを生成している場合、Campaign Labで組み合わせたカスタムリンクの正しいリンクトークンを使用していることを確認してください。 | +| `shorten_url` | `Boolean` | ボディ | リンクが短縮されるかどうか。リンクはデフォルトでは短縮されません。デフォルト値 \- false | +| `campaign` | `String` または `null` | ボディ | キャンペーンの名前 | +| `adgroup` | `String` または `null` | ボディ | アドグループの名前 | +| `creative` | `String` または `null` | ボディ | クリエイティブの名前 | +| `deep_link_path` | `String` | ボディ | ユーザーが遷移するアプリ内の遷移先を指定。シングルプラットフォームアプリにはこれを使用してください。 | +| `ios_deep_link_path` | `String` | ボディ | ユーザーが遷移するiOSのアプリ内の遷移先を指定。マルチプラットフォームのiOSアプリまたは複合リンクにはこれを使用してください。 | +| `android_deep_link_path` | `String` | ボディ | ユーザーが遷移するiOSのアプリ内の遷移先を指定。マルチプラットフォームのiOSアプリまたは複合リンクにはこれを使用してください。 | +| `fallback` | `String` | ボディ | オフプラットフォームのユーザーを送るランディングページ。フォールバックURLを指定する際には、macOSユーザー向けに`redirect_macos`を指定することをお勧めします。 | +| `redirect_macos` | `String` | ボディ | macOSのAdjustのデフォルトリダイレクトを上書きするリダイレクトURL。\`fallback\` を指定する場合は、macOSユーザー向けに`fallback`を指定することをお勧めします。 | +| `label` | `String` | ボディ | リンクにカスタムデータを追加します。このパラメーターを使用して、ユーザーがアプリからショートリンクを共有した際に自動入力される一意の[ユーザー紹介ID](https://help.adjust.com/ja/article/set-up-user-referrals)を追加できます。 | +| `og_title` | `String` | ボディ | リンクのソーシャル共有プレビューのタイトル。 | +| `og_description` | `String` | ボディ | リンクのソーシャル共有プレビューの説明。 | +| `og_image` | `String` | ボディ | ソーシャル共有プレビューに使用する、200 x 200 ピクセル以上のJPGまたはPNG形式の画像のURLを指定。 | + +## 単一のディープリンクを生成\{\#generate\-a\-single\-deep\-link\} シングルまたはマルチプラットフォームのアプリ用に、長いまたは短縮ディープリンクを生成するには、`POST`リクエストを送信します。 -### エンドポイント \{\#endpoint\-single\} +### エンドポイント {#endpoint-single} ```http https://automate.adjust.com/engage/deep-links ``` -### 例 \{\#examples\-single\} +### 例 {#examples-single} -**シングルプラットフォームアプリ** - +**シングルプラットフォームアプリ** + + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -117,16 +119,18 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - + + ```http {"url": "https://insights.go.link/fryYl"} ``` - + + +**マルチプラットフォームアプリ** -**マルチプラットフォームアプリ** - + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -142,18 +146,20 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - + + ```json { "url": "https://insights.go.link/jlbKj" } ``` - + + +**複合リンク** -**複合リンク** +ディープリンクジェネレーターAPIを使用してディープリンクを生成する前に、[Campaign Labで複合カスタムリンクを作成](https://help.adjust.com/ja/article/custom-link-setup)してください。 -ディープリンクジェネレーターAPIを使用してディープリンクを生成する前に、[Campaign Labで複合カスタムリンクを作成](https://help.adjust.com/en/article/custom-link-setup)してください。 - + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -170,28 +176,28 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - + + ```http {"url": "https://insights.go.link/6JtQx"} ``` - + -ディープリンクを一括で生成\{\#generate\-deep\-links\-in\-bulk\} ---------------------------------------------------------- +## ディープリンクを一括で生成\{\#generate\-deep\-links\-in\-bulk\} シングルまたはマルチプラットフォームのアプリ用に、長いまたは短縮ディープリンクを一括で生成するには、`POST`リクエストを送信します。 -### エンドポイント \{\#endpoint\-bulk\} +### エンドポイント {#endpoint-bulk} ```http https://automate.adjust.com/engage/deep-links/bulk ``` -### 例 \{\#example\-bulk\} +### 例 {#example-bulk} - + ```bash curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ @@ -225,7 +231,8 @@ curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ }' ``` - + + ```json { @@ -243,22 +250,21 @@ curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ } ``` - + -ショートリンクトークンを更新\{\#update\-short\-link\-token\} ----------------------------------------------------- +## ショートリンクトークンを更新\{\#update\-short\-link\-token\} `PUT`リクエストを送信して、ディープリンク内の既存のショートリンクトークンを長いリンクに更新します。 -### エンドポイント \{\#endpoint\-update\} +### エンドポイント {#endpoint-update} ```http https://automate.adjust.com/engage/deep-links/{short_token} ``` -### 例 \{\#example\-update\} +### 例 {#example-update} - + ```bash curl --location --request PUT 'https://automate.adjust.com/engage/deep-links/4IlkC' \ @@ -272,11 +278,11 @@ curl --location --request PUT 'https://automate.adjust.com/engage/deep-links/4Il }' ``` - + + ```http 204 No Content ``` - diff --git a/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx b/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx index 6da819a6b..21f78c66e 100644 --- a/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx +++ b/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx @@ -1,27 +1,27 @@ --- -title: "リンクのresolution（解析と変換）" -description: "メール、SMS、QRコード、リンクを短縮するプラットフォームを介したディープリンクのリンク解析を設定します。" -slug: "en/sdk/ios/v4/features/deep-links/resolution" +title: リンクのresolution（解析と変換） +description: メール、SMS、QRコード、リンクを短縮するプラットフォームを介したディープリンクのリンク解析を設定します。 +slug: ja/sdk/ios/v4/features/deep-links/resolution sidebar-position: 5 -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/ios/features/deep-links/resolution" +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ja/sdk/ios/features/deep-links/resolution --- + メール、SMS、QRコード、リンクを短縮するプラットフォームを介したディープリンクのリンク解析を設定する必要があります。そのようなケースのためにリンク解析を設定しない場合、ユニバーサルリンクからのリダイレクトでは、アプリをインストールしているユーザーを含めた全てのユーザーがApp Storeに誘導されます。リンク解析が有効な場合、ユニバーサルリンクへのリダイレクトはアプリ内で発生し、既存のユーザーはApp Storeに誘導されません。 - + + リンク解析がアプリに必要かどうか、マーケティングチームに確認してください。その後、各ユースケースに合わせてリンク解析ドメインを設定できます。 - -仕組み \{\#how\-it\-works\} ------------------------------ + + +## 仕組み \{\#how\-it\-works\} リンク解析は、アプリをインストールしているユーザーがリダイレクトURLをクリックしたときにのみ実行されます。リダイレクトURL内のドメインを、アプリ内のユニバーサルリンクドメインとして設定する必要があります。 @@ -33,41 +33,44 @@ redirects: 3. Adjust SDKのリンク解析メソッドで、リダイレクトURL内のドメインと開発者がAdjust SDKで設定したリンク解析ドメインが比較され、次のいずれかが実行されます。 - * ドメインが一致しない \- メソッドはディープリンクURLをそのまま転送します。 - * ドメインが一致する \- メソッドはリンクを解析し、結果のディープリンクを返します。 + - ドメインが一致しない \- メソッドはディープリンクURLをそのまま転送します。 + - ドメインが一致する \- メソッドはリンクを解析し、結果のディープリンクを返します。 URLの解析を試みると、Adjust SDKは最大10のリダイレクトをフォローアップします。リダイレクトが10以上ある場合は、10番目のリダイレクトURLが返されます。 + 4. アプリは返されたURLを受け取り、ディープリンクコンテンツを開いてユーザーに表示します。またアプリは、返されたURLを使用してAdjust SDKの`appWillOpenUrl`メソッドを呼び出します。これにより、解析されたURLが記録のためにAdjustサーバーに送られます。 - + アプリをインストールしていないユーザーがリダイレクトURLをクリックした場合、iOSはこれを通常のWeb URLとして処理し、ユーザーをApp Storeにリダイレクトします。この場合、リンク解析は実行されません。 - -ユースケース \{\#use\-cases\} ---------------------------- + + +## ユースケース \{\#use\-cases\} リンク解析は、次の場合に実行されます。 -* [Eメールマーケティング](#email-marketing) -* [URLを短縮するプラットフォーム](#url-shorteners) +- [Eメールマーケティング](#email-marketing) +- [URLを短縮するプラットフォーム](#url-shorteners) -### Eメールマーケティング \{\#email\-marketing\} +### Eメールマーケティング {#email-marketing} メールマーケターがキャンペーンを実施する際、メールマーケティングプラットフォームでは通常、独自のクリック計測用リダイレクトURLを使用してメール内の全てのリンクをラップします。これによりメールマーケターは、メールマーケティングプラットフォームでクリック率を確認できます。ただし、メールにユニバーサルリンクが含まれている場合、リダイレクトURLが原因でiOSはユニバーサルリンクを解析できません。 -* メールマーケティングプラットフォーム：メールマーケターがキャンペーンを構築するために使用するソフトウェア。これには、メールテンプレートやオーディエンスターゲティングなどの機能が含まれます。 **例：** Braze、Iterable、SendGrid -* メールサービスプロバイダー（ESP）：メールを送信し、ISP（インターネットサービスプロバイダー）のメールサーバーへの送達可能性を管理する基盤インフラストラクチャー。 **例：** SendGrid、SparkPost -* メールパートナー：メールマーケティングプラットフォームまたはメールサービスプロバイダー（ESP）のいずれかを表す一般的な用語。メールパートナーとは、メールマーケティングプラットフォーム、ESP、またはその両方を指します。 **例：** SendGridはメールマーケティングプラットフォームであり、ESPでもあります。メールマーケティングでは、他のパートナーをESPとして使用することができます。 **例：** BrazeとIterableはどちらもSendGridとSparkPostをESPとして使用しています。 +- メールマーケティングプラットフォーム：メールマーケターがキャンペーンを構築するために使用するソフトウェア。これには、メールテンプレートやオーディエンスターゲティングなどの機能が含まれます。 **例：** Braze、Iterable、SendGrid +- メールサービスプロバイダー（ESP）：メールを送信し、ISP（インターネットサービスプロバイダー）のメールサーバーへの送達可能性を管理する基盤インフラストラクチャー。 **例：** SendGrid、SparkPost +- メールパートナー：メールマーケティングプラットフォームまたはメールサービスプロバイダー（ESP）のいずれかを表す一般的な用語。メールパートナーとは、メールマーケティングプラットフォーム、ESP、またはその両方を指します。 **例：** SendGridはメールマーケティングプラットフォームであり、ESPでもあります。メールマーケティングでは、他のパートナーをESPとして使用することができます。 **例：** BrazeとIterableはどちらもSendGridとSparkPostをESPとして使用しています。 -#### \{\#setup\} の設定 +#### {#setup} の設定 1. 使用しているドメイン上に、メール計測専用のドメインまたはサブドメインを作成します。メール計測用のドメインまたはサブドメインがすでにある場合は、既存のキャンペーンを妨げることなくこの実装を完了できるよう、新たに作成することをお勧めします。この実装を完了してテストした後に、この実装を既存のメールリダイレクトドメインに切り替えることができます。 **例：** `email.example.com` + 2. Xcodeで、メールリダイレクトドメインを **Associated Domains** 設定に追加します。 **例：** `applinks:email.example.com` + 3. ユニバーサルリンクを設定します。 4. `resolveLinkWithUrl`リンク解析メソッドの`resolveUrlSuffixArray`にメールリダイレクトドメインが追加されていることを確認します。 @@ -79,35 +82,38 @@ redirects: 1. **SSL証明書** ：iOSでは、ユニバーサルリンクでHTTPSのみを使用する必要があります。そのため、メールリダイレクトドメインにはSSL証明書が必要です。 2. **AASA（Apple\-App\-Site\-Association）ファイル** ：メールパートナーによっては、独自のAASAファイルをホストするか、AASAファイルをメールパートナーシステムにアップロードする必要があります。AASAファイルのホスティングについては、メールパートナーのドキュメントを参照してください。 - 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます：`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` - 3. （該当する場合、AASAファイルを除いた）メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 + 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます：`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` 3. （該当する場合、AASAファイルを除いた）メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 **例：** `redirect.example.net` + 7. CDNをポイントするようにメールリダイレクトドメインのDNSを設定します。 - + + +上記の指示に対応するパートナー固有の指示については、ヘルプセンターの[ESP連携に関するセクション](https://help.adjust.com/ja/marketer/esp-integrations)を参照してください。 -上記の指示に対応するパートナー固有の指示については、ヘルプセンターの[ESP連携に関するセクション](https://help.adjust.com/en/marketer/esp-integrations)を参照してください。 - + -##### メールパートナーのサポート \{\#support\-for\-email\-partners\} +##### メールパートナーのサポート {#support-for-email-partners} リンク解析を使用するには、リダイレクトドメイン（またはサブドメイン）をユニバーサルリンクドメインとして設定することをメールパートナーが許可している必要があります。許可されている場合、それらのリダイレクトサービスを独自のカスタムドメインにポイントできます。 -**例：** +**例：** -* Braze：割り当てられているESP Brazeに応じて、SendGridまたはSparkPostでリダイレクトドメインを設定し、独自のカスタムドメインをそれにポイントします。その後、カスタムドメインをユニバーサルリンクドメインとして設定できます。 -* Iterable：Iterableでは、カスタムドメインをサポートするURLリダイレクトサービスが提供されています。 -* Mailchimp：Mailchimpでは、リダイレクトドメインをユニバーサルリンクとして設定することが許可されていないため、リンク解析は利用できません。 +- Braze：割り当てられているESP Brazeに応じて、SendGridまたはSparkPostでリダイレクトドメインを設定し、独自のカスタムドメインをそれにポイントします。その後、カスタムドメインをユニバーサルリンクドメインとして設定できます。 +- Iterable：Iterableでは、カスタムドメインをサポートするURLリダイレクトサービスが提供されています。 +- Mailchimp：Mailchimpでは、リダイレクトドメインをユニバーサルリンクとして設定することが許可されていないため、リンク解析は利用できません。 -#### 例 \{\#example\} +#### 例 {#example} 1. メールマーケターが、テンプレートを使用してメールを作成します。このテンプレートには、ユニバーサルリンクを使用したリンクまたは画像が含まれています。 **例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` + 2. 受信者リストに対して、メールを送信します。メールが送信される前に、メールマーケティングプラットフォームは、独自のリダイレクトURLを使用してユニバーサルリンクをラップします。 **例：** `https://email.example.com/2wuTnQvU` + 3. アプリをインストールしたユーザーが、メール内のリダイレクトURLをクリックします。 4. iOSがアプリを開き、リダイレクトURLをアプリにパスします。 @@ -118,17 +124,18 @@ redirects: したがって、 `https://email.example.com/2wuTnQvU` は `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123`にリダイレクトされます。 + 7. リンク解析メソッドが、解析されたURLを返します。 8. アプリが、返されたURLを処理します。この場合、アプリは`summer-clothes`ページをアプリ内に`beach promo`モーダルでユーザーに表示します。 9. アプリは返されたURLでAdjust SDKの`appWillOpenUrl`メソッドを呼び出します。 -### URL短縮 \{\#url\-shorteners\} +### URL短縮 {#url-shorteners} マーケターが特定の種類のキャンペーンを実施する際、短いURLが必要になる場合があります。例えば、SMSには160文字の制限がありますが、リンクを短縮してSlackなどのチームコミュニケーションプラットフォームで共有することを顧客が望む場合があります。ただし、短縮URLがユニバーサルリンクにリダイレクトされる場合、iOSはユニバーサルリンクを解析できません。 -#### \{\#setup\-1\} の設定 +#### {#setup-1} の設定 1. 使用しているドメイン上に、URL短縮専用のドメインまたはサブドメインを作成します。 URL短縮用のドメインまたはサブドメインがすでにある場合は、既存のキャンペーンを妨げることなくこの実装を完了できるよう、新たに作成することをお勧めします。この実装を完了してテストした後に、この実装を既存のURL短縮ドメインに切り替えることができます。 @@ -136,6 +143,7 @@ redirects: 2. XcodeでURL短縮ドメインを **Associated Domains** 設定に追加します。 **例：** `applinks:short.example.com` + 3. ユニバーサルリンクを設定します。 4. `resolveLinkWithUrl`リンク解析メソッドの`resolveUrlSuffixArray`にメールリダイレクトドメインが追加されていることを確認します。 @@ -143,18 +151,21 @@ redirects: 5. ユニバーサルリンクをサポートするURL短縮サービスを設定します。AdjustではURL短縮サービスを提供していません。 **例：** [`short.io`](http://short.io) + 6. URL短縮サービスで、URL短縮ドメインをカスタムドメインとして設定します。URL短縮サービスのサーバーをポイントするように、URL短縮ドメインのDNSを設定してください（[short.ioにカスタムドメインを追加する参照ドキュメント](https://help.short.io/en/articles/9991681-how-can-i-add-a-domain)）。 7. URL短縮サービスでユニバーサルリンクを設定します（[short.ioのユニバーサルリンクを設定する参照ドキュメント](https://help.short.io/en/articles/4065870-how-to-set-up-deep-links-for-ios)）。 -#### 例 \{\#example\-1\} +#### 例 {#example-1} 1. マーケターがユニバーサルリンクを作成します。 **例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` + 2. URL短縮サービスを使用して、短縮リンクを生成します。 **例：** `https://short.example.com/2wuTnQvU` + 3. SMSキャンペーンなどのキャンペーンで短縮リンクを使用します。 4. アプリをインストールしたユーザーが、SMSメッセージ内の短縮URLをクリックします。 @@ -167,9 +178,9 @@ redirects: したがって、 `https://short.example.com/2wuTnQvU` は `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123`にリダイレクトされます。 + 8. リンク解析メソッドが、解析されたURLを返します。 9. アプリが、返されたURLを処理します。この場合、アプリは`summer-clothes`ページをアプリ内に`beach promo`モーダルでユーザーに表示します。 -10. アプリは返されたURLでAdjust SDKの`appWillOpenUrl`メソッドを呼び出します。 - +10. アプリは返されたURLでAdjust SDKの`appWillOpenUrl`メソッドを呼び出します。 diff --git a/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx b/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx index 18078c3c6..de8110277 100644 --- a/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx +++ b/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx @@ -1,27 +1,27 @@ --- -title: "リンクのresolution（解析と変換）" -description: "メール、SMS、QRコード、リンクを短縮するプラットフォームを介したディープリンクのリンク解析を設定します。" -slug: "en/sdk/ios/features/deep-links/resolution" +title: リンクのresolution（解析と変換） +description: メール、SMS、QRコード、リンクを短縮するプラットフォームを介したディープリンクのリンク解析を設定します。 +slug: ja/sdk/ios/features/deep-links/resolution sidebar-position: 5 -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/ios/v4/features/deep-links/resolution" +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ja/sdk/ios/v4/features/deep-links/resolution --- + メール、SMS、QRコード、リンクを短縮するプラットフォームを介したディープリンクのリンク解析を設定する必要があります。そのようなケースのためにリンク解析を設定しない場合、ユニバーサルリンクからのリダイレクトでは、アプリをインストールしているユーザーを含めた全てのユーザーがApp Storeに誘導されます。リンク解析が有効な場合、ユニバーサルリンクへのリダイレクトはアプリ内で発生し、既存のユーザーはApp Storeに誘導されません。 - + + リンク解析がアプリに必要かどうか、マーケティングチームに確認してください。その後、各ユースケースに合わせてリンク解析ドメインを設定できます。 - -仕組み \{\#how\-it\-works\} ------------------------------ + + +## 仕組み \{\#how\-it\-works\} リンク解析は、アプリをインストールしているユーザーがリダイレクトURLをクリックしたときにのみ実行されます。リダイレクトURL内のドメインを、アプリ内のユニバーサルリンクドメインとして設定する必要があります。 @@ -33,41 +33,44 @@ redirects: 3. Adjust SDKのリンク解析メソッドで、リダイレクトURL内のドメインと開発者がAdjust SDKで設定したリンク解析ドメインが比較され、次のいずれかが実行されます。 - * ドメインが一致しない \- メソッドはディープリンクURLをそのまま転送します。 - * ドメインが一致する \- メソッドはリンクを解析し、結果のディープリンクを返します。 + - ドメインが一致しない \- メソッドはディープリンクURLをそのまま転送します。 + - ドメインが一致する \- メソッドはリンクを解析し、結果のディープリンクを返します。 URLの解析を試みると、Adjust SDKは最大10のリダイレクトをフォローアップします。リダイレクトが10以上ある場合は、10番目のリダイレクトURLが返されます。 + 4. アプリは返されたURLを受け取り、ディープリンクコンテンツを開いてユーザーに表示します。またアプリは、返されたURLを使用してAdjust SDKの`processDeeplink`メソッドを呼び出します。これにより、解析されたURLが記録のためにAdjustサーバーに送られます。 - + アプリをインストールしていないユーザーがリダイレクトURLをクリックした場合、iOSはこれを通常のWeb URLとして処理し、ユーザーをApp Storeにリダイレクトします。この場合、リンク解析は実行されません。 - -ユースケース \{\#use\-cases\} ---------------------------- + + +## ユースケース \{\#use\-cases\} リンク解析は、次の場合に実行されます。 -* [Eメールマーケティング](#email-marketing) -* [URLを短縮するプラットフォーム](#url-shorteners) +- [Eメールマーケティング](#email-marketing) +- [URLを短縮するプラットフォーム](#url-shorteners) -### Eメールマーケティング \{\#email\-marketing\} +### Eメールマーケティング {#email-marketing} メールマーケターがキャンペーンを実施する際、メールマーケティングプラットフォームでは通常、独自のクリック計測用リダイレクトURLを使用してメール内の全てのリンクをラップします。これによりメールマーケターは、メールマーケティングプラットフォームでクリック率を確認できます。ただし、メールにユニバーサルリンクが含まれている場合、リダイレクトURLが原因でiOSはユニバーサルリンクを解析できません。 -* メールマーケティングプラットフォーム：メールマーケターがキャンペーンを構築するために使用するソフトウェア。これには、メールテンプレートやオーディエンスターゲティングなどの機能が含まれます。 **例：** Braze、Iterable、SendGrid -* メールサービスプロバイダー（ESP）：メールを送信し、ISP（インターネットサービスプロバイダー）のメールサーバーへの送達可能性を管理する基盤インフラストラクチャー。 **例：** SendGrid、SparkPost -* メールパートナー：メールマーケティングプラットフォームまたはメールサービスプロバイダー（ESP）のいずれかを表す一般的な用語。メールパートナーとは、メールマーケティングプラットフォーム、ESP、またはその両方を指します。 **例：** SendGridはメールマーケティングプラットフォームであり、ESPでもあります。メールマーケティングでは、他のパートナーをESPとして使用することができます。 **例：** BrazeとIterableはどちらもSendGridとSparkPostをESPとして使用しています。 +- メールマーケティングプラットフォーム：メールマーケターがキャンペーンを構築するために使用するソフトウェア。これには、メールテンプレートやオーディエンスターゲティングなどの機能が含まれます。 **例：** Braze、Iterable、SendGrid +- メールサービスプロバイダー（ESP）：メールを送信し、ISP（インターネットサービスプロバイダー）のメールサーバーへの送達可能性を管理する基盤インフラストラクチャー。 **例：** SendGrid、SparkPost +- メールパートナー：メールマーケティングプラットフォームまたはメールサービスプロバイダー（ESP）のいずれかを表す一般的な用語。メールパートナーとは、メールマーケティングプラットフォーム、ESP、またはその両方を指します。 **例：** SendGridはメールマーケティングプラットフォームであり、ESPでもあります。メールマーケティングでは、他のパートナーをESPとして使用することができます。 **例：** BrazeとIterableはどちらもSendGridとSparkPostをESPとして使用しています。 -#### \{\#setup\} の設定 +#### {#setup} の設定 1. 使用しているドメイン上に、メール計測専用のドメインまたはサブドメインを作成します。メール計測用のドメインまたはサブドメインがすでにある場合は、既存のキャンペーンを妨げることなくこの実装を完了できるよう、新たに作成することをお勧めします。この実装を完了してテストした後に、この実装を既存のメールリダイレクトドメインに切り替えることができます。 **例：** `email.example.com` + 2. Xcodeで、メールリダイレクトドメインを **Associated Domains** 設定に追加します。 **例：** `applinks:email.example.com` + 3. ユニバーサルリンクを設定します。 4. `resolveLinkWithUrl`リンク解析メソッドの`resolveUrlSuffixArray`にメールリダイレクトドメインが追加されていることを確認します。 @@ -79,35 +82,38 @@ redirects: 1. **SSL証明書** ：iOSでは、ユニバーサルリンクでHTTPSのみを使用する必要があります。そのため、メールリダイレクトドメインにはSSL証明書が必要です。 2. **AASA（Apple\-App\-Site\-Association）ファイル** ：メールパートナーによっては、独自のAASAファイルをホストするか、AASAファイルをメールパートナーシステムにアップロードする必要があります。AASAファイルのホスティングについては、メールパートナーのドキュメントを参照してください。 - 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます：`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` - 3. （該当する場合、AASAファイルを除いた）メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 + 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます：`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` 3. （該当する場合、AASAファイルを除いた）メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 **例：** `redirect.example.net` + 7. CDNをポイントするようにメールリダイレクトドメインのDNSを設定します。 - + + +上記の指示に対応するパートナー固有の指示については、ヘルプセンターの[ESP連携に関するセクション](https://help.adjust.com/ja/marketer/esp-integrations)を参照してください。 -上記の指示に対応するパートナー固有の指示については、ヘルプセンターの[ESP連携に関するセクション](https://help.adjust.com/en/marketer/esp-integrations)を参照してください。 - + -##### メールパートナーのサポート \{\#support\-for\-email\-partners\} +##### メールパートナーのサポート {#support-for-email-partners} リンク解析を使用するには、リダイレクトドメイン（またはサブドメイン）をユニバーサルリンクドメインとして設定することをメールパートナーが許可している必要があります。許可されている場合、それらのリダイレクトサービスを独自のカスタムドメインにポイントできます。 -**例：** +**例：** -* Braze：割り当てられているESP Brazeに応じて、SendGridまたはSparkPostでリダイレクトドメインを設定し、独自のカスタムドメインをそれにポイントします。その後、カスタムドメインをユニバーサルリンクドメインとして設定できます。 -* Iterable：Iterableでは、カスタムドメインをサポートするURLリダイレクトサービスが提供されています。 -* Mailchimp：Mailchimpでは、リダイレクトドメインをユニバーサルリンクとして設定することが許可されていないため、リンク解析は利用できません。 +- Braze：割り当てられているESP Brazeに応じて、SendGridまたはSparkPostでリダイレクトドメインを設定し、独自のカスタムドメインをそれにポイントします。その後、カスタムドメインをユニバーサルリンクドメインとして設定できます。 +- Iterable：Iterableでは、カスタムドメインをサポートするURLリダイレクトサービスが提供されています。 +- Mailchimp：Mailchimpでは、リダイレクトドメインをユニバーサルリンクとして設定することが許可されていないため、リンク解析は利用できません。 -#### 例 \{\#example\} +#### 例 {#example} 1. メールマーケターが、テンプレートを使用してメールを作成します。このテンプレートには、ユニバーサルリンクを使用したリンクまたは画像が含まれています。 **例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` + 2. 受信者リストに対して、メールを送信します。メールが送信される前に、メールマーケティングプラットフォームは、独自のリダイレクトURLを使用してユニバーサルリンクをラップします。 **例：** `https://email.example.com/2wuTnQvU` + 3. アプリをインストールしたユーザーが、メール内のリダイレクトURLをクリックします。 4. iOSがアプリを開き、リダイレクトURLをアプリにパスします。 @@ -118,17 +124,18 @@ redirects: したがって、 `https://email.example.com/2wuTnQvU` は `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123`にリダイレクトされます。 + 7. リンク解析メソッドが、解析されたURLを返します。 8. アプリが、返されたURLを処理します。この場合、アプリは`summer-clothes`ページをアプリ内に`beach promo`モーダルでユーザーに表示します。 9. アプリは返されたURLでAdjust SDKの`processDeeplink`メソッドを呼び出します。 -### URL短縮 \{\#url\-shorteners\} +### URL短縮 {#url-shorteners} マーケターが特定の種類のキャンペーンを実施する際、短いURLが必要になる場合があります。例えば、SMSには160文字の制限がありますが、リンクを短縮してSlackなどのチームコミュニケーションプラットフォームで共有することを顧客が望む場合があります。ただし、短縮URLがユニバーサルリンクにリダイレクトされる場合、iOSはユニバーサルリンクを解析できません。 -#### \{\#setup\-1\} の設定 +#### {#setup-1} の設定 1. 使用しているドメイン上に、URL短縮専用のドメインまたはサブドメインを作成します。 URL短縮用のドメインまたはサブドメインがすでにある場合は、既存のキャンペーンを妨げることなくこの実装を完了できるよう、新たに作成することをお勧めします。この実装を完了してテストした後に、この実装を既存のURL短縮ドメインに切り替えることができます。 @@ -136,6 +143,7 @@ redirects: 2. XcodeでURL短縮ドメインを **Associated Domains** 設定に追加します。 **例：** `applinks:short.example.com` + 3. ユニバーサルリンクを設定します。 4. `resolveLinkWithUrl`リンク解析メソッドの`resolveUrlSuffixArray`にメールリダイレクトドメインが追加されていることを確認します。 @@ -143,18 +151,21 @@ redirects: 5. ユニバーサルリンクをサポートするURL短縮サービスを設定します。AdjustではURL短縮サービスを提供していません。 **例：** [`short.io`](http://short.io) + 6. URL短縮サービスで、URL短縮ドメインをカスタムドメインとして設定します。URL短縮サービスのサーバーをポイントするように、URL短縮ドメインのDNSを設定してください（[short.ioにカスタムドメインを追加する参照ドキュメント](https://help.short.io/en/articles/9991681-how-can-i-add-a-domain)）。 7. URL短縮サービスでユニバーサルリンクを設定します（[short.ioのユニバーサルリンクを設定する参照ドキュメント](https://help.short.io/en/articles/4065870-how-to-set-up-deep-links-for-ios)）。 -#### 例 \{\#example\-1\} +#### 例 {#example-1} 1. マーケターがユニバーサルリンクを作成します。 **例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` + 2. URL短縮サービスを使用して、短縮リンクを生成します。 **例：** `https://short.example.com/2wuTnQvU` + 3. SMSキャンペーンなどのキャンペーンで短縮リンクを使用します。 4. アプリをインストールしたユーザーが、SMSメッセージ内の短縮URLをクリックします。 @@ -167,9 +178,9 @@ redirects: したがって、 `https://short.example.com/2wuTnQvU` は `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123`にリダイレクトされます。 + 8. リンク解析メソッドが、解析されたURLを返します。 9. アプリが、返されたURLを処理します。この場合、アプリは`summer-clothes`ページをアプリ内に`beach promo`モーダルでユーザーに表示します。 -10. アプリは返されたURLでAdjust SDKの`processDeeplink`メソッドを呼び出します。 - +10. アプリは返されたURLでAdjust SDKの`processDeeplink`メソッドを呼び出します。 diff --git a/src/content/docs/ko/api/deep-link-generator-api.mdx b/src/content/docs/ko/api/deep-link-generator-api.mdx index bd87ad075..b0688e6ba 100644 --- a/src/content/docs/ko/api/deep-link-generator-api.mdx +++ b/src/content/docs/ko/api/deep-link-generator-api.mdx @@ -1,59 +1,62 @@ --- -title: "딥링크 생성기 API" -description: "딥링크 생성기 API를 사용하여 앱에 대한 긴/단축 딥링크를 개별 또는 일괄로 생성할 수 있습니다." -category-title: "딥링크 생성기 API" -slug: "en/api/deep-link-generator-api" +title: 딥링크 생성기 API +description: 딥링크 생성기 API를 사용하여 앱에 대한 긴/단축 딥링크를 개별 또는 일괄로 생성할 수 있습니다. +category-title: 딥링크 생성기 API +slug: ko/api/deep-link-generator-api sidebar-position: 8 --- + 딥링크 생성기 API를 사용하여 앱에 대한 긴/단축 딥링크를 개별 또는 일괄로 생성할 수 있습니다. 이러한 맞춤형 딥링크는 다양한 플랫폼에서 사용자 경험을 향상시킵니다. -시작에 앞서 \{\#before\-you\-begin\} ------------------------------------- +## 시작에 앞서 \{\#before\-you\-begin\} 시작하기 전에 알아야 할 사항은 다음과 같습니다. -### 가용성 \{\#availability\} +### 가용성 {#availability} - + 딥링크 생성기 API는 초당 200개의 요청으로 제한됩니다. 이 제한을 초과하면 429 오류가 발생합니다. - -* 딥링크 생성기 API에 액세스하려면 TrueLink Base, Core 또는 Enterprise 패키지를 사용해야 합니다. -* 딥링크 생성기 API를 사용하여 생성된 링크는 [Campaign Lab](https://help.adjust.com/en/article/campaign-setup) 에 표시되지 않습니다. -* 딥링크 생성기 API를 사용하여 생성된 단축 링크의 TTL\(time\-to\-live\)은 120일입니다. + + +- 딥링크 생성기 API에 액세스하려면 TrueLink Base, Core 또는 Enterprise 패키지를 사용해야 합니다. +- 딥링크 생성기 API를 사용하여 생성된 링크는 [Campaign Lab](https://help.adjust.com/ko/article/campaign-setup) 에 표시되지 않습니다. +- 딥링크 생성기 API를 사용하여 생성된 단축 링크의 TTL\(time\-to\-live\)은 120일입니다. + +### 요구 사항 {#requirements} + +- 관리자, 편집자 또는 사용자 지정 편집자 [권한](https://help.adjust.com/ko/article/permission-levels). +- iOS와 Android 앱에 대해 [동일한 브랜드 도메인을 설정](https://help.adjust.com/ko/article/set-up-branded-domain)합니다. + + - iOS 앱의 경우 브랜드 도메인을 [Associated Domain](https://help.adjust.com/ko/article/set-up-branded-domain#ios-only-update)으로 추가하시기 바랍니다. 이렇게 하면 도메인이 유니버셜 링크로 구성되도록 설정됩니다. + - Android 앱의 경우 브랜드 도메인을 [Android 앱 링크](https://help.adjust.com/ko/article/set-up-android-app-links)로 정의하시기 바랍니다. -### 요구 사항 \{\#requirements\} +- 앱에 대한 커스텀 링크. -* 관리자, 편집자 또는 사용자 지정 편집자 [권한](https://help.adjust.com/en/article/permission-levels). -* iOS와 Android 앱에 대해 [동일한 브랜드 도메인을 설정](https://help.adjust.com/en/article/set-up-branded-domain)합니다. - * iOS 앱의 경우 브랜드 도메인을 [Associated Domain](https://help.adjust.com/en/article/set-up-branded-domain#ios-only-update)으로 추가하시기 바랍니다. 이렇게 하면 도메인이 유니버셜 링크로 구성되도록 설정됩니다. - * Android 앱의 경우 브랜드 도메인을 [Android 앱 링크](https://help.adjust.com/en/article/set-up-android-app-links)로 정의하시기 바랍니다. + - 단일 플랫폼 앱, 멀티 플랫폼 앱 \- [Campaign Lab에서 커스텀 링크를 생성](https://help.adjust.com/ko/article/custom-link-setup) 하여 단일 링크 토큰을 받을 수 있습니다. + - 여러 개의 단일 플랫폼 앱 \- [Campaign Lab](https://help.adjust.com/ko/article/custom-link-setup#combined-custom-links) 에서 여러 개의 단일 플랫폼 앱으로부터 결합된 커스텀 링크를 생성하여, 여러 개의 링크 토큰이 '\_'로 구분된 단일 결합된 커스텀 링크를 생성할 수 있습니다. 자세한 정보는 [복합 커스텀 링크에 대한 플랫폼별 링크 토큰](https://help.adjust.com/ko/article/manage-custom-link-setup#link-tokens-combined-custom-link)을 참조하시기 바랍니다. -* 앱에 대한 커스텀 링크. - * 단일 플랫폼 앱, 멀티 플랫폼 앱 \- [Campaign Lab에서 커스텀 링크를 생성](https://help.adjust.com/en/article/custom-link-setup) 하여 단일 링크 토큰을 받을 수 있습니다. - * 여러 개의 단일 플랫폼 앱 \- [Campaign Lab](https://help.adjust.com/en/article/custom-link-setup#combined-custom-links) 에서 여러 개의 단일 플랫폼 앱으로부터 결합된 커스텀 링크를 생성하여, 여러 개의 링크 토큰이 '\_'로 구분된 단일 결합된 커스텀 링크를 생성할 수 있습니다. 자세한 정보는 [복합 커스텀 링크에 대한 플랫폼별 링크 토큰](https://help.adjust.com/en/article/manage-custom-link-setup#link-tokens-combined-custom-link)을 참조하시기 바랍니다. +- 단축 링크 해석을 위해 Adjust SDK를 업데이트 하시기 바랍니다. -* 단축 링크 해석을 위해 Adjust SDK를 업데이트 하시기 바랍니다. - * [iOS](/en/sdk/ios/features/short-links) \| [Android](/en/sdk/android/features/short-links) \| [Unity](/en/sdk/unity/features/short-links) \| [React Native](/en/sdk/react-native/features/short-links) \| [Flutter](/en/sdk/flutter/features/short-links) \| [Cordova](/en/sdk/cordova/features/short-links) \| [Cocos2d\-x](/en/sdk/cocos2dx/features/short-links) + - [iOS](/ko/sdk/ios/features/short-links) \| [Android](/ko/sdk/android/features/short-links) \| [Unity](/ko/sdk/unity/features/short-links) \| [React Native](/ko/sdk/react-native/features/short-links) \| [Flutter](/ko/sdk/flutter/features/short-links) \| [Cordova](/ko/sdk/cordova/features/short-links) \| [Cocos2d\-x](/ko/sdk/cocos2dx/features/short-links) -* [데이터 레지던시를 설정](https://help.adjust.com/en/article/data-residency-setup)한 경우, iOS와 Android 앱에 동일한 지역을 사용해야 합니다. +- [데이터 레지던시를 설정](https://help.adjust.com/ko/article/data-residency-setup)한 경우, iOS와 Android 앱에 동일한 지역을 사용해야 합니다. -인증 \{\#authentication\} --------------------------- +## 인증 \{\#authentication\} 캠페인 API는 인증을 위해 [베어러 토큰](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) 을 사용합니다. 반드시 캠페인 API에 대한 각 요청과 함께 `Authorization` 헤더에 Adjust API 토큰을 포함해야 합니다. Single Sign\-On \(SSO\)를 활성화한 경우, Adjust 담당자에게 연락하거나 [support@adjust.com](mailto:support@adjust.com) 으로 이메일을 보내 API를 찾는 데 도움을 받으시기 바랍니다. -비 SSO 계정의 경우, API는 사용자의 **프로필** 에서 확인하실 수 있습니다. Adjust API 토큰을 확인하려면 다음 단계를 따르시기 바랍니다. +비 SSO 계정의 경우, API는 사용자의 **프로필** 에서 확인하실 수 있습니다. Adjust API 토큰을 확인하려면 다음 단계를 따르시기 바랍니다. 1. 계정\(사용자\) 아이콘을 선택합니다. 2. **계정 설정** 을 선택합니다. 3. **내 프로필** 탭을 선택합니다. 4. **API 토큰** 은 **사용자 세부 사항** 과 함께 표시됩니다. 시스템 클립보드에 토큰을 복사하기 위해 복사를 선택합니다. -### Adjust API 토큰 재설정 \{\#reset\-your\-adjust\-api\-token\} +### Adjust API 토큰 재설정 {#reset-your-adjust-api-token} Adjust API 토큰은 언제든지 재설정할 수 있습니다. 토큰을 재설정하면 이전의 토큰은 무효화됩니다. Adjust API 토큰을 재설정한 경우 기존 토큰이 사용되는 모든 곳에서 교체해야 합니다. 무효화된 토큰에 대한 요청은 Adjust에 의해 거부됩니다. @@ -62,47 +65,46 @@ Adjust API 토큰 재설정 1. 계정\(사용자\) 아이콘을 선택합니다. 2. **계정 설정** 을 선택합니다. 3. **내 프로필** 탭을 선택합니다. -4. **API 토큰** 은 **사용자 세부 사항** 과 함께 표시됩니다. +4. **API 토큰** 은 **사용자 세부 사항** 과 함께 표시됩니다. 5. **API 토큰 재설정** 을 선택합니다. 6. 모달에 계정 비밀번호를 입력한 후 API 토큰 재설정을 위해 **재설정** 을 선택합니다. 화면 우측 상단에 확인 메시지가 나타납니다. 7. 시스템 클립보드에 **API 토큰** 을 복사하기 위해 복사를 선택합니다. -파라미터 \{\#parameters\} ------------------------- - -| 파라미터 | 데이터 유형 | In | 설명 | -|--------------------------|--------------------|------|-----------------------------------------------------------------------------------------------------------------------------------------------------------| -| `adjust_auth_token` | `String` | 헤더 | Adjust API 토큰 | -| `link_token` | `String` | Body | 커스텀 링크의 링크 토큰. 결합된 링크에서 딥링크를 생성하는 경우, Campaign Lab에서 결합된 커스텀 링크로부터의 올바른 링크 토큰을 사용해야 합니다. | -| `shorten_url` | `Boolean` | Body | 링크 단축 여부. 기본값은 단축하지 않은 링크로 설정되어 있습니다. 기본값 \- false | -| `campaign` | `String` 또는 `null` | Body | 캠페인의 이름 | -| `adgroup` | `String` 또는 `null` | Body | 광고그룹 이름 | -| `creative` | `String` 또는 `null` | Body | 크리에이티브의 이름 | -| `deep_link_path` | `String` | Body | 사용자가 이동되는 인앱 목적지를 지정합니다. 단일 플랫폼 앱에 사용하시기 바랍니다. | -| `ios_deep_link_path` | `String` | Body | 사용자가 이동되는 iOS 인앱 목적지를 지정합니다. 멀티 플랫폼 iOS 앱 또는 복합 링크에 사용하시기 바랍니다. | -| `android_deep_link_path` | `String` | Body | 사용자가 이동되는 Android 인앱 목적지를 지정합니다. 멀티 플랫폼 Android 앱 또는 복합 링크에 사용하시기 바랍니다. | -| `fallback` | `String` | Body | 오프 플랫폼 사용자를 보내는 랜딩 페이지. 폴백 URL을 지정할 때 macOS 사용자에 대해 \`redirect\_macos\`를 지정하는 것을 권장합니다. | -| `redirect_macos` | `String` | Body | macOS에 대한 Adjust의 디폴트 리다이렉트를 오버라이드하기 위한 리다이렉트 URL. `fallback`을 지정할 때 macOS 사용자에 대해 이 파라미터를 설정하는 것을 권장합니다. | -| `label` | `String` | Body | 링크에 커스텀 데이터를 추가합니다. 이 파라미터를 사용하여 사용자가 앱에서 단축 링크를 공유할 때 자동으로 입력되는 고유한 [사용자 리퍼러 ID](https://help.adjust.com/en/article/set-up-user-referrals) 를 추가할 수 있습니다. | -| `og_title` | `String` | Body | 링크의 소셜 공유 미리보기 제목. | -| `og_description` | `String` | Body | 링크의 소셜 공유 미리보기에 대한 설명. | -| `og_image` | `String` | Body | 링크의 소셜 공유 미리보기를 위한 최소 200 x 200 픽셀 크기의 JPG 또는 PNG 이미지에 대한 URL. | - -단일 딥링크 \{\#generate\-a\-single\-deep\-link\} 생성 ------------------------------------------------------- +## 파라미터 \{\#parameters\} + +| 파라미터 | 데이터 유형 | In | 설명 | +| ------------------------ | -------------------- | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `adjust_auth_token` | `String` | 헤더 | Adjust API 토큰 | +| `link_token` | `String` | Body | 커스텀 링크의 링크 토큰. 결합된 링크에서 딥링크를 생성하는 경우, Campaign Lab에서 결합된 커스텀 링크로부터의 올바른 링크 토큰을 사용해야 합니다. | +| `shorten_url` | `Boolean` | Body | 링크 단축 여부. 기본값은 단축하지 않은 링크로 설정되어 있습니다. 기본값 \- false | +| `campaign` | `String` 또는 `null` | Body | 캠페인의 이름 | +| `adgroup` | `String` 또는 `null` | Body | 광고그룹 이름 | +| `creative` | `String` 또는 `null` | Body | 크리에이티브의 이름 | +| `deep_link_path` | `String` | Body | 사용자가 이동되는 인앱 목적지를 지정합니다. 단일 플랫폼 앱에 사용하시기 바랍니다. | +| `ios_deep_link_path` | `String` | Body | 사용자가 이동되는 iOS 인앱 목적지를 지정합니다. 멀티 플랫폼 iOS 앱 또는 복합 링크에 사용하시기 바랍니다. | +| `android_deep_link_path` | `String` | Body | 사용자가 이동되는 Android 인앱 목적지를 지정합니다. 멀티 플랫폼 Android 앱 또는 복합 링크에 사용하시기 바랍니다. | +| `fallback` | `String` | Body | 오프 플랫폼 사용자를 보내는 랜딩 페이지. 폴백 URL을 지정할 때 macOS 사용자에 대해 \`redirect_macos\`를 지정하는 것을 권장합니다. | +| `redirect_macos` | `String` | Body | macOS에 대한 Adjust의 디폴트 리다이렉트를 오버라이드하기 위한 리다이렉트 URL. `fallback`을 지정할 때 macOS 사용자에 대해 이 파라미터를 설정하는 것을 권장합니다. | +| `label` | `String` | Body | 링크에 커스텀 데이터를 추가합니다. 이 파라미터를 사용하여 사용자가 앱에서 단축 링크를 공유할 때 자동으로 입력되는 고유한 [사용자 리퍼러 ID](https://help.adjust.com/ko/article/set-up-user-referrals) 를 추가할 수 있습니다. | +| `og_title` | `String` | Body | 링크의 소셜 공유 미리보기 제목. | +| `og_description` | `String` | Body | 링크의 소셜 공유 미리보기에 대한 설명. | +| `og_image` | `String` | Body | 링크의 소셜 공유 미리보기를 위한 최소 200 x 200 픽셀 크기의 JPG 또는 PNG 이미지에 대한 URL. | + +## 단일 딥링크 \{\#generate\-a\-single\-deep\-link\} 생성 `POST` 요청을 전송하여 단일 또는 멀티 플랫폼 앱에 대해 긴/단축 딥링크를 생성합니다. -### 엔드포인트 \{\#endpoint\-single\} +### 엔드포인트 {#endpoint-single} ```http https://automate.adjust.com/engage/deep-links ``` -### 예 \{\#examples\-single\} +### 예 {#examples-single} -**단일 플랫폼 앱** - +**단일 플랫폼 앱** + + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -117,16 +119,18 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - + + ```http {"url": "https://insights.go.link/fryYl"} ``` - + + +**멀티 플랫폼 앱** -**멀티 플랫폼 앱** - + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -142,18 +146,20 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - + + ```json { "url": "https://insights.go.link/jlbKj" } ``` - + + +**복합 링크** -**복합 링크** +딥링크 생성기 API를 사용하여 딥링크를 생성하기 전에 [Campaign Lab에서 복합 커스텀 링크](https://help.adjust.com/ko/article/custom-link-setup) 를 생성해야 합니다. -딥링크 생성기 API를 사용하여 딥링크를 생성하기 전에 [Campaign Lab에서 복합 커스텀 링크](https://help.adjust.com/en/article/custom-link-setup) 를 생성해야 합니다. - + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -170,28 +176,28 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - + + ```http {"url": "https://insights.go.link/6JtQx"} ``` - + -딥링크 일괄 생성 \{\#generate\-deep\-links\-in\-bulk\} ------------------------------------------------------- +## 딥링크 일괄 생성 \{\#generate\-deep\-links\-in\-bulk\} `POST` 요청을 전송하여 단일 또는 멀티 플랫폼 앱에 대해 긴/단축 딥링크를 일괄 생성합니다. -### 엔드포인트 \{\#endpoint\-bulk\} +### 엔드포인트 {#endpoint-bulk} ```http https://automate.adjust.com/engage/deep-links/bulk ``` -### 예 \{\#example\-bulk\} +### 예 {#example-bulk} - + ```bash curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ @@ -225,7 +231,8 @@ curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ }' ``` - + + ```json { @@ -243,22 +250,21 @@ curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ } ``` - + -단축 링크 토큰 업데이트 \{\#update\-short\-link\-token\} ----------------------------------------------------- +## 단축 링크 토큰 업데이트 \{\#update\-short\-link\-token\} `PUT` 요청을 전송하여 딥링크의 기존 단축 링크 토큰을 긴 링크로 업데이트합니다. -### 엔드포인트 \{\#endpoint\-update\} +### 엔드포인트 {#endpoint-update} ```http https://automate.adjust.com/engage/deep-links/{short_token} ``` -### 예 \{\#example\-update\} +### 예 {#example-update} - + ```bash curl --location --request PUT 'https://automate.adjust.com/engage/deep-links/4IlkC' \ @@ -272,11 +278,11 @@ curl --location --request PUT 'https://automate.adjust.com/engage/deep-links/4Il }' ``` - + + ```http 204 No Content ``` - diff --git a/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx b/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx index 642b07994..bd877f9f6 100644 --- a/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx +++ b/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx @@ -1,27 +1,27 @@ --- -title: "링크 해석(resolution)" -description: "이메일, SMS, QR 코드 또는 링크 단축 플랫폼을 통한 딥링킹의 경우, 링크 해석(link resolution)을 설정합니다." -slug: "en/sdk/ios/v4/features/deep-links/resolution" +title: 링크 해석(resolution) +description: 이메일, SMS, QR 코드 또는 링크 단축 플랫폼을 통한 딥링킹의 경우, 링크 해석(link resolution)을 설정합니다. +slug: ko/sdk/ios/v4/features/deep-links/resolution sidebar-position: 5 -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/ios/features/deep-links/resolution" +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /ko/sdk/ios/features/deep-links/resolution --- + 이메일, SMS, QR 코드 또는 링크 단축 플랫폼을 통한 딥링킹의 경우, 링크 해석\(link resolution\)을 설정해야 합니다. 링크 해석이 없다면, 유니버설 링크에 의한 리다이렉트가 모든 사용자\(앱 설치 사용자 포함\)를 앱 스토어로 이동시키게 됩니다. 링크 해석이 설정되면 유니버설 링크로의 리다이렉트가 앱 내에서 작동하여, 기존 사용자는 앱 스토어로 이동되지 않습니다. - + + 마케팅팀과 확인하여 앱에 링크 해석이 필요한지 확인하시기 바랍니다. 다양한 시나리오에 맞게 링크 해석을 설정할 수 있습니다. - -작동 방식 \{\#how\-it\-works\} -------------------------------- + + +## 작동 방식 \{\#how\-it\-works\} 앱을 설치한 사용자가 리다이렉트 URL을 클릭하는 경우에만 링크 해석이 필요하며, 리다이렉트 URL의 도메인을 앱에서의 유니버설 링크 도메인으로써 구성해야 합니다. @@ -33,41 +33,44 @@ redirects: 3. Adjust SDK의 링크 해석 메서드는 리다이렉트 URL의 도메인을 개발자가 Adjust SDK에서 설정한 링크 해석 도메인과 비교하고, 다음 중 하나의 결과가 발생합니다. - * 도메인이 일치하지 않음 \- 메서드가 딥링크 URL을 그대로 전달합니다. - * 도메인이 일치함 \- 메서드가 링크를 해석하고, 결과 딥링크를 반환합니다. + - 도메인이 일치하지 않음 \- 메서드가 딥링크 URL을 그대로 전달합니다. + - 도메인이 일치함 \- 메서드가 링크를 해석하고, 결과 딥링크를 반환합니다. Adjust SDK는 URL을 해석할 때 최대 10개의 리다이렉트를 따릅니다. 10개 이상의 리다이렉트가 있는 경우 SDK는 10번째 리다이렉트 URL을 반환합니다. + 4. 앱은 반환된 URL을 수신하고, 딥링크 내용을 실행하여 사용자에게 표시합니다. 앱은 또한 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. 이는 해석된 URL을 기록을 위해 Adjust 서버로 전송합니다. - + 앱을 설치하지 않은 사용자가 리다이렉트 URL을 클릭하면, iOS는 이를 일반적인 웹 URL로 처리하여, 사용자를 앱 스토어로 리다이렉트합니다. 이 경우, 링크 해석이 적용되지 않습니다. - -활용법 \{\#use\-cases\} ------------------------- + + +## 활용법 \{\#use\-cases\} 링크 해석은 다음에 적용될 수 있습니다. -* [이메일 마케팅](#email-marketing) -* [URL을 단축한 플랫폼](#url-shorteners) +- [이메일 마케팅](#email-marketing) +- [URL을 단축한 플랫폼](#url-shorteners) -### 이메일 마케팅 \{\#email\-marketing\} +### 이메일 마케팅 {#email-marketing} 이메일 마케터가 캠페인을 진행할 때, 이메일 마케팅 플랫폼은 일반적으로 자체 클릭 측정 리다이렉트 URL을 사용하여 이메일의 모든 링크를 래핑합니다. 이를 통해 이메일 마케터는 이메일 마케팅 플랫폼에서 클릭률 통계를 볼 수 있습니다. 하지만 이메일에 Adjust 유니버셜 링크가 포함된 경우, 리다이렉트 URL은 iOS가 Adjust 유니버셜 링크를 해석하는 것을 방해합니다. -* 이메일 마케팅 플랫폼: 이메일 마케터가 캠페인 구축을 위해 사용하는 소프트웨어. 일반적으로 이메일 템플릿이나 오디언스 타겟팅과 같은 기능을 포함합니다. **예:** Braze, Iterable, SendGrid -* ESP\(이메일 서비스 제공자\): 이메일을 전송하고 ISP\(인터넷 서비스 제공자\) 이메일 서버로의 전달률을 관리하는 기저 인프라. **예:** SendGrid, SparkPost -* 이메일 파트너: 이메일 마케팅 플랫폼 또는 ESP\(이메일 서비스 제공자\)를 지칭하는 일반적인 용어. 이메일 파트너는 이메일 마케팅 플랫폼이나 ESP 또는 둘 다가 될 수 있습니다. **예:** SendGrid는 이메일 마케팅 플랫폼이자 ESP입니다. 이메일 마케팅에서 ESP를 또다른 파트너로 이용할 수 있습니다. **예:** Braze와 Iterable은 둘 다 SendGrid, SparkPost를 ESP로 이용합니다. +- 이메일 마케팅 플랫폼: 이메일 마케터가 캠페인 구축을 위해 사용하는 소프트웨어. 일반적으로 이메일 템플릿이나 오디언스 타겟팅과 같은 기능을 포함합니다. **예:** Braze, Iterable, SendGrid +- ESP\(이메일 서비스 제공자\): 이메일을 전송하고 ISP\(인터넷 서비스 제공자\) 이메일 서버로의 전달률을 관리하는 기저 인프라. **예:** SendGrid, SparkPost +- 이메일 파트너: 이메일 마케팅 플랫폼 또는 ESP\(이메일 서비스 제공자\)를 지칭하는 일반적인 용어. 이메일 파트너는 이메일 마케팅 플랫폼이나 ESP 또는 둘 다가 될 수 있습니다. **예:** SendGrid는 이메일 마케팅 플랫폼이자 ESP입니다. 이메일 마케팅에서 ESP를 또다른 파트너로 이용할 수 있습니다. **예:** Braze와 Iterable은 둘 다 SendGrid, SparkPost를 ESP로 이용합니다. -#### 설정 \{\#setup\} +#### 설정 {#setup} 1. 도메인을 생성하거나, 이메일 측정에 사용될 도메인에 하위 도메인을 생성합니다. 이메일 측정에 사용할 도메인/하위 도메인이 이미 있는 경우, 기존의 캠페인에 대한 영향 없이 이 구현을 완료할 수 있도록 새로운 도메인/하위 도메인을 생성해야 합니다. 구현 과정이 완료되고 테스트 된 이후, 다시 이 구현을 기존 이메일 리다이렉트 도메인으로 전환할 수 있습니다. **예시:** `email.example.com` + 2. Xcode의 **Associated Domains** 구성에 이메일 리다이렉트 도메인을 추가합니다. **예시:** `applinks:email.example.com` + 3. 유니버설 링크를 설정합니다. 4. 이메일 리다이렉트 도메인을 `resolveLinkWithUrl` 링크 해석 메서드의 `resolveUrlSuffixArray`에 추가했는지 확인합니다. @@ -79,35 +82,38 @@ redirects: 1. **SSL 인증서** : iOS에서는 유니버설 링크가 HTTPS만 사용할 수 있습니다. 따라서 이메일 리다이렉트 도메인에 SSL 인증서가 필요합니다. 2. **AASA\(Apple\-App\-Site\-Association\) 파일** : 이메일 파트너에 따라 AASA 파일을 직접 호스트하거나, AASA 파일을 이메일 파트너 시스템에 업로드해야 합니다. AASA 파일 호스트에 관한 정보는, 이메일 파트너의 관련 문서를 참조하시기 바랍니다. - 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` - 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. + 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. **예시:** `redirect.example.net` + 7. 이메일 리다이렉트 도메인에 대해 DNS를 구성하여 CDN으로 전달되도록 합니다. - + + +위 설명에 상응하는 파트너별 설명의 경우, Adjust 헬프 센터의 [ESP 연동](https://help.adjust.com/ko/marketer/esp-integrations)을 참조하시기 바랍니다. -위 설명에 상응하는 파트너별 설명의 경우, Adjust 헬프 센터의 [ESP 연동](https://help.adjust.com/en/marketer/esp-integrations)을 참조하시기 바랍니다. - + -##### 이메일 파트너 지원 \{\#support\-for\-email\-partners\} +##### 이메일 파트너 지원 {#support-for-email-partners} 링크 해석을 사용하려면 리다이렉트 도메인\(또는 하위 도메인\)을 유니버설 링크 도메인으로 설정할 수 있도록 이메일 파트너의 허용이 필요합니다. 이 경우, 이메일 파트너의 리다이렉션 서비스를 자체 맞춤 도메인으로 전달할 수 있습니다. -**예시:** +**예시:** -* Braze: Braze가 할당된 ESP에 따라, SendGrid 또는 SparkPost에서 리다이렉트 도메인을 설정하고 커스텀 도메인을 지정합니다. 이후 커스텀 도메인을 유니버설 링크 도메인으로 설정할 수 있습니다. -* Iterable: Iterable은 커스텀 도메인을 지원하는 URL 리다이렉트 서비스를 제공합니다. -* Mailchimp: Mailchimp은 리다이렉트 도메인을 유니버설 링크로 구성하도록 허용하지 않기 때문에 링크 해석을 이용할 수 없습니다. +- Braze: Braze가 할당된 ESP에 따라, SendGrid 또는 SparkPost에서 리다이렉트 도메인을 설정하고 커스텀 도메인을 지정합니다. 이후 커스텀 도메인을 유니버설 링크 도메인으로 설정할 수 있습니다. +- Iterable: Iterable은 커스텀 도메인을 지원하는 URL 리다이렉트 서비스를 제공합니다. +- Mailchimp: Mailchimp은 리다이렉트 도메인을 유니버설 링크로 구성하도록 허용하지 않기 때문에 링크 해석을 이용할 수 없습니다. -#### 예 \{\#example\} +#### 예 {#example} 1. 이메일 마케터는 템플릿을 사용해 이메일을 빌드합니다. 템플릿은 링크 또는 유니버설 링크가 있는 이미지를 포함합니다. **예시:** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` + 2. 이메일 마케터가 수신인에게 이메일을 발송합니다. 이메일이 발송되기 전, 이메일 마케팅 플랫폼은 유니버설 링크를 자체 리다이렉트 URL로 래핑합니다. **예시:** `https://email.example.com/2wuTnQvU` + 3. 앱을 설치한 사용자가 이메일의 리다이렉트 URL을 클릭합니다. 4. iOS가 앱을 실행하고, 리다이렉트 URL을 앱에 전달합니다. @@ -118,17 +124,18 @@ redirects: 따라서 `https://email.example.com/2wuTnQvU` 은/는 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 으로 리다이렉트됩니다. + 7. 링크 해석 메서드는 해석된 URL을 반환합니다. 8. 앱이 반환된 URL을 처리합니다. 이 경우 앱은 사용자에게 `summer-clothes` 페이지를 `beach promo` 모달과 함께 표시합니다. 9. 앱은 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. -### URL 단축기 \{\#url\-shorteners\} +### URL 단축기 {#url-shorteners} 특정 유형의 캠페인의 경우, URL을 단축해야 할 때가 있습니다. 예를 들어, SMS에는 160자의 글자 수 제한이 있으며, 소비자들이 단축 링크를 Slack과 같은 협업툴에 공유하길 원할 수 있습니다. 하지만 단축 URL이 유니버셜 링크로 리다이렉트 될 경우, iOS는 Adjust 유니버셜 링크를 해석하지 못합니다. -#### 설정 \{\#setup\-1\} +#### 설정 {#setup-1} 1. 도메인을 생성하거나, URL 단축에 사용될 도메인에 하위 도메인을 생성합니다. 이미 URL 단축에 사용할 도메인/하위 도메인이 있는 경우, 기존의 캠페인에 대한 영향 없이 이 구현을 완료할 수 있도록 새로운 도메인/하위 도메인을 생성해야 합니다. 이 구현 과정이 완료되고 테스트되면, 이 구현을 기존 URL 단축 도메인으로 전환할 수 있습니다. @@ -136,6 +143,7 @@ redirects: 2. Xcode의 **Associated Domains** 구성에 URL 단축 도메인을 추가합니다. **예시:** `applinks:short.example.com` + 3. 유니버설 링크를 설정합니다. 4. 이메일 리다이렉트 도메인을 `resolveLinkWithUrl` 링크 해석 메서드의 `resolveUrlSuffixArray`에 추가했는지 확인합니다. @@ -143,18 +151,21 @@ redirects: 5. 유니버설 링크를 지원하는 URL 단축 서비스를 설정합니다. Adjust는 URL 단축 서비스를 제공하지 않습니다. **예:** [`short.io`](http://short.io) + 6. URL 단축 도메인을 URL 단축 서비스의 맞춤 도메인으로 구성합니다. URL 단축 도메인에 대해 DNS를 구성하여 URL 단축 서비스의 서버로 전달되도록 해야 합니다. \([short.io에 커스텀 도메인을 추가하기 위한 참고 문서](https://help.short.io/en/articles/9991681-how-can-i-add-a-domain)\). 7. URL 단축 서비스에서 유니버설 링크를 구성합니다. \([short.io에 유니버설 링크를 구성하기 위한 참고 문서](https://help.short.io/en/articles/4065870-how-to-set-up-deep-links-for-ios)\). -#### 예 \{\#example\-1\} +#### 예 {#example-1} 1. 마케터가 유니버설 링크를 생성합니다. **예시:** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` + 2. 마케터가 URL 단축 서비스를 사용하여 단축 링크를 생성합니다. **예시:** `https://short.example.com/2wuTnQvU` + 3. 마케터가 단축 링크를 캠페인\(예: SMS\)에 사용합니다. 4. 앱을 설치한 사용자가 SMS 메시지에서 단축 링크를 클릭합니다. @@ -167,9 +178,9 @@ redirects: 따라서 `https://short.example.com/2wuTnQvU` 은/는 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 으로 리다이렉트됩니다. + 8. 링크 해석 메서드는 해석된 URL을 반환합니다. 9. 앱이 반환된 URL을 처리합니다. 이 경우 앱은 사용자에게 `summer-clothes` 페이지를 `beach promo` 모달과 함께 표시합니다. -10. 앱은 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. - +10. 앱은 Adjust SDK에서 `appWillOpenUrl` 메서드를 반환된 URL과 함께 호출합니다. diff --git a/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx b/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx index a8bdeb6b7..7c66b26a7 100644 --- a/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx +++ b/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx @@ -1,27 +1,27 @@ --- -title: "링크 해석(resolution)" -description: "이메일, SMS, QR 코드 또는 링크 단축 플랫폼을 통한 딥링킹의 경우, 링크 해석(link resolution)을 설정합니다." -slug: "en/sdk/ios/features/deep-links/resolution" +title: 링크 해석(resolution) +description: 이메일, SMS, QR 코드 또는 링크 단축 플랫폼을 통한 딥링킹의 경우, 링크 해석(link resolution)을 설정합니다. +slug: ko/sdk/ios/features/deep-links/resolution sidebar-position: 5 -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/ko/sdk/ios/v4/features/deep-links/resolution" +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /ko/sdk/ios/v4/features/deep-links/resolution --- + 이메일, SMS, QR 코드 또는 링크 단축 플랫폼을 통한 딥링킹의 경우, 링크 해석\(link resolution\)을 설정해야 합니다. 링크 해석이 없다면, 유니버설 링크에 의한 리다이렉트가 모든 사용자\(앱 설치 사용자 포함\)를 앱 스토어로 이동시키게 됩니다. 링크 해석이 설정되면 유니버설 링크로의 리다이렉트가 앱 내에서 작동하여, 기존 사용자는 앱 스토어로 이동되지 않습니다. - + + 마케팅팀과 확인하여 앱에 링크 해석이 필요한지 확인하시기 바랍니다. 다양한 시나리오에 맞게 링크 해석을 설정할 수 있습니다. - -작동 방식 \{\#how\-it\-works\} -------------------------------- + + +## 작동 방식 \{\#how\-it\-works\} 앱을 설치한 사용자가 리다이렉트 URL을 클릭하는 경우에만 링크 해석이 필요하며, 리다이렉트 URL의 도메인을 앱에서의 유니버설 링크 도메인으로써 구성해야 합니다. @@ -33,41 +33,44 @@ redirects: 3. Adjust SDK의 링크 해석 메서드는 리다이렉트 URL의 도메인을 개발자가 Adjust SDK에서 설정한 링크 해석 도메인과 비교하고, 다음 중 하나의 결과가 발생합니다. - * 도메인이 일치하지 않음 \- 메서드가 딥링크 URL을 그대로 전달합니다. - * 도메인이 일치함 \- 메서드가 링크를 해석하고, 결과 딥링크를 반환합니다. + - 도메인이 일치하지 않음 \- 메서드가 딥링크 URL을 그대로 전달합니다. + - 도메인이 일치함 \- 메서드가 링크를 해석하고, 결과 딥링크를 반환합니다. Adjust SDK는 URL을 해석할 때 최대 10개의 리다이렉트를 따릅니다. 10개 이상의 리다이렉트가 있는 경우 SDK는 10번째 리다이렉트 URL을 반환합니다. + 4. 앱은 반환된 URL을 수신하고, 딥링크 내용을 실행하여 사용자에게 표시합니다. 앱은 또한 Adjust SDK에서 `processDeeplink` 메서드를 반환된 URL과 함께 호출합니다. 이는 해석된 URL을 기록을 위해 Adjust 서버로 전송합니다. - + 앱을 설치하지 않은 사용자가 리다이렉트 URL을 클릭하면, iOS는 이를 일반적인 웹 URL로 처리하여, 사용자를 앱 스토어로 리다이렉트합니다. 이 경우, 링크 해석이 적용되지 않습니다. - -활용법 \{\#use\-cases\} ------------------------- + + +## 활용법 \{\#use\-cases\} 링크 해석은 다음에 적용될 수 있습니다. -* [이메일 마케팅](#email-marketing) -* [URL을 단축한 플랫폼](#url-shorteners) +- [이메일 마케팅](#email-marketing) +- [URL을 단축한 플랫폼](#url-shorteners) -### 이메일 마케팅 \{\#email\-marketing\} +### 이메일 마케팅 {#email-marketing} 이메일 마케터가 캠페인을 진행할 때, 이메일 마케팅 플랫폼은 일반적으로 자체 클릭 측정 리다이렉트 URL을 사용하여 이메일의 모든 링크를 래핑합니다. 이를 통해 이메일 마케터는 이메일 마케팅 플랫폼에서 클릭률 통계를 볼 수 있습니다. 하지만 이메일에 Adjust 유니버셜 링크가 포함된 경우, 리다이렉트 URL은 iOS가 Adjust 유니버셜 링크를 해석하는 것을 방해합니다. -* 이메일 마케팅 플랫폼: 이메일 마케터가 캠페인 구축을 위해 사용하는 소프트웨어. 일반적으로 이메일 템플릿이나 오디언스 타겟팅과 같은 기능을 포함합니다. **예:** Braze, Iterable, SendGrid -* ESP\(이메일 서비스 제공자\): 이메일을 전송하고 ISP\(인터넷 서비스 제공자\) 이메일 서버로의 전달률을 관리하는 기저 인프라. **예:** SendGrid, SparkPost -* 이메일 파트너: 이메일 마케팅 플랫폼 또는 ESP\(이메일 서비스 제공자\)를 지칭하는 일반적인 용어. 이메일 파트너는 이메일 마케팅 플랫폼이나 ESP 또는 둘 다가 될 수 있습니다. **예:** SendGrid는 이메일 마케팅 플랫폼이자 ESP입니다. 이메일 마케팅에서 ESP를 또다른 파트너로 이용할 수 있습니다. **예:** Braze와 Iterable은 둘 다 SendGrid, SparkPost를 ESP로 이용합니다. +- 이메일 마케팅 플랫폼: 이메일 마케터가 캠페인 구축을 위해 사용하는 소프트웨어. 일반적으로 이메일 템플릿이나 오디언스 타겟팅과 같은 기능을 포함합니다. **예:** Braze, Iterable, SendGrid +- ESP\(이메일 서비스 제공자\): 이메일을 전송하고 ISP\(인터넷 서비스 제공자\) 이메일 서버로의 전달률을 관리하는 기저 인프라. **예:** SendGrid, SparkPost +- 이메일 파트너: 이메일 마케팅 플랫폼 또는 ESP\(이메일 서비스 제공자\)를 지칭하는 일반적인 용어. 이메일 파트너는 이메일 마케팅 플랫폼이나 ESP 또는 둘 다가 될 수 있습니다. **예:** SendGrid는 이메일 마케팅 플랫폼이자 ESP입니다. 이메일 마케팅에서 ESP를 또다른 파트너로 이용할 수 있습니다. **예:** Braze와 Iterable은 둘 다 SendGrid, SparkPost를 ESP로 이용합니다. -#### 설정 \{\#setup\} +#### 설정 {#setup} 1. 도메인을 생성하거나, 이메일 측정에 사용될 도메인에 하위 도메인을 생성합니다. 이메일 측정에 사용할 도메인/하위 도메인이 이미 있는 경우, 기존의 캠페인에 대한 영향 없이 이 구현을 완료할 수 있도록 새로운 도메인/하위 도메인을 생성해야 합니다. 구현 과정이 완료되고 테스트 된 이후, 다시 이 구현을 기존 이메일 리다이렉트 도메인으로 전환할 수 있습니다. **예시:** `email.example.com` + 2. Xcode의 **Associated Domains** 구성에 이메일 리다이렉트 도메인을 추가합니다. **예시:** `applinks:email.example.com` + 3. 유니버설 링크를 설정합니다. 4. 이메일 리다이렉트 도메인을 `resolveLinkWithUrl` 링크 해석 메서드의 `resolveUrlSuffixArray`에 추가했는지 확인합니다. @@ -79,35 +82,38 @@ redirects: 1. **SSL 인증서** : iOS에서는 유니버설 링크가 HTTPS만 사용할 수 있습니다. 따라서 이메일 리다이렉트 도메인에 SSL 인증서가 필요합니다. 2. **AASA\(Apple\-App\-Site\-Association\) 파일** : 이메일 파트너에 따라 AASA 파일을 직접 호스트하거나, AASA 파일을 이메일 파트너 시스템에 업로드해야 합니다. AASA 파일 호스트에 관한 정보는, 이메일 파트너의 관련 문서를 참조하시기 바랍니다. - 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` - 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. + 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. **예시:** `redirect.example.net` + 7. 이메일 리다이렉트 도메인에 대해 DNS를 구성하여 CDN으로 전달되도록 합니다. - + + +위 설명에 상응하는 파트너별 설명의 경우, Adjust 헬프 센터의 [ESP 연동](https://help.adjust.com/ko/marketer/esp-integrations)을 참조하시기 바랍니다. -위 설명에 상응하는 파트너별 설명의 경우, Adjust 헬프 센터의 [ESP 연동](https://help.adjust.com/en/marketer/esp-integrations)을 참조하시기 바랍니다. - + -##### 이메일 파트너 지원 \{\#support\-for\-email\-partners\} +##### 이메일 파트너 지원 {#support-for-email-partners} 링크 해석을 사용하려면 리다이렉트 도메인\(또는 하위 도메인\)을 유니버설 링크 도메인으로 설정할 수 있도록 이메일 파트너의 허용이 필요합니다. 이 경우, 이메일 파트너의 리다이렉션 서비스를 자체 맞춤 도메인으로 전달할 수 있습니다. -**예시:** +**예시:** -* Braze: Braze가 할당된 ESP에 따라, SendGrid 또는 SparkPost에서 리다이렉트 도메인을 설정하고 커스텀 도메인을 지정합니다. 이후 커스텀 도메인을 유니버설 링크 도메인으로 설정할 수 있습니다. -* Iterable: Iterable은 커스텀 도메인을 지원하는 URL 리다이렉트 서비스를 제공합니다. -* Mailchimp: Mailchimp은 리다이렉트 도메인을 유니버설 링크로 구성하도록 허용하지 않기 때문에 링크 해석을 이용할 수 없습니다. +- Braze: Braze가 할당된 ESP에 따라, SendGrid 또는 SparkPost에서 리다이렉트 도메인을 설정하고 커스텀 도메인을 지정합니다. 이후 커스텀 도메인을 유니버설 링크 도메인으로 설정할 수 있습니다. +- Iterable: Iterable은 커스텀 도메인을 지원하는 URL 리다이렉트 서비스를 제공합니다. +- Mailchimp: Mailchimp은 리다이렉트 도메인을 유니버설 링크로 구성하도록 허용하지 않기 때문에 링크 해석을 이용할 수 없습니다. -#### 예 \{\#example\} +#### 예 {#example} 1. 이메일 마케터는 템플릿을 사용해 이메일을 빌드합니다. 템플릿은 링크 또는 유니버설 링크가 있는 이미지를 포함합니다. **예시:** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` + 2. 이메일 마케터가 수신인에게 이메일을 발송합니다. 이메일이 발송되기 전, 이메일 마케팅 플랫폼은 유니버설 링크를 자체 리다이렉트 URL로 래핑합니다. **예시:** `https://email.example.com/2wuTnQvU` + 3. 앱을 설치한 사용자가 이메일의 리다이렉트 URL을 클릭합니다. 4. iOS가 앱을 실행하고, 리다이렉트 URL을 앱에 전달합니다. @@ -118,17 +124,18 @@ redirects: 따라서 `https://email.example.com/2wuTnQvU` 은/는 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 으로 리다이렉트됩니다. + 7. 링크 해석 메서드는 해석된 URL을 반환합니다. 8. 앱이 반환된 URL을 처리합니다. 이 경우 앱은 사용자에게 `summer-clothes` 페이지를 `beach promo` 모달과 함께 표시합니다. 9. 앱은 Adjust SDK에서 `processDeeplink` 메서드를 반환된 URL과 함께 호출합니다. -### URL 단축기 \{\#url\-shorteners\} +### URL 단축기 {#url-shorteners} 특정 유형의 캠페인의 경우, URL을 단축해야 할 때가 있습니다. 예를 들어, SMS에는 160자의 글자 수 제한이 있으며, 소비자들이 단축 링크를 Slack과 같은 협업툴에 공유하길 원할 수 있습니다. 하지만 단축 URL이 유니버셜 링크로 리다이렉트 될 경우, iOS는 Adjust 유니버셜 링크를 해석하지 못합니다. -#### 설정 \{\#setup\-1\} +#### 설정 {#setup-1} 1. 도메인을 생성하거나, URL 단축에 사용될 도메인에 하위 도메인을 생성합니다. 이미 URL 단축에 사용할 도메인/하위 도메인이 있는 경우, 기존의 캠페인에 대한 영향 없이 이 구현을 완료할 수 있도록 새로운 도메인/하위 도메인을 생성해야 합니다. 이 구현 과정이 완료되고 테스트되면, 이 구현을 기존 URL 단축 도메인으로 전환할 수 있습니다. @@ -136,6 +143,7 @@ redirects: 2. Xcode의 **Associated Domains** 구성에 URL 단축 도메인을 추가합니다. **예시:** `applinks:short.example.com` + 3. 유니버설 링크를 설정합니다. 4. 이메일 리다이렉트 도메인을 `resolveLinkWithUrl` 링크 해석 메서드의 `resolveUrlSuffixArray`에 추가했는지 확인합니다. @@ -143,18 +151,21 @@ redirects: 5. 유니버설 링크를 지원하는 URL 단축 서비스를 설정합니다. Adjust는 URL 단축 서비스를 제공하지 않습니다. **예:** [`short.io`](http://short.io) + 6. URL 단축 도메인을 URL 단축 서비스의 맞춤 도메인으로 구성합니다. URL 단축 도메인에 대해 DNS를 구성하여 URL 단축 서비스의 서버로 전달되도록 해야 합니다. \([short.io에 커스텀 도메인을 추가하기 위한 참고 문서](https://help.short.io/en/articles/9991681-how-can-i-add-a-domain)\). 7. URL 단축 서비스에서 유니버설 링크를 구성합니다. \([short.io에 유니버설 링크를 구성하기 위한 참고 문서](https://help.short.io/en/articles/4065870-how-to-set-up-deep-links-for-ios)\). -#### 예 \{\#example\-1\} +#### 예 {#example-1} 1. 마케터가 유니버설 링크를 생성합니다. **예시:** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` + 2. 마케터가 URL 단축 서비스를 사용하여 단축 링크를 생성합니다. **예시:** `https://short.example.com/2wuTnQvU` + 3. 마케터가 단축 링크를 캠페인\(예: SMS\)에 사용합니다. 4. 앱을 설치한 사용자가 SMS 메시지에서 단축 링크를 클릭합니다. @@ -167,9 +178,9 @@ redirects: 따라서 `https://short.example.com/2wuTnQvU` 은/는 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 으로 리다이렉트됩니다. + 8. 링크 해석 메서드는 해석된 URL을 반환합니다. 9. 앱이 반환된 URL을 처리합니다. 이 경우 앱은 사용자에게 `summer-clothes` 페이지를 `beach promo` 모달과 함께 표시합니다. -10. 앱은 Adjust SDK에서 `processDeeplink` 메서드를 반환된 URL과 함께 호출합니다. - +10. 앱은 Adjust SDK에서 `processDeeplink` 메서드를 반환된 URL과 함께 호출합니다. diff --git a/src/content/docs/zh/api/deep-link-generator-api.mdx b/src/content/docs/zh/api/deep-link-generator-api.mdx index b181227d6..9bf4ee7c5 100644 --- a/src/content/docs/zh/api/deep-link-generator-api.mdx +++ b/src/content/docs/zh/api/deep-link-generator-api.mdx @@ -1,46 +1,49 @@ --- -title: "深度链接生成器 API" -description: "使用深度链接生成器 API，您可以单独或批量创建应用定制深度链接。" -category-title: "深度链接生成器 API" -slug: "en/api/deep-link-generator-api" +title: 深度链接生成器 API +description: 使用深度链接生成器 API，您可以单独或批量创建应用定制深度链接。 +category-title: 深度链接生成器 API +slug: zh/api/deep-link-generator-api sidebar-position: 8 --- + 使用深度链接生成器 API，您可以单独或批量创建应用定制深度链接。这些深度链接可长可短，能改善各个平台的用户体验。 -操作前须知 \{\#before\-you\-begin\} ------------------------------------ +## 操作前须知 \{\#before\-you\-begin\} 以下是您在操作前需要了解的内容。 -### 可用性\{\#availability\} +### 可用性{#availability} - + 深度链接生成器 API 的速率限制为每秒 200 个请求。如果超过此限制，您将收到 429 报错。 - -* 您需要使用 TrueLink Core 或 Enterprise 套餐才能使用深度链接生成器 API。 -* 使用深度链接生成器 API 创建的链接不会出现在 [Campaign Lab](https://help.adjust.com/en/article/campaign-setup)中。 -* 使用深度链接生成器 API 创建的短链接的 TTL \(生存时间\) 为 120 天。 + + +- 您需要使用 TrueLink Core 或 Enterprise 套餐才能使用深度链接生成器 API。 +- 使用深度链接生成器 API 创建的链接不会出现在 [Campaign Lab](https://help.adjust.com/zh/article/campaign-setup)中。 +- 使用深度链接生成器 API 创建的短链接的 TTL \(生存时间\) 为 120 天。 + +### 要求{#requirements} + +- 管理员、编辑员或自定义编辑员[权限](https://help.adjust.com/zh/article/permission-levels)。 +- 为您的 iOS 和安卓应用[设置相同的品牌化域名](https://help.adjust.com/zh/article/set-up-branded-domain)。 + + - 对于 iOS 应用，请确保将您的品牌化域名添加为[Associated Domain \(关联域名\)](https://help.adjust.com/zh/article/set-up-branded-domain#ios-only-update)。此操作会将域名设置为通用链接。 + - 对于安卓应用，请确保将品牌化域名定义为[Android App Link \(安卓应用链接\)](https://help.adjust.com/zh/article/set-up-android-app-links)。 -### 要求\{\#requirements\} +- 应用的自定义链接。 -* 管理员、编辑员或自定义编辑员[权限](https://help.adjust.com/en/article/permission-levels)。 -* 为您的 iOS 和安卓应用[设置相同的品牌化域名](https://help.adjust.com/en/article/set-up-branded-domain)。 - * 对于 iOS 应用，请确保将您的品牌化域名添加为[Associated Domain \(关联域名\)](https://help.adjust.com/en/article/set-up-branded-domain#ios-only-update)。此操作会将域名设置为通用链接。 - * 对于安卓应用，请确保将品牌化域名定义为[Android App Link \(安卓应用链接\)](https://help.adjust.com/en/article/set-up-android-app-links)。 + - 单一平台应用、多平台应用 \- [在 Campaign Lab 中创建自定义链接](https://help.adjust.com/zh/article/custom-link-setup)，获得单个链接识别码。 + - 多个单一平台应用 \-[在 Campaign Lab](https://help.adjust.com/zh/article/custom-link-setup#combined-custom-links)中使用多个单一平台应用创建单个复合自定义链接，其中包含以“\_”分隔的多个链接识别码。要了解更多信息，请查看[复合自定义链接的平台特定链接识别码](https://help.adjust.com/zh/article/manage-custom-link-setup#link-tokens-combined-custom-link)。 -* 应用的自定义链接。 - * 单一平台应用、多平台应用 \- [在 Campaign Lab 中创建自定义链接](https://help.adjust.com/en/article/custom-link-setup)，获得单个链接识别码。 - * 多个单一平台应用 \-[在 Campaign Lab](https://help.adjust.com/en/article/custom-link-setup#combined-custom-links)中使用多个单一平台应用创建单个复合自定义链接，其中包含以“\_”分隔的多个链接识别码。要了解更多信息，请查看[复合自定义链接的平台特定链接识别码](https://help.adjust.com/en/article/manage-custom-link-setup#link-tokens-combined-custom-link)。 +- 更新 Adjust SDK 来解析短链接。 -* 更新 Adjust SDK 来解析短链接。 - * [iOS](/en/sdk/ios/features/short-links) \|[安卓](/en/sdk/android/features/short-links)\| [Unity](/en/sdk/unity/features/short-links) \| [React Native](/en/sdk/react-native/features/short-links) \| [Flutter](/en/sdk/flutter/features/short-links) \| [Cordova](/en/sdk/cordova/features/short-links) \| [Cocos2d\-x](/en/sdk/cocos2dx/features/short-links) + - [iOS](/zh/sdk/ios/features/short-links) \|[安卓](/zh/sdk/android/features/short-links)\| [Unity](/zh/sdk/unity/features/short-links) \| [React Native](/zh/sdk/react-native/features/short-links) \| [Flutter](/zh/sdk/flutter/features/short-links) \| [Cordova](/zh/sdk/cordova/features/short-links) \| [Cocos2d\-x](/zh/sdk/cocos2dx/features/short-links) -* 如果您已[设置数据驻留](https://help.adjust.com/en/article/data-residency-setup)，请确保 iOS 和安卓应用使用同一地区。 +- 如果您已[设置数据驻留](https://help.adjust.com/zh/article/data-residency-setup)，请确保 iOS 和安卓应用使用同一地区。 -认证\{\#authentication\} -------------------------- +## 认证\{\#authentication\} 深度链接生成器 API 使用 [Bearer 识别码](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication)进行认证。您必须在向深度链接生成器 API 发出的每个请求的 `Authorization` 标头中包含您的 Adjust API 识别码。 @@ -53,7 +56,7 @@ sidebar-position: 8 3. 选择 **个人档案** 标签页。 4. 您的 **API 识别码** 会显示在 **用户详细信息** 中。选择复制按钮来将识别码复制到您的系统剪贴板。 -### 重置 Adjust API 识别码\{\#reset\-your\-adjust\-api\-token\} +### 重置 Adjust API 识别码{#reset-your-adjust-api-token} 您可以随时重置 Adjust API 识别码。重置后，旧的识别码将失效。如果您重置了 Adjust API 识别码，请务必在所有使用识别码的位置进行替换。使用无效识别码发送的请求会被 Adjust 拒绝。 @@ -67,42 +70,41 @@ sidebar-position: 8 6. 在窗口中输入账户密码并选择 **重置** 来重置您的 API 识别码。屏幕右上角会显示确认信息。 7. 选择 **API 识别码** 旁的复制按钮来将识别码复制到您的系统剪贴板。 -参数\{\#parameters\} ---------------------- - -| 参数 | 数据类型 | 位置 | 描述 | -|--------------------------|-------------------|---------------|---------------------------------------------------------------------------------------------------------------------| -| `adjust_auth_token` | `String` | 标头 | Adjust API 识别码 | -| `link_token` | `String` | 正文 \(Body\) | 自定义链接的链接识别码。如果您是从复合链接生成深度链接，请务必在 Campaign Lab 中使用复合自定义链接的正确链接识别码。 | -| `shorten_url` | `Boolean` | 正文 \(Body\) | 链接是否会被缩短。默认情况下链接不会被缩短。默认值 \- false | -| `campaign` | `String` 或 `null` | 正文 \(Body\) | 推广活动名称 | -| `adgroup` | `String` 或 `null` | 正文 \(Body\) | 广告组名称 | -| `creative` | `String` 或 `null` | 正文 \(Body\) | 素材名称 | -| `deep_link_path` | `String` | 正文 \(Body\) | 指定用户被转至的应用内位置。适用于单一平台应用。 | -| `ios_deep_link_path` | `String` | 正文 \(Body\) | 指定用户被转至的 iOS 应用内位置。适用于多平台 iOS 应用或复合链接。 | -| `android_deep_link_path` | `String` | 正文 \(Body\) | 指定用户被转至的安卓应用内位置。适用于多平台安卓应用或复合链接。 | -| `fallback` | `String` | 正文 \(Body\) | 非默认平台用户被转到的登陆页。在指定后备 URL 时，我们建议为 macOS 用户指定 `redirect_macos`。 | -| `redirect_macos` | `String` | 正文 \(Body\) | 重定向 URL，用于覆盖 Adjust 针对 macOS 的默认重定向。在指定 `fallback` 时，我们建议为 macOS 用户指定该参数。 | -| `label` | `String` | 正文 \(Body\) | 向链接附加自定义数据。使用该参数，添加唯一的[用户推荐 ID](https://help.adjust.com/en/article/set-up-user-referrals)。用户分享来自应用的短链接时，该 ID 会自动填充。 | -| `og_title` | `String` | 正文 \(Body\) | 链接在社交媒体上分享的预览标题。 | -| `og_description` | `String` | 正文 \(Body\) | 链接社交平台分享预览的描述。 | -| `og_image` | `String` | 正文 \(Body\) | JPG 或 PNG 图片的 URL，大小至少为 200 x 200 像素，用于链接的社交分享预览。 | - -生成单个深度链接\{\#generate\-a\-single\-deep\-link\} ----------------------------------------------------- +## 参数\{\#parameters\} + +| 参数 | 数据类型 | 位置 | 描述 | +| ------------------------ | ------------------ | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `adjust_auth_token` | `String` | 标头 | Adjust API 识别码 | +| `link_token` | `String` | 正文 \(Body\) | 自定义链接的链接识别码。如果您是从复合链接生成深度链接，请务必在 Campaign Lab 中使用复合自定义链接的正确链接识别码。 | +| `shorten_url` | `Boolean` | 正文 \(Body\) | 链接是否会被缩短。默认情况下链接不会被缩短。默认值 \- false | +| `campaign` | `String` 或 `null` | 正文 \(Body\) | 推广活动名称 | +| `adgroup` | `String` 或 `null` | 正文 \(Body\) | 广告组名称 | +| `creative` | `String` 或 `null` | 正文 \(Body\) | 素材名称 | +| `deep_link_path` | `String` | 正文 \(Body\) | 指定用户被转至的应用内位置。适用于单一平台应用。 | +| `ios_deep_link_path` | `String` | 正文 \(Body\) | 指定用户被转至的 iOS 应用内位置。适用于多平台 iOS 应用或复合链接。 | +| `android_deep_link_path` | `String` | 正文 \(Body\) | 指定用户被转至的安卓应用内位置。适用于多平台安卓应用或复合链接。 | +| `fallback` | `String` | 正文 \(Body\) | 非默认平台用户被转到的登陆页。在指定后备 URL 时，我们建议为 macOS 用户指定 `redirect_macos`。 | +| `redirect_macos` | `String` | 正文 \(Body\) | 重定向 URL，用于覆盖 Adjust 针对 macOS 的默认重定向。在指定 `fallback` 时，我们建议为 macOS 用户指定该参数。 | +| `label` | `String` | 正文 \(Body\) | 向链接附加自定义数据。使用该参数，添加唯一的[用户推荐 ID](https://help.adjust.com/zh/article/set-up-user-referrals)。用户分享来自应用的短链接时，该 ID 会自动填充。 | +| `og_title` | `String` | 正文 \(Body\) | 链接在社交媒体上分享的预览标题。 | +| `og_description` | `String` | 正文 \(Body\) | 链接社交平台分享预览的描述。 | +| `og_image` | `String` | 正文 \(Body\) | JPG 或 PNG 图片的 URL，大小至少为 200 x 200 像素，用于链接的社交分享预览。 | + +## 生成单个深度链接\{\#generate\-a\-single\-deep\-link\} 发送 `POST` 请求，为单一或多平台应用生成长或短深度链接。 -### 终端\{\#endpoint\-single\} +### 终端{#endpoint-single} ```http https://automate.adjust.com/engage/deep-links ``` -### 示例 \{\#examples\-single\} +### 示例 {#examples-single} -**单一平台应用** - +**单一平台应用** + + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -117,16 +119,18 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - + + ```http {"url": "https://insights.go.link/fryYl"} ``` - + + +**多平台应用** -**多平台应用** - + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -142,18 +146,20 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - + + ```json { "url": "https://insights.go.link/jlbKj" } ``` - + + +**复合链接** -**复合链接** +在使用深度链接生成器 API 生成深度链接之前，请务必[在 Campaign Lab 中创建复合自定义链接](https://help.adjust.com/zh/article/custom-link-setup)。 -在使用深度链接生成器 API 生成深度链接之前，请务必[在 Campaign Lab 中创建复合自定义链接](https://help.adjust.com/en/article/custom-link-setup)。 - + ```bash curl --location 'https://automate.adjust.com/engage/deep-links' \ @@ -170,28 +176,28 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ }' ``` - + + ```http {"url": "https://insights.go.link/6JtQx"} ``` - + -批量生成深度链接\{\#generate\-deep\-links\-in\-bulk\} ----------------------------------------------------- +## 批量生成深度链接\{\#generate\-deep\-links\-in\-bulk\} 发送`POST` 请求，为单一或多平台应用批量生成长或短深度链接。 -### 终端\{\#endpoint\-bulk\} +### 终端{#endpoint-bulk} ```http https://automate.adjust.com/engage/deep-links/bulk ``` -### 示例 \{\#example\-bulk\} +### 示例 {#example-bulk} - + ```bash curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ @@ -225,7 +231,8 @@ curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ }' ``` - + + ```json { @@ -243,22 +250,21 @@ curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ } ``` - + -更新短链接识别码\{\#update\-short\-link\-token\} ----------------------------------------------- +## 更新短链接识别码\{\#update\-short\-link\-token\} 发送 `PUT` 请求，将深度链接中的现有短链接识别码更新为长链接识别码。 -### 终端\{\#endpoint\-update\} +### 终端{#endpoint-update} ```http https://automate.adjust.com/engage/deep-links/{short_token} ``` -### 示例 \{\#example\-update\} +### 示例 {#example-update} - + ```bash curl --location --request PUT 'https://automate.adjust.com/engage/deep-links/4IlkC' \ @@ -272,11 +278,11 @@ curl --location --request PUT 'https://automate.adjust.com/engage/deep-links/4Il }' ``` - + + ```http 204 No Content ``` - diff --git a/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx b/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx index 733cfb2f2..b9c46ece1 100644 --- a/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx +++ b/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx @@ -1,27 +1,27 @@ --- -title: "链接解析" -description: "对于通过电邮、短信、二维码和短链接生成平台的深度链接，请设置链接解析。" -slug: "en/sdk/ios/v4/features/deep-links/resolution" +title: 链接解析 +description: 对于通过电邮、短信、二维码和短链接生成平台的深度链接，请设置链接解析。 +slug: zh/sdk/ios/v4/features/deep-links/resolution sidebar-position: 5 -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v5: "/en/sdk/ios/features/deep-links/resolution" +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v5: /zh/sdk/ios/features/deep-links/resolution --- + 对于通过电邮、短信、二维码和短链接生成平台的深度链接，请务必设置链接解析，否则，通用链接重定向会将所有用户转到 App Store，其中包括已安装应用的用户。设置链接解析后，通用链接重定向会在您的应用内发生，现有用户不会被转到 App Store。 - + + 请咨询您的营销团队，决定应用是否需要链接解析。随后，您就可以针对不同用例设置链接解析域了。 - -工作原理\{\#how\-it\-works\} ------------------------------ + + +## 工作原理\{\#how\-it\-works\} 仅在已安装应用的用户点击重定向 URL 时，链接解析才适用。请在应用中将重定向 URL 域配置为通用链接域。 @@ -33,41 +33,44 @@ redirects: 3. Adjust SDK 中的链接解析方法会参考开发者在 Adjust SDK 中设置的链接解析域，对比重定向 URL 中的域。对比结果分两种： - * 域不匹配 \- 方法会按原样转发深度链接 URL。 - * 域匹配 \- 方法解析链接并返回解析所得的深度链接。 + - 域不匹配 \- 方法会按原样转发深度链接 URL。 + - 域匹配 \- 方法解析链接并返回解析所得的深度链接。 在尝试解析 URL 时，Adjust SDK 会追溯最多 10 个重定向，也就是说，如果要追溯的重定向超过 10 个，那么 SDK 就会返回第 10 个重定向 URL。 + 4. 应用收到返回的 URL，打开展示深度链接内容并将其展示给用户。您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。此操作会将已解析的 URL 发送给 Adjust 服务器用于记录。 - + 如果未安装应用的用户点击了重定向 URL，那么 iOS 就会以正常网页 URL 方式进行处理，将用户重定向至 App Store。链接解析不适用这种情况。 - -使用案例\{\#use\-cases\} ------------------------- + + +## 使用案例\{\#use\-cases\} 下列情况中适用链接解析： -* [电子邮件营销](#email-marketing) -* [短 URL 生成平台](#url-shorteners) +- [电子邮件营销](#email-marketing) +- [短 URL 生成平台](#url-shorteners) -### 电子邮件营销\{\#email\-marketing\} +### 电子邮件营销{#email-marketing} 电邮营销人员开展推广时，电邮营销平台会通过其自有的点击监测重定向 URL 包装邮件中的所有链接。这样，电邮营销人员就能在平台上看到点击数据。不过，如果电邮中包含通用链接，那么重定向 URL 会导致 iOS 无法解析通用链接。 -* 电子邮件营销平台：电邮营销人员用来打造推广活动的软件，其中包括电邮模板、受众定向等功能。 **示例：** Braze，Iterable，SendGrid -* 电邮服务提供商 \(ESP\)：能发送电邮、管理对互联网服务提供商 \(ISP\) 电邮服务器交付活动的底层基础架构。 **示例：** SendGrid，SparkPost。 -* 电子邮件合作伙伴：用来指代电子邮件营销平台或电子邮件服务提供商 \(ESP\) 的一般术语。电子邮件合作伙伴可以是电邮营销平台或 ESP，也可以两者皆是。 **示例：** SendGrid 既是电邮营销平台，也是ESP。电邮营销可能使用其他 ESP 合作伙伴。 **示例：** Graze 和 Iterable 的 ESP 都是 SendGrid 和 SparkPost。 +- 电子邮件营销平台：电邮营销人员用来打造推广活动的软件，其中包括电邮模板、受众定向等功能。 **示例：** Braze，Iterable，SendGrid +- 电邮服务提供商 \(ESP\)：能发送电邮、管理对互联网服务提供商 \(ISP\) 电邮服务器交付活动的底层基础架构。 **示例：** SendGrid，SparkPost。 +- 电子邮件合作伙伴：用来指代电子邮件营销平台或电子邮件服务提供商 \(ESP\) 的一般术语。电子邮件合作伙伴可以是电邮营销平台或 ESP，也可以两者皆是。 **示例：** SendGrid 既是电邮营销平台，也是ESP。电邮营销可能使用其他 ESP 合作伙伴。 **示例：** Graze 和 Iterable 的 ESP 都是 SendGrid 和 SparkPost。 -#### 设置 \{\#setup\} +#### 设置 {#setup} 1. 在您的域上创建专门用于电子邮件监测的域或子域。如果您已经拥有专门用于电子邮件监测的域或子域，您应当重新创建，以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后，您就可以换用自己现有的电邮重定向域。 **示例：** `email.example.com` + 2. 在 Xcode 中向您的 **Associated Domain** \(关联域\) 配置添加电邮重定向域。 **示例：** `applinks:email.example.com` + 3. 设置您的通用链接。 4. 确保已将您的电邮重定向域添加到 `resolveLinkWithUrl` 链接解析方法的 `resolveUrlSuffixArray` 中。 @@ -79,35 +82,38 @@ redirects: 1. **SSL 证书** ：iOS 要求所有通用链接只能使用 HTTPS。因此，您的电邮重定向域必须拥有 SSL 证书。 2. **AASA \(Apple\-App\-Site\-Association\) 文件** ：您需要自行托管 AASA 文件，或将 AASA 文件上传至电邮合作伙伴的系统中，具体视您的电邮合作伙伴情况而定。请查看电邮合作伙伴的文档，了解 AASA 文件托管信息。 - 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件，那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` - 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 + 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件，那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 **示例：** `redirect.example.net` + 7. 进行 DNS 配置，让电邮重定向域指向 CDN。 - + + +请访问帮助中心的 [ESP 集成](https://help.adjust.com/zh/marketer/esp-integrations)版面，了解与上述操作对应的具体合作伙伴操作说明。 -请访问帮助中心的 [ESP 集成](https://help.adjust.com/en/marketer/esp-integrations)版面，了解与上述操作对应的具体合作伙伴操作说明。 - + -##### 电邮服务合作伙伴支持\{\#support\-for\-email\-partners\} +##### 电邮服务合作伙伴支持{#support-for-email-partners} 要使用链接解析，您的电邮服务合作伙伴需要允许您将通用链接域设为重定向域 \(或子域\)。在这种情况下，您可以将合作伙伴的重定向服务指向您自己的自定义域。 -**示例：** +**示例：** -* Braze：根据 Braze 指定的 ESP，设置 SendGrid 或 SparkPost 的重定向域，并将您的自定义域指向该重定向域。随后就可以将自定义域设置为通用链接域了。 -* Iterable：Iterable 的 URL 重定向服务支持自定义域。 -* Mailchimp：Mailchimp 不允许您将其重定向域配置为通用链接，因此您无法采用链接解析。 +- Braze：根据 Braze 指定的 ESP，设置 SendGrid 或 SparkPost 的重定向域，并将您的自定义域指向该重定向域。随后就可以将自定义域设置为通用链接域了。 +- Iterable：Iterable 的 URL 重定向服务支持自定义域。 +- Mailchimp：Mailchimp 不允许您将其重定向域配置为通用链接，因此您无法采用链接解析。 -#### 示例 \{\#example\} +#### 示例 {#example} 1. 电邮营销人员使用模板创建电子邮件。该模板包含链接或带有通用链接的图片。 **示例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` + 2. 电邮营销人员将邮件发送给收件人。在发送邮件前，电邮营销平台会用自己的重定向 URL 包装通用链接。 **示例：** `https://email.example.com/2wuTnQvU` + 3. 已安装应用的用户点击电子邮件中的重定向 URL。 4. iOS 打开您的应用，将重定向 URL 发送至应用。 @@ -118,23 +124,25 @@ redirects: 因此，`https://email.example.com/2wuTnQvU` 会重定向至 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 。 + 7. 链接解析方法返回已解析的 URL。 8. 您的应用处理返回的 URL。在这种情况下，您的应用将在应用中显示 `summer-clothes` 页面，用户会看到 `beach promo` 弹窗。 9. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。 -### URL 缩短服务\{\#url\-shorteners\} +### URL 缩短服务{#url-shorteners} 有时，营销人员需要在特定类型的推广活动中用到短 URL。例如：短信文本长度上限为 160 个字符。有时，客户需要缩短链接，以便在 Slack 等团队通讯平台上分享。不过，如果短 URL 重定向到通用链接，那么 iOS 就不会解析通用链接。 -#### 设置 \{\#setup\-1\} +#### 设置 {#setup-1} 1. 在您的域上创建专门用于缩短 URL 的域或子域。如果您已经拥有专门用于缩短 URL 的域或子域，也还是应当重新创建，以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后，您就可以换用自己现有的 URL 缩短域。 2. 在 Xcode 中向您的 **Associated Domain** \(关联域\) 配置添加短 URL 域。 **示例：** `applinks:short.example.com` + 3. 设置您的通用链接。 4. 确保已将您的电邮重定向域添加到 `resolveLinkWithUrl` 链接解析方法的 `resolveUrlSuffixArray` 中。 @@ -142,18 +150,21 @@ redirects: 5. 设置支持通用链接的 URL 缩短服务。请注意：Adjust 不提供任何 URL 缩短服务。 **示例** ：[`short.io`](http://short.io) + 6. 在短 URL 生成服务平台上，将短 URL 生成域配置为自定义域。您需要进行 DNS 配置，才能让短 URL 生成域指向短 URL 生成服务的服务器。\([在 short.io 中添加自定义域的参考文档](https://help.short.io/en/articles/9991681-how-can-i-add-a-domain)\)。 7. 在 URL 缩短服务中配置通用链接。\([在 short.io 中设置通用链接的参考文档](https://help.short.io/en/articles/4065870-how-to-set-up-deep-links-for-ios)\)。 -#### 示例 \{\#example\-1\} +#### 示例 {#example-1} 1. 营销人员创建通用链接。 **示例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` + 2. 营销人员使用 URL 缩短服务生成短链接。 **示例：** `https://short.example.com/2wuTnQvU` + 3. 营销人员在推广活动中使用短链接，例如短信推广活动。 4. 已安装应用的用户点击短信中的短 URL。 @@ -166,9 +177,9 @@ redirects: 因此，`https://short.example.com/2wuTnQvU` 会重定向至 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 。 + 8. 链接解析方法返回已解析的 URL。 9. 您的应用处理返回的 URL。在这种情况下，您的应用将在应用中显示 `summer-clothes` 页面，用户会看到 `beach promo` 弹窗。 -10. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。 - +10. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `appWillOpenUrl` 方法 。 diff --git a/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx b/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx index f8aac2a73..0721d9346 100644 --- a/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx +++ b/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx @@ -1,27 +1,27 @@ --- -title: "链接解析" -description: "对于通过电邮、短信、二维码和短链接生成平台的深度链接，请设置链接解析。" -slug: "en/sdk/ios/features/deep-links/resolution" +title: 链接解析 +description: 对于通过电邮、短信、二维码和短链接生成平台的深度链接，请设置链接解析。 +slug: zh/sdk/ios/features/deep-links/resolution sidebar-position: 5 -versions: - - - label: "v5" - value: "v5" - default: true - - - label: "v4" - value: "v4" -redirects: - v4: "/en/sdk/ios/v4/features/deep-links/resolution" +versions: + - label: v5 + value: v5 + default: true + - label: v4 + value: v4 +redirects: + v4: /zh/sdk/ios/v4/features/deep-links/resolution --- + 对于通过电邮、短信、二维码和短链接生成平台的深度链接，请务必设置链接解析，否则，通用链接重定向会将所有用户转到 App Store，其中包括已安装应用的用户。设置链接解析后，通用链接重定向会在您的应用内发生，现有用户不会被转到 App Store。 - + + 请咨询您的营销团队，决定应用是否需要链接解析。随后，您就可以针对不同用例设置链接解析域了。 - -工作原理\{\#how\-it\-works\} ------------------------------ + + +## 工作原理\{\#how\-it\-works\} 仅在已安装应用的用户点击重定向 URL 时，链接解析才适用。请在应用中将重定向 URL 域配置为通用链接域。 @@ -33,41 +33,44 @@ redirects: 3. Adjust SDK 中的链接解析方法会参考开发者在 Adjust SDK 中设置的链接解析域，对比重定向 URL 中的域。对比结果分两种： - * 域不匹配 \- 方法会按原样转发深度链接 URL。 - * 域匹配 \- 方法解析链接并返回解析所得的深度链接。 + - 域不匹配 \- 方法会按原样转发深度链接 URL。 + - 域匹配 \- 方法解析链接并返回解析所得的深度链接。 在尝试解析 URL 时，Adjust SDK 会追溯最多 10 个重定向，也就是说，如果要追溯的重定向超过 10 个，那么 SDK 就会返回第 10 个重定向 URL。 + 4. 应用收到返回的 URL，打开展示深度链接内容并将其展示给用户。您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `processDeeplink` 方法 。此操作会将已解析的 URL 发送给 Adjust 服务器用于记录。 - + 如果未安装应用的用户点击了重定向 URL，那么 iOS 就会以正常网页 URL 方式进行处理，将用户重定向至 App Store。链接解析不适用这种情况。 - -使用案例\{\#use\-cases\} ------------------------- + + +## 使用案例\{\#use\-cases\} 下列情况中适用链接解析： -* [电子邮件营销](#email-marketing) -* [短 URL 生成平台](#url-shorteners) +- [电子邮件营销](#email-marketing) +- [短 URL 生成平台](#url-shorteners) -### 电子邮件营销\{\#email\-marketing\} +### 电子邮件营销{#email-marketing} 电邮营销人员开展推广时，电邮营销平台会通过其自有的点击监测重定向 URL 包装邮件中的所有链接。这样，电邮营销人员就能在平台上看到点击数据。不过，如果电邮中包含通用链接，那么重定向 URL 会导致 iOS 无法解析通用链接。 -* 电子邮件营销平台：电邮营销人员用来打造推广活动的软件，其中包括电邮模板、受众定向等功能。 **示例：** Braze，Iterable，SendGrid -* 电邮服务提供商 \(ESP\)：能发送电邮、管理对互联网服务提供商 \(ISP\) 电邮服务器交付活动的底层基础架构。 **示例：** SendGrid，SparkPost。 -* 电子邮件合作伙伴：用来指代电子邮件营销平台或电子邮件服务提供商 \(ESP\) 的一般术语。电子邮件合作伙伴可以是电邮营销平台或 ESP，也可以两者皆是。 **示例：** SendGrid 既是电邮营销平台，也是ESP。电邮营销可能使用其他 ESP 合作伙伴。 **示例：** Graze 和 Iterable 的 ESP 都是 SendGrid 和 SparkPost。 +- 电子邮件营销平台：电邮营销人员用来打造推广活动的软件，其中包括电邮模板、受众定向等功能。 **示例：** Braze，Iterable，SendGrid +- 电邮服务提供商 \(ESP\)：能发送电邮、管理对互联网服务提供商 \(ISP\) 电邮服务器交付活动的底层基础架构。 **示例：** SendGrid，SparkPost。 +- 电子邮件合作伙伴：用来指代电子邮件营销平台或电子邮件服务提供商 \(ESP\) 的一般术语。电子邮件合作伙伴可以是电邮营销平台或 ESP，也可以两者皆是。 **示例：** SendGrid 既是电邮营销平台，也是ESP。电邮营销可能使用其他 ESP 合作伙伴。 **示例：** Graze 和 Iterable 的 ESP 都是 SendGrid 和 SparkPost。 -#### 设置 \{\#setup\} +#### 设置 {#setup} 1. 在您的域上创建专门用于电子邮件监测的域或子域。如果您已经拥有专门用于电子邮件监测的域或子域，您应当重新创建，以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后，您就可以换用自己现有的电邮重定向域。 **示例：** `email.example.com` + 2. 在 Xcode 中向您的 **Associated Domain** \(关联域\) 配置添加电邮重定向域。 **示例：** `applinks:email.example.com` + 3. 设置您的通用链接。 4. 确保已将您的电邮重定向域添加到 `resolveLinkWithUrl` 链接解析方法的 `resolveUrlSuffixArray` 中。 @@ -79,35 +82,38 @@ redirects: 1. **SSL 证书** ：iOS 要求所有通用链接只能使用 HTTPS。因此，您的电邮重定向域必须拥有 SSL 证书。 2. **AASA \(Apple\-App\-Site\-Association\) 文件** ：您需要自行托管 AASA 文件，或将 AASA 文件上传至电邮合作伙伴的系统中，具体视您的电邮合作伙伴情况而定。请查看电邮合作伙伴的文档，了解 AASA 文件托管信息。 - 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件，那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` - 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 + 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件，那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 **示例：** `redirect.example.net` + 7. 进行 DNS 配置，让电邮重定向域指向 CDN。 - + + +请访问帮助中心的 [ESP 集成](https://help.adjust.com/zh/marketer/esp-integrations)版面，了解与上述操作对应的具体合作伙伴操作说明。 -请访问帮助中心的 [ESP 集成](https://help.adjust.com/en/marketer/esp-integrations)版面，了解与上述操作对应的具体合作伙伴操作说明。 - + -##### 电邮服务合作伙伴支持\{\#support\-for\-email\-partners\} +##### 电邮服务合作伙伴支持{#support-for-email-partners} 要使用链接解析，您的电邮服务合作伙伴需要允许您将通用链接域设为重定向域 \(或子域\)。在这种情况下，您可以将合作伙伴的重定向服务指向您自己的自定义域。 -**示例：** +**示例：** -* Braze：根据 Braze 指定的 ESP，设置 SendGrid 或 SparkPost 的重定向域，并将您的自定义域指向该重定向域。随后就可以将自定义域设置为通用链接域了。 -* Iterable：Iterable 的 URL 重定向服务支持自定义域。 -* Mailchimp：Mailchimp 不允许您将其重定向域配置为通用链接，因此您无法采用链接解析。 +- Braze：根据 Braze 指定的 ESP，设置 SendGrid 或 SparkPost 的重定向域，并将您的自定义域指向该重定向域。随后就可以将自定义域设置为通用链接域了。 +- Iterable：Iterable 的 URL 重定向服务支持自定义域。 +- Mailchimp：Mailchimp 不允许您将其重定向域配置为通用链接，因此您无法采用链接解析。 -#### 示例 \{\#example\} +#### 示例 {#example} 1. 电邮营销人员使用模板创建电子邮件。该模板包含链接或带有通用链接的图片。 **示例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` + 2. 电邮营销人员将邮件发送给收件人。在发送邮件前，电邮营销平台会用自己的重定向 URL 包装通用链接。 **示例：** `https://email.example.com/2wuTnQvU` + 3. 已安装应用的用户点击电子邮件中的重定向 URL。 4. iOS 打开您的应用，将重定向 URL 发送至应用。 @@ -118,23 +124,25 @@ redirects: 因此，`https://email.example.com/2wuTnQvU` 会重定向至 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 。 + 7. 链接解析方法返回已解析的 URL。 8. 您的应用处理返回的 URL。在这种情况下，您的应用将在应用中显示 `summer-clothes` 页面，用户会看到 `beach promo` 弹窗。 9. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `processDeeplink` 方法 。 -### URL 缩短服务\{\#url\-shorteners\} +### URL 缩短服务{#url-shorteners} 有时，营销人员需要在特定类型的推广活动中用到短 URL。例如：短信文本长度上限为 160 个字符。有时，客户需要缩短链接，以便在 Slack 等团队通讯平台上分享。不过，如果短 URL 重定向到通用链接，那么 iOS 就不会解析通用链接。 -#### 设置 \{\#setup\-1\} +#### 设置 {#setup-1} 1. 在您的域上创建专门用于缩短 URL 的域或子域。如果您已经拥有专门用于缩短 URL 的域或子域，也还是应当重新创建，以求在不干扰现有推广活动的前提下完成实装。完成并测试该实装后，您就可以换用自己现有的 URL 缩短域。 2. 在 Xcode 中向您的 **Associated Domain** \(关联域\) 配置添加短 URL 域。 **示例：** `applinks:short.example.com` + 3. 设置您的通用链接。 4. 确保已将您的电邮重定向域添加到 `resolveLinkWithUrl` 链接解析方法的 `resolveUrlSuffixArray` 中。 @@ -142,18 +150,21 @@ redirects: 5. 设置支持通用链接的 URL 缩短服务。请注意：Adjust 不提供任何 URL 缩短服务。 **示例** ：[`short.io`](http://short.io) + 6. 在短 URL 生成服务平台上，将短 URL 生成域配置为自定义域。您需要进行 DNS 配置，才能让短 URL 生成域指向短 URL 生成服务的服务器。\([在 short.io 中添加自定义域的参考文档](https://help.short.io/en/articles/9991681-how-can-i-add-a-domain)\)。 7. 在 URL 缩短服务中配置通用链接。\([在 short.io 中设置通用链接的参考文档](https://help.short.io/en/articles/4065870-how-to-set-up-deep-links-for-ios)\)。 -#### 示例 \{\#example\-1\} +#### 示例 {#example-1} 1. 营销人员创建通用链接。 **示例：** `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` + 2. 营销人员使用 URL 缩短服务生成短链接。 **示例：** `https://short.example.com/2wuTnQvU` + 3. 营销人员在推广活动中使用短链接，例如短信推广活动。 4. 已安装应用的用户点击短信中的短 URL。 @@ -166,9 +177,9 @@ redirects: 因此，`https://short.example.com/2wuTnQvU` 会重定向至 `https://example.go.link/summer-clothes?promo=beach&adj_t=abc123` 。 + 8. 链接解析方法返回已解析的 URL。 9. 您的应用处理返回的 URL。在这种情况下，您的应用将在应用中显示 `summer-clothes` 页面，用户会看到 `beach promo` 弹窗。 -10. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `processDeeplink` 方法 。 - +10. 您的应用也会使用返回的 URL 调用 Adjust SDK 中的 `processDeeplink` 方法 。 From 7504be0cd8efe3f6cc55a10b608cfe126854349a Mon Sep 17 00:00:00 2001 From: Tomoko Goto <42029374+tomokogoto1@users.noreply.github.com> Date: Wed, 8 Jan 2025 09:43:24 -0800 Subject: [PATCH 11/13] Update deep-link-generator-api.mdx --- src/content/docs/ja/api/deep-link-generator-api.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/docs/ja/api/deep-link-generator-api.mdx b/src/content/docs/ja/api/deep-link-generator-api.mdx index 509d82e05..dcf150729 100644 --- a/src/content/docs/ja/api/deep-link-generator-api.mdx +++ b/src/content/docs/ja/api/deep-link-generator-api.mdx @@ -74,7 +74,7 @@ Adjust APIトークンをリセットする方法： | パラメーター | データタイプ | 入力する値 | 説明 | | ------------------------ | ---------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `adjust_auth_token` | `String` | 説明 | Adjust APIトークン | +| `adjust_auth_token` | `String` | ヘッダー | Adjust APIトークン | | `link_token` | `String` | ボディ | カスタムリンクのリンクトークン。複合リンクからディープリンクを生成している場合、Campaign Labで組み合わせたカスタムリンクの正しいリンクトークンを使用していることを確認してください。 | | `shorten_url` | `Boolean` | ボディ | リンクが短縮されるかどうか。リンクはデフォルトでは短縮されません。デフォルト値 \- false | | `campaign` | `String` または `null` | ボディ | キャンペーンの名前 | From 6875a93d6110f6fcb83c1cb71658a1e2e0602877 Mon Sep 17 00:00:00 2001 From: github-actions <41898282+github-actions[bot]@users.noreply.github.com> Date: Wed, 8 Jan 2025 17:44:03 +0000 Subject: [PATCH 12/13] Fix translated and formatted files --- .../docs/ja/api/deep-link-generator-api.mdx | 14 +++++++------- .../sdk/ios/v4/features/deep-links/resolution.mdx | 4 ++-- .../sdk/ios/v5/features/deep-links/resolution.mdx | 4 ++-- .../docs/ko/api/deep-link-generator-api.mdx | 12 ++++++------ .../sdk/ios/v4/features/deep-links/resolution.mdx | 4 ++-- .../sdk/ios/v5/features/deep-links/resolution.mdx | 4 ++-- .../docs/zh/api/deep-link-generator-api.mdx | 12 ++++++------ .../sdk/ios/v4/features/deep-links/resolution.mdx | 4 ++-- .../sdk/ios/v5/features/deep-links/resolution.mdx | 4 ++-- 9 files changed, 31 insertions(+), 31 deletions(-) diff --git a/src/content/docs/ja/api/deep-link-generator-api.mdx b/src/content/docs/ja/api/deep-link-generator-api.mdx index dcf150729..ec2c6e700 100644 --- a/src/content/docs/ja/api/deep-link-generator-api.mdx +++ b/src/content/docs/ja/api/deep-link-generator-api.mdx @@ -8,7 +8,7 @@ sidebar-position: 8 ディープリンクジェネレーターAPIを使用して、アプリ用の短いおよび長いディープリンクを個別または一括で作成できます。これらのカスタマイズされたディープリンクは、さまざまなプラットフォームでユーザー体験を向上させます。 -## 事前準備 \{\#before\-you\-begin\} +## 事前準備 {#before-you-begin} はじめに、以下の設定手順をご覧ください。 @@ -43,7 +43,7 @@ sidebar-position: 8 - [データレジデンシーを設定](https://help.adjust.com/ja/article/data-residency-setup)している場合、iOSアプリとAndroidアプリで同じ地域を使用していることを確認してください。 -## 認証 \{\#authentication\} +## 認証 {#authentication} ディープリンクジェネレーターは、[ベアラートークン](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication)を使用して認証します。ディープリンクジェネレーターAPIへの各リクエストには、Adjust APIトークンを`Authorization`ヘッダーに必ず含める必要があります。 @@ -70,11 +70,11 @@ Adjust APIトークンをリセットする方法： 6. 表示されたモーダルにアカウントのパスワードを入力し、 **リセット** を選択してAPIトークンをリセットします。画面の右上に確認メッセージが表示されます。 7. **APIトークン** の横にあるコピーボタンを選択して、トークンをクリップボードにコピーします。 -## パラメーター \{\#parameters\} +## パラメーター {#parameters} | パラメーター | データタイプ | 入力する値 | 説明 | | ------------------------ | ---------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -| `adjust_auth_token` | `String` | ヘッダー | Adjust APIトークン | +| `adjust_auth_token` | `String` | ヘッダー | Adjust APIトークン | | `link_token` | `String` | ボディ | カスタムリンクのリンクトークン。複合リンクからディープリンクを生成している場合、Campaign Labで組み合わせたカスタムリンクの正しいリンクトークンを使用していることを確認してください。 | | `shorten_url` | `Boolean` | ボディ | リンクが短縮されるかどうか。リンクはデフォルトでは短縮されません。デフォルト値 \- false | | `campaign` | `String` または `null` | ボディ | キャンペーンの名前 | @@ -90,7 +90,7 @@ Adjust APIトークンをリセットする方法： | `og_description` | `String` | ボディ | リンクのソーシャル共有プレビューの説明。 | | `og_image` | `String` | ボディ | ソーシャル共有プレビューに使用する、200 x 200 ピクセル以上のJPGまたはPNG形式の画像のURLを指定。 | -## 単一のディープリンクを生成\{\#generate\-a\-single\-deep\-link\} +## 単一のディープリンクを生成{#generate-a-single-deep-link} シングルまたはマルチプラットフォームのアプリ用に、長いまたは短縮ディープリンクを生成するには、`POST`リクエストを送信します。 @@ -185,7 +185,7 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ -## ディープリンクを一括で生成\{\#generate\-deep\-links\-in\-bulk\} +## ディープリンクを一括で生成{#generate-deep-links-in-bulk} シングルまたはマルチプラットフォームのアプリ用に、長いまたは短縮ディープリンクを一括で生成するには、`POST`リクエストを送信します。 @@ -252,7 +252,7 @@ curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ -## ショートリンクトークンを更新\{\#update\-short\-link\-token\} +## ショートリンクトークンを更新{#update-short-link-token} `PUT`リクエストを送信して、ディープリンク内の既存のショートリンクトークンを長いリンクに更新します。 diff --git a/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx b/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx index 21f78c66e..657bcf501 100644 --- a/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx +++ b/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx @@ -21,7 +21,7 @@ redirects: -## 仕組み \{\#how\-it\-works\} +## 仕組み {#how-it-works} リンク解析は、アプリをインストールしているユーザーがリダイレクトURLをクリックしたときにのみ実行されます。リダイレクトURL内のドメインを、アプリ内のユニバーサルリンクドメインとして設定する必要があります。 @@ -46,7 +46,7 @@ redirects: -## ユースケース \{\#use\-cases\} +## ユースケース {#use-cases} リンク解析は、次の場合に実行されます。 diff --git a/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx b/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx index de8110277..3ac2830bf 100644 --- a/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx +++ b/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx @@ -21,7 +21,7 @@ redirects: -## 仕組み \{\#how\-it\-works\} +## 仕組み {#how-it-works} リンク解析は、アプリをインストールしているユーザーがリダイレクトURLをクリックしたときにのみ実行されます。リダイレクトURL内のドメインを、アプリ内のユニバーサルリンクドメインとして設定する必要があります。 @@ -46,7 +46,7 @@ redirects: -## ユースケース \{\#use\-cases\} +## ユースケース {#use-cases} リンク解析は、次の場合に実行されます。 diff --git a/src/content/docs/ko/api/deep-link-generator-api.mdx b/src/content/docs/ko/api/deep-link-generator-api.mdx index b0688e6ba..909baf68e 100644 --- a/src/content/docs/ko/api/deep-link-generator-api.mdx +++ b/src/content/docs/ko/api/deep-link-generator-api.mdx @@ -8,7 +8,7 @@ sidebar-position: 8 딥링크 생성기 API를 사용하여 앱에 대한 긴/단축 딥링크를 개별 또는 일괄로 생성할 수 있습니다. 이러한 맞춤형 딥링크는 다양한 플랫폼에서 사용자 경험을 향상시킵니다. -## 시작에 앞서 \{\#before\-you\-begin\} +## 시작에 앞서 {#before-you-begin} 시작하기 전에 알아야 할 사항은 다음과 같습니다. @@ -43,7 +43,7 @@ sidebar-position: 8 - [데이터 레지던시를 설정](https://help.adjust.com/ko/article/data-residency-setup)한 경우, iOS와 Android 앱에 동일한 지역을 사용해야 합니다. -## 인증 \{\#authentication\} +## 인증 {#authentication} 캠페인 API는 인증을 위해 [베어러 토큰](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) 을 사용합니다. 반드시 캠페인 API에 대한 각 요청과 함께 `Authorization` 헤더에 Adjust API 토큰을 포함해야 합니다. @@ -70,7 +70,7 @@ Adjust API 토큰 재설정 6. 모달에 계정 비밀번호를 입력한 후 API 토큰 재설정을 위해 **재설정** 을 선택합니다. 화면 우측 상단에 확인 메시지가 나타납니다. 7. 시스템 클립보드에 **API 토큰** 을 복사하기 위해 복사를 선택합니다. -## 파라미터 \{\#parameters\} +## 파라미터 {#parameters} | 파라미터 | 데이터 유형 | In | 설명 | | ------------------------ | -------------------- | ---- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -90,7 +90,7 @@ Adjust API 토큰 재설정 | `og_description` | `String` | Body | 링크의 소셜 공유 미리보기에 대한 설명. | | `og_image` | `String` | Body | 링크의 소셜 공유 미리보기를 위한 최소 200 x 200 픽셀 크기의 JPG 또는 PNG 이미지에 대한 URL. | -## 단일 딥링크 \{\#generate\-a\-single\-deep\-link\} 생성 +## 단일 딥링크 {#generate-a-single-deep-link} 생성 `POST` 요청을 전송하여 단일 또는 멀티 플랫폼 앱에 대해 긴/단축 딥링크를 생성합니다. @@ -185,7 +185,7 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ -## 딥링크 일괄 생성 \{\#generate\-deep\-links\-in\-bulk\} +## 딥링크 일괄 생성 {#generate-deep-links-in-bulk} `POST` 요청을 전송하여 단일 또는 멀티 플랫폼 앱에 대해 긴/단축 딥링크를 일괄 생성합니다. @@ -252,7 +252,7 @@ curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ -## 단축 링크 토큰 업데이트 \{\#update\-short\-link\-token\} +## 단축 링크 토큰 업데이트 {#update-short-link-token} `PUT` 요청을 전송하여 딥링크의 기존 단축 링크 토큰을 긴 링크로 업데이트합니다. diff --git a/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx b/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx index bd877f9f6..1b33d592b 100644 --- a/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx +++ b/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx @@ -21,7 +21,7 @@ redirects: -## 작동 방식 \{\#how\-it\-works\} +## 작동 방식 {#how-it-works} 앱을 설치한 사용자가 리다이렉트 URL을 클릭하는 경우에만 링크 해석이 필요하며, 리다이렉트 URL의 도메인을 앱에서의 유니버설 링크 도메인으로써 구성해야 합니다. @@ -46,7 +46,7 @@ redirects: -## 활용법 \{\#use\-cases\} +## 활용법 {#use-cases} 링크 해석은 다음에 적용될 수 있습니다. diff --git a/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx b/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx index 7c66b26a7..cedef958d 100644 --- a/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx +++ b/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx @@ -21,7 +21,7 @@ redirects: -## 작동 방식 \{\#how\-it\-works\} +## 작동 방식 {#how-it-works} 앱을 설치한 사용자가 리다이렉트 URL을 클릭하는 경우에만 링크 해석이 필요하며, 리다이렉트 URL의 도메인을 앱에서의 유니버설 링크 도메인으로써 구성해야 합니다. @@ -46,7 +46,7 @@ redirects: -## 활용법 \{\#use\-cases\} +## 활용법 {#use-cases} 링크 해석은 다음에 적용될 수 있습니다. diff --git a/src/content/docs/zh/api/deep-link-generator-api.mdx b/src/content/docs/zh/api/deep-link-generator-api.mdx index 9bf4ee7c5..fc5d6c36f 100644 --- a/src/content/docs/zh/api/deep-link-generator-api.mdx +++ b/src/content/docs/zh/api/deep-link-generator-api.mdx @@ -8,7 +8,7 @@ sidebar-position: 8 使用深度链接生成器 API，您可以单独或批量创建应用定制深度链接。这些深度链接可长可短，能改善各个平台的用户体验。 -## 操作前须知 \{\#before\-you\-begin\} +## 操作前须知 {#before-you-begin} 以下是您在操作前需要了解的内容。 @@ -43,7 +43,7 @@ sidebar-position: 8 - 如果您已[设置数据驻留](https://help.adjust.com/zh/article/data-residency-setup)，请确保 iOS 和安卓应用使用同一地区。 -## 认证\{\#authentication\} +## 认证{#authentication} 深度链接生成器 API 使用 [Bearer 识别码](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication)进行认证。您必须在向深度链接生成器 API 发出的每个请求的 `Authorization` 标头中包含您的 Adjust API 识别码。 @@ -70,7 +70,7 @@ sidebar-position: 8 6. 在窗口中输入账户密码并选择 **重置** 来重置您的 API 识别码。屏幕右上角会显示确认信息。 7. 选择 **API 识别码** 旁的复制按钮来将识别码复制到您的系统剪贴板。 -## 参数\{\#parameters\} +## 参数{#parameters} | 参数 | 数据类型 | 位置 | 描述 | | ------------------------ | ------------------ | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -90,7 +90,7 @@ sidebar-position: 8 | `og_description` | `String` | 正文 \(Body\) | 链接社交平台分享预览的描述。 | | `og_image` | `String` | 正文 \(Body\) | JPG 或 PNG 图片的 URL，大小至少为 200 x 200 像素，用于链接的社交分享预览。 | -## 生成单个深度链接\{\#generate\-a\-single\-deep\-link\} +## 生成单个深度链接{#generate-a-single-deep-link} 发送 `POST` 请求，为单一或多平台应用生成长或短深度链接。 @@ -185,7 +185,7 @@ curl --location 'https://automate.adjust.com/engage/deep-links' \ -## 批量生成深度链接\{\#generate\-deep\-links\-in\-bulk\} +## 批量生成深度链接{#generate-deep-links-in-bulk} 发送`POST` 请求，为单一或多平台应用批量生成长或短深度链接。 @@ -252,7 +252,7 @@ curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \ -## 更新短链接识别码\{\#update\-short\-link\-token\} +## 更新短链接识别码{#update-short-link-token} 发送 `PUT` 请求，将深度链接中的现有短链接识别码更新为长链接识别码。 diff --git a/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx b/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx index b9c46ece1..e1f018934 100644 --- a/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx +++ b/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx @@ -21,7 +21,7 @@ redirects: -## 工作原理\{\#how\-it\-works\} +## 工作原理{#how-it-works} 仅在已安装应用的用户点击重定向 URL 时，链接解析才适用。请在应用中将重定向 URL 域配置为通用链接域。 @@ -46,7 +46,7 @@ redirects: -## 使用案例\{\#use\-cases\} +## 使用案例{#use-cases} 下列情况中适用链接解析： diff --git a/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx b/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx index 0721d9346..103085a94 100644 --- a/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx +++ b/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx @@ -21,7 +21,7 @@ redirects: -## 工作原理\{\#how\-it\-works\} +## 工作原理{#how-it-works} 仅在已安装应用的用户点击重定向 URL 时，链接解析才适用。请在应用中将重定向 URL 域配置为通用链接域。 @@ -46,7 +46,7 @@ redirects: -## 使用案例\{\#use\-cases\} +## 使用案例{#use-cases} 下列情况中适用链接解析： From ab0e6780eda968245ca340f69790c4ce80165e87 Mon Sep 17 00:00:00 2001 From: Bohdan Zavhorodskyi Date: Tue, 14 Jan 2025 11:42:23 +0200 Subject: [PATCH 13/13] fix: fix for the translated docs --- .../docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx | 4 +++- .../docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx | 4 +++- .../docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx | 4 +++- .../docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx | 4 +++- .../docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx | 4 +++- .../docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx | 4 +++- 6 files changed, 18 insertions(+), 6 deletions(-) diff --git a/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx b/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx index 657bcf501..7d49298ce 100644 --- a/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx +++ b/src/content/docs/ja/sdk/ios/v4/features/deep-links/resolution.mdx @@ -82,7 +82,9 @@ redirects: 1. **SSL証明書** ：iOSでは、ユニバーサルリンクでHTTPSのみを使用する必要があります。そのため、メールリダイレクトドメインにはSSL証明書が必要です。 2. **AASA（Apple\-App\-Site\-Association）ファイル** ：メールパートナーによっては、独自のAASAファイルをホストするか、AASAファイルをメールパートナーシステムにアップロードする必要があります。AASAファイルのホスティングについては、メールパートナーのドキュメントを参照してください。 - 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます：`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` 3. （該当する場合、AASAファイルを除いた）メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 + 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます：`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` + + 3. （該当する場合、AASAファイルを除いた）メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 **例：** `redirect.example.net` diff --git a/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx b/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx index 3ac2830bf..9bef49b20 100644 --- a/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx +++ b/src/content/docs/ja/sdk/ios/v5/features/deep-links/resolution.mdx @@ -82,7 +82,9 @@ redirects: 1. **SSL証明書** ：iOSでは、ユニバーサルリンクでHTTPSのみを使用する必要があります。そのため、メールリダイレクトドメインにはSSL証明書が必要です。 2. **AASA（Apple\-App\-Site\-Association）ファイル** ：メールパートナーによっては、独自のAASAファイルをホストするか、AASAファイルをメールパートナーシステムにアップロードする必要があります。AASAファイルのホスティングについては、メールパートナーのドキュメントを参照してください。 - 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます：`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` 3. （該当する場合、AASAファイルを除いた）メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 + 次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます：`https://example.go.link/.well-known/apple-app-site-association`。ドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパスからそのファイルを提供する必要があります \- `https://email.example.com/.well-known/apple-app-site-association` + + 3. （該当する場合、AASAファイルを除いた）メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 **例：** `redirect.example.net` diff --git a/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx b/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx index 1b33d592b..c46f27ec5 100644 --- a/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx +++ b/src/content/docs/ko/sdk/ios/v4/features/deep-links/resolution.mdx @@ -82,7 +82,9 @@ redirects: 1. **SSL 인증서** : iOS에서는 유니버설 링크가 HTTPS만 사용할 수 있습니다. 따라서 이메일 리다이렉트 도메인에 SSL 인증서가 필요합니다. 2. **AASA\(Apple\-App\-Site\-Association\) 파일** : 이메일 파트너에 따라 AASA 파일을 직접 호스트하거나, AASA 파일을 이메일 파트너 시스템에 업로드해야 합니다. AASA 파일 호스트에 관한 정보는, 이메일 파트너의 관련 문서를 참조하시기 바랍니다. - 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. + 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` + + 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. **예시:** `redirect.example.net` diff --git a/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx b/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx index cedef958d..fcdbf2b0c 100644 --- a/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx +++ b/src/content/docs/ko/sdk/ios/v5/features/deep-links/resolution.mdx @@ -82,7 +82,9 @@ redirects: 1. **SSL 인증서** : iOS에서는 유니버설 링크가 HTTPS만 사용할 수 있습니다. 따라서 이메일 리다이렉트 도메인에 SSL 인증서가 필요합니다. 2. **AASA\(Apple\-App\-Site\-Association\) 파일** : 이메일 파트너에 따라 AASA 파일을 직접 호스트하거나, AASA 파일을 이메일 파트너 시스템에 업로드해야 합니다. AASA 파일 호스트에 관한 정보는, 이메일 파트너의 관련 문서를 참조하시기 바랍니다. - 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. + 다음 Path에서 호스팅되는 유니버설 링크 AASA 파일을 다운로드할 수 있습니다. `https://example.go.link/.well-known/apple-app-site-association` 도메인을 유니버설 링크 도메인으로 바꾸시기 바랍니다. Adjust 유니버설 링크 AASA 파일을 복사하고, 이메일 리다이렉트 도메인 AASA 파일에 사용할 수 있습니다. 이메일 파트너가 자신의 AASA 파일을 호스팅하도록 요청하는 경우 CDN은 이메일 리다이렉트 도메인의 상응하는 Path에서 해당 파일을 제공해야 합니다. `https://email.example.com/.well-known/apple-app-site-association` + + 3. 이메일 리다이렉트 도메인\(해당되는 경우 AASA 파일 제외\)으로의 모든 요청을 이메일 파트너의 리다이렉트 서버로 전달합니다. **예시:** `redirect.example.net` diff --git a/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx b/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx index e1f018934..92b77d9ad 100644 --- a/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx +++ b/src/content/docs/zh/sdk/ios/v4/features/deep-links/resolution.mdx @@ -82,7 +82,9 @@ redirects: 1. **SSL 证书** ：iOS 要求所有通用链接只能使用 HTTPS。因此，您的电邮重定向域必须拥有 SSL 证书。 2. **AASA \(Apple\-App\-Site\-Association\) 文件** ：您需要自行托管 AASA 文件，或将 AASA 文件上传至电邮合作伙伴的系统中，具体视您的电邮合作伙伴情况而定。请查看电邮合作伙伴的文档，了解 AASA 文件托管信息。 - 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件，那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 + 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件，那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` + + 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 **示例：** `redirect.example.net` diff --git a/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx b/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx index 103085a94..75550f019 100644 --- a/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx +++ b/src/content/docs/zh/sdk/ios/v5/features/deep-links/resolution.mdx @@ -82,7 +82,9 @@ redirects: 1. **SSL 证书** ：iOS 要求所有通用链接只能使用 HTTPS。因此，您的电邮重定向域必须拥有 SSL 证书。 2. **AASA \(Apple\-App\-Site\-Association\) 文件** ：您需要自行托管 AASA 文件，或将 AASA 文件上传至电邮合作伙伴的系统中，具体视您的电邮合作伙伴情况而定。请查看电邮合作伙伴的文档，了解 AASA 文件托管信息。 - 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件，那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 + 您可以为托管在路径 \- `https://example.go.link/.well-known/apple-app-site-association`\-上的通用链接下载 AASA 文件。请将该路径的域名变更为您的通用链接域名。您可以复制 Adjust 通用链接 AASA 文件并将其用于电邮重定向域 AASA 文件。如果您的电邮服务合作伙伴要求您自行托管 AASA 文件，那么您的 CDN 要从电邮重定向域的相应路径上提供该文件 \- `https://email.example.com/.well-known/apple-app-site-association` + + 3. 将电邮重定向域的所有传入请求 \(适用情况下 AASA 文件除外\) 导向电邮合作伙伴的重定向服务器。 **示例：** `redirect.example.net`