Guides

iOS initial setup

建议编辑

At a glance: The initial app setup enables the marketer to create links that send existing app users directly into the app. The initial setup is also a prerequisite for deep linking and deferred deep linking.

应用程序打开方法

有两种应用程序打开的方法需要实施才能覆盖整个用户群。使用的方法取决于移动平台版本。

以下各节将详细介绍这两种实现方法和说明。

方法描述iOS版本程序
通用链接Directly opens the mobile app at the default activity. Universal Links take the format of regular web links (e.g. https://yourbrand.onelink.me or https://www.yourbrand.com)iOS 9 及更高版本
  1. 获取应用程序捆绑ID和前缀ID。
  2. 启用关联域。
URI 方案根据URI方案中指定的行为路径直接打开应用程序。iOS所有版本
  1. 与营销人员共同决定URI方案。
  2. 启用关联域。
  3. 测试

iOS通用链接的步骤

Getting the app bundle ID and prefix ID

  1. 登录您的Apple开发者账户。
  2. On the left-hand menu, select Certificates, Identifiers & Profiles.
  3. Under Identifiers, select App IDs.
  4. 点击相关应用程序。
  5. 复制前缀ID和应用程序捆绑ID。
  6. Give the prefix ID and app bundle ID to your marketer.
    The marketer will use it in the AppsFlyer dashboard to register the app.
    certs_apple_info!

Enabling associated domains

要在您的应用程序中支持关联域：

Follow the iOS instructions to add the associated domains entitlement to your app.

Configuring mobile apps to register approved domains

配置移动应用程序以注册获批的域是在Xcode内进行的。它需要您的营销人员生成的OneLink子域。

要配置移动应用程序以注册获批的域：

  1. 从您的营销人员处获取OneLink子域。
  2. 在Xcode中，点击您的项目。
  3. Click on the project target (see the screenshot that follows).
  4. Switch to the Capabilities tab.
  5. Turn on Associated Domain.
  6. Add the subdomain that you got from your marketer.
    The format is applinks:subdomain.onelink.me.

xcode-associated-domains!

📘

To associate a domain with your app, you need to have the associated domain file on your domain and the appropriate entitlement in your app. Once the redirection logic for existing app users is added to the OneLink template configuration, AppsFlyer hosts the apple-app-site-association file.
When a user installs your app, the system attempts to download the associated domain file and verify the domains in your Associated Domains Entitlement.

Universal Link limitations

从浏览器打开应用

Universal Links仅在被点击时起作用。例如，当点击网页或电子邮件中的链接时。把链接粘贴到浏览器地址栏中并不会实现深度链接。

OneLink子域名

由于OneLink子域名随时可以更改，这会导致所有使用该初始子域名的OneLink URL 失效。

社交应用中的 OneLink

并非所有应用程序（包括社交网络应用程序）都完全支持通用链接。如需获取更多详细信息，请参阅本指南。

其他限制和问题

通用链接可能还有其他限制。有关更多详细信息，请访问OneLink故障排除。

URI方案的步骤

URI方案是将用户直接引导到移动应用程序的URL。

当应用程序用户在浏览器地址栏框中输入URI方案，或点击基于URI方案的链接时，应用程序将启动而且用户将被深度链接。

每当通用链接无法打开应用程序时，URI方案可用作打开应用程序的后备方案。

Deciding on a URI scheme

决定URI方案：

  1. Contact the marketer.
  2. 选择URI方案。例如： yourappname://

📘

  • 使用对您的应用和品牌尽可能独特的URI方案，以避免与生态系统中的其他应用同时发生重复。与其他应用程序出现重叠是URI方案协议本质上的固有问题。
  • URI方案不应以http或https开头。
  • URI方案应该在Android和iOS上进行类似的定义。
  1. 将URI方案发送给营销人员，例如 afshopapp://mainactivity.

Adding URI scheme

添加URI方案：

  1. 在Xcode中，打开应用程序信息plist文件。
  2. 添加URL类型条目。
  3. 展开URL类型和Item 0行。
  4. 为URL标识符添加应用程序的唯一标识符作为值。
    最好选择一个不太可能被其他应用程序使用的唯一标识符。
  5. 右键单击URL标识符并选择添加行>URI方案。
  6. 将Item 0值设置为您的独特方案。

info_list_uri_schemes!

Prerequisites:

An iOS device with the app installed. Make sure it is the app source and version where you made changes and implemented Universal Links and URI schemes.

Testing the URI scheme:

  1. 联系营销人员并获取他们创建的自定义链接。
  2. 将营销人员给您的短URL或长URL发送到您的手机上。您可以：
    • 使用手机摄像头或二维码扫描仪应用程序扫描二维码。
    • 通过电子邮件或WhatsApp自己发送链接，然后在手机上打开它。
  3. 点击移动设备上的链接。 应用程序应该会打开它的主屏幕。

If the link doesn't open the app, add the parameter af_force_deeplink=true to the custom attribution link. For example:

https://demo.onelink.me/1aBC/123ab45c?af_force_deeplink=true

URI scheme limitations

Neither Apple nor Google enforces unique naming for app schemes. Choose a scheme name unique to your brand to avoid conflicting schemes across different applications. A good scheme name could be your app bundle ID, for example: com.company.app.

To enable OneLink to serve both iOS and Android, it's important that the same scheme be defined for both platforms.

When a OneLink that has af_force_deeplink=true is opened in iOS 12.3.1, the following logic applies:

  • 显示一个对话框，询问用户是否安装了该应用程序：
    • If the user chooses OK (app is installed), AppsFlyer attempts to open the app using URI scheme.
    • If the user chooses Cancel (app is not installed), AppsFlyer redirects the user to the app store.
    • 如果用户选择“确定”但并未安装该应用程序，则会显示错误信息：

uri_cannot_open_page!

已更新 5 months ago