Inicio rápido para desarrolladores

Necesitará Visual Studio 2013 o posterior para implementar el SDK.

Obtención del SDK

Después de descomprimir la descarga delSDK, dispondrá de una carpeta independiente para cada combinación de arquitectura y plataforma admitida. También tendrá un ADBMobileConfig.json archivo que se explicará más adelante en esta guía.

Select the correct version

Se proporcionan diferentes archivos .dll/ .winmd para cada plataforma de destinatario (Windows 8.1, Windows Phone 8.1) y arquitectura compatible (x86, x64, ARM). Los archivos se separan en una estructura de carpetas de acuerdo con lo siguiente:

IMPORTANT

La versión de ADBMobile.winmd no refleja la versión de la biblioteca. El .winmd archivo solo contiene metadatos y, como tal, tendrá un número de versión 255.255.255.255 cuyo comportamiento aceptado según Microsoft (consulte ¿Cómo agrego información de ensamblado para un archivo DLL de componente WinRT C++ / CX?). Para comprobar la versión de la biblioteca que está utilizando, compruebe la versión del ADBMobile.dll archivo subyacente.

Diferencias de sintaxis

La biblioteca Universal App Store para Windows 8.1 se puede utilizar en varios lenguajes de programación. Los ejemplos de esta guía están en WinJS (JavaScript) y es posible que deban modificarse si utiliza un idioma diferente. Tenga en cuenta que cuando consume métodos winmd de winJS (JavaScript), todos los métodos automáticamente tienen su primera letra minúscula.

La principal diferencia entre las implementaciones es la estructura de datos utilizada para los datos de contexto.

Además, al utilizar el SDK en un proyecto WinJS, utilice una cadena vacía ( "" o '') en lugar de null para valores de cadena vacíos.

Añadir la biblioteca y el archivo de configuración al proyecto: C Sharp

  1. Inicie Visual Studio y abra la solución.

  2. En el Explorador de soluciones, haga clic con el botón derecho en Referencias y seleccione Añadir referencia.

  3. Seleccione la versión correcta de la biblioteca y busque el ADBMobile.winmd archivo asociado.

    Para obtener más información, consulte la sección Seleccionar la versión correcta a continuación.

  4. Haga clic en Agregar.

  5. Compruebe que ADBMobile.winmd esté seleccionado en la ventana Administrador de referencias y haga clic en Aceptar.

    NOTE

    Al agregar una referencia a una aplicación de Windows Phone, para seleccionarla ADBMobile.winmd, cambie el filtro de archivos predeterminado de Archivos de componentes a Todos los archivos.

  6. En el Explorador de soluciones, haga clic con el botón derecho en Referencias y seleccione Añadir referencia.

    Omita este paso si también tiene un proyecto de C++ en la solución.

  7. En la ficha Windows de la izquierda, seleccione Extensiones y, a continuación, seleccione y agregue Paquete de tiempo de ejecución de Microsoft Visual C++ 2013 para Windows.

  8. Añada la línea siguiente en la clase:

    using ADBMobile;
    
  9. Haga clic con el botón derecho en el proyecto y seleccione Añadir > Elemento ​existente.

  10. Vaya al ADBMobileConfig.json archivo y haga clic en Añadir.

  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 por Contenido.

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

  1. Inicie Visual Studio y abra la solución.

  2. En el Explorador de soluciones, haga clic con el botón derecho en el proyecto y seleccione Añadir > Referencias.

  3. Seleccione la versión correcta de la biblioteca y, a continuación, agregue una referencia al ADBMobile.winmd archivo asociado.

    Para obtener más información, consulte la sección Seleccionar la versión correcta a continuación.

  4. Haga clic en Agregar.

  5. En la ventana Administrador de referencias, verifique que ADBMobile.winmd esté seleccionado y haga clic en Aceptar.

    TIP

    Al agregar una referencia a una aplicación de Windows Phone, para seleccionarla ADBMobile.winmd, cambie el filtro de archivos predeterminado de Archivos de componentes a Todos los archivos.

  6. Añada la línea siguiente en la clase:

    using namespace ADMS::Measurement;
    
  7. Haga clic con el botón derecho en el proyecto y seleccione Añadir > Elemento ​existente.

  8. Vaya al ADBMobileConfig.json archivo y haga clic en Añadir.

  9. Haga clic con el botón derecho en el ADBMobileConfig.json archivo de la solución y seleccione Propiedades.

  10. En la ficha General , cambie Contenido a y haga clic en Aceptar.

Add the library and config file to your project - WinJS

  1. Inicie Visual Studio y abra la solución.

  2. En el Explorador de soluciones, haga clic con el botón derecho en Referencias y seleccione Añadir referencia.

    Para obtener más información, consulte Seleccionar la sección Versión correcta más abajo.

  3. Seleccione la versión correcta de la biblioteca y, a continuación, busque el ADBMobile.winmd archivo asociado.

  4. Haga clic en Agregar.

  5. Compruebe que ADBMobile.winmd está marcado en la ventana Administrador de referencias y haga clic en Aceptar.

    TIP

    Al agregar una referencia a una aplicación de Windows Phone, para seleccionarla ADBMobile.winmd, cambie el filtro de archivos predeterminado de Archivos de componentes a Todos los archivos.

  6. En el Explorador de soluciones, haga clic con el botón derecho en Referencias y seleccione Añadir referencia.

    Omita este paso si también tiene un proyecto de C++ en la solución.

  7. En la ficha Windows de la izquierda, seleccione Extensiones y seleccione y agregue Paquete de tiempo de ejecución de Microsoft Visual C++ 2013 para Windows.

  8. Haga clic con el botón derecho en el proyecto y seleccione Añadir > Elemento ​existente.

  9. Vaya al ADBMobileConfig.json archivo y haga clic en Añadir.

  10. Haga clic con el botón derecho en el ADBMobileConfig.json] archivo de la solución y seleccione Propiedades.

  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.

Actualizar el archivo de configuración ADBMobileConfig.json

El ADBMobileConfig.json archivo contiene la configuración global del SDK y se encuentra en la raíz del proyecto después de completar los pasos en la sección Añadir la biblioteca y el archivo de configuración a su proyecto . Si Adobe Mobile Services no ha preconfigurado el ADBMobileConfig.json archivo, deberá actualizar algunos valores para empezar.

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" 
 } 
}

Como mínimo, actualice los siguientes valores para las soluciones que está utilizando:

  • Analytics: rsids y server
  • Target: clientCode
  • Audience Manager: server

Para obtener más información, consulte ADBMobileConfig.json config.

Depuración

Cuando desee habilitar la depuración para el SDK, debe llamar a ADBMobile.Config.setDebugLogging(true);.

Para las aplicaciones de C Sharp y JS, debe activar la depuración de código nativo completando los siguientes pasos (la depuración de código nativo es la configuración predeterminada para las aplicaciones de C++):

C Sharp

Haga clic con el botón derecho en el proyecto y seleccione Propiedades > ficha Depurar. En la lista desplegable del depurador, seleccione Solo nativo.

JS

Haga clic con el botón derecho en el proyecto y seleccione Propiedades > Propiedades ​de configuración > ficha ​Depuración. Cambie la lista desplegable de tipo de depurador a Solo nativo.

¡Ya está! Ya está listo para implementar Analytics, Destinatario y administración de Audiencias en la aplicación Universal App Store para Windows 8.1.

En esta página