Show Menu
TEMAS×

Developer quick start

A continuación encontrará información sobre cómo implementar la biblioteca de la Plataforma universal de Windows.
Para implementar el SDK, necesita Visual Studio 2013 o posterior.

Obtención del SDK

After you unzip the SDK download file, you will have a separate folder for each supported architecture and platform combination. También tendrá un ADBMobileConfig.json archivo. Para obtener más información sobre este archivo, consulte Archivo de configuración ADBMobileConfig.json.

Select the correct version

Different .dll/.winmd files are provided for each supported architecture (x86, x64, ARM).
The version of ADBMobile.winmd does not reflect the version of the library. El .winmd archivo solo contiene metadatos y tiene un número de versión de 255.255.255.255 , que es un comportamiento aceptado según Microsoft. Para obtener más información, consulte ¿Cómo agrego información de ensamblado para un archivo DLL de componente WinRT C++ / CX? . To check the version of the library you are using, check the version of the underlying ADBMobile.dll file.

Diferencias sintácticas

La biblioteca de la Plataforma universal de Windows se puede emplear en varios lenguajes de programación. Los ejemplos de esta guía están en WinJS (JavaScript), si utiliza un lenguaje diferente, puede que sea necesario modificarlos. When you consume winmd methods from winJS, all methods automatically have their first letter lowercased.
La diferencia principal entre las implementaciones radica en la estructura de datos usada para los datos de contexto. 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#

  1. Inicie Visual Studio y abra la solución.
  2. In the Solution Explorer , right-click References and select Add Reference .
  3. Seleccione la versión correcta de la biblioteca y busque el archivo ADBMobile.winmd asociado.
    Para obtener más información, consulte Seleccionar la sección de la versión correcta en esta página.
  4. Haga clic en Agregar .
  5. Verify that the ADBMobile.winmd file is checked in the Reference Manager window and click OK .
  6. In the Solution Explorer , right-click References and select Add Reference .
    Si también tiene un proyecto de C++ en la solución, omita este paso.
  7. En la ficha Windows de la izquierda, seleccione Extensiones , seleccione y agregue Tiempo de ejecución de Visual C++ 2015 para aplicaciones de la Plataforma universal de Windows.
  8. Agregue la siguiente línea a la clase:
    using ADBMobile;
    
    
  9. Right-click your project and click Add > Existing Item .
  10. Browse to the ADBMobileConfig.json file and click Add .
  11. Haga clic con el botón derecho en el ADBMobileConfig.json archivo de la solución y seleccione Propiedades .
  12. Cambie Acción de compilación a Contenido .

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

  1. Inicie Visual Studio y abra la solución.
  2. In the Solution Explorer , right-click your project and select Add > References .
  3. Seleccione la versión correcta de la biblioteca y agregue una referencia al archivo ADBMobile.winmd asociado.
    Para obtener más información, consulte Seleccionar la sección de la versión correcta en esta página.
  4. Haga clic en Agregar .
  5. Verifique que ADBMobile.winmd esté marcado en la ventana Administrador de referencias y haga clic en Aceptar .
  6. Agregue la siguiente línea a la clase:
    using namespace ADBMobile;
    
    
  7. Right-click your project and select Add > Existing Item .
  8. Browse to ADBMobileConfig.json file and click Add .
  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. Inicie Visual Studio y abra la solución.
  2. In the Solution Explorer , right-click References and select Add Reference .
  3. Seleccione la versión correcta de la biblioteca y busque el archivo ADBMobile.winmd asociado.
  4. Haga clic en Agregar .
  5. Verify that the ADBMobile.winmd file is checked in the Reference Manager window and click OK .
  6. In the Solution Explorer , right-click References and select Add Reference .
    Si también tiene un proyecto de C++ en la solución, omita este paso.
  7. En la ficha Windows de la izquierda, seleccione Extensiones y seleccione y agregue Tiempo de ejecución de Visual C++ 2015 para aplicaciones de la Plataforma universal de Windows.
  8. Right-click your project and select Add > Existing Item .
  9. Browse to the ADBMobileConfig.json file and click Add .
  10. Right-click the ADBMobileConfig.json file in your solution and select Properties .
  11. Una vez seleccionadas las propiedades del archivo, asegúrese de que la acción de paquete está establecida en Contenido .
    Para proyectos JavaScript, el archivo se establece en Contenido de forma predeterminada.

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.
Este es un ejemplo de archivo 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" 
 } 
}

Como mínimo, actualice los siguientes valores para las soluciones que está utilizando:
  • Adobe Analytics : rsids y server
  • Adobe Target : clientCode
  • Adobe Audience Manager : server
Para obtener más información, consulte Métodos SDK .

Depuración

Para habilitar la depuración para el SDK, llame ADBMobile.Config.setDebugLogging(true); .
For C Sharp and JavaScript apps, you need to enable native code debugging by completing the following steps (native code debugging is the default setting for C++ apps):

C

  1. Right-click the project, click Properties > Debug tab.
  2. Cambie el menú desplegable de tipo de depurador a Solo nativo .

JavaScript

  1. Right-click the project, click Properties > Configuration Properties > Debug tab .
  2. Cambie el menú desplegable de tipo de depurador a Solo nativo .
¡Ya está! Ya está todo listo para implementar Analytics, Target y Gestión de público en la aplicación de la Plataforma universal de Windows.