leads-sdk

Leads SDK 为 iOS 应用提供了一次性按钮，使得从原生应用中捕获线索变得非常简单。线索存储在 Salesforce 销售云 中，销售团队可以从任何移动应用程序中快速采取行动并推动更多销售。

用法

要运行示例项目，请克隆仓库，并首先从 Example 目录运行 pod install。

需求

安装

leads-sdk 通过 CocoaPods 提供。要安装它，只需将以下行添加到您的 Podfile 中：

use_frameworks!

pod "leads-sdk"

或者，要获取最新版本：

use_frameworks!

pod 'leads-sdk' :git => 'https://github.com/quintonwall/leads-sdk.git'

将 LeadsButton 添加到 UIView 中

在您的 storyboard 中，从工具箱拖拽一个标准按钮，然后将其类型更改为 leads 按钮。

然后在属性编辑器中，添加由您的 Salesforce 管理员提供的 Salesforce org id。回退 URL 在移动应用中实际上并不使用。您可以将它设置为默认值。当前 pod 不使用它，但未来的版本可能支持一种类似 webview 的确认方法。

将线索信息传递给 LeadsButton

要添加字段到 LeadsButton，在 ViewController 中创建一个出口，并导入 leads_sdk 模块。

import leads_sdk

class ViewController: UIViewController {

    @IBOutlet weak var myLeadButton: LeadsButton!

添加标准字段

LeadsButton 预配置为支持典型的标准线索字段（名字，姓氏，电子邮件，公司，城市和州）。当使用标准字段时，Salesforce 管理员无需创建自定义的 web-to-lead 字段。只要在 Salesforce org 中启用了 web-to-lead，这就足够了。

  var d :Dictionary = [String: String]()

  //populate the standard fields
  d[Leads.StandardFields.FIRST_NAME] = "Quinton"
  d[Leads.StandardFields.LAST_NAME] = "Wall"
  d[Leads.StandardFields.EMAIL] = "[email protected]"
  d[Leads.StandardFields.COMPANY] = "Salesforce"
  d[Leads.StandardFields.CITY] = "San Francisco"
  d[Leads.StandardFields.STATE] = "CA"

添加自定义字段

销售易商机也支持自定义字段。您的管理员需要使用销售易中的网页转商机功能来生成唯一的自定义字段ID。如果您只需收集标准商机字段，则无需生成网页转商机表单。一旦您有了这些字段ID，只需将它们添加到字典对象中。

  //populate custom fields
  d["00NG000000CZxsC"] = "MyCustomValue"

将商机发送到销售易

一旦您创建了字段字典，将其添加到LeadsButton并调用sendLead()方法。sendLead()还会检查您是否指定了Org Id，如果没有正确设置，则会抛出错误。

  myLeadButton.formFields = d
  do {
         try myLeadButton.sendLead()
    }
    catch Leads.LeadError.NoOrgId {
        print("no org id set!")
    }
    catch Leads.LeadError.CommsFailure {
        //comms problem
    }
    catch {
        //unexpected error
    }

添加主题

LeadsButton已包括三种UI主题

1. 默认：
2. 深色：
3. 图形：

您可以使用以下命令添加主题。如果您未指定任何主题，可以手动设置颜色和样式。

  LeadsThemeManager.applyTheme(LeadsTheme.[Default | Dark | Graphical], leadsbutton: myLeadButton)

示例应用

有关使用LeadsButton的完整示例，请查看此项目中包含的示例应用。

作者

Quinton Wall, @quintonwall

许可

LeadsSDK在MIT许可下可用。有关更多信息，请参阅LICENSE文件。