Show Menu
화제×

Developer quick start

SDK를 구현하려면 Visual Studio 2013 이상이 필요합니다.

SDK 가져오기

SDK 다운로드 를 압축 해제하면 지원되는 각 아키텍처 및 플랫폼 조합에 대해 별도의 폴더가 있습니다. 이 가이드의 뒷부분에 설명된 ADBMobileConfig.json 파일도 있습니다.

Select the correct version

Different .dll / .winmd files are provided for each target platform (Windows 8.1, Windows Phone 8.1), and supported architecture (x86, x64, ARM). 파일은 다음에 따라 폴더 구조로 구분됩니다.
The version of ADBMobile.winmd does not reflect the version of the library. The .winmd file contains metadata only, and as such will have a version number of 255.255.255.255 which is accepted behavior according to Microsoft (see How do I add assembly information for a WinRT C++ / CX component dll? 참조). To check the version of the library you are using, check the version of the underlying ADBMobile.dll file.

Syntax differences

Windows 8.1 Universal App Store 라이브러리는 여러 프로그래밍 언어로 사용할 수 있습니다. 이 가이드의 예는 WinJS(JavaScript)로 작성되어 있으므로 다른 언어를 사용하는 경우에는 수정해야 할 수 있습니다. winJS(JavaScript)에서 winmd 메서드를 사용할 때 모든 메서드에서 첫 번째 문자가 자동으로 소문자가 됩니다.
구현 간의 주요 차이점은 컨텍스트 데이터에 사용되는 데이터 구조입니다.
Additionally, when using the SDK in a WinJS project, use an empty string ( "" or '' ) instead of null for empty string values.

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

  1. Visual Studio를 시작하고 솔루션을 엽니다.
  2. In the Solution Explorer , right-click References and select #.
  3. Select the correct version of the library and browse to the associated ADBMobile.winmd file.
    자세한 내용은 아래 올바른 버전 선택 섹션을 참조하십시오.
  4. 추가를 클릭합니다 .
  5. Verify that ADBMobile.winmd is selected in the Reference Manager window and click OK .
    Windows Phone 앱에 대한 참조를 추가할 때 ADBMobile.winmd 선택하려면 기본 파일 필터를 구성 요소 파일에서 모든 파일로 변경하십시오 .
  6. 솔루션 탐색기 ​에서 참조 ​를 마우스 오른쪽 버튼으로 클릭하고 참조 추가를 선택합니다 .
    솔루션에 C++ 프로젝트가 있는 경우 이 단계를 건너뛸 수 있습니다.
  7. In the Windows tab on the left, select Extensions, then select and add Microsoft Visual C++ 2013 Runtime Package for Windows.
  8. 다음 줄을 클래스에 추가합니다.
    using ADBMobile;
    
    
  9. Right-click you your project and select Add > Existing Item .
  10. 파일을 찾아 ADBMobileConfig.json 추가를 클릭합니다 .
  11. Right-click the ADBMobileConfig.json file in your solution and select Properties .
  12. Change Build Action to Content .

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

  1. Visual Studio를 시작하고 솔루션을 엽니다.
  2. In the Solution Explorer , right-click your project and select Add > References .
  3. Select the correct version of the library and then add a reference to the associated ADBMobile.winmd file.
    자세한 내용은 아래 올바른 버전 선택 섹션을 참조하십시오.
  4. 추가를 클릭합니다 .
  5. In the Reference Manager window, verify that is selected and click OK. ADBMobile.winmd
    When adding a reference to a Windows Phone app, to select , change the default file filter from Component Files to All Files. ADBMobile.winmd
  6. 다음 줄을 클래스에 추가합니다.
    using namespace ADMS::Measurement;
    
    
  7. Right-click you your project and select Add > Existing Item .
  8. 파일을 ADBMobileConfig.json 찾아 추가를 클릭합니다 .
  9. Right-click the ADBMobileConfig.json file in your solution and select Properties .
  10. On the General tab, change Content to Yes , and click OK .

Add the library and config file to your project - WinJS

  1. Visual Studio를 시작하고 솔루션을 엽니다.
  2. In the Solution Explorer , right-click References and select [Add Reference .
    자세한 내용은 아래 올바른 버전 선택 섹션을 참조하십시오.
  3. Select the correct version of the library and then browse to the associated ADBMobile.winmd file.
  4. 추가를 클릭합니다 .
  5. Verify that ADBMobile.winmd is checked in the Reference Manager window and click OK .
    Windows Phone 앱에 대한 참조를 추가할 때 ADBMobile.winmd 선택하려면 기본 파일 필터를 구성 요소 파일에서 모든 파일로 변경하십시오 .
  6. 솔루션 탐색기 ​에서 참조 ​를 마우스 오른쪽 버튼으로 클릭하고 참조 추가를 선택합니다 .
    솔루션에 C++ 프로젝트가 있는 경우 이 단계를 건너뛸 수 있습니다.
  7. 왼쪽의 Windows 탭에서 확장을 선택하고 Windows용 Microsoft Visual C++ 2013 런타임 ​패키지를선택하여 추가합니다.
  8. Right-click your project and select Add > Existing Item .
  9. 파일을 ADBMobileConfig.json 찾아 추가를 클릭합니다 .
  10. Right-click the ADBMobileConfig.json] file in your solution and select Properties .
  11. [ 파일 속성 ]을 선택한 상태에서 [패키지 작업 ]을 [ #로] ​설정해야 합니다.
    JavaScript 프로젝트의 경우 기본적으로 파일이 컨텐츠로 설정됩니다.

Update the ADBMobileConfig.json config file

The ADBMobileConfig.json file contains global SDK settings, and is located at your project root after you complete the steps in the Add the Library and Config File to your Project section. If your ADBMobileConfig.json file was not pre-configured by Adobe Mobile Services, you need to update a few values to get started.
다음은 ADBMobileConfig.json 파일 예제입니다.
{ 
    "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
For more details, see ADBMobileConfig.json config .

디버깅

SDK에 디버깅을 사용하려면 ADBMobile.Config.setDebugLogging(true); );를 호출해야 합니다.
C Sharp 및 JS 앱의 경우 다음 단계를 완료하여 기본 코드 디버깅을 활성화해야 합니다(기본 코드 디버깅은 C++ 앱의 기본 설정).

C Sharp

Right-click the project, select Properties > Debug tab . In the debugger drop-down, select Native Only.

JS

Right-click the project, select Properties > Configuration Properties > Debug tab . 디버거 유형 드롭다운을 기본 ​으로 변경합니다.
그러면 됩니다! 이제 Windows 8.1 Universal App Store 앱에서 Analytics, Target 및 고객 관리를 구현할 준비가 되었습니다.