Inicio rápido para desarrolladores

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

Obtención del SDK

Después de descomprimir el Descarga de SDK, tendrá una carpeta independiente para cada combinación de arquitectura y plataforma admitida. También tendrá un ADBMobileConfig.json que se explica más adelante en esta guía.

Seleccione la versión correcta

Different .dll/ .winmd se proporcionan archivos para cada plataforma de destino (Windows 8.1, Windows Phone 8.1) y arquitectura compatible (x86, x64, ARM). Los archivos se separan en una estructura de carpetas según lo siguiente:

IMPORTANTE

La versión de ADBMobile.winmd no refleja la versión de la biblioteca. La variable .winmd contiene solo metadatos y, como tal, tendrá un número de versión de 255.255.255.255 que es un comportamiento aceptado de acuerdo con Microsoft (consulte ¿Cómo puedo agregar información de ensamblaje para un archivo dll de componente WinRT C++ / CX?). Para comprobar la versión de la biblioteca que está utilizando, compruebe la versión de la ADBMobile.dll archivo.

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 distinto. Tenga en cuenta que cuando consume métodos winmd desde winJS (JavaScript), la primera letra de todos los métodos se hace minúscula automáticamente.

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

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

Agregar 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 Referencias y seleccione Agregar referencia.

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

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

  4. Haga clic en Agregar.

  5. Compruebe que ADBMobile.winmd se selecciona en la variable Administrador de referencias y haga clic en OK.

    NOTA

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

  6. En el Explorador de soluciones, haga clic con el botón derecho Referencias y seleccione Agregar referencia.

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

  7. En el Windows a la izquierda, seleccione Extensiones y, a continuación, seleccione y agregue Microsoft Visual C++ 2013 Runtime Package for Windows.

  8. Agregue la siguiente línea a la clase:

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

  10. Vaya a su ADBMobileConfig.json y haga clic en Agregar.

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

  12. Cambiar Acción de compilación a Contenido.

Agregar la biblioteca y el archivo de configuración al proyecto - C++

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

  2. En el Explorador de soluciones, haga clic con el botón derecho del ratón en el proyecto y seleccione Agregar > Referencias.

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

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

  4. Haga clic en Agregar.

  5. En el Administrador de referencias , compruebe que ADBMobile.winmd está seleccionado y haga clic en OK.

    SUGERENCIA

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

  6. Agregue la siguiente línea a la clase:

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

  8. Vaya a la ADBMobileConfig.json y haga clic en Agregar.

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

  10. En el General pestaña, cambiar Contenido a y haga clic en OK.

Agregar la biblioteca y el archivo de configuración a su proyecto: WinJS

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

  2. En el Explorador de soluciones, haga clic con el botón derecho Referencias y seleccione Agregar referencia.

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

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

  4. Haga clic en Agregar.

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

    SUGERENCIA

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

  6. En el Explorador de soluciones, haga clic con el botón derecho Referencias y seleccione Agregar referencia.

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

  7. En el Windows a la izquierda, seleccione Extensiones y seleccione y agregue Microsoft Visual C++ 2013 Runtime Package for Windows.

  8. Haga clic con el botón derecho del ratón en el proyecto y seleccione Agregar > Elemento existente.

  9. Vaya a la ADBMobileConfig.json y haga clic en Agregar.

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

  11. con Propiedades del archivo seleccionado, asegúrese Acción del paquete está configurado como Contenido.

    Para proyectos JavaScript, el archivo se establece en Contenido de forma predeterminada.

Actualizar el archivo de configuración ADBMobileConfig.json

La variable ADBMobileConfig.json contiene la configuración global de SDK y se encuentra en la raíz del proyecto después de completar los pasos del Agregar la biblioteca y el archivo de configuración a su proyecto para obtener más información. Si su ADBMobileConfig.json Adobe Mobile Services no lo preconfiguró, por lo que deberá actualizar algunos valores para comenzar.

El siguiente es un ejemplo de ADBMobileConfig.json archivo:

{
    "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 utilice:

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

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

Depuración

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

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

C

Haga clic con el botón derecho en el proyecto y seleccione Propiedades > Ficha Depuración. En la lista desplegable Debugger , 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 depurador a Solo nativo.

¡Ya está! Ya está listo para implementar Analytics, Target y Gestión de público en su aplicación Universal App Store para Windows 8.1.

En esta página