-
Novidades do AdAttributionKit
Saiba mais sobre os novos recursos do AdAttributionKit, incluindo como avaliar as conversões de reengajamento sobrepostas e personalizar as regras de atribuição de anúncios do seu app. Obtenha informações sobre uma nova propriedade postback que você pode usar para avaliar o sucesso de campanhas publicitárias em vários países e regiões. Também demonstraremos novos recursos e melhores práticas para testar a implementação do AdAttributionKit. Para aproveitar ao máximo esta sessão, recomendamos assistir antes ao vídeo “Meet AdAttributionKit”.
Capítulos
- 0:00 - Introdução
- 3:23 - Avaliar as conversões de reengajamento sobrepostas
- 7:50 - Personalizar as regras de atribuição
- 14:46 - Receber dados geográficos em postbacks
- 18:12 - Testar o AdAttributionKit
Recursos
- Configuring attribution rules for your app
- Identifying conversion values with conversion tags
- Creating postbacks in developer settings
- Supplying an install verification token
- Verifying a postback
- Enabling Developer Mode on a device
- AdAttributionKit
Vídeos relacionados
WWDC25
WWDC24
-
Buscar neste vídeo...
-
-
5:42 - Function that retrieves a conversion tag from a URL
func retrieveConversionTag(fromURL url: URL) -> String? { guard let components = URLComponents(url: url, resolvingAgainstBaseURL: true) else { print("Could not get components for URL.") return nil } guard let queryItems = components.queryItems else { print("URL does not contain query items.") return nil } for item in queryItems { guard item.name == Postback.reengagementOpenURLParameter else { continue } return item.value } return nil } -
6:55 - Function that updates conversion value using a conversion tag
func updateConversionValue(_ conversionValue: Int, conversionTag: String) async { do { let update = PostbackUpdate(fineConversionValue: conversionValue, lockPostback: false, conversionTag: conversionTag) try await Postback.updateConversionValue(update) } catch { print("An error occurred while updating the conversion value: \(error)") } } -
9:32 - Example Info.plist for configuring attribution window
{ "AdAttributionKitConfigurations": { "AttributionWindows": { "com.example.adNetwork": { "install": { "click": 2, "view": 1 } } } } -
9:58 - Example Info.plist for configuring attribution window
{ "AdAttributionKitConfigurations": { "AttributionWindows": { "com.example.adNetwork": { "install": { "click": 2, "view": 1 } } } } -
10:14 - Example Info.plist for configuring attribution window
{ "AdAttributionKitConfigurations": { "AttributionWindows": { "com.example.adNetwork": { "install": { "click": 2, "ignoreInteractionType": "view" } } } } -
10:30 - Example Info.plist for configuring attribution window
{ "AdAttributionKitConfigurations": { "AttributionWindows": { "global": { "install": { "view": 3 } } "com.example.adNetwork": { "install": { "click": 5, "ignoreInteractionType": "view" } } } } -
11:05 - Example Info.plist for configuring attribution window
{ "AdAttributionKitConfigurations": { "AttributionWindows": { "global": { "install": { "view": 3 } } "com.example.adNetwork": { "install": { "click": 5, "ignoreInteractionType": "view" } } } } -
13:52 - Example Info.plist for configuring attribution cooldown
{ "AdAttributionKitConfigurations": { "AttributionCooldown": { "install-cooldown-hours": 6， "reengagement-cooldown-hours": 1 { } } -
16:02 - Example install verification token payload
{ "iss": 13421973, "iat": 1745255692, "iid": "34890933", "vid": "46392455", "aud": "AppleDownloadVerification-v1", "bid": "com.example.marketplace", "dtype": "download", "nonce": "9BC2C5CC-A1F8-4F93-9D6A-4D524685B67E" } -
16:26 - Example install verification token payload
{ "iss": 13421973, "iat": 1745255692, "iid": "34890933", "vid": "46392455", "aud": "AppleDownloadVerification-v1", "bid": "com.example.marketplace", "dtype": "download", "nonce": "9BC2C5CC-A1F8-4F93-9D6A-4D524685B67E", "ccode": "MT" } -
17:05 - Example postback with country code
{ "ad-interaction-type": "click", "jws-string": "eyJraWQiOiJhcHBsZS1jYXMtaWRlbnRpZmllci8wIiwiYWxnIjoiRVMyNTYifQ.eyJhZHZlcnRpc2VkLWl0ZW0taWRlbnRpZmllciI6Njg0OTM5LCJjb252ZXJzaW9uLXR5cGUiOiJyZS1lbmdhZ2VtZW50IiwibWFya2V0cGxhY2UtaWRlbnRpZmllciI6ImNvbS5hcHBsZS5BcHBTdG9yZSIsImFkLW5ldHdvcmstaWRlbnRpZmllciI6InRlc3QuYWRhdHRyaWJ1dGlvbmtpdCIsImltcHJlc3Npb24tdHlwZSI6ImFwcC1pbXByZXNzaW9uIiwicG9zdGJhY2stc2VxdWVuY2UtaW5kZXgiOjAsInNvdXJjZS1pZGVudGlmaWVyIjoiODM0NCIsImRpZC13aW4iOnRydWUsInBvc3RiYWNrLWlkZW50aWZpZXIiOiIzZjUwZmU1Ny0yOWFlLTQ4NjEtOGMwYi1hYzZhZGRkZmY3MmMiLCJwdWJsaXNoZXItaXRlbS1pZGVudGlmaWVyIjo1ODM4NDkyfQ.AemK1x2ahIPKOnFEEscG4wvipRtR1G6DzpNF4M4joPb8POIH4FJjm4VvcNgLXc9rWBrEDQPvDblduoc7MFcK5w", "coarse-conversion-value": "medium", "country-code": "MT" }
-
-
- 0:00 - Introdução
O AdAttributionKit, projetado com foco na privacidade do usuário, permite que anunciantes meçam o sucesso da campanha publicitária enquanto preserva o anonimato do usuário. O sistema envolve três agentes principais: redes de anúncios, apps editores e apps promovidos. O processo começa com uma rede de anúncios que envia um anúncio a um app editor, que o exibe aos usuários. As interações com o anúncio podem levar a instalações ou novos engajamentos, que são medidos pelo app promovido. Após uma janela de conversão específica, os dados são enviados de volta à rede de anúncios em um postback. O AdAttributionKit, lançado no iOS 17.4 e posteriormente atualizado para oferecer suporte a reengajamento no iOS 18, agora inclui novos recursos, como tags de conversão para medir as conversões de reengajamento sobrepostas, regras de atribuição personalizáveis, novos dados geográficos em postbacks e maior capacidade de teste nos app Ajustes do iOS.
- 3:23 - Avaliar as conversões de reengajamento sobrepostas
No iOS 18.4, você pode ter várias janelas de conversão de reengajamento ativas simultaneamente nos apps. Antes, apenas uma conversão ficava ativa por vez. As tags de conversão, que funcionam como favoritos, também especificam a conversão de reengajamento que deve ser atualizada quando um usuário interage com vários anúncios ou campanhas. Isso é especialmente útil ao realizar promoções simultâneas para produtos diferentes. Para habilitar essa nova funcionalidade, você deve definir a chave "EligibleForAdAttributionKitOverlappingConversions" no arquivo Info.plist do app. Depois de selecionadas, as tags de conversão são anexadas aos URLs de reengajamento para que você possa extraí-las e armazená-las para uso posterior. Quando alguém executa uma ação dentro do app, a tag de conversão correspondente é recuperada e usada para atualizar o valor da conversão diretamente por meio da API Postback, o que garante a atribuição precisa das conversões às campanhas relevantes.
- 7:50 - Personalizar as regras de atribuição
Agora os anunciantes podem personalizar as regras de atribuição para os apps. Esse novo recurso oferece duas maneiras principais de ajustar o fluxo de atribuição: Janela de atribuição configurável. Com esse recurso, os anunciantes podem especificar o período em que um anúncio ainda pode ser considerado para atribuição depois da exibição. Anteriormente, eram considerados todos os anúncios clicados há até 30 dias e anúncios visualizados há até um dia. Agora, os anunciantes podem definir essas janelas por rede de anúncios e por tipo de interação com o anúncio. Também podem ignorar determinados tipos de anúncio de algumas redes especificando a chave "ignoreInteractionType" ou definir uma duração para a janela de atribuição global que se aplique a todas as redes, a não ser que seja substituída por configurações específicas. Período de espera de atribuição configurável. Esse recurso evita que haja a sobreposição de várias conversões e a atribuição incorreta do engajamento do usuário. Após uma conversão, você pode definir um período de espera no Info.plist, durante o qual outras conversões não serão atribuídas. Isso garante que o valor de uma conversão seja medido de maneira precisa para o anúncio que a gerou. Os anunciantes podem especificar os períodos de espera por tipo de conversão, como as conversões de instalação ou reengajamento.
- 14:46 - Receber dados geográficos em postbacks
O AdAttributionKit agora aprimorou os postbacks com novas informações geográficas, especificamente os códigos de país, para ajudar anunciantes e redes de anúncios a otimizar a veiculação de anúncios nos diferentes países. O campo de código do país nos postbacks é derivado da App Store para as instalações iniciais e novos engajamentos. Para os apps instalados em mercados de app alternativos no iOS 17.4 e versões posteriores, o código do país é incluído na payload do token de verificação de instalação, validado pela Apple e adicionado ao postback. Esse novo campo está sujeito ao algoritmo de anonimato coletivo da Apple para garantir a privacidade do usuário e só é incluído em postbacks para conversões com volume suficiente dentro do mesmo país, o que fornece mais dados sem comprometer as informações existentes.
- 18:12 - Testar o AdAttributionKit
No iOS 18.4, agora você pode criar os postbacks de desenvolvimento para seu apps nos Ajustes do iOS. Esse novo recurso permite que sejam feitos testes de vários cenários, como atualizar os valores de conversão antes que o app seja liberado para a produção e validar a implementação do servidor para processar as diferentes camadas de dados de postbacks. Você pode configurar os postbacks especificando o identificador de pacote do app, o URL de destino e as várias propriedades, incluindo a nova propriedade de código de país. Também é possível ajustar a granularidade dos dados de cada postback. Os postbacks criados nos Ajustes de Desenvolvedor têm características distintas, como uma nova chave de assinatura e valores específicos para o identificador da rede de anúncios (development.adattributionkit), e o identificador do item anunciado, para diferenciá-los dos postbacks de produção. Esse aprimoramento simplifica o fluxo de trabalho de desenvolvimento e teste da implementação do AdAttributionKit.