Novedades de AdAttributionKit

Hola, soy Mike, ingeniero del equipo de ingeniería de App Store. Compartiré las funciones de AdAttributionKit creadas para desarrolladores de apps. Hola, soy Yuchi, ingeniero del equipo de Ingeniería de Comercio y hoy compartiré nuevas funciones para configurar la atribución y recibir nuevos datos si eres consumidor de postbacks.

En Apple, creemos que la privacidad es un derecho humano fundamental. Por eso creamos AdAttributionKit desde cero para ayudar a los anunciantes a medir el éxito de sus campañas publicitarias preservando la privacidad de los usuarios. Comenzaré con un resumen de cómo funciona. Un flujo de AdAttributionKit consta de tres partes diferentes. Una red publicitaria es responsable de crear y entregar una publicidad útil a la app de editor.

La app del editor se encargará de mostrar un anuncio de la app anunciada. Por último, la app anunciada mide la participación mediante las acciones de personas desde dentro de su app. Cada actor desempeña un rol en puntos del flujo de extremo a extremo AdAttributionKit.

Un flujo de extremo a extremo comienza con una red que crea una publicidad útil para app. Luego, la red publicitaria envía una carga publicitaria útil a la app del editor, la cual le mostrará un anuncio a alguien.

Alguien puede interactuar con un anuncio viéndolo o tocándolo, lo que genera una conversión de instalación o de reactivación.

Una conversión de instalación ocurre cuando alguien instala tu app desde la App Store o tienda alternativa como resultado de la interacción con anuncio.

Las conversiones de reactivación ocurren al interactuar con un anuncio de una app ya instalada, lo que lo lleva a la app anunciada.

Cuando se produce una conversión, el anunciante mide las interacciones y el compromiso dentro de su app. Una vez finalizada la ventana de conversión, los datos que representan las mediciones de conversión y participación se transmiten en forma de postback a la red publicitaria. Y eso completa un flujo de extremo a extremo de AdAttributionKit. Si no está familiarizado, AdAttributionKit se lanzó con iOS 17.4 e incluyó soporte para conversiones de instalaciones. Agregamos soporte para reactivación con iOS 18. Para un repaso de cómo empezar a usar AdAttributionKit, consulta nuestra sesión de la WWDC24, "Meet AdAttributionKit". Con eso en mente, nos complace mostrarte las nuevas funciones que desarrollamos para mejorar el flujo de extremo a extremo.

Si eres desarrollador de una app, te mostraré nuevas y potentes funciones para flujos de medición y pruebas que puedes usar en la app. Si eres una red publicitaria o un consumidor de datos descendente, Yuchi compartirá las mejoras que creamos para tus flujos de atribución y los nuevos datos en los postbacks.

Dividimos esta charla en cuatro partes. Primero, veremos las etiquetas de conversión, que te permiten medir conversiones de reactivación superpuestas dentro de tu app.

Luego, Yuchi explicará cómo personalizar las reglas de atribución para tu app y analizará los nuevos datos geográficos que agregamos a los postbacks.

Finalmente, explicaré cómo probar la implementación de AdAttributionKit con la nueva capacidad de prueba en la app de Configuración de iOS.

Cómo se pueden medir las ventanas de conversión superpuestas.

Centrémonos en el flujo de reactivación en el diagrama de extremo a extremo. Hasta iOS 18.3, tu app solo puede tener una conversión de reactivación activa en cualquier momento.

A partir de iOS 18.4, tu app puede tener múltiples ventanas de conversión de reactivación activas al mismo tiempo. Tu app puede recibir etiquetas de conversión, que son marcadores de conversión. Puedes utilizar etiquetas para especificar qué conversión de reactivación actualizar. Mira un escenario en que utilizarías etiquetas de conversión. Como desarrollador, puedes hacer campañas de reactivación para promover las diferentes ventas a los clientes en tu app.

Un cliente podría ver un anuncio que promociona un descuento en tu app y tocarlo. Esa interacción los vinculará con tu app y creará una conversión de reactivación. Después de unos minutos, abandonan tu app sin comprar. En el mismo escenario, unas horas más tarde el mismo cliente ve otro anuncio que promociona un segundo artículo con descuento en tu app y decide tocar el anuncio. Esto crea otra conversión de reactivación en el sistema. Después de un tiempo en la app, decide regresar y comprar el primer artículo con descuento. Al utilizar etiquetas de conversión, puedes actualizar el valor de conversión de la conversión original correspondiente al Descuento 1. Esto será muy útil si ejecutas campañas de reactivación para varios productos en tu app al mismo tiempo. Para comenzar a medir ventanas de conversión superpuestas, configura la clave EligibleForAdAttributionKitOverlappingConversions en SÍ en Info.plist de tu app. Sin esto, las conversiones anteriores continuarán bloqueándose cuando se superpongan, como antes. Te mostraré cómo obtener etiquetas de conversión.

Una vez que tu app se incluya se agregarán etiquetas de conversión a la URL de reactivación que AdAttributionKit envía a tu app cuando se produce una reactivación. Las URL de reactivación son enlaces que se pasan a las API al haber un anuncio renderizado personalizado o en StoreKit en la pantalla. La etiqueta se entrega como el parámetro de apertura de reactivación de AdAttributionKit. En esta URL, la etiqueta es igual a 1.

Al recibir la app la URL de reactivación, extrae la etiqueta de conversión con una función igual. Voy a desglosar lo que pasa. Primero, la función obtiene los componentes de la URL que se pasaron mediante URLComponents. Obtiene la lista de consulta. AdAttributionKit agrega un parámetro de apertura de reactivación si la app se abrió por una reactivación.

Después, examina la lista de parámetros de consulta adjuntos en la URL. Si encuentra el parámetro de reactivación abierto, devolverá el valor del parámetro inmediatamente. Si no puede encontrarlo de consulta, la función devolverá cero.

Ya que tienes la etiqueta de conversión, puedes usarla para actualizarla directamente.

Recomendamos asociar las etiquetas de conversión con la conversión de reactivación que la creó para que pueda vincular eventos significativos que resultan de esa conversión.

También debes almacenar la etiqueta de conversión en tu app o del lado del servidor.

Cuando un cliente realice una acción en su app que deseas medir para esa conversión específica, recupera la etiqueta para esa conversión.

Te mostraré cómo usar una etiqueta de conversión para actualizar una conversión en el código.

Esta función toma un valor de conversión en la etiqueta para actualizar un postback específico. Al inicializar una estructura PostbackUpdate, pasa la etiqueta para la conversión que deseas actualizar. Puedes llamar la API de Postback para actualizar el valor de conversión.

También puedes llamar la API updateConversionValue sin una etiqueta de conversión y el sistema actualizará los postbacks de conversiones recientes. Y puedes usar etiquetas de conversión para actualizar postbacks al tener ventanas superpuestas. Medir la conversión de postbacks es solo una pieza del rompecabezas al usar AdAttributionKit. La interpretación de datos de postback que recibes después es un aspecto importante y justifica las decisiones de marketing que tomas en el negocio. Yuchi, ¿tienes actualizaciones para compartir? Claro que sí. Algunas nuevas características para consumir e interpretar mejor los datos que recibes. Para capturar las señales más significativas en tus datos de postback, agregamos la capacidad de personalizar las reglas de atribución para tu app, lo que permite ajustar tu flujo de atribución.

Hay dos formas para ajustar tu flujo de atribución. La primera es la ventana de atribución configurable.

AdAttributionKit revisa el flujo de atribución de anuncios de extremo a extremo y realiza la atribución según la actualidad y tipo de anuncio.

Los dos tipos de anuncios admitidos por AdAttributionKit son los de clic y los de visualización.

Estos anuncios suelen apuntar a un horizonte temporal diferente. Por ejemplo, el objetivo de un anuncio de clic podría ser impulsar conversiones en 10 días. Cuando una conversión ocurre después del periodo objetivo, digamos 20 días después del momento de visualización de la impresión, esta conversión ya no debería considerarse impulsada por este anuncio. Y este periodo de segmentación de anuncios es lo que llamamos ventana de atribución. La ventana de atribución es el periodo que comienza desde el momento de visualización del anuncio hasta el último momento en el que se considera para la atribución. Si la conversión ocurre dentro de la ventana de atribución de un anuncio, este anuncio competiría por la atribución de esta conversión. De lo contrario, no competiría por la atribución de esta conversión. Antes, todos los anuncios de clic con menos de 30 días de antigüedad y de visualización con menos de 1 día de antigüedad se consideraban para la atribución. Queríamos que este periodo fuera flexible para ti y por eso presentamos una ventana de atribución configurable. Como anunciante, puede especificar la duración de la ventana de atribución deseada en el archivo Info.plist. Este ejemplo utiliza un archivo JSON para ilustrar las configuraciones, pero se pueden usar las mismas claves y estructura al editar el archivo Info.plist de tu app. La ventana de atribución se puede definir por red publicitaria y por tipo de interacción publicitaria, que son anuncios de visualización y anuncios de clic. Este es un ejemplo. Para la red publicitaria com.example.adNetwork, el anunciante especificó una ventana de atribución de dos días para anuncios de clic y de un día para anuncios de visualización. Si un socio de una red publicitaria se centra principalmente en un tipo de anuncio, tal vez quieras ignorar otros tipos de anuncios de esa red publicitaria. Puede hacerlo especificando la clave ignoreInteractionType. Esta se puede configurar para "ver" o "hacer clic", pero no para ambas a la vez. Si trabajas con múltiples redes publicitarias, especificar la duración de la ventana de atribución una por una puede ser mucho trabajo. En este caso, puedes especificar una duración de ventana para todas las redes publicitarias con las que trabajas agregando la clave global, que se aplica a todas las redes por defecto. Además de la duración de la ventana global, puedes configurar la duración de la ventana de atribución para redes publicitarias específicas, que tendrá prioridad sobre la configuración global. Si no se encuentra red publicitaria ni configuración global, recurriremos a la duración de la ventana de atribución por predeterminada. En el ejemplo, la ventana de atribución para los anuncios de clic de com.example.adNetwork será de cinco días y los anuncios de visualización de esa red publicitaria se ignorarán. Para las demás redes, la ventana de atribución para anuncios con visualización será de tres días. El concepto de ventana de atribución solo se aplica a los anuncios de instalación, no a los de reactivación. Esto se debe a que las interacciones y conversiones de anuncios de reactivación ocurren una tras otra sin espacio entre ellas. La segunda forma para ajustar tu flujo de atribución es el tiempo de reutilización configurable. Revisemos el flujo de anuncios de extremo a extremo. Centrémonos en la medición de la participación del usuario luego de una conversión por publicidad. Cuando una red publicitaria publica un anuncio y se produce la conversión impulsada por el anuncio, se abre la ventana para que los anunciantes midan la participación. A esta ventana la llamamos ventana de conversión. Los anunciantes pueden medir el valor de la conversión en función de las actividades que las personas realizan en su app, como suscripciones y compras dentro de la app, con la API updateConversionValue. Muchas de estas atribuciones de anuncios podrían ocurrir simultáneamente para la misma app anunciada en el mismo dispositivo. Las ventanas de conversión pueden superponerse, en cuyo caso es posible que una medición no se registre con la conversión más adecuada.

Veamos un ejemplo más concreto. Si alguien hizo clic en un anuncio y descargó la app anunciada y, un poco después, realizó una compra dentro de la app, eso resultó en una medición de alto valor de usuario con respecto al anuncio. Pero imaginemos que justo después de instalar la app, la misma persona hiciera clic en un anuncio de reactivación y abriera la app. La compra dentro de la app que debería atribuirse al anuncio de instalación se atribuiría al de reactivación. Es posible que este no sea el objetivo de medición que deseas.

El mismo escenario puede ocurrir con un anuncio de reactivación que sigue de cerca a otra conversión de reactivación. Lo que se hubiera atribuido al primer anuncio de reactivación ahora se atribuirá al segundo anuncio de reactivación. Para evitar esto, tal vez quieras establecer un periodo después de cada conversión para bloquear otras señales y usarlo solo para medir el valor de los anuncios que generaron la conversión dedicada. Se le llama tiempo de recuperación de atribución configurable. El tiempo de recuperación de atribución configurable se puede especificar según el tipo de conversión. El tiempo de reutilización comenzará a partir de cada conversión de ese tipo específico y todas las demás que ocurrieron antes no se atribuirán a ninguna conversión. Puedes especificar la duración del tiempo de recuperación de atribución deseada en el archivo Info.plist. En este ejemplo, un anunciante especificó un tiempo de recuperación de seis horas para la instalación y una hora para la reactivación. Con esta configuración, digamos que alguien hizo clic en el anuncio de instalación e instaló una app en el momento T. El tiempo de recuperación para la instalación es de seis horas. Si la misma persona toca el anuncio de reactivación y abre la app cuatro horas después de la instalación, esta conversión de reactivación no se atribuirá al anuncio. Si el toque en el anuncio y la apertura de la app de reactivación ocurrieron siete horas después de la instalación, la reactivación recibirá una atribución de anuncio. Tanto para la ventana de atribución como para el tiempo de recuperación de atribución, JWS permanecerá sin cambios para las impresiones y los postbacks. Además de estas funciones configurables, también agregamos una nueva información geográfica a los postbacks que te ayudarán a medir el éxito de tus campañas publicitarias en distintos países.

Volvamos al flujo de anuncios de extremo a extremo. Centrémonos en los postbacks.

Los postbacks son los resultados de AdAttributionKit que transmiten información sobre la conversión, como la atribución y la medición de la participación del usuario. Los postbacks se envían a las redes publicitarias y, opcionalmente, a los desarrolladores de apps anunciadas. A los anunciantes y a las redes publicitarias les gustaría acceder a la información geográfica para las conversiones con el fin de optimizar anuncios. Algunas implementaciones se basan en el identificador de origen para obtener información. Con la última versión de AdAttributionKit, el código de país es un nuevo campo en el postback. Es lo que representa el código de país en distintos contextos.

Para las app instaladas desde la App Store, el código de país en el postback se deriva de la tienda de App Store donde se descargó la app según la ubicación en la Configuración de la cuenta del usuario. Para la conversión de reactivación, los postbacks usan la misma ubicación desde la que se instaló la app inicialmente. Con iOS 17.4, las tiendas de app alternativas pueden proporcionar un token de verificación de instalación para comunicar una señal de instalación de la app con un dispositivo Apple. El token de verificación de instalación es un token JWS con carga útil que incluye información sobre la instalación de la app, como la marca de tiempo de la descarga y el ID de la app descargada. A partir de la nueva versión de iOS, los mercados de app alternativos brindan un nuevo campo para el código de país en la carga del token de verificación de instalación. Fírmalo y envíalo a Apple. Apple validará el valor y completará el campo de código de país del postback con el código. El código de país es opcional en el token de verificación de instalación. Si el sistema no puede encontrar un código de país en el token de verificación de instalación, no habrá ningún código de país en el postback.

Ten en cuenta que el valor del código de país para la conversión a través de mercados de app alternativos está limitado a las ubicaciones donde se admiten dichos mercados.

Así es como se agregará el código de país al postback. El código de país será un campo sin firmar paralelo al tipo de interacción del anuncio, el token JWS firmado y el valor de conversión aproximado. El campo de código de país está sujeto al algoritmo de anonimato colectivo que AdAttributionKit aplica a todos los postbacks. El algoritmo de anonimato colectivo se encuentra en el centro de nuestra atribución de anuncios que preserva la privacidad y garantiza que la singularidad de cada individuo se combine antes de proporcionar información identificable a los anunciantes.

Los postbacks solo contendrán el código de país si ha habido suficiente volumen para conversiones similares dentro del mismo país. El nivel de anonimato colectivo que califica para la presencia del código de país en el postback será adicional a los cuatro niveles de anonimato colectivo que aplicamos hoy. Así que bajo ninguna circunstancia los anunciantes y las redes publicitarias perderán los datos que están recibiendo actualmente. Así terminan las últimas actualizaciones de datos de postback. Mike compartirá la nueva capacidad de prueba de AdAttributionKit. Gracias por la información, Yuchi. Ya que cubrimos las nuevas características de AdAttributionKit, mostraré las formas de probar su implementación.

De vuelta al diagrama de extremo a extremo, centrémonos en el flujo de entrega y conversión de anuncios. Este es un flujo típico al probar la implementación de AdAttributionKit de la app.

Primero, debes crear y servir una carga publicitaria para tu app anunciada. Luego, muestra e interactúa con un anuncio en una app del editor independiente y realiza una conversión de instalación o reactivación para crear postbacks de desarrollo para tu app.

Con iOS 18.4, ahora puedes crear postbacks de desarrollo para tu app en la Configuración de iOS de la app.

Los postbacks de la configuración te dejan realizar pruebas de nuevas maneras. Ahora puedes probar la actualización de los valores de conversión si tu app se ejecutó desde Xcode u otros mecanismos de distribución, como la distribución ad-hoc. Ahora también tienes control directo sobre los datos que contendrán postbacks. Puede ser útil para probar la implementación de su servidor para procesar varios datos de postbacks.

Te diré cómo usar la configuración de desarrollador para crear postbacks.

Asegúrate de que el Modo de desarrollador esté activado en el dispositivo. Mira la configuración de desarrollador en Configuración.

Dentro de configuración, mira abajo hasta la sección Prueba de atribución de anuncios. Agregamos una nueva página, Postbacks de desarrollo arriba de Modo de desarrollador AdAttributionKit. Al ingresar a la página Postbacks de desarrollo, verás opciones para configurarlos para tu app, transmitir cualquier postback elegible o borrar todos los postbacks de desarrollo de tu dispositivo. Para configurar los postbacks, escribe el identificador de paquete y toca el botón Configurar.

La app debe estar instalada en tu dispositivo antes de crear postbacks en ella. El primer paso es especificar un destino para tu postback. Esta debería ser la URL del servidor. Se recomienda utilizar una URL de desarrollo en las pruebas, diferente a la URL que recibes los postbacks de producción. Puedes obtener la URL de copia de postback desde tu app automáticamente. Puedes usar esto para confirmar que la URL conocida que genera el sistema coincide con la URL que expone tu servidor.

Luego, completa las propiedades de tu postback. Puedes configurar el postback para representar el tipo de conversión que quieras editando propiedades.

En iOS, podrás configurar el código de país como una nueva propiedad. Te ayudará a probar el código de país en postbacks, como dijo Yuchi.

Luego de configurar propiedades, puedes ajustar la granularidad de los datos de cada postback. Esta granularidad controla cuánta información se enviará a tu servidor. Puedes usarlo para validar que la implementación procese correctamente distintos datos de postback.

Cuando termines de configurar tus postbacks, pulsa el botón para crearlos.

Ya que tu app tiene postbacks, puedes actualizar valores de conversión.

Durante la prueba, llama a updateConversionValue(_:) API para actualizar los postbacks de desarrollo. Puedes esperar a que el postback de desarrollo se envíe automáticamente o puedes tocar el botón Transmitir postbacks de desarrollo cuando finalice la ventana de conversión. Postbacks de configuraciones de desarrollador tienen diferencias con los de flujos de extremo a extremo. Te mostraré los cambios de la firma web JSON de tu postback.

Este es un fragmento del encabezado de postback.

Los postbacks creados en configuración del desarrollador se firman con una nueva clave, con un valor secundario. Consulta nuestra documentación sobre cómo verificar postbacks para obtener la nueva clave pública para validar su firma. Cambiando el enfoque, la carga útil del postback tiene diferencias a mencionar. El identificador de publicidad siempre se establecerá en development.adattributionkit. Ayuda a distinguir aún más los postbacks creados en configuraciones de desarrollador de producción.

El identificador del artículo anunciado del postback puede ser cero. Como si ejecutaste las app desde Xcode mientras hacias pruebas.

Con esto terminamos las funciones de prueba que agregamos a AdAttributionKit. Creemos que la capacidad de prueba ayudará a optimizar el flujo de trabajo al desarrollar y probar AdAttributionKit. Hoy cubrimos mucho terreno para nuestras nuevas funciones AdAttributionKit. Desde la medición de ventanas superpuestas en app hasta la recepción de códigos de país y postbacks, las actualizaciones afectan varios aspectos de los anuncios. Próximos pasos: Si estás listo para configurar las reglas de atribución para tu app, asegúrate de agregar las nuevas claves de configuración al Info.plist. Utiliza la nueva capacidad de prueba para tu implementación de AdAttributionKit más temprano en tu ciclo de vida de desarrollo, antes de lanzarla a producción. Y usas SKAdNetwork, es un excelente momento para migrar a AdAttributionKit y comenzar a desarrollar con las nuevas funciones. Agredecemos a la comunidad de desarrolladores que nos comentan sus experiencias con las estructuras de publicidad priorizando privacidad. Nos ayudan a impulsar lo que construimos y a ofrecer excelentes experiencias publicitarias que mantengan la privacidad del usuario. ¡Gracias!