Show Menu
主题×

开发人员快速开始

您需要Visual Studio 2013或更高版本来实施SDK。

获取SDK

解压SDK下 载后 ,您将为每个受支持的架构和平台组合提供一个单独的文件夹。 您还将有一个 ADBMobileConfig.json 文件,将在本指南的后面进行说明。

选择正确的版本

每个 .dll 目标 .winmd 平台(Windows 8.1、Windows Phone 8.1)以及支持的架构(x86、x64、ARM)提供不同的/文件。 根据以下规定,将文件分为文件夹结构:
版本不 ADBMobile.winmd 反映库的版本。 文 .winmd 件仅包含元数据,因此将具有根据Microsoft 255.255.255.255 可接受的行为的版本号(请参阅 如何为WinRT C++ / CX组件dll添加程序集信息? )。要检查您所使用的库的版本,请检查基础文件的版 ADBMobile.dll 本。

语法差异

Windows 8.1 Universal App Store库可用于多种编程语言。 本指南中的示例在WinJS(JavaScript)中,如果您使用的是其他语言,则可能需要修改。 请注意,当您使用winJS(JavaScript)中的winmd方法时,所有方法都会自动将其第一个字母小写。
实现之间的主要区别是用于上下文数据的数据结构。
此外,在WinJS项目中使用SDK时,请使用空字符串( "" '' )而不 null 是空字符串值。

将库和配置文件添加到项目- C Sharp

  1. 启动Visual Studio并打开您的解决方案。
  2. 在“解决 方案浏览器 ”中,右键单击“ 引用 ”,然后选 择“添加引用”
  3. 选择库的正确版本并浏览至关联的 ADBMobile.winmd 文件。
    有关详细信息,请参 阅下面的选择正确的版 本部分。
  4. 单击​ 添加
  5. 验证是 ADBMobile.winmd 否在“Reference Manager(引用 管理器)”窗口中选 定,然后单 击“OK(确定) ”。
    在添加对Windows Phone应用程序的引用时,要进行选择, ADBMobile.winmd 请将默认文件过滤器从“组件文 件” 更改为“ 所有文件”
  6. 在“解决 方案浏览器 ”中,右键单击“ 引用 ”,然后选 择“添加引用”
    如果您的解决方案中还包含C++项目,请跳过此步骤。
  7. 在左侧 Windows选项卡中,选 择Extensions ,然后选择并添 加“Microsoft Visual C++ 2013 Runtime Package for Windows ”。
  8. 将以下代码行添加到您的类中:
    using ADBMobile;
    
    
  9. 右键单击您的项目,然后选择“添 ”>“ 现有项目 ”。
  10. 浏览至您的 ADBMobileConfig.json 文件,然后单 击“添加 ”。
  11. 右键单击解决方案 ADBMobileConfig.json 中的文件,然后选择“ 属性”
  12. 将“ 构建操作 ”更 改为内容

Add the library and config file to your project - C++

  1. 启动Visual Studio并打开您的解决方案。
  2. 在“解决 方案浏览器 ”中,右键单击项目并选 择“添加 >“ ​引用”。
  3. 选择库的正确版本,然后添加对关联文件的引 ADBMobile.winmd 用。
    有关详细信息,请参 阅下面的选择正确版 本部分。
  4. 单击​ 添加
  5. 在“Reference Manager (参考管理 器)”窗口中 ADBMobile.winmd ,验证是否已选 中,然后单 ​击“OK”。
    在添加对Windows Phone应用程序的引用时,要进行选择, ADBMobile.winmd 请将默认文件过滤器从“组件文 件” 更改为“ 所有文件”
  6. 将以下代码行添加到您的类中:
    using namespace ADMS::Measurement;
    
    
  7. 右键单击您的项目,然后选择“添 ”>“ 现有项目 ”。
  8. 浏览至文件 ADBMobileConfig.json 并单击“添 加”
  9. 右键单击解决方案 ADBMobileConfig.json 中的文件,然后选择“ 属性”
  10. 在“常规 选项卡上,将“内 ”更 ​改为“是 ”,然 ​后单击“确定”。

Add the library and config file to your project - WinJS

  1. 启动Visual Studio并打开您的解决方案。
  2. 在“解决 方案浏览器 ”中,右键单击“ 引用 ”,然后选 择“添加引用”
    有关详细信息,请参 阅下面的选择正确 版本部分。
  3. 选择库的正确版本,然后浏览至关联的 ADBMobile.winmd 文件。
  4. 单击​ 添加
  5. 验证是 ADBMobile.winmd 否在“Reference Manager(引用 管理器)”窗口中选中 ,然后单 击“OK(确定) ”。
    在添加对Windows Phone应用程序的引用时,要进行选择, ADBMobile.winmd 请将默认文件过滤器从“组件文 件” 更改为“ 所有文件”
  6. 在“解决 方案浏览器 ”中,右键单击“ 引用 ”,然后选 择“添加引用”
    如果您的解决方案中还包含C++项目,请跳过此步骤。
  7. 在左侧 “Windows”选项卡中,选 择“Extensions ,然后选择并添 ​加“Microsoft Visual C++ 2013 Runtime Package for Windows”。
  8. 右键单击您的项目,然后选择“ 添加 ”> “现有项目 ”。
  9. 浏览至文件 ADBMobileConfig.json 并单击“添 加”
  10. 右键单击解决方案 ADBMobileConfig.json] 中的文件,然后选择“ 属性”
  11. 选择 “文件属性 ”,确保将“ 包操作 ”设置为“ 内容”
    对于JavaScript项目,默认情况下将文件设 置为 “内容”。

更新ADBMobileConfig.json配置文件

ADBMobileConfig.json 件包含全局SDK设置,在您完成“将库和配置文件添加到项目”部分中 的步骤后,该文件位于项目根目录 。 如果 ADBMobileConfig.json AdobeMobile Services未预配置文件,您需要更新一些值才能开始。
The following is an example of an ADBMobileConfig.json file:
{ 
    "version" : "1.0", 
    "analytics" : { 
        "rsids" : "coolApp", 
        "server" : "my.CoolApp.com", 
        "charset" : "UTF-8", 
        "ssl" : true, 
        "offlineEnabled" : true, 
        "lifecycleTimeout" : 300, 
        "privacyDefault" : "optedin", 
        "poi" : [ 
                    ["san francisco",37.757144,-122.44812,7000], 
                    ["santa cruz",36.972935,-122.01725,600] 
                ] 
    }, 
 "target" : { 
  "clientCode" : "myTargetClientCode", 
  "timeout" : 1 
 }, 
 "audienceManager" : { 
  "server" : "myServer.demdex.com" 
 } 
}

至少要更新您所使用的解决方案的以下值:
  • 分析 : rsids server
  • Target : clientCode
  • 受众管理 : server
有关详细信息,请 参阅ADBMobileConfig.json配置

调试

当您要启用SDK调试时,您必须致电 ADBMobile.Config.setDebugLogging(true);
对于C Sharp和JS应用程序,您必须完成以下步骤(本机代码调试是C++应用程序的默认设置)以启用本机代码调试:

C Sharp

右键单击项目,选择“属性 >“调 试”选项卡 。 在调试器下拉框中,选择“仅 本机 ”。

JS

右键单击项目,选择“属 ”>“ 配置属性 >“调 ​试”选项卡。 将调试器类型下拉框更改为“仅 限本机 ”。
操作完成!现在,您已准备好在Windows 8.1通用App Store应用程序中实施分析、目标和受众管理。