Thunderhead 10.0.1

Thunderhead 10.0.1

×

由 Thunderhead 维护。

Thunderhead 10.0.1

  • 作者
  • Thunderhead ONE

Thunderhead SDK

资源

目录

对于原生集成，只需按照安装和配置部分中的说明进行操作，即可快速将 SDK 集成到您的应用中。

先决条件

  • 安装以下内容

    • Xcode 14.0或更高版本

    • CocoaPods 1.10.0或更高版本

  • 确保你的项目符合以下要求

    • 你的项目必须针对iOS 11或更高版本。

  • 设置一个物理iOS设备或使用iOS模拟器运行你的应用。

注意

  • Xcode版本小于13.0仅支持在没有bitcode的情况下存档应用程序。

步骤1：将Thunderhead SDK添加到你的应用中

我们建议使用CocoaPods安装Thunderhead SDK。但是，如果你不想使用CocoaPods，你可以直接集成SDK框架（见“手动安装”）或使用Swift Package Manager。

CocoaPods

通过CocoaPods进行集成，请按照CocoaPods集成指南进行。

Swift Package Manager

通过Swift Package Manager进行集成，请按照SPM集成指南进行。

手动安装

对于手动集成，请遵循手动集成指南。

步骤 2：配置生物识别认证

SDK 支持在管理员模式下使用生物识别认证（Touch ID / Face ID）

注意

  • 要使用 Face ID 认证，您需要在 Info.plist 文件中添加
<key>NSFaceIDUsageDescription</key>
<string>Why is my app authenticating using face id?</string>

。未执行此操作会导致出现对话框，通知用户您的应用程序未提供 Face ID 使用说明。

步骤 3：配置 iOS 无代码 Thunderhead SDK

通过执行以下步骤，使您的应用程序能够自动识别应用中的 交互

初始化 SDK

完成以下步骤以初始化 SDK。

导入SDK模块

  1. 打开您的App Delegate文件。
  2. 在文件的顶部，在您的导入语句下方添加以下行
Swift:
```swift
import Thunderhead
```

Objective-C:
```objective-c
@import Thunderhead;
```

为App Store构建设置SDK为用户模式

要开始使用Thunderhead SDK在用户模式下跟踪、抓取和接收优化，您必须首先使用Thunderhead API参数对其进行初始化。您可以在Thunderhead ONE或Salesforce Interaction Studio中的“API凭证”页面上找到您的Thunderhead API参数。

有关查找这些参数的更多信息

有了您的参数后，请将以下行添加到didFinishLaunchingWithOptions的顶部

Swift

One.startSessionWithSK("ONE-XXXXXXXXXX-1022",
                    uri:"myAppsNameURI",
                 apiKey:"f713d44a-8af0-4e79-ba7e-xxxxxxxxxxxxxxxx",
           sharedSecret:"bb8bacb2-ffc2-4c52-aaf4-xxxxxxxxxxxxxxxx",
                 userId:"api@yourCompanyName", // For Interaction Studio integrations use a numeric user id - see https://permalink.thunderhead.com/mobile-docs/is-mobile-integration-info-credentials
              adminMode:false,
               hostName:"eu2.thunderhead.com")

Objective-C

[One startSessionWithSK:@"ONE-XXXXXXXXXX-1022"
                    uri:@"myAppsNameURI"
                 apiKey:@"f713d44a-8af0-4e79-ba7e-xxxxxxxxxxxxxxxx"
           sharedSecret:@"bb8bacb2-ffc2-4c52-aaf4-xxxxxxxxxxxxxxxx"
                 userId:@"api@yourCompanyName" // For Interaction Studio integrations use a numeric user id - see https://permalink.thunderhead.com/mobile-docs/is-mobile-integration-info-credentials
              adminMode:NO
               hostName:@"eu2.thunderhead.com"];

为内部分发设置SDK为管理模式

我们建议在您的内部构建中添加管理模式功能，在调试设置功能或专用构建管道后面，如此处所述。

要在管理模式下使用框架，只需将adminMode布尔值更改为true，如下所示

Swift

One.startSessionWithSK("ONE-XXXXXXXXXX-1022",
                    uri:"myAppsNameURI",
                 apiKey:"f713d44a-8af0-4e79-ba7e-xxxxxxxxxxxxxxxx",
           sharedSecret:"bb8bacb2-ffc2-4c52-aaf4-xxxxxxxxxxxxxxxx",
                 userId:"api@yourCompanyName", // For Interaction Studio integrations use a numeric user id - see https://permalink.thunderhead.com/mobile-docs/is-mobile-integration-info-credentials
              adminMode:true,
               hostName:"eu2.thunderhead.com")

Objective-C

[One startSessionWithSK:@"ONE-XXXXXXXXXX-1022"
                    uri:@"myAppsNameURI"
                 apiKey:@"f713d44a-8af0-4e79-ba7e-xxxxxxxxxxxxxxxx"
           sharedSecret:@"bb8bacb2-ffc2-4c52-aaf4-xxxxxxxxxxxxxxxx"
                 userId:@"api@yourCompanyName" // For Interaction Studio integrations use a numeric user id - see https://permalink.thunderhead.com/mobile-docs/is-mobile-integration-info-credentials
              adminMode:YES
               hostName:@"eu2.thunderhead.com"];

注意

  • 支持管理模式和用户模式的动态配置。

您现在已成功集成了iOS的无代码Thunderhead SDK。

额外的无代码集成注意事项

针对 Salesforce Interaction Studio 集成

当与 Salesforce Interaction Studio 集成时，您可以设置管理员模式主题以匹配 Interaction Studio 的外观和感观，具体如下

Swift

One.setTheme(OneTheme.InteractionStudio)

Objective-C

 [One setTheme:OneThemeInteractionStudio];

注意

  • 默认情况下，SDK 将使用 Thunderhead ONE 主题启动。如果您是 Salesforce 客户，才应使用 Interaction Studio 主题。

ViewController/View 生命周期覆盖规则

框架监听多个 UIViewController 和 UIView 方法以提供所需的功能。这些方法包括

  • viewWillAppear
  • viewDidAppear
  • viewWillDisappear
  • didMoveToWindow

如果您在这些方法中使用了这些方法，请确保在实现时调用 super。

基于交互图发送交互请求

为了减少SDK自动发送的不必要交互请求的数量，只有与非编码交互相关且在触点下创建的具有明确交互路径，至少配置了一个点的非编码交互才会发送到Thunderhead ONE或Salesforce Interaction Studio。此配置更改已经在iOS SDK的5.3.0版本中引入。

注意

  • 如果非编码交互是在触点下创建的，或者与触点下定义的通配符规则匹配，SDK才会发送非编码交互。
  • 为了使SDK发送非编码交互，此交互至少需要包含一个活动捕捉点、属性捕捉点和一个或多个优化点。
  • 如果您正在以用户模式运行SDK，您需要确保在SDK触发请示之前，所有交互以及相关的点都已经完全发布。

Thunderhead SDK的其他功能

有关Thunderhead SDK的附加功能，请参阅附加功能指南。

故障排除指南

在Thunderhead和iOS项目遇到问题？请访问故障排除指南

问题或需要帮助

Salesforce Interaction Studio支持

有关Salesforce营销云交互工作室的问题，请通过https://help.salesforce.com/home提交支持工单。.

雷电头ONE支持

有关雷电头ONE的问题，请通过https://support.thunderhead.com提交支持工单。.