A página de produto da App Store em 2026: cada superfície, medida

O que a Apple lançou para as páginas de produto da App Store em outubro de 2026? Em 5 de outubro de 2026, a Apple ativou os “creative assets” (recursos criativos) que apresentou na WWDC26 em junho e para os quais, em 5 de agosto, pediu que os desenvolvedores se preparassem: um cabeçalho da página de produto, que é uma imagem de exatamente 3840 por 1646 pixels (21:9) ou um vídeo de 5 a 30 segundos, e um recurso de resultados de busca, em 3:2 e em qualquer tamanho de 1920 por 1280 a 3840 por 2560, que aparece na busca “Instead of showing the default app screenshots” (em vez das capturas de tela padrão do app).¹²³⁴ As pessoas veem os dois no iOS 27 e no iPadOS 27 ou posterior.⁵ No mesmo dia a Apple abriu a biblioteca de recursos (Asset Library), onde imagens e vídeos são enviados uma vez e aprovados antes do uso; uma ferramenta de prévia que mostra a página de produto e o resultado de busca antes do envio; e os uploads para o iPhone Duo, cujas capturas todo app enviado a partir de abril de 2027 vai precisar ter.¹⁶⁷ Para a página de um app, isso significa duas coisas. O topo da página e o resultado de busca agora são uma arte que você escolhe, e não suas primeiras capturas, e, depois que um recurso criativo é aprovado, trocá-lo numa versão publicada não exige um novo envio.⁵³ As páginas de produto personalizadas (até 70 por app) e a otimização da página de produto (até três tratamentos, por até 90 dias) também podem usar os novos recursos.⁸⁹¹⁰

Resumo

• Dois espaços novos, no ar desde 5 de outubro. O cabeçalho da página de produto (3840 por 1646, 21:9) e o recurso de resultados de busca (3:2, de 1920 por 1280 a 3840 por 2560) aceitam uma imagem ou um vídeo de 5 a 30 segundos; um único PNG “universal” de 16:9, com 5244 por 2950, pode preencher os dois. A Ajuda aceita JPEG para a imagem do cabeçalho; o catálogo da API aceita só PNG.⁴¹¹¹
• Uma biblioteca, dois caminhos de revisão. A Asset Library guarda cada captura, cada app preview e cada recurso criativo. Quando o app já tem uma versão aprovada, um recurso pode ser enviado sozinho, e um recurso criativo aprovado (um cabeçalho ou um recurso de resultados de busca) pode ser publicado na página da versão ativa sem uma versão nova; capturas e app previews continuam indo para a revisão junto com uma versão. Antes da primeira aprovação, tudo vai junto com a primeira versão.⁵¹²
• Os uploads para o iPhone Duo estão abertos, e o caminho documentado da API é a biblioteca de recursos. O Duo aceita capturas de 1398 por 2034 (tela externa) e 2007 por 2853 (interna), em qualquer uma das duas orientações, e o mesmo app preview de 886 por 1920 dos outros iPhones modernos; as capturas do Duo serão obrigatórias nos envios a partir de abril de 2027. A Apple documenta os uploads do Duo pela nova biblioteca de recursos, e os enums de capturas e app previews do arquivo OpenAPI 4.5.1 não têm nenhum valor para o Duo. O serviço em produção está à frente do arquivo: uma leitura do recurso obsoleto de conjuntos de capturas devolveu nosso conjunto do Duo como APP_IPHONE_DUO. Se esse recurso aceita um novo conjunto do Duo não foi testado, porque não fiz nenhuma escrita.^13146151617
• As superfícies mais antigas cresceram. As páginas de produto personalizadas passaram de 35 por app, o número que a Apple deu na WWDC21, para 70 em 28 ou 29 de outubro de 2025 (as notas de versão da Apple e a notícia diferem em um dia), com palavras-chave; o deep link de uma página de produto personalizada funciona no iOS 18 ou posterior. A otimização da página de produto continua rodando até três tratamentos por até 90 dias e declara um resultado com 90% de confiança.^1871989
• As próprias páginas da Apple se contradizem em pelo menos dez pontos com que quem constrói vai esbarrar. Um teste por vez ou vários, em que estados o app pode ser testado, quem pode usar a Asset Library, com quanta antecedência indicar o app para destaque, se as palavras-chave contam caracteres ou bytes, qual classe de captura de iPhone é obrigatória, se o canal alfa é permitido, se a imagem do cabeçalho pode ser JPEG, que taxa de quadros e que áudio um app preview precisa e o que “Archived” significa. Cada um aparece abaixo com as duas fontes.^{9205122122232413114142526}
• Nenhuma das nossas páginas tem cabeçalho nem recurso de resultados de busca, pela própria leitura da API. A leitura que a Apple documenta para listar as posições de uma página, feita em 7 de outubro em todas as 258 localizações das nossas versões publicadas e das duas versões aguardando revisão (sem o tvOS 1.6.3 do Reps, em revisão naquela manhã), devolveu 2.073 posições, todas de capturas: nenhum cabeçalho, nenhum recurso de resultados de busca, nenhum app preview. Se um cabeçalho publicado pelo console aparece nessa leitura continua sem verificação até existir um nosso. A Apple não publica nenhuma área segura em pixels; as áreas seguras abaixo são minha medição do modelo da Apple para Sketch.²⁷²⁸²⁹
• O que isso dá aos nossos apps. Em 7 de outubro nossa conta tinha 28 apps, 9 deles publicados; nenhum tinha teste de otimização da página de produto nem app preview, só o Kiradex tinha capturas do iPhone Duo, nenhum tinha cabeçalho ou recurso de resultados de busca posicionado, e os únicos recursos criativos em qualquer biblioteca eram as mídias do evento do Reps. A última seção é o kit que o agente de cada app agora constrói, com a leitura ou o script que prova que cada item está feito.³⁰³¹

1. O que a Apple lançou, e quando

Cada data abaixo vem de uma página que a Apple datou: uma notícia, uma nota de versão, o ano de uma sessão da WWDC ou a própria linha “Last Updated” das App Review Guidelines. As páginas de marketing da Apple em /app-store/ e as páginas da Ajuda não têm data própria, então, onde uma regra importa, informo junto da página a data em que a acessei, 7 de outubro de 2026 (UTC).³²

A nota de versão de 5 de outubro diz isso numa linha: “You can now use creative assets to highlight your brand identity, promote seasonal updates, and showcase new app or game across the App Store” (agora você pode usar recursos criativos para destacar a identidade da sua marca, promover atualizações sazonais e mostrar um app ou jogo novo em toda a App Store), e cita cabeçalhos de páginas de produto, resultados de busca e eventos no app.⁷ A notícia daquele dia acrescenta a ferramenta de prévia, “With support for Dark Mode, as well as different devices and orientations” (com suporte ao modo escuro e a diferentes aparelhos e orientações), e a Asset Library, onde você pode “submit creative assets for approval today to use in a future seasonal campaign, then immediately use them once you’re ready” (enviar hoje recursos criativos para aprovação para uma futura campanha sazonal e usá-los imediatamente quando estiver pronto).¹ A página What’s New da Apple marca os recursos criativos, a Asset Library e a ferramenta de prévia como “Now available” (já disponíveis).¹⁰ A notícia de 5 de agosto dizia “As we announced in June” (como anunciamos em junho), o que liga o lançamento de outubro à sessão da WWDC26; a página da sessão não mostra data, e a sessão está na coleção da WWDC26, aberta em 8 de junho.²³⁶³

Duas páginas da própria Apple não acompanharam. A página de marketing “Creating Your Product Page” (/app-store/product-page/) ainda começa com “You can now take advantage of product page optimization, and create custom product pages” (agora você pode aproveitar a otimização da página de produto e criar páginas de produto personalizadas) e não menciona o cabeçalho, os recursos criativos nem a Asset Library.²³ A página “Promoting your apps” ainda oferece “up to 100 promo codes per in-app purchase” (até 100 códigos promocionais por compra dentro do app), algo que a nota de versão de 27 de março aposentou.⁴⁰⁷

Onde este site disse outra coisa, e o que mudou. O post de 22 de setembro Capturas de tela da App Store que vendem o porquê anunciava os recursos criativos como algo por vir: “to be submitted through a new Asset Library and checked in a product page preview tool, both listed as coming this fall.” (a serem enviados por uma nova Asset Library e conferidos numa ferramenta de prévia da página de produto, ambas anunciadas para este outono).⁴¹ Eles chegaram em 5 de outubro, e este post é a continuação. Duas linhas daquele post descrevem a página de capturas da Apple como estava em 22 de setembro e já não batem com ela em 7 de outubro. Na época, nas palavras daquele post, a página marcava o tamanho de 6,5 polegadas como obrigatório só quando faltava o conjunto de 6,9 polegadas, e a linha do Duo estava “listed but not yet accepting uploads” (listada, mas ainda sem aceitar uploads).⁴¹ Agora a página nomeia classes em vez de polegadas (“iPhone with Dynamic Island (large display)” e assim por diante), a linha de tamanho obrigatório pede “At least one screenshot for iPhone with Dynamic Island (medium display)” (pelo menos uma captura para iPhone com Dynamic Island, tela média), e a nota sobre os uploads do Duo sumiu.¹³ O post do segundo dia do iPhone Duo, de 10 de setembro, dizia aos leitores que os uploads do Duo abririam mais para o fim do ano, que era a redação da Apple naquele dia. Os uploads abriram em 5 de outubro. Cinco trechos daquele post diziam outra coisa: a lista do que eu usaria hoje, a resposta do FAQ sobre os tamanhos de captura do Duo, a observação sobre a nota de versão da Apple de 9 de setembro, o parágrafo sobre a linha de app previews e o parágrafo sobre as ferramentas de mockup da comunidade; os cinco foram corrigidos em 7 de outubro de 2026 com notas datadas.⁶⁴² Prepare seu app para o iPhone Duo, de 2 de outubro, ainda tratava os uploads como fechados no resumo, na tabela de status, na nova checagem de 4 de outubro abaixo dessa tabela, em dois trechos da seção sobre o envio e na resposta do FAQ sobre tamanhos de captura, e esses seis também foram corrigidos no mesmo dia.

2. A página de produto em 2026, superfície por superfície

A Apple agora separa o que vai na página em três tipos. “App previews and screenshots showcase your app in-use or gameplay, while creative assets can be used to highlight your brand, promote seasonal offerings, showcase new content, and more.” (app previews e capturas mostram o app em uso ou a jogabilidade, enquanto os recursos criativos servem para destacar a marca, promover ofertas sazonais, mostrar conteúdo novo e mais).⁴³ Os recursos criativos são “optional and separate from your app’s screenshots, app previews, In-App Purchase and Subscription images, and any promotional artwork requested by editorial teams” (opcionais e separados das capturas, dos app previews, das imagens de compras dentro do app e de assinaturas e de qualquer arte promocional pedida pelas equipes editoriais), e a Ajuda os descreve como “distinct from the in-use functionality requirement in app previews and screenshots” (distintos da exigência de mostrar a funcionalidade em uso que vale para app previews e capturas).⁵ A página de especificações lista três: “Creative assets include product page header, search results, and in-app event cards.” (os recursos criativos incluem o cabeçalho da página de produto, os resultados de busca e os cards de eventos no app).⁴

Todas as telas numa mesma escala, desenhadas por script a partir das especificações da Ajuda da Apple e do catálogo de referência da API.^4131411

O cabeçalho da página de produto

“When someone lands on your product page, the first thing they’ll notice is your header.” (quando alguém chega à sua página de produto, a primeira coisa que nota é o cabeçalho).⁴³ Nas palavras da sessão da WWDC26, ele é “the first visual element people will see when they land on your app” (o primeiro elemento visual que as pessoas veem ao chegar ao seu app), e pode ser uma imagem ou um vídeo.³ A Apple o apresenta para marca e sazonalidade: “Use video or images to express your brand, seasonal offerings, exciting new content, and more to set the tone for the rest of your product page.” (use vídeo ou imagens para expressar sua marca, ofertas sazonais, conteúdos novos e empolgantes e mais, dando o tom para o resto da página de produto).⁴³

O recurso de resultados de busca

“Your search result asset is the first thing people experience when they find your app or game through the Search tab, before they ever reach your product page.” (o recurso de resultados de busca é a primeira coisa que as pessoas veem quando encontram seu app ou jogo pela aba Buscar, antes mesmo de chegar à página de produto).⁴³ Ele substitui o que a busca mostra por padrão: “Instead of showing the default app screenshots, you can use an impactful image or video, to make your app stand out in the Search Results.” (em vez de mostrar as capturas padrão do app, você pode usar uma imagem ou um vídeo de impacto para que o app se destaque nos resultados de busca).³ A página What’s New da Apple inclui o app Jogos: “Reach people in relevant search results on the App Store and in the Apple Games app.” (alcance pessoas em resultados de busca relevantes na App Store e no app Apple Games).¹⁰ Deixar vazio não quebra nada: “If you choose to not use a search result creative asset, your In-App Events, app previews, and screenshots will appear.” (se você optar por não usar um recurso criativo de resultados de busca, aparecerão seus eventos no app, app previews e capturas).⁴³

Um arquivo para os dois: o recurso universal

Um PNG de 16:9 com 5244 por 2950 pixels pode preencher os dois espaços. A Ajuda: “If you upload a universal creative asset, you can use it for both your product page header and search results placement. Otherwise, select dedicated assets for each.” (se você enviar um recurso criativo universal, pode usá-lo tanto no cabeçalho da página de produto quanto na posição de resultados de busca; caso contrário, escolha recursos dedicados para cada um). O atalho do console, “Use header asset in search results”, está “only available for universal creative assets” (disponível apenas para recursos criativos universais).⁵ A tabela de especificações da Apple imprime a linha de 16:9 sob cada posição sem dar nome a ela; o catálogo da API dá o nome, marcando a especificação de 5244 por 2950 como universalAsset: true e compatível com os dois tipos de posição.⁴¹¹ Não existe vídeo universal: o catálogo não lista nenhuma especificação de vídeo de 5244 por 2950, então, na minha leitura, um recurso universal é sempre uma imagem.¹¹

Há duas divergências nessa tabela. A Ajuda aceita JPEG para a imagem do cabeçalho e o catálogo da API não, então um cabeçalho feito em PNG atende aos dois.⁴¹¹ E os nomes curtos do catálogo codificam um mínimo de 10 segundos para o vídeo do cabeçalho e de 15 para o da busca (t10~30, t15~30), enquanto os campos estruturados duration dessas mesmas entradas dizem de 5 a 30 segundos, como a Ajuda; confio no campo estruturado e na Ajuda mais do que no nome.¹¹⁴

Quem vê. “Creative assets support both images and videos, and are available for iOS and iPadOS apps and games running iOS 27 or iPadOS 27 or later.” (os recursos criativos aceitam imagens e vídeos e estão disponíveis para apps e jogos de iOS e iPadOS rodando iOS 27 ou iPadOS 27 ou posterior).⁵ Na minha leitura, “running iOS 27” descreve o aparelho de quem compra, não o destino de implantação do seu app, e nenhuma página que salvei cita uma posição no Mac, na Apple TV, no Apple Vision Pro ou no Apple Watch.⁵⁴³

Por idioma. As boas práticas da Apple dizem sobre o texto nesses recursos “Be sure to localize for all languages your app supports” (lembre-se de localizar para todos os idiomas que o app suporta), e a prévia do console funciona “across different orientations and languages” (em diferentes orientações e idiomas).⁴³⁵ Nenhum passo da Ajuda descreve o upload de um cabeçalho por idioma, mas a API vincula cada posição a uma localização, então o modelo de dados é um cabeçalho por idioma por superfície.²⁷

Áreas seguras. A Apple não publica nenhuma em pixels. A regra dela é qualitativa: “Design key elements with a safe area in mind to accommodate different devices and orientations. Be sure your focal point artwork is within the center of your composition to prevent any unwanted clipping.” (projete os elementos principais pensando numa área segura que acomode diferentes aparelhos e orientações; mantenha o ponto focal da arte no centro da composição para evitar cortes indesejados).⁴³ O modelo da Apple para Sketch desses recursos, porém, desenha em cada tela um retângulo chamado “ART SAFE AREA”, e eu os medi a partir das camadas do arquivo.²⁹

Os retângulos “ART SAFE AREA” do modelo da Apple para Sketch, pela minha medição; a Apple não informa nenhuma área segura em pixels.²⁹

Duas ressalvas sobre esses números. Alguns quadros de grupo no arquivo do Sketch estão desatualizados, então os números se referem aos retângulos desenhados dentro dos grupos da área segura; e não abri os modelos da Apple para Photoshop nem para Pixelmator para conferir a área segura alta da tela universal.²⁹ Na minha leitura, as áreas seguras são pequenas porque o mesmo arquivo é recortado de formas diferentes no iPhone, no iPad e conforme a orientação, e é para isso que serve a ferramenta de prévia.⁴³¹

Modelos. A página de boas práticas da Apple traz links para modelos de Figma, Photoshop, Pixelmator e Sketch para o cabeçalho e o resultado de busca; a notícia de 5 de agosto citava os três primeiros, e o arquivo do Sketch que baixei tinha última modificação em 28 de agosto de 2026.⁴³²²⁹

Apple Ads, ainda não. Os mesmos recursos são pensados também para anúncios, mas a página do Apple Ads diz “Coming soon to Apple Ads” (em breve no Apple Ads) e informa que os recursos aprovados poderão ser usados “at a later date” (mais adiante); “Videos can only be used in search results ads” (vídeos só podem ser usados em anúncios nos resultados de busca), “Videos can be uploaded with or without audio, but audio will not play” (vídeos podem ser enviados com ou sem áudio, mas o áudio não toca), e o Apple Ads faz uma revisão própria das peças publicitárias.⁴⁴

Destaque. A página de boas práticas da Apple diz que os recursos criativos aparecem “when your app is featured” (quando seu app é destacado), e um resumo de um group lab da WWDC26 diz que os novos recursos “also appear in featuring placements” (também aparecem nas posições de destaque); nenhum dos dois diz em quais.⁴³⁴⁵

Capturas, por classe de aparelho

As quantidades não mudaram: “You can have up to 10 screenshots on your product page. Depending on orientation, up to three screenshots can appear in search results.” (você pode ter até 10 capturas na página de produto; dependendo da orientação, até três podem aparecer nos resultados de busca).⁴³ A Ajuda: “You must include at least one screenshot and can upload up to 10 screenshots per device size in .jpeg, .jpg, or .png formats” (você precisa incluir pelo menos uma captura e pode enviar até 10 por tamanho de aparelho nos formatos .jpeg, .jpg ou .png) e “Images can’t include alpha channels or transparencies.” (as imagens não podem incluir canais alfa nem transparências).¹³ O redimensionamento poupa trabalho: “If your app’s user interface is consistent across multiple device sizes and localizations, you only need to provide screenshots for the highest required resolution. App Store Connect automatically scales them down for smaller device sizes.” (se a interface do app for consistente em vários tamanhos de aparelho e localizações, basta fornecer capturas na maior resolução exigida; o App Store Connect as reduz automaticamente para aparelhos menores).¹³

Fonte: Ajuda do App Store Connect, Screenshot specifications, acessada em 7 de outubro de 2026, linhas 33 a 283 (iPhone), 347 a 449 (iPad) e 535 a 551 (Mac); grupos de posição do catálogo de referência em produção.¹³¹¹ A página também lista os iPhones com botão de início de 4 e 3,5 polegadas, os iPads de 12,9, 10,5 e 9,7 polegadas, a Apple TV (1920 x 1080 ou 3840 x 2160), o Apple Vision Pro (3840 x 2160) e seis tamanhos de Apple Watch, com a regra “You must use the same screenshot size for Apple Watch consistently across all localizations for the app.” (você precisa usar o mesmo tamanho de captura de Apple Watch de forma consistente em todas as localizações do app).¹³

As linhas do iPhone Duo. A Apple mostra o Duo como o primeiro card de iPhone, com um card de tamanhos e nada mais: sem lista de aparelhos, sem exigência e sem nota de alternativa.¹³ Externa de 1398 por 2034 e interna de 2007 por 2853, nas duas orientações, são os números que o post deste site sobre o iPhone Duo para desenvolvedores calculou em pontos, e nada nas páginas da Apple acessadas em 7 de outubro os contradiz; a classe de tela da API lista as dimensões de tela do Duo como esse mesmo par.⁴⁶¹¹ O catálogo da Apple rotula as quatro especificações do Duo como 3:2 e 2:3, mas 2034 dividido por 1398 dá 1,455 e 2853 dividido por 2007 dá 1,42, então, na minha leitura, o rótulo é uma categoria, não uma proporção para a qual projetar.¹¹ O que um comprador com Duo vê numa página sem conjunto do Duo não está documentado em nenhuma página que salvei.¹³

Qual classe de iPhone é obrigatória: as páginas da Apple divergem. O topo da página da Ajuda diz: “iPhone: At least one screenshot for iPhone with Dynamic Island (medium display).” (iPhone: pelo menos uma captura para iPhone com Dynamic Island, tela média).¹³ A linha Face ID (large display) da mesma página diz que ela é “Required if app runs on iPhone and screenshots for iPhone with Dynamic Island (large display) aren’t provided” (obrigatória se o app roda no iPhone e não foram fornecidas capturas para iPhone com Dynamic Island, tela grande), e a nota de versão de 11 de setembro de 2024 diz que você está “only required to provide a single screenshot” (obrigado a fornecer só uma captura) para iPhone, citando o tamanho de 6,5 ou o de 6,9 polegadas.¹³⁷ A linha da tela média é a redação mais recente; não verifiquei qual regra o App Store Connect aplica no envio. Seis dos nossos sete apps de iPhone publicados têm um conjunto de 1320 por 2868 nas versões aprovadas, o maior tamanho da classe Dynamic Island grande, que segundo a Ajuda é reduzido para as classes menores. O sétimo, Tappy Color, tem seis quadros de 1290 por 2796, outro tamanho da mesma classe, ao lado de seis de 1242 por 2208, da classe Home Button grande.³⁰⁴⁷¹³

Canal alfa: a Ajuda e a API divergem. A Ajuda proíbe canal alfa em todas as capturas.¹³ O catálogo da API marca 35 especificações mais antigas como alphaAllowed: true, entre elas todos os tamanhos de iPhone com botão de início, os iPads de 10,5 e 9,7 polegadas, o Mac, a Apple TV e o Vision Pro; nenhuma especificação de Dynamic Island, Face ID, 13 polegadas, 11 polegadas ou do Duo permite.¹¹ Faça as capturas novas sem canal alfa e as duas fontes concordam. O catálogo também rotula os tamanhos de Mac como 16:9 onde a Ajuda diz 16:10 (2880 dividido por 1800 dá 1,6), e informa um máximo de 524.288.000 bytes para cada imagem, um limite que a Ajuda não informa para capturas.¹¹¹³

App previews

“App previews are optional. You can upload up to three app previews per supported device size and language for iOS, macOS, tvOS, and visionOS apps.” (app previews são opcionais; você pode enviar até três por tamanho de aparelho e idioma suportados em apps de iOS, macOS, tvOS e visionOS).¹⁴ Eles tocam sozinhos e vêm primeiro: “App previews always appear before screenshots on iPhone, iPad, Mac, and Apple TV” (os app previews sempre aparecem antes das capturas no iPhone, no iPad, no Mac e na Apple TV), mesmo que reordenados, com uma exceção no mesmo parágrafo da Ajuda: “If a preview video uses an aspect ratio different from your screenshots” (se o vídeo usar uma proporção diferente da das capturas), ele aparece na seção A Closer Look da página.¹⁴ E “up to three may appear in search results” (até três podem aparecer nos resultados de busca).¹⁴⁴³

A linha do áudio importa para quem gera app previews. A Ajuda descreve formatos de áudio, mas em nenhum momento diz que um app preview precisa ter som; a API marca todas as especificações de app preview como audioRequired: true, e o artigo dela sobre vídeos avisa que um arquivo com “no audio track where audioRequired is true, fails processing rather than being rejected up front.” (sem faixa de áudio quando audioRequired é true falha no processamento em vez de ser rejeitado logo de cara).¹⁴¹¹⁴⁸ Um app preview sem som precisa, portanto, de uma faixa estéreo silenciosa, e a taxa de quadros dele tem de ficar entre 23 e 30 fps para atender às duas páginas.¹¹¹⁴

O Duo não tem um app preview no formato do Duo. A linha dele lista as resoluções do aparelho 2034 por 1398 e 2853 por 2007, com o rótulo “(19.5:9 aspect ratio)”, e aceita o mesmo arquivo de 886 por 1920 de todos os iPhones com Face ID e Dynamic Island; o rótulo não bate com nenhum dos dois números do Duo, como o post do segundo dia já tinha apontado.¹⁴¹¹⁴² Como a App Store encaixa esse arquivo nas telas do Duo não está documentado.¹⁴

A página de app previews da Apple acrescenta as regras de conteúdo: “App previews must show only content within the app itself. Don’t film people interacting with a device, such as an over-the-shoulder angle or fingers tapping the screen.” (os app previews devem mostrar só conteúdo do próprio app; não filme pessoas usando um aparelho, como um plano por cima do ombro ou dedos tocando a tela). “Avoid any seasonal or timely references that will age your video” (evite referências sazonais ou de momento que envelheçam o vídeo), e os exemplos da Apple são “new for spring” e datas. Se as funcionalidades exigirem compra, assinatura ou login, “you must disclose this” (você precisa informar isso). E: “If you change the poster frame on an app preview that’s already approved, you’ll need to submit a new version of your app preview.” (se você mudar o quadro de capa de um app preview já aprovado, vai precisar enviar uma nova versão do app preview).⁴⁹

Texto promocional, e os outros campos de texto

“Your app’s promotional text appears at the top of the description and is up to 170 characters long. You can update promotional text at any time without having to submit a new version of your app.” (o texto promocional do app aparece no topo da descrição e tem até 170 caracteres; você pode atualizá-lo a qualquer momento sem enviar uma nova versão do app).²³ A Ajuda o coloca “above your description on the App Store for customers with devices running iOS 11 or later” (acima da descrição na App Store para clientes com aparelhos no iOS 11 ou posterior), e a Apple avisa que “promotional text doesn’t affect your app’s search ranking so it should not be used to display keywords.” (o texto promocional não afeta a posição do app na busca, então não deve ser usado para exibir palavras-chave).²⁴²³ É o único texto da página padrão que você pode mudar entre versões. Nenhuma página que salvei diz se o App Review analisa uma edição no texto promocional da página padrão; numa página de produto personalizada ele é revisado junto com a página.⁵⁰

A linha das palavras-chave é uma das divergências da Apple: a página de marketing conta caracteres, a Ajuda conta bytes. Na minha leitura, os bytes são o limite que vale para qualquer idioma cujos caracteres ocupem mais de um byte, então uma lista de palavras-chave em japonês ou coreano enche antes do que a contagem de caracteres sugere.²³²⁴ O esquema da API não codifica nenhum desses comprimentos: nenhum maxLength aparece nessas strings no arquivo OpenAPI, então os limites estão escritos só na Ajuda, e se o servidor os aplica não foi testado, porque não fiz nenhuma escrita.¹⁶

Eventos no app

“In-App Events are timely events within apps and games” (eventos no app são eventos oportunos dentro de apps e jogos), e eles aparecem “On your product page, which displays all of your currently published events” (na sua página de produto, que exibe todos os eventos publicados no momento), na busca e nas seleções editoriais das abas Hoje, Jogos e Apps.⁵² Na busca, o card aparece “for users who have downloaded your app, while screenshots show for those who haven’t downloaded your app.” (para quem já baixou o app, enquanto as capturas aparecem para quem não baixou).⁵² Eles só existem para apps de iPhone e iPad.²¹

Os eventos passam por revisão (“In-app events must be approved before they are visible to users”, os eventos no app precisam ser aprovados antes de ficarem visíveis para os usuários) e, sem uma versão do app, são “reviewed together with the latest version of the selected platform.” (revisados junto com a versão mais recente da plataforma escolhida).⁵³⁵⁵ Depois que um evento é publicado, “you can modify only the start and end dates” (você só pode mudar as datas de início e de fim); depois que ele começa, só a data de fim.⁵⁶ A Apple lista o que não se qualifica: “Repetitive activities such as daily tasks or rewards” (atividades repetitivas, como tarefas ou recompensas diárias), “Price promotions that don’t introduce any new content, features, or goods” (promoções de preço que não trazem conteúdo, funcionalidades ou itens novos) e “General promotions that raise awareness about your app or game.” (promoções gerais para divulgar o app ou jogo).⁵² As regras de mídia dela puxam para o lado oposto do discurso dos recursos criativos: “When possible, avoid using text or logos in your media, especially if they include your event name or app name” (sempre que possível, evite texto ou logotipos na mídia, principalmente se incluírem o nome do evento ou do app) e “Don’t add borders or gradients to your media.” (não acrescente bordas nem degradês à mídia).⁵² Se um recurso criativo usado como mídia de evento está sujeito a essa regra sobre texto não é dito em nenhuma página que salvei.

Indicações para destaque

“To nominate your app to be featured, whether it’s a new launch or an exciting update, submit your plans through App Store Connect.” (para indicar seu app para destaque, seja um lançamento novo ou uma atualização empolgante, envie seus planos pelo App Store Connect).²¹ Há três tipos, New Content, App Enhancements e App Launch; uma indicação pode citar até 10 apps relacionados e 5 URLs complementares, e uma importação por CSV aceita até 50 de uma vez, com nome de 60 caracteres e descrição de 1.000 caracteres.²¹⁵⁷ Não é App Review: quem lê é a equipe editorial, e “if it’s a fit, we’ll reach out to the email address you provide.” (se fizer sentido, entraremos em contato pelo e-mail informado).⁵⁷

Com quanta antecedência: quatro respostas. A Ajuda: “we recommend submitting plans as early as possible, with a minimum lead time of 3 weeks.” (recomendamos enviar os planos o quanto antes, com antecedência mínima de 3 semanas). O modelo de indicações: “Make sure to submit and finalize your plan at least three weeks in advance.” (envie e finalize seu plano com pelo menos três semanas de antecedência). A página sobre destaque: “please give our team a minimum of two weeks notice. For wider featuring consideration, we recommend submitting a nomination up to three months in advance.” (avise nossa equipe com no mínimo duas semanas; para uma consideração mais ampla, recomendamos enviar a indicação com até três meses de antecedência). O formulário de histórias da página sobre descoberta: “let us know six to eight weeks in advance of your launch.” (avise-nos de seis a oito semanas antes do lançamento). Nenhuma das quatro páginas tem data.^21572258 Na minha leitura, três semanas é o piso com que vale planejar, já que duas das quatro páginas o dão como mínimo.

O que os editores levam em conta, pela lista da Apple, termina com a página de que trata este post: “App Store product page. Compelling screenshots, app previews, and descriptions, as well as positive ratings and reviews.” (página de produto da App Store: capturas, app previews e descrições atraentes, além de avaliações e resenhas positivas).²²

Códigos promocionais, em resumo

“You can request up to 100 promo codes per version of each platform your app supports” (você pode solicitar até 100 códigos promocionais por versão de cada plataforma que o app suporta), cada um válido por quatro semanas e de uso único, e os clientes que resgatam um “can’t rate or review the app.” (não podem avaliar nem resenhar o app).⁵⁹ Os códigos para compras dentro do app acabaram: a notícia de 29 de outubro de 2025 dizia “starting March 26, 2026” (a partir de 26 de março de 2026), e a nota de versão de 27 de março de 2026 diz que eles “are no longer supported.” (não são mais aceitos).¹⁹⁷ Os códigos de oferta os substituem.¹⁹

3. Páginas de produto personalizadas

Uma página de produto personalizada é outra versão da sua página, com URL própria: “Publish additional versions of your App Store product page, each of which highlights a feature or specific content from your app and has a unique URL to share.” (publique versões adicionais da sua página de produto na App Store, cada uma destacando uma funcionalidade ou um conteúdo específico do app e com uma URL única para compartilhar).⁸ A Ajuda lista o que pode mudar: “Each custom product page can include different screenshots, previews, promotional text, and keywords, and is localizable and shareable through a unique URL.” (cada página de produto personalizada pode ter capturas, app previews, texto promocional e palavras-chave diferentes, e pode ser localizada e compartilhada por uma URL única).⁶⁰ A novidade de 2026 é o cabeçalho. A sessão da WWDC26 mostrou uma página personalizada cujo cabeçalho combina com um banner de site (“Now, you have the ability to customize the header”, agora você pode personalizar o cabeçalho), a página What’s New da Apple diz para usar os recursos criativos “on your custom product pages” (nas suas páginas de produto personalizadas), e o catálogo da API dá às páginas de produto personalizadas uma posição de cabeçalho e uma de resultados de busca por localização.³¹⁰¹¹ As páginas de Ajuda e de marketing da Apple sobre páginas de produto personalizadas, acessadas em 7 de outubro, ainda não mencionam cabeçalhos.⁶⁰⁸

Como as pessoas chegam a uma. Por link: “The unique URL adds a new product page ID parameter to the default product page URL.” (a URL única acrescenta um novo parâmetro de ID de página de produto à URL da página de produto padrão).⁸ Por rede de anúncios: o ID da página entra como “customProductPageIdentifier with SKOverlay” ou como parâmetro de SKStoreProductViewController.⁸ Pela busca, desde outubro de 2025: “Custom product pages with keywords assigned to them can appear in search results for those selected keywords instead of your default product page.” (páginas de produto personalizadas com palavras-chave atribuídas podem aparecer nos resultados de busca dessas palavras-chave no lugar da sua página de produto padrão).¹⁹ Pela Apple: as páginas personalizadas “can appear in editorially curated stories and collections on the Today, Games, and Apps tabs” (podem aparecer em histórias e coleções editoriais das abas Hoje, Jogos e Apps) e podem servir de base para variações de anúncios do Apple Ads.⁸⁶² Fora isso, ninguém as vê: “Custom product pages are only visible to people if they follow a custom product page link, or if you choose to make your custom product page visible in App Store search results by adding keywords.” (as páginas de produto personalizadas só ficam visíveis para quem segue um link para uma delas, ou se você decidir torná-la visível nos resultados de busca da App Store adicionando palavras-chave).⁶⁰

Revisão. “Any metadata included in your custom product pages must be submitted for review, which you can do independent of an app update.” (todo metadado das suas páginas de produto personalizadas precisa ser enviado para revisão, o que você pode fazer independentemente de uma atualização do app).⁸ Antes da primeira aprovação de um app, a página personalizada precisa ir em “the same submission as your first iOS app version.” (o mesmo envio da primeira versão do app para iOS).⁵⁰ Durante a revisão, a página fica travada: “You can’t modify a custom product page’s screenshots, previews, promotional text, or keywords, while it’s under review.” (você não pode alterar as capturas, os app previews, o texto promocional nem as palavras-chave de uma página de produto personalizada enquanto ela está em revisão).⁵⁰ Depois da aprovação, “An approved custom product page can be edited and submitted for review without affecting its unique URL. Changes are published automatically upon approval by App Review.” (uma página de produto personalizada aprovada pode ser editada e enviada para revisão sem afetar a URL única; as mudanças são publicadas automaticamente quando o App Review aprova).⁶⁰ Só atribuir palavras-chave não exige revisão (“as long as you’re just assigning keywords, you can make this live without needing to submit for review”, desde que você esteja só atribuindo palavras-chave, pode colocar isso no ar sem enviar para revisão), mas uma página só aparece na busca depois de aprovada e marcada como visível.⁶³⁶⁰ Páginas desativadas ou excluídas redirecionam para a página padrão.⁶⁰

Para que servem. Os exemplos da Apple são campanhas: um time esportivo num e-mail, as aulas de ioga de um site cujo banner vira o cabeçalho e cujo deep link abre a seção de ioga.⁸³ O número da própria Apple para o efeito é “Developers see a 2.5 percentage point increase on average when referring people to a custom product page. This is a 156% increase compared to the 1.6% average conversion rate on default product pages” (os desenvolvedores veem em média um aumento de 2,5 pontos percentuais ao direcionar pessoas para uma página de produto personalizada, 156% a mais que a taxa média de conversão de 1,6% das páginas padrão), sem data nem método informados.⁸ A otimização da página de produto não roda nelas: “Product page optimization tests aren’t available for custom product pages or for product pages on the App Store for Apple Watch or iMessage.” (os testes de otimização da página de produto não estão disponíveis para páginas de produto personalizadas nem para páginas de produto na App Store para Apple Watch ou iMessage).⁶⁴ Na minha leitura, isso faz da página personalizada a ferramenta para um público conhecido que você manda para algum lugar, e do teste a ferramenta para a página padrão, onde chegam todos os outros.

Mudar o idioma principal tem uma armadilha aqui: “If your app has a custom product page configured, you must also have uploaded screenshots in the language for each custom product page.” (se o app tiver uma página de produto personalizada configurada, você também precisa ter enviado capturas nesse idioma para cada página de produto personalizada).⁶⁵

4. Otimização da página de produto

A otimização da página de produto (Product Page Optimization) é o teste A/B da Apple para a página padrão: “Test up to three alternate product page versions against your original, view the results in App Analytics, and set the best performing version to display to everyone on the App Store.” (teste até três versões alternativas da página de produto contra a original, veja os resultados no App Analytics e defina a versão com melhor desempenho para ser exibida a todos na App Store).⁹ Os tratamentos são “shown to a percentage of randomly selected people on the App Store in iOS and iPadOS 15 or later, who will see the same treatment for the duration of your test.” (mostrados a uma porcentagem de pessoas escolhidas aleatoriamente na App Store no iOS e no iPadOS 15 ou posterior, que veem o mesmo tratamento durante todo o teste).⁹ Em 2026 um tratamento pode levar os novos recursos: o editor de tratamentos agora tem uma aba “Header and Search Results” ao lado de “App Previews and Screenshots”, o catálogo da API dá a cada localização de tratamento uma posição de cabeçalho e uma de busca, e as boas práticas da Apple dizem que “you can use product page optimization to test alternative header visuals and see which performs best.” (você pode usar a otimização da página de produto para testar visuais alternativos de cabeçalho e ver qual tem melhor desempenho).⁶⁶¹¹⁴³

Onde as páginas da Apple divergem. Sobre quantos testes: a página de marketing diz “You can create one test at a time which will run for up to 90 days” (você pode criar um teste por vez, que roda por até 90 dias), enquanto a Ajuda do Analytics responde a “Can I run multiple tests simultaneously on different elements?” (posso rodar vários testes ao mesmo tempo em elementos diferentes?) com “Yes. You can test different product page elements (screenshots, description, preview video, etc.) in separate tests at the same time.” (sim; você pode testar elementos diferentes da página de produto, como capturas, descrição ou vídeo de prévia, em testes separados ao mesmo tempo).⁹²⁰ A mesma página do Analytics inclui “descriptions” entre o que um teste pode mudar, o que nenhuma outra página que salvei faz, e sugere “extending your test beyond 90 days if possible” (estender o teste além de 90 dias, se possível), contra os 90 dias que a página de marketing e duas páginas da Ajuda, Create a test e Run a test, dão como limite, e que a própria página do Analytics trata como a janela em outros trechos.^2096768 Sobre quais apps podem testar: a Ajuda geral diz “Your app must be in the Ready for Distribution state to test its product page” (o app precisa estar no estado Ready for Distribution para testar a página de produto), enquanto a Ajuda de criação de teste aceita “a Pre-Order Ready for Distribution or Ready for Distribution status” (um status Pre-Order Ready for Distribution ou Ready for Distribution) e acrescenta “and is live on the App Store” (e estar publicado na App Store).⁶⁴⁶⁷ Todas foram acessadas na mesma manhã. Na minha leitura, o plano seguro é um teste por vez, num app publicado, por no máximo 90 dias.

Revisão. “Before you can publish your test, any new metadata that you’d like to include in your treatments must be approved by App Review.” (antes de publicar o teste, todo metadado novo que você queira incluir nos tratamentos precisa ser aprovado pelo App Review). Testes sem ícones alternativos “can be submitted for review independent of a new app version.” (podem ser enviados para revisão independentemente de uma nova versão do app).⁹ Reordenar capturas que já estão na loja, ou só trocar o ícone, não exige reenvio.⁶⁶ Se um cabeçalho já aprovado da Asset Library, escolhido com Browse Assets, pula a revisão dentro de um tratamento não é dito em nenhuma página de PPO; na minha leitura, deveria pular, já que a sessão da Apple na WWDC26 diz que os recursos aprovados ficam prontos para as posições de cabeçalho e de busca “without going through additional reviews.” (sem passar por revisões adicionais).³

As estatísticas que a Apple mostra. O teste aparece no Analytics quando “at least five first-time downloads are attributed to the test.” (pelo menos cinco primeiros downloads são atribuídos ao teste).²⁰ Os resultados usam “Bayesian techniques designed specifically for App Store product page data” (técnicas bayesianas projetadas especificamente para dados de páginas de produto da App Store), uma tabela de resultados com “Unique Impressions”, “Conversion Rate”, “Improvement” e “Confidence”, e quatro status: Performing Better, Performing Worse, Collecting Data e Likely to be Inconclusive.²⁰ “When a treatment reaches 90% confidence, it may be labeled as Performing Better or Performing Worse” (quando um tratamento atinge 90% de confiança, pode ser rotulado como Performing Better ou Performing Worse), e o intervalo de credibilidade é “a 90% probability that the true value falls within this range.” (uma probabilidade de 90% de que o valor real esteja nesse intervalo).²⁰ O conselho da Apple: esperar para aplicar ou interromper “until at least one treatment has been declared to be performing better or worse than the baseline with at least 90% confidence” (até que pelo menos um tratamento seja declarado melhor ou pior que a referência com pelo menos 90% de confiança) e, segundo o Tech Talk, rodar “for at least one week and in seven day increments.” (por pelo menos uma semana e em incrementos de sete dias).⁹⁷⁰

O que um teste pode e não pode dizer. Ele pode dizer qual de até quatro versões da página padrão converte melhor nas localizações incluídas, com 90% de confiança, se o seu tráfego chegar lá em 90 dias; “Likely to be Inconclusive” existe porque o tráfego de muitos apps não vai chegar.²⁰ Na minha leitura, ele não pode dizer por quê, não pode testar uma página de produto personalizada, não pode falar pelos compradores fora das localizações incluídas e, com menos de cinco primeiros downloads atribuídos, não diz absolutamente nada.⁶⁴²⁰

5. A Asset Library, e como a revisão funciona agora

“Use Asset Library to submit and manage your app’s images and videos across platforms, sizes, and placements, including app previews, screenshots, and custom creative assets like the product page header and in-app event cards.” (use a Asset Library para enviar e gerenciar as imagens e os vídeos do app em todas as plataformas, tamanhos e posições, incluindo app previews, capturas e recursos criativos personalizados, como o cabeçalho da página de produto e os cards de eventos no app).⁵ Ela é um item da barra lateral do App Store Connect, e toda superfície que recebe mídia (a página da versão, as páginas de produto personalizadas, os tratamentos de teste, os eventos no app) agora tem um botão Browse Assets que a abre.⁵⁶⁰⁶⁶ A visualização de detalhes de cada recurso mostra “which App Store features and placements the asset is compatible with” (com quais funcionalidades e posições da App Store o recurso é compatível) e “where this asset was most recently used.” (onde o recurso foi usado mais recentemente).⁵ Um recurso pode alimentar várias posições, e “The poster frame set applies to everywhere the asset is used.” (o quadro de capa definido vale em todos os lugares onde o recurso é usado).⁵²⁶ Nenhuma página que salvei dá um limite de quantos recursos uma biblioteca comporta.

Revisão avulsa. O novo caminho de revisão manda um recurso para revisão sem uma versão, com duas condições no texto da Apple: o app já tem uma versão aprovada, e o item ao qual o recurso está atribuído não faz parte de um envio ativo. As regras da Apple, da página de Ajuda sobre o envio pela Asset Library:¹²

• “First app version: If your app doesn’t yet have an approved version, include your assets in the same submission as your first app version.” (primeira versão: se o app ainda não tem uma versão aprovada, inclua os recursos no mesmo envio da primeira versão).
• “Subsequent updates: After your app has an approved version, you can submit standalone assets directly from the Asset Library without creating a new app version.” (atualizações seguintes: depois que o app tem uma versão aprovada, você pode enviar recursos avulsos direto da Asset Library sem criar uma nova versão).
• “Assets assigned to other items: When you submit an app version, Custom Product Page, Product Page Optimization test, or In-App Event, any assets assigned to it are automatically included in that submission and reviewed together.” (recursos atribuídos a outros itens: quando você envia uma versão do app, uma página de produto personalizada, um teste de otimização ou um evento no app, os recursos atribuídos entram automaticamente nesse envio e são revisados juntos).
• “Submission restrictions: An asset can’t be submitted on its own through the Asset Library if the item it is assigned to is already part of an active submission.” (restrições: um recurso não pode ser enviado sozinho pela Asset Library se o item ao qual está atribuído já faz parte de um envio ativo).

Um recurso avulso é julgado em relação ao app como ele está: “Standalone assets are reviewed against your app’s latest version.” (recursos avulsos são revisados em relação à versão mais recente do app).⁵ Depois de aprovado, um recurso criativo pode ir para uma página publicada sem uma versão nova: “If your app’s current version is already live on the App Store, you can update its creative assets with approved assets without submitting a new version” (se a versão atual do app já está publicada na App Store, você pode atualizar os recursos criativos dela com recursos aprovados sem enviar uma nova versão), escolhendo o recurso com Browse Assets e clicando em Publish.⁵ A sessão da WWDC26 demonstrou exatamente isso, um cabeçalho de trilha de verão trocado por um de inverno, “publishing changes directly to the App Store without a new submission.” (publicando as mudanças direto na App Store, sem um novo envio).³

Qual arquivo vai para qual espaço. O console diz que os recursos podem ser usados em diferentes pontos de contato conforme o tamanho (minha observação da página da Asset Library em 6 de outubro de 2026); essa frase não está em nenhuma página pública que encontrei. A versão pública é o catálogo de referência da API, que lista, para cada especificação, as posições que ela pode preencher.¹¹⁷¹

Fonte: leitura em produção do catálogo de referência, GET /v1/appAssetLibraryRefData, 7 de outubro de 2026, 05:51 UTC.¹¹ Uma captura nunca preenche um espaço criativo e um recurso criativo nunca preenche um espaço de captura: a categoria (APP_SCREENSHOTS_AND_PREVIEWS ou CREATIVE_ASSETS) é fixada quando o arquivo é reservado.¹¹²⁶

Status. A Ajuda lista Uploading, Processing, Prepare for Submission, Ready for Review, Waiting for Review, In Review, Accepted, Approved, Rejected e Archived.²⁵ Accepted significa aceito enquanto outra coisa do envio não foi: “All items in the submission must be accepted before any can be published.” (todos os itens do envio precisam ser aceitos antes que qualquer um seja publicado).²⁵ A Ajuda e a API definem Archived de formas diferentes. A Ajuda: “The asset belonged to a previous app version and has been replaced by a newer one.” (o recurso pertencia a uma versão anterior do app e foi substituído por um mais novo). A API: “You retired an approved asset from active use.” (você retirou de uso ativo um recurso aprovado).²⁵²⁶ Você pode excluir um recurso “only when its status is Prepared for Submission” (só quando o status é Prepared for Submission; a página de status escreve Prepare for Submission), e “Archived assets can’t be used in new placements.” (recursos arquivados não podem ser usados em novas posições).⁵²⁵

Quem pode usar: três respostas. A página da Ajuda sobre gerenciar recursos: “Required role: Account Holder, Admin, App Manager, or Marketing.” (função necessária: Account Holder, Admin, App Manager ou Marketing). A página da Ajuda sobre enviá-los: “Required role: Account Holder, Admin, or App Manager.” (função necessária: Account Holder, Admin ou App Manager). O artigo da API lista só ACCOUNT_HOLDER, ADMIN e APP_MANAGER para gerenciar a biblioteca pela API.⁵¹²²⁶ Na minha leitura, um usuário com a função Marketing pode fazer upload no console, mas não enviar, e nada documenta que uma chave de API com a função Marketing funcione de alguma forma.

6. As regras da Apple, citadas

Estas são as frases pelas quais um recurso é julgado, nas palavras da Apple. A página de boas práticas diz que elas “reflect our overarching policies as well as how we evaluate artwork for featuring, so you can put your best work forward.” (refletem nossas políticas gerais e a forma como avaliamos artes para destaque, para que você possa apresentar seu melhor trabalho).⁴³

As boas práticas de recursos, como regras

Das App Store asset best practices da Apple, acessadas em 7 de outubro de 2026; cada linha vale igualmente para capturas, app previews e recursos criativos, a menos que cite um deles.⁴³

O que pode aparecer em qualquer recurso - “Don’t include specific pricing, discounts, website URLs, copyright symbols. This ensures your content remains relevant to a global audience and more evergreen.” (nada de preços específicos, descontos, URLs de sites ou símbolos de copyright, para que o conteúdo continue relevante para um público global e dure mais). - “Avoid claims that can’t be verified, such as awards or recognition that your app or game hasn’t actually received.” (evite afirmações que não possam ser verificadas, como prêmios ou reconhecimentos que o app ou jogo não recebeu de fato). - “Don’t include logos or references to other platforms or marketplaces.” (não inclua logotipos nem referências a outras plataformas ou lojas). - “Please don’t include any Apple-designated recognitions” (não inclua reconhecimentos concedidos pela Apple), e os exemplos da Apple são “Editor’s Choice, App of the Day, Game of the Day, or Apple Design Award winner, as many of these already appear alongside your app or game in search results, as well as on your product page.” (Editor’s Choice, App do Dia, Jogo do Dia ou vencedor do Apple Design Award, já que muitos deles já aparecem junto ao app ou jogo nos resultados de busca e na página de produto). - “While you may depict content outside of your app or game in use, it must still relate to its general functionality.” (você pode mostrar conteúdo de fora do app ou jogo em uso, mas ele precisa ter relação com a funcionalidade geral).

Público - “Assets displayed on the App Store must meet a 4+ age rating, even if your app’s rating is higher and it’s intended for an older audience.” (os recursos exibidos na App Store precisam atender à classificação 4+, mesmo que a classificação do app seja mais alta e ele se destine a um público mais velho). - “Keep violent content in check. Games that include violence may use action imagery, but must avoid depictions of gore, graphic imagery, or weapons that are pointed directly at a person or the audience.” (controle o conteúdo violento: jogos com violência podem usar imagens de ação, mas devem evitar sangue explícito, imagens chocantes ou armas apontadas diretamente para uma pessoa ou para o público). - “You can localize your metadata, including images and videos, to tailor your content to each region or country in which you offer your app or game.” (você pode localizar seus metadados, inclusive imagens e vídeos, para adaptar o conteúdo a cada região ou país onde oferece o app ou jogo).

Imagens - “Consider using the latest UI and reflecting your app or game’s aesthetic. Aim for strong composition and a clear focal point for each asset.” (considere usar a interface mais recente e refletir a estética do app ou jogo; busque uma composição forte e um ponto focal claro em cada recurso). - “If using text, use a short phrase that enhances your visual rather than describes it. Be sure to localize for all languages your app supports.” (se usar texto, prefira uma frase curta que valorize o visual em vez de descrevê-lo; localize para todos os idiomas que o app suporta). - “Design key elements with a safe area in mind to accommodate different devices and orientations.” (projete os elementos principais pensando numa área segura que acomode diferentes aparelhos e orientações).

Vídeo - “Select an impactful poster frame.” (escolha um quadro de capa de impacto). - “Start strong. Lead with your value proposition or most compelling feature.” (comece forte: abra com sua proposta de valor ou sua funcionalidade mais atraente). - “Avoid quick cuts and fast-moving visuals, as these can be difficult for people to follow and may not be accessible for everyone.” (evite cortes rápidos e imagens que se movem depressa, porque são difíceis de acompanhar e podem não ser acessíveis para todos). - “Loop seamlessly. Videos autoplay and repeat, so people may see the loop multiple times.” (faça um loop sem emendas: os vídeos tocam sozinhos e se repetem, então as pessoas podem ver o loop várias vezes). - “In most cases, audio is muted by default, so your creative must work silently first.” (na maioria dos casos o áudio fica sem som por padrão, então a peça precisa funcionar primeiro em silêncio).

Por superfície - Cabeçalho: “Focus on a single, clear idea. Visually dense or cluttered assets dilute your impact.” (concentre-se numa única ideia clara; recursos visualmente densos ou poluídos diluem o impacto). “Design with a first-time visitor in mind.” (projete pensando em quem visita pela primeira vez). - Resultado de busca: “State the obvious. Since people tend to look for something specific when using search, be sure your app or game’s purpose is obvious at a glance.” (diga o óbvio: como as pessoas costumam procurar algo específico na busca, garanta que o propósito do app ou jogo fique claro num relance). “Showcase the firsthand experience.” (mostre a experiência em primeira mão). - Eventos no app: “You need media for the event card (16:9 landscape) and the event details page (9:16 portrait).” (você precisa de mídia para o card do evento, 16:9 em paisagem, e para a página de detalhes, 9:16 em retrato). “Design your media to complement the badge rather than duplicate it.” (crie a mídia para complementar o selo, não para repeti-lo). - Capturas: “Stay focused on the core user experience” (mantenha o foco na experiência principal do usuário), e depois “avoid using the entire asset to highlight general accolades or call-to-action statements.” (evite usar o recurso inteiro para elogios genéricos ou chamadas para ação). “Lead with your best features.” (abra com suas melhores funcionalidades). - App previews: “Use real-UI or gameplay.” (use a interface real ou a jogabilidade). “Tell a complete story.” (conte uma história completa). - Tudo junto: “consider using similar visual style, such as color palette, iconography, fonts, message, and tone.” (considere manter um estilo visual parecido: paleta de cores, iconografia, fontes, mensagem e tom).

Capturas no App Review: mais da metade em uso

Diretriz 2.3.3: “Screenshots should show the app in use, and not merely the title art, login page, or splash screen.” (as capturas devem mostrar o app em uso, e não apenas a arte de título, a página de login ou a tela de abertura).³⁷ Em 5 de outubro a Apple publicou uma Ajuda nova sobre ela, com link na notícia daquele dia como “new App Review guidance on how to avoid common screenshot issues.” (nova orientação do App Review sobre como evitar problemas comuns com capturas).¹⁷² O teste é uma contagem: “App Review takes the set of screenshots submitted for each supported device into account, and will approve only those submissions where more than half of screenshots show the app in use.” (o App Review considera o conjunto de capturas enviado para cada aparelho suportado e só aprova os envios em que mais da metade das capturas mostra o app em uso). O exemplo dela: “If an app has four screenshots for each device, three must show the app in use, and so on.” (se um app tem quatro capturas por aparelho, três precisam mostrar o app em uso, e assim por diante).⁷² Quadros de marketing cabem dentro dessa contagem: você pode “Include splash screens or marketing text, as long as the majority of screenshots still show the app in use.” (incluir telas de abertura ou texto de marketing, desde que a maioria das capturas continue mostrando o app em uso).⁷² O que não fazer: “Don’t submit screenshots that only show generic login pages or splash screens” (não envie capturas que só mostrem páginas de login genéricas ou telas de abertura), “Don’t let overlays or marketing visuals crowd out your app” (não deixe sobreposições ou elementos de marketing esconderem o app) e “Don’t show only the hardware or an overlay with no app interface behind it.” (não mostre só o aparelho ou uma sobreposição sem a interface do app por trás).⁷² Os conjuntos localizados são julgados um a um: “Each localization’s screenshots are still assessed on whether the majority show your app in use.” (as capturas de cada localização continuam sendo avaliadas pelo critério de a maioria mostrar o app em uso).⁷² É uma página de Ajuda, não uma mudança nas diretrizes; a revisão das diretrizes de 8 de junho de 2026 não mudou nenhum item da 2.3.⁷³

Se o App Review aplica esse teste de mais da metade aos recursos criativos não é dito em nenhum lugar que encontrei. A Ajuda chama os recursos criativos de “distinct from the in-use functionality requirement” (distintos da exigência de mostrar a funcionalidade em uso), o que, na minha leitura, significa que não.⁵

O resto da diretriz 2.3, e duas vizinhas

Das App Review Guidelines (“Last Updated: June 8, 2026”):³⁷

• 2.3: “make sure all your app metadata, including privacy information, your app description, screenshots, and previews accurately reflect the app’s core experience and remember to keep them up-to-date with new versions.” (todos os metadados devem refletir com precisão a experiência principal do app e ser atualizados a cada nova versão).
• 2.3.2: “make sure your app description, screenshots, and previews clearly indicate whether any featured items, levels, subscriptions, etc. require additional purchases.” (deixe claro se itens, níveis ou assinaturas mostrados exigem compras adicionais).
• 2.3.4: “previews may only use video screen captures of the app itself.” (os app previews só podem usar gravações de tela do próprio app).
• 2.3.7: “Metadata such as app names, subtitles, screenshots, and previews should not include prices, terms, or descriptions that are not specific to the metadata type.” (os metadados não devem incluir preços, termos ou descrições alheios ao tipo de metadado).
• 2.3.8: “make sure your app and in-app purchase icons, screenshots, and previews adhere to a 4+ age rating even if your app is rated higher.” (ícones, capturas e app previews precisam atender à classificação 4+, mesmo que o app tenha classificação mais alta).
• 2.3.9: “You are responsible for securing the rights to use all materials in your app icons, screenshots, and previews, and you should display fictional account information instead of data from a real person.” (você é responsável por garantir os direitos de todo o material e deve mostrar dados de conta fictícios, não de uma pessoa real).
• 2.3.10: “don’t include names, icons, or imagery of other mobile platforms or alternative app marketplaces in your app or metadata, unless there is specific, approved interactive functionality.” (não inclua nomes, ícones ou imagens de outras plataformas móveis ou lojas alternativas, salvo uma funcionalidade interativa específica e aprovada).
• 2.3.13, para eventos: “All event metadata must be accurate and pertain to the event itself, rather than the app more generally.” (todos os metadados do evento devem ser precisos e tratar do próprio evento, não do app em geral).
• 4.1(c), incluída em 13 de novembro de 2025: “You cannot use another developer’s icon, brand, or product name in your app’s icon or name, without approval from the developer.” (você não pode usar o ícone, a marca ou o nome de produto de outro desenvolvedor no ícone ou no nome do seu app sem a aprovação dele).⁷⁴
• 5.2.4(b): se o seu app for escolhido como Editor’s Choice, “Apple will apply the badge automatically.” (a Apple aplicará o selo automaticamente).

Imagens de aparelhos e selos no marketing

As Marketing Guidelines da Apple regem as imagens de aparelhos e o selo da App Store no marketing fora dos espaços da própria loja: “Use Apple-provided product bezels in all your marketing materials to display your app on the Apple devices it supports. Always use the latest-generation devices for which your app is currently developed.” (use as molduras de produto fornecidas pela Apple em todo o material de marketing para mostrar o app nos aparelhos Apple que ele suporta, e use sempre os aparelhos de última geração para os quais o app é desenvolvido).⁷⁵ As imagens de produtos da Apple devem ser usadas “as is” (como estão) e “without modification” (sem modificação), o que exclui reflexos, sombras, cortes, inclinações, animações, espelhamentos ou rotações; “You can place promotional copy or violators beside the product images, not on top of them.” (você pode colocar texto promocional ou selos chamativos ao lado das imagens do produto, não por cima delas).⁷⁵ As diretrizes também proíbem “Rendering in 3D or creating any simulation of an Apple product” (renderizar em 3D ou criar qualquer simulação de um produto Apple), fixam “200 px onscreen” (200 px na tela) como tamanho mínimo do aparelho e pedem “a full network icon or product designator, a full Wi-Fi icon, and a full battery icon” (um ícone de rede completo ou um designador de produto, um ícone de Wi-Fi completo e um ícone de bateria completo) na barra de status.⁷⁵ Para o selo: “Use one App Store badge per layout or video” (use um selo da App Store por layout ou vídeo) e “Don’t modify, angle, or animate the App Store badge.” (não modifique, incline nem anime o selo da App Store).⁷⁵ O post de 22 de setembro aplicou essas regras às próprias capturas; na minha leitura, elas valem igualmente para um cabeçalho ou recurso de busca que mostre um aparelho Apple.⁴¹

Anúncios

Quando esses recursos rodam no Apple Ads, vale uma política mais rígida: “Pricing, offers, or other incentivized promotions are not allowed in your app icon, name, subtitle, custom product page assets, or creative assets. App rankings, app awards claims, and promoting in-app purchases are also not allowed.” (preços, ofertas ou outras promoções com incentivo não são permitidos no ícone, no nome, no subtítulo, nos recursos de páginas personalizadas nem nos recursos criativos; posições em rankings, alegações de prêmios e promoção de compras dentro do app também não).⁴⁴ E sobre idioma: “The custom product page and creative assets that you use must match the default language for the associated App Store country or region where your campaign is set to run. You can include a creative asset with no text that can be used when you don’t have a localized image or video.” (a página personalizada e os recursos criativos precisam corresponder ao idioma padrão do país ou região da App Store onde a campanha roda; você pode incluir um recurso criativo sem texto para usar quando não tiver uma imagem ou um vídeo localizados).⁴⁴

Localização

Os metadados da App Store agora vêm em 50 localizações: a notícia de 31 de março de 2026 acrescentou 11, “bringing the total number of supported localizations to 50.” (elevando o total de localizações suportadas para 50).³⁵ Um idioma novo começa como cópia: “screenshots and the properties for the new language default to those of the primary language, except for the description and keywords.” (as capturas e as propriedades do novo idioma assumem por padrão as do idioma principal, exceto a descrição e as palavras-chave).⁶⁵ Quando nenhuma localização corresponde, “the next most relevant localization is used” (usa-se a próxima localização mais relevante), e nos demais casos aparece o idioma principal.⁶⁵ Para app previews: “If an app preview is not provided for a specific language, the preview in the next best available language appears on your App Store product page.” (se não houver app preview para um idioma, aparece na página de produto o do próximo melhor idioma disponível).¹³

Onde as próprias páginas da Apple divergem

Duas divergências menores ficam onde aparecem: o catálogo rotula os tamanhos de Mac como 16:9 onde a Ajuda diz 16:10 (seção 2), e a página do Analytics inclui as descrições entre o que um teste pode mudar e sugere passar dos 90 dias (seção 4).

7. Como medir

O App Analytics, dentro do App Store Connect, é onde essas superfícies reportam, e a Apple o reconstruiu este ano: a notícia de 25 de março de 2026 chamou a mudança de “biggest update since its launch” (a maior atualização do Analytics desde o lançamento), com “More than 100 new metrics” (mais de 100 métricas novas), coortes e comparativos com apps semelhantes.⁷⁶ O que ele pode mostrar sobre uma página de produto:

O que “conversão” significa ali. A Apple define Conversion Rate como “Total downloads and pre-orders divided by unique device impressions” (o total de downloads e pré-encomendas dividido pelas impressões únicas por aparelho), e uma impressão como uma exibição “on the Today, Games, Apps, and Search tabs of the App Store for more than one second” (nas abas Hoje, Jogos, Apps e Buscar da App Store por mais de um segundo), que “Includes product page views.” (inclui as visualizações da página de produto).⁷⁷ Então a taxa de conversão de uma página não é a parcela dos visitantes da página que baixaram o app; ela conta todo mundo que viu o app em qualquer lugar da loja por um segundo. Já na tabela de resultados de um teste, Conversion Rate é “the percentage of viewers who downloaded your app” (a porcentagem de quem viu e baixou o app) para cada variante.²⁰ Na minha leitura, os dois números não são comparáveis, e uma mudança de cabeçalho deve ser julgada por um teste, não olhando a taxa de conversão do painel subir ou descer.

O que não dá para medir. Nenhuma página do Analytics que salvei cita uma métrica para o cabeçalho da página de produto ou para o recurso de resultados de busca; na minha leitura, o jeito mais limpo de medir um deles é um tratamento de teste, e o outro caminho é uma página de produto personalizada, que tem cabeçalho próprio e cuja conversão o Analytics reporta em relação à página padrão.⁷⁷⁶⁶ Não há dados por palavra-chave: no group lab do App Store Connect na WWDC26, a resposta da Apple foi “We don’t provide keyword level data in ASC” (não fornecemos dados por palavra-chave no ASC), com a sugestão de usar duas páginas de produto personalizadas, uma para anúncios e outra para a busca orgânica, para separar as duas.⁴⁵ Páginas personalizadas individuais só podem ser exportadas “in the detailed reports, which have more rigorous privacy protections than the standard reports.” (nos relatórios detalhados, que têm proteções de privacidade mais rigorosas que os relatórios padrão).⁷⁹ As indicações não têm métrica nenhuma. E a alegação de efeito da própria Apple para as páginas personalizadas, o ganho de 2,5 pontos citado na seção 3, vem sem data nem método.⁸

8. O que um agente pode automatizar

O trabalho dos nossos apps na App Store é feito por agentes pela App Store Connect API, então esta é a seção que li com mais rigor. O arquivo OpenAPI que a Apple distribui com a documentação é a versão 4.5.1, modificada pela última vez em 6 de outubro de 2026; a sessão da WWDC26 prometia o lado da API (“you can upload and submit to Asset Library, using the App Store Connect API as well”, você também pode fazer upload e enviar para a Asset Library pela App Store Connect API).¹⁶³

O principal: toda a mídia de marketing foi para a biblioteca de recursos. As notas de versão da 4.5.1 acrescentam imagens, vídeos, posições, ordenação de posições e dados de referência da biblioteca, e “Target iPhone Duo screenshots and app previews with the new IPHONE_DUO display class in AppAssetLibraryDisplayClass.” (direcione capturas e app previews do iPhone Duo pela nova classe de tela IPHONE_DUO em AppAssetLibraryDisplayClass). Elas também tornam obsoleto o caminho antigo: “The App Screenshot Sets, App Screenshots, App Preview Sets, and App Previews resources are deprecated” (os recursos App Screenshot Sets, App Screenshots, App Preview Sets e App Previews estão obsoletos), assim como os recursos de capturas e clipes de vídeo de eventos.¹⁵ Cada página de recurso antigo agora abre com “This resource is deprecated. Use the App Asset Library and App Asset Library placements instead.” (este recurso está obsoleto; use a App Asset Library e as posições dela).⁸¹ O arquivo legível por máquina não acompanhou: o documento OpenAPI ainda não marca essas operações de criação como obsoletas, embora marque a versão 1 do recurso de experimentos.¹⁶ Para o iPhone Duo, a documentação aponta numa só direção: ScreenshotDisplayType e PreviewType, que os recursos antigos exigem, não têm valor para o Duo no arquivo 4.5.1, então o caminho documentado da API para capturas e app previews do Duo é a biblioteca de recursos, pela classe de tela IPHONE_DUO e pelo grupo de posição IPHONE_DUO_PROFILE.¹⁶¹¹ Isso bate com o que o post de 22 de setembro encontrou no arquivo 4.5: oito tipos de tela de iPhone e nenhum para o Duo.⁴¹ O serviço em produção, porém, está à frente do próprio arquivo. Meu GET somente leitura dos conjuntos de capturas do Kiradex pelo recurso obsoleto appScreenshotSets devolveu o conjunto do Duo dele com "screenshotDisplayType": "APP_IPHONE_DUO", um valor que o enum da 4.5.1 não lista, e a leitura de posições devolveu os mesmos dez quadros em IPHONE_DUO_PROFILE.¹⁷²⁸ Então o recurso antigo pelo menos consegue reportar um conjunto do Duo. Se ele aceita uma criação com APP_IPHONE_DUO continua sem verificação: testar isso exige uma escrita, e não fiz nenhuma. Um agente deve construir sobre a biblioteca de recursos, que é o caminho que a Apple documenta.

Recurso por recurso

A última linha é minha leitura do arquivo OpenAPI, não um artigo da Apple: o item de um envio para revisão pode apontar para uma imagem ou um vídeo da biblioteca, que é como um envio avulso de recurso se expressa na API. Os artigos da Apple sobre a biblioteca de recursos só descrevem posições que vão junto com a superfície-mãe.¹⁶²⁷

O fluxo de upload

1. GET /v1/apps/{id}/assetLibrary e guarde o id.
2. GET /v1/appAssetLibraryRefData e ajuste o arquivo a uma especificação exata; “Image specifications state exact dimensions, not ranges” (as especificações de imagem informam dimensões exatas, não faixas), com exceção dos tamanhos criativos de busca e de eventos.⁸²¹¹
3. Reserve: POST /v1/appAssetLibraryImages (ou Videos) com o nome do arquivo, o tamanho em bytes e a categoria. A resposta é AWAITING_UPLOAD com uploadOperations.⁸²
4. Faça o PUT de cada parte na URL dela. “The upload URLs are unauthenticated and time-limited, so you don’t send a JSON Web Token (JWT), and you don’t share them.” (as URLs de upload não têm autenticação e expiram, então você não envia um JSON Web Token, JWT, e não as compartilha).⁸²
5. Confirme com PATCH .../{id} e apenas uploaded: true: “Unlike the deprecated appScreenshots flow, there’s no sourceFileChecksum attribute to send” (ao contrário do fluxo obsoleto de appScreenshots, não há atributo sourceFileChecksum para enviar); a confirmação falha se os bytes recebidos não baterem com o tamanho declarado.⁸²
6. Consulte até PREPARE_FOR_SUBMISSION (ou FAILED com stateDetails), depois leia o specId, procure-o nos imageSpecs do catálogo (ou em videoSpecs) e confirme que o shortName dele é a especificação pretendida (i1320x2868a0 para uma captura de 1320 por 2868) e que o grupo de posição que você vai usar lista esse specId nos specMappings do tipo de posição; a Apple associa o arquivo durante o processamento, e o artigo dela sobre especificações diz para resolver um specId no catálogo, não numa lista fixa no código.^82837111
7. Posicione: um POST /v1/appAssetLibraryPlacements por superfície e localização, depois uma solicitação de ordenação por grupo.²⁷
8. Envie a superfície-mãe; as posições seguem o estado de revisão dela.²⁷

Duas armadilhas do artigo de migração da Apple. “You can only create placements while the parent surface is editable, so migrate against an App Store version in PREPARE_FOR_SUBMISSION rather than one that’s already approved.” (você só pode criar posições enquanto a superfície-mãe é editável, então migre contra uma versão em PREPARE_FOR_SUBMISSION, não contra uma já aprovada). E as exclusões vão na ordem inversa: “Delete the placements first, then the asset.” (exclua primeiro as posições, depois o recurso).⁸³ Para app previews, o audioRequired: true do catálogo significa uma faixa de áudio, silenciosa se for o caso; estéreo é a especificação da Ajuda, não a do catálogo.¹¹⁴⁸

O que não tem API e precisa do console

• A ferramenta de prévia. Nenhum endpoint renderiza a página de produto ou o resultado de busca; a checagem é uma pessoa, ou um agente operando o console, olhando no iPhone, no iPad e no Duo, nas duas orientações e no modo escuro.¹¹⁶
• Trocar um recurso criativo numa versão publicada. O fluxo da Ajuda é Browse Assets e depois Publish, na versão publicada; a API só cria posições numa superfície-mãe editável, então, na minha leitura, essa troca é um passo de console.⁵⁸³
• “Use header asset in search results”. Não existe essa opção na API; o equivalente, na minha leitura do modelo de posições, é uma segunda posição do mesmo recurso universal.⁵¹¹
• Confirmar um cabeçalho publicado pelo console. A leitura de posições é onde a API deveria mostrá-lo, como uma posição PRODUCT_PAGE_HEADER_ASSET ou APP_STORE_SEARCH_RESULTS_ASSET na localização da versão, mas nenhum dos nossos apps tem uma ainda, então se um cabeçalho publicado pelo console aparece ali continua sem verificação (seção 9).²⁷²⁸
• As escolhas de redimensionamento do Media Manager (Ajuda: “to manage scaled app previews and screenshots for other device sizes, select View All Sizes in Media Manager”; ou seja, para gerenciar app previews e capturas redimensionadas para outros tamanhos de aparelho, selecione View All Sizes no Media Manager)⁵, e as checagens de comprimento: o arquivo OpenAPI não codifica nenhum dos limites de texto da Ajuda (nenhuma string nele tem maxLength), e não fiz nenhuma escrita, então se o servidor rejeita uma string longa demais continua sem verificação; o script do próprio agente confere cada comprimento antes de enviar qualquer coisa.¹⁶²⁴
• Chaves com a função Marketing. O artigo da API cita só Account Holder, Admin e App Manager para a biblioteca.²⁶
• Posições de anúncios e de retenção. Os enums citam SEARCH_RESULTS_ADS_ASSET, TODAY_TAB_ADS_ASSET e RETENTION_MESSAGE_ASSET, mas o catálogo em produção devolve só quatro funcionalidades e sete tipos de posição; a Apple diz para “treat a feature that’s absent as unavailable for your app.” (tratar uma funcionalidade ausente como indisponível para o seu app).¹¹⁷¹

9. Nossos apps em 7 de outubro de 2026

Li nossa conta do App Store Connect em 7 de outubro de 2026, no intervalo 05:47:01 to 05:51:14 UTC; depois, numa segunda passada, no intervalo 05:51:43 to 05:52:03, as imagens e os vídeos da biblioteca de recursos de cada app, com as consultas públicas dos EUA para as avaliações em estrelas; e li a conta de novo no intervalo 08:04:24 to 08:05:53 UTC para as posições de recursos de cada versão publicada e das duas versões aguardando revisão; toda solicitação foi um GET somente leitura e nada foi escrito.³⁰²⁸ A conta tem 28 apps. Nove têm uma versão publicada; 19 nunca tiveram: Kiradex e Founder Camera estão aguardando revisão, e os outros 17 têm cada um uma 1.0 em Prepare for Submission, sem nada em nenhuma superfície. Por plataforma, esses 17 são 12 apps de iOS (três dos quais também têm uma 1.0 de Mac ou de tvOS), 4 apps só de Mac e 1 app só de visionOS.³⁰ Dois nomes mudaram no caminho até a loja: Banana List é publicado como Get Bananas, e Yawara como Randori; não existe nenhum app Water na conta.³⁰

Nossos apps por superfície, desenhados por script a partir das respostas da API salvas em 7 de outubro (a coluna de cabeçalho e busca vem da leitura de posições, 08:04:24 to 08:05:53 UTC); os 17 apps que só têm uma 1.0 não enviada ficam de fora.³⁰²⁸

As contagens de capturas são as do idioma principal (inglês, EUA), na versão que o comprador vê, ou na versão pendente para os dois apps sem nenhuma publicada. A coluna de iPhone conta o conjunto de Dynamic Island grande: 1320 por 2868 em todos os apps menos o Tappy Color, cujos seis quadros têm 1290 por 2796.⁴⁷ “Imagens na biblioteca” conta cada imagem da Asset Library do app por GET /v1/appAssetLibraries/{id}/images, lida na segunda passada, 05:51:43 to 05:52:03 UTC, e não na janela da própria linha; o número entre parênteses é a categoria CREATIVE_ASSETS.³¹

O que as superfícies têm, onde há alguma coisa:

• Reps tem a única página de produto personalizada, “Progress Pics (all locales)”, aprovada e visível em 22 idiomas, com 8 capturas de iPhone e 7 de iPad em cada, sem app preview, sem texto promocional e sem deep link.⁸⁵ O único evento no app dele, “Progress Pics”, está aprovado com o selo Major Update, é publicado em 7 de outubro às 14:00 UTC, começa em 8 de outubro e termina em 8 de novembro, em 175 territórios, com um deep link para o app.⁸⁵ Os três recursos criativos dele são o card de 1920 por 1080 e a imagem de detalhes de 1080 por 1920 desse evento, ambos aprovados, e uma reserva do card cujo upload nunca terminou.⁸⁵ Todos os 22 idiomas da versão de iOS publicada do Reps têm texto promocional; o inglês diz “New: Progress Pics. Front, side and back on the same mark every time. Encrypted on your iPhone, synced only through your own iCloud, never on our servers.” (novidade: Progress Pics; de frente, de lado e de costas sempre a partir da mesma marca; criptografadas no seu iPhone, sincronizadas só pelo seu próprio iCloud, nunca nos nossos servidores).⁸⁵
• Tappy Color tem duas páginas de produto personalizadas: uma aprovada, com 6 capturas em cada um de dois tamanhos e texto promocional, e uma em Prepare for Submission com 10 em cada; nenhuma tem deep link.⁴⁷
• Kiradex tem as únicas capturas do Duo da conta: cinco da tela interna em paisagem (2853 por 2007) e cinco da tela externa em retrato (1398 por 2034), ao lado de oito de 1320 por 2868, todas na 1.0 que está aguardando revisão.¹⁷ A única indicação dele, do tipo App Launch, foi enviada em 7 de outubro às 04:37 UTC com início de publicação em 23 de outubro, o primeiro dia do Duo à venda.⁹²⁶ O texto promocional dele: “Scan a card and it’s registered. Every set, English and Japanese. Your lists live in your own iCloud: no account, no ads.” (escaneie uma carta e ela está registrada; todas as coleções, em inglês e japonês; suas listas ficam no seu próprio iCloud: sem conta, sem anúncios).¹⁷
• 941 Tiles é um app de Mac, publicado a US$ 14,99, com capturas de Mac em 17 idiomas e texto promocional só na 1.3.1, que ainda não foi enviada.⁹¹

As lacunas, contadas. Nenhum app tem teste de otimização da página de produto, app preview ou vídeo de qualquer tipo na biblioteca.³⁰³¹ Sete apps de iPhone publicados poderiam rodar um teste e nenhum roda.³⁰⁶⁷ Só o Kiradex tem um conjunto do Duo.¹⁷ Nenhuma imagem de biblioteca corresponde a uma especificação de cabeçalho ou de resultados de busca, os únicos recursos criativos da conta são as mídias do evento do Reps, e a leitura de posições não encontrou nenhuma posição de cabeçalho ou de resultados de busca em nenhuma das 258 localizações.³¹²⁸ Das páginas personalizadas que existem, nenhuma tem deep link.⁸⁵⁴⁷ Falta texto promocional na maioria das páginas publicadas: Return e Get Bananas nos 27 idiomas, Ace Citizenship em 10 de 12, Tappy Color e ResumeGeni for iOS no único idioma de cada, Reps no Mac e no tvOS 1.6.2 publicado, e 941 Tiles na versão publicada; o tvOS 1.6.3 do Reps, em revisão, tem o texto nos 22 idiomas, assim como a 1.3.1 não enviada do 941 Tiles nos 17.³⁰⁸⁵⁹¹ Os onze idiomas do Founder Camera que não são inglês não têm capturas próprias, e o conjunto de 5,5 polegadas do Ace Citizenship só existe em inglês; a leitura de posições devolveu listas vazias para essas onze localizações do Founder Camera, e quais imagens um comprador vê nesses idiomas depende de um fallback da loja que a API não informa.^84882893

O que a leitura de posições mostra, e o que ela não consegue mostrar. O artigo da Apple sobre posicionar recursos cita a leitura que lista cada posição de uma superfície, GET /v1/appStoreVersionLocalizations/{id}/placements.²⁷ Fiz essa leitura em 7 de outubro, no intervalo 08:04:24 to 08:05:53 UTC, para cada localização das 14 versões publicadas (245 localizações) e das versões do Kiradex e do Founder Camera aguardando revisão (mais 13), 258 solicitações e nenhum erro; o tvOS 1.6.3 do Reps, em revisão naquela manhã, ficou de fora.²⁸ Ela devolveu 2.073 posições, e todas são APP_SCREENSHOT: nenhum PRODUCT_PAGE_HEADER_ASSET, nenhum APP_STORE_SEARCH_RESULTS_ASSET e nenhum APP_PREVIEW em nenhum app.²⁸ As posições de capturas batem com as contagens de capturas da tabela, quadro a quadro, então a leitura enxerga capturas enviadas antes de a biblioteca existir, e as bibliotecas concordam: a categoria criativa delas só tem as mídias do evento do Reps, e a Ajuda diz que os cabeçalhos ficam na Asset Library.²⁸³¹⁵ Dois detalhes para quem escreve scripts contra ela: cada posição traz um state de ACTIVE, ou de INACTIVE nas 85 posições de Mac publicadas do 941 Tiles, e nenhum dos dois valores está no enum AppAssetLibraryPlacementState do arquivo 4.5.1; e os quadros do Duo do Kiradex ficam em IPHONE_DUO_PROFILE.²⁸¹⁶ O que a leitura ainda não consegue mostrar é se um cabeçalho publicado pelo console aparece nela, já que nenhum dos nossos tem um para comparar. Na minha leitura do modelo de posições, ele apareceria como uma posição PRODUCT_PAGE_HEADER_ASSET, e o primeiro cabeçalho que publicarmos será o teste. As avaliações em estrelas vêm só da consulta pública dos EUA, e o Analytics não foi lido (a API de relatórios dele exige antes uma solicitação de relatório, que é uma escrita).⁹³

O que as bibliotecas têm, por especificação. Uma imagem de biblioteca carrega um specId, a especificação do catálogo à qual o App Store Connect associou o arquivo durante o processamento, e as páginas da Apple dizem para resolver um specId devolvido num recurso “by looking it up in the catalog” (procurando-o no catálogo).⁷¹⁸² Cruzadas com os imageSpecs do catálogo, 3.546 das 3.655 imagens de biblioteca da conta se resolvem, e cada uma tem as dimensões da sua especificação; o shortName da especificação a identifica, então os quadros da tela externa do Kiradex se resolvem para i1398x2034a0 e os da tela interna para i2853x2007a0.³¹¹¹ Por especificação, as bibliotecas têm 1.168 imagens em i1320x2868a0 (o iPhone de Dynamic Island grande), 815 em i2064x2752a0 (o iPad de 13 polegadas), 437 em i416x496a0 e 75 em i368x448a1 (Apple Watch), 425 em i2880x1800a1 e 141 em i2560x1600a1 (Mac), 302 em i3840x2160a1 e 111 em i1920x1080a1 (Apple TV), 23 em i1290x2796a0, 22 em i1242x2208a1, 15 em i1398x2034a0 e 5 em i2853x2007a0 (o Duo, todas do Kiradex), 5 em i2048x2732a0, e uma em cada uma das especificações do card de evento, i16x9w1920~3840a0, e da página de detalhes do evento, i9x16w1080~2160a0, ambas do Reps. Nenhuma se resolve para a do cabeçalho, i3840x1646a0, para a universal, i5244x2950a0, nem para a do recurso de busca, i3x2w1920~3840a0.³¹¹¹ A biblioteca do Kiradex tem dez imagens de tela externa a mais do que a página dele posiciona, em Prepare for Submission.³¹²⁸ As 109 imagens que não se resolvem são a reserva de card do Reps cujo upload nunca terminou e todo o conjunto de Mac publicado do Get Bananas: 4 capturas em cada um de 27 idiomas, 108 imagens, aprovadas e posicionadas em MAC_PROFILE, com 1800 por 1104 e specId nulo. 1800 por 1104 não é um dos quatro tamanhos de Mac da Ajuda, todos em 16:10, e não corresponde a nenhuma especificação do catálogo, cujo MAC_PROFILE lista só i2880x1800a1, i2560x1600a1, i1440x900a1 e i1280x800a1.^8731281311

10. O brief: o que o agente de cada app constrói e as checagens que precisa passar

Esta seção foi escrita para os agentes que cuidam da presença de cada app na App Store. Cada item diz o que construir, a checagem que prova que está feito (uma leitura da API, um script rodado no arquivo ou uma captura da ferramenta de prévia do App Store Connect) e onde o app estava em 7 de outubro de 2026, segundo a leitura da seção 9. Todo limite aqui é da Apple, com fonte acima; a ordem e as escolhas são minhas. Nada disto deve ser escrito no App Store Connect sem a revisão normal da mudança por mim.

O kit comum

Todo app de iPhone e iPad com uma versão publicada recebe os dez itens, e o K3 tem duas partes: o conjunto de iPhone para todos eles, e o conjunto de iPad de 13 polegadas para cada app que roda no iPad, que a Ajuda põe como condição para o envio.¹³ O cabeçalho, o recurso de resultados de busca, as páginas de produto personalizadas, os testes e os eventos só existem para iPhone e iPad.⁵⁸⁹²¹

K1. Um cabeçalho da página de produto. Construa um PNG universal de 16:9, com 5244 por 2950, que também preenche o K2, ou um PNG dedicado de 21:9 com exatamente 3840 por 1646 (PNG porque o catálogo da API não aceita outra coisa para a imagem do cabeçalho). Sem canal alfa. Conteúdo principal dentro do retângulo seguro do modelo (seção 2). Classificação 4+; sem preços, descontos, URLs, símbolos de copyright, logotipos de outras plataformas nem reconhecimentos concedidos pela Apple; texto, se houver, uma frase curta localizada para cada idioma, ou nenhum texto.^4112943 - Checagem, script: o arquivo é PNG, com exatamente 5244 x 2950 ou 3840 x 1646, sem canal alfa. - Checagem, leitura: GET /v1/appAssetLibraries/{id}/images?filter[category]=CREATIVE_ASSETS o devolve com essa largura e altura, um specId que no catálogo se resolve para i5244x2950a0 ou i3840x1646a0, e state APPROVED; GET /v1/appStoreVersionLocalizations/{id}/placements?filter[placementType]=PRODUCT_PAGE_HEADER_ASSET devolve uma posição em cada idioma. Se o primeiro cabeçalho publicado pelo console não gerar nenhuma posição nessa leitura, a captura da ferramenta de prévia abaixo é a checagem de aceitação, e a posição ausente é registrada como uma lacuna da API.¹⁶¹¹²⁸ - Checagem, captura: a ferramenta de prévia no iPhone, no iPad e no iPhone Duo, em retrato e paisagem, nos modos claro e escuro, em cada idioma; nada importante cortado.¹⁶ - Em 7 de outubro: nenhuma imagem de biblioteca da conta se resolve para uma especificação de cabeçalho, e a leitura de posições não devolveu nenhum PRODUCT_PAGE_HEADER_ASSET em nenhuma localização (08:04:24 to 08:05:53 UTC); o console não foi verificado.³¹²⁸

K2. Um recurso de resultados de busca. O arquivo universal do K1 posicionado uma segunda vez, ou uma imagem de 3:2 entre 1920 por 1280 e 3840 por 2560. Deixe o propósito do app “obvious at a glance” (óbvio num relance) e mostre a interface ou o conteúdo.⁴⁴³ - Checagem, script: 3:2 dentro dessa faixa, ou o tamanho universal; sem canal alfa. - Checagem, leitura: o specId da imagem de biblioteca se resolve para i5244x2950a0 ou i3x2w1920~3840a0, e a mesma leitura de posições com filter[placementType]=APP_STORE_SEARCH_RESULTS_ASSET devolve uma por idioma. Se o primeiro recurso de busca publicado pelo console não gerar nenhuma posição nessa leitura, a captura da ferramenta de prévia abaixo é a checagem de aceitação, e a posição ausente é registrada como uma lacuna da API.¹⁶¹¹²⁸ - Checagem, captura: o resultado de busca da ferramenta de prévia no iPhone e no iPad.⁵ - Em 7 de outubro: nenhum em nenhum app: nenhuma imagem de biblioteca se resolve para uma especificação de busca, e nenhuma localização tem uma posição APP_STORE_SEARCH_RESULTS_ASSET.³¹²⁸

K3. O conjunto grande de iPhone em 1320 por 2868, e o conjunto de iPad de 13 polegadas onde o app roda no iPad. Até 10 capturas de 1320 por 2868, o maior tamanho da classe Dynamic Island grande (os modelos de 6,9 polegadas, com o iPhone Air e os modelos Plus na mesma classe pela lista da Ajuda), sem canal alfa, com a interface atual, em cada idioma que a página tiver; mais da metade do conjunto de cada idioma mostrando o app em uso.¹³⁷² Onde o app roda no iPad, nas palavras da Ajuda “if your app supports iPadOS” (se o app suporta iPadOS), a Ajuda pede um segundo conjunto antes que o app possa sequer ser enviado, “At least one screenshot for iPad 13-inch display” (pelo menos uma captura para a tela do iPad de 13 polegadas), numa linha que ela marca como “Required if app runs on iPad” (obrigatório se o app roda no iPad): até 10 capturas de 2064 por 2752 ou 2048 por 2732 (2752 por 2064 ou 2732 por 2048 em paisagem), sem canal alfa, em cada idioma, com a mesma regra de mais da metade. O agente confirma isso pelo target do próprio app, cujas famílias de aparelhos precisam incluir o iPad, e não por uma lista de compatibilidade: um app só para iPhone também roda num iPad em modo de compatibilidade, e a consulta pública lista 80 modelos de iPad em supportedDevices para cada um dos nossos apps de iOS publicados, universal ou não.¹³⁷² - Checagem, leitura (iPhone): nas localizações da versão que leva o conjunto, e de novo nas localizações da versão publicada quando ela sair, para que o conjunto esteja na página e não só na biblioteca, as posições com filter[placementGroup]=IPHONE_DYNAMIC_ISLAND_LARGE_PROFILE&include=image somam de 1 a 10 em cada idioma, e cada imagem incluída tem 1320 x 2868, com um specId que se resolve para i1320x2868a0 (sem include=image a leitura não devolve dimensões).¹⁶²⁷¹¹ - Checagem, leitura (iPad, onde o app roda no iPad): as mesmas leituras com filter[placementGroup]=IPAD_13_PROFILE&include=image somam de 1 a 10 em cada idioma, e o specId de cada imagem incluída se resolve para uma das quatro especificações de captura que o catálogo associa a IPAD_13_PROFILE: i2064x2752a0, i2752x2064a0, i2048x2732a0 ou i2732x2048a0.¹⁶²⁷¹¹ - Checagem, script: uma lista rotulada dos quadros marca cada um como em uso ou não, e os quadros em uso são mais da metade, idioma por idioma e no conjunto de cada aparelho.⁷² - Checagem, captura: a ferramenta de prévia no iPhone, e no iPad para um app que roda lá, mostra cada conjunto na ordem pretendida.¹ - Em 7 de outubro: a classe está preenchida em todos os apps de iPhone publicados no idioma principal (de 5 a 8 quadros), em 1320 por 2868 em seis dos sete. Os seis quadros do Tappy Color têm 1290 por 2796, então o Tappy Color não passa nesta checagem até o conjunto ser refeito em 1320 por 2868. A 1.0.1 do Founder Camera tem o conjunto só em inglês.^30472884 - Em 7 de outubro, iPad: a consulta pública dos EUA lista iosUniversal entre as features de quatro apps publicados, Reps, Return, Get Bananas e ResumeGeni for iOS, e os quatro passam na leitura de iPad nas versões publicadas: o Reps com 7 quadros em cada um de 22 idiomas, e o Return e o Get Bananas com 5 em cada um de 27, todos se resolvendo para i2064x2752a0, e o ResumeGeni for iOS com 5 no seu único idioma, se resolvendo para i2048x2732a0. Ace Citizenship, Randori e Tappy Color não estão marcados como universais e não têm conjunto de iPad, então, por essa leitura, a parte de iPad não se aplica a eles. Nenhum dos apps aguardando revisão tem conjunto de iPad; as leituras salvas não registram a família de aparelhos deles, exceto que a indicação do Kiradex lista o iPhone como única família de aparelhos.⁹⁴²⁸

K4. O conjunto do iPhone Duo. Tela externa de 1398 por 2034 e tela interna de 2007 por 2853, nas orientações que o app suporta, enviados pela biblioteca de recursos (o caminho que a Apple documenta; seção 8) e posicionados em IPHONE_DUO_PROFILE. Num app publicado, o conjunto vai junto com a próxima versão do app: a Ajuda só leva capturas para revisão enquanto uma versão está em Prepare for Submission, em Invalid Binary ou num dos estados de rejeição, e a API só cria posições enquanto a superfície-mãe é editável. Obrigatório nos envios a partir de abril de 2027; o Duo chega aos clientes em 23 de outubro de 2026.^1315115836 - Checagem, leitura: filter[placementGroup]=IPHONE_DUO_PROFILE&include=image na leitura de posições, nas localizações da versão que leva o conjunto e de novo nas da versão publicada quando ela sair, devolve o conjunto em cada idioma, e o specId de cada imagem incluída se resolve no catálogo para uma das quatro especificações do Duo, i1398x2034a0, i2034x1398a0, i2007x2853a0 ou i2853x2007a0.¹⁶⁸³¹¹ - Checagem, captura: a ferramenta de prévia no iPhone Duo.⁶ - Em 7 de outubro: só o Kiradex, dez quadros na 1.0 pendente, em IPHONE_DUO_PROFILE pela leitura de posições.¹⁷²⁸

K5. Um app preview. 886 por 1920 (retrato) para todos os iPhones modernos e o Duo; de 15 a 30 segundos; de 23 a 30 fps; H.264 em .mov, .m4v ou .mp4 de no máximo 500 MB; uma faixa AAC estéreo a 256 kbps e 44,1 ou 48 kHz, silenciosa se o vídeo não tiver som; só gravações de tela do app; quadro de capa escolhido antes da aprovação, porque depois não pode mudar.^141148375 Para um app que roda no iPad, o app preview de iPad tem 1200 por 1600 (retrato) ou 1600 por 1200, as especificações do catálogo v1200x1600f23~30t15~30u1 ou v1600x1200f23~30t15~30u1 em IPAD_13_PROFILE, com a mesma duração, taxa de quadros e áudio; a classe de 11 polegadas aceita os mesmos dois tamanhos.¹⁴¹¹ - Checagem, script: uma análise do arquivo informa essas dimensões, essa duração, uma taxa de quadros de 23 a 30 e áudio AAC a 256 kbps e 44,1 ou 48 kHz numa faixa de dois canais ou nas duas faixas de um canal que a Ajuda também aceita. - Checagem, leitura (processado): o vídeo chega a PREPARE_FOR_SUBMISSION, não a FAILED, com um specId que se resolve para uma especificação de app preview (v886x1920f23~30t15~30u1 para o arquivo de iPhone em retrato). Esse estado não é a página: o artigo da Apple o define como “Processing succeeded and the video is ready to place.” (o processamento deu certo e o vídeo está pronto para ser posicionado).⁴⁸⁸²¹¹ - Checagem, leitura (posicionado): depois que a versão que leva o app preview passou pela revisão e foi lançada, GET /v1/appStoreVersionLocalizations/{id}/placements?filter[placementType]=APP_PREVIEW&include=video na localização da versão publicada, para cada idioma em que ele deva aparecer, devolve uma posição em cada grupo pretendido (IPHONE_DYNAMIC_ISLAND_LARGE_PROFILE para o arquivo de iPhone em retrato, IPHONE_DUO_PROFILE para o Duo, que o catálogo associa à mesma especificação de 886 por 1920, e IPAD_13_PROFILE para o arquivo de iPad) cujo vídeo incluído é o que foi enviado, com state ACTIVE, o valor que todas as posições das nossas versões de iOS publicadas tinham em 7 de outubro. O estado sozinho não prova o lançamento: as posições de Mac publicadas do 941 Tiles estavam INACTIVE naquela manhã, e as posições das duas versões aguardando revisão estavam ACTIVE, e é por isso que a checagem lê a localização da versão publicada. Posicionar o vídeo e enviar a versão são escritas, sujeitas à regra de revisão do início desta seção.^48271628 - Checagem, captura: em cada um desses idiomas a ferramenta de prévia mostra o app preview com o quadro de capa escolhido e o reproduz onde a Ajuda diz que ele fica: antes das capturas, ou em A Closer Look se a proporção dele for diferente da delas.¹⁴¹ - Em 7 de outubro: nenhum app da conta tem app preview, e nenhuma biblioteca tem vídeo.³¹

K6. Texto promocional. Até 170 caracteres em cada idioma de cada versão publicada, dizendo o que há de novo; nunca uma lista de palavras-chave.²³²⁴ - Checagem, leitura e script: GET /v1/appStoreVersions/{id}/appStoreVersionLocalizations devolve um promotionalText não vazio de no máximo 170 caracteres em cada idioma.¹⁶ - Em 7 de outubro: completo na versão de iOS do Reps, no Randori e no ResumeGeni for Safari; ausente em tudo no Return e no Get Bananas, em 10 de 12 idiomas no Ace Citizenship, no Tappy Color, no ResumeGeni for iOS, na versão de Mac do Reps e no tvOS 1.6.2 publicado dele, e na versão publicada do 941 Tiles. O tvOS 1.6.3 do Reps, em revisão, já tem o texto nos 22 idiomas, então, para o tvOS do Reps, a checagem roda contra a 1.6.3 quando ela sair, e o texto não é reescrito nesse meio-tempo.³⁰⁸⁵

K7. Uma página de produto personalizada por campanha, com deep link. Uma página para cada público que de fato mandamos para algum lugar (um link num post, um evento, um anúncio), com cabeçalho, capturas e texto promocional próprios, e um deep link do app para o conteúdo de que trata a campanha; palavras-chave só onde a página também deva ganhar na busca orgânica, cada combinação exclusiva de uma página.⁶⁰⁸³ - Checagem, leitura: GET /v1/apps/{id}/appCustomProductPages lista a página com visible true; GET /v1/appCustomProductPages/{id}/appCustomProductPageVersions mostra a versão atual com state APPROVED e um deepLink não nulo; e, para cada localização de GET /v1/appCustomProductPageVersions/{id}/appCustomProductPageLocalizations, GET /v1/appCustomProductPageLocalizations/{id}/placements?filter[placementType]=PRODUCT_PAGE_HEADER_ASSET devolve uma posição.¹⁶ - Checagem, captura: a URL da página a abre, e no iOS 18 ou posterior o botão Abrir leva à tela do deep link.⁸ - Em 7 de outubro: o Reps tem uma página e o Tappy Color duas, nenhuma com deep link; nenhum outro app tem.⁸⁵⁴⁷

K8. Um teste de otimização da página de produto com três tratamentos. Na página padrão de um app de iPhone publicado; um teste por vez; três tratamentos que variam uma só coisa (primeiro o cabeçalho); todas as localizações, salvo um motivo em contrário; deixado rodando até um tratamento ser rotulado com 90% de confiança ou passarem 90 dias, em semanas inteiras.^9672070 - Checagem, leitura: GET /v1/apps/{id}/appStoreVersionExperimentsV2 devolve exatamente um teste cujo state é APPROVED, com um startDate no passado e sem ter chegado a nenhum endDate. O state do esquema não tem um valor de “em andamento”, então, na minha leitura, essa combinação é o teste. Depois, GET /v2/appStoreVersionExperiments/{id}/appStoreVersionExperimentTreatments devolve três tratamentos, e a leitura de appStoreVersionExperimentTreatmentLocalizations de cada tratamento devolve as localizações dele.¹⁶ - Checagem, captura: a visão de otimização da página de produto no Analytics mostra o status de cada tratamento.²⁰ - Em 7 de outubro: nenhum em nenhum app; sete apps de iPhone publicados são elegíveis.³⁰

K9. Um evento no app, onde o app tiver um de verdade. Algo oportuno dentro do app, não uma tarefa diária, uma redução de preço nem uma promoção genérica; de 15 minutos a 31 dias; publicado com no máximo 14 dias de antecedência; nome de 30, descrição curta de 50 e descrição longa de 120 caracteres; mídia de 16:9 para o card e de 9:16 para os detalhes.⁵²⁵³⁴ - Checagem, leitura e script: GET /v1/apps/{id}/appEvents mostra o eventState do evento, APPROVED antes da data de publicação ou PUBLISHED depois (os estados da API vão de DRAFT, passando por APPROVED, PUBLISHED e PAST, até ARCHIVED), e as datas dele. Essa leitura não traz texto, só um link para as localizações do evento, então GET /v1/appEvents/{id}/localizations (ou include=localizations na primeira leitura, que devolve no máximo 50 por evento) fornece o texto, e o nome, a descrição curta e a descrição longa de cada localização devolvida, seguindo cada página até a última, estão dentro desses limites.¹⁶⁸⁵ - Checagem, captura: o card do evento na página de produto depois de publicado. - Em 7 de outubro: o Reps tem um, aprovado, com publicação em 7 de outubro.⁸⁵

K10. Uma indicação, quando um lançamento ou uma melhoria se qualificar. Enviada pelo menos três semanas antes da data que ela cita, o maior dos dois mínimos que as páginas da Apple informam (três semanas na Ajuda e no modelo de indicações, duas na página sobre destaque).²¹⁵⁷²² - Checagem, leitura e script: GET /v1/nominations?filter[state]=SUBMITTED a devolve, e o publishStartDate dela fica pelo menos 21 dias depois da data de envio.¹⁶ - Em 7 de outubro: o Kiradex tem uma, um App Launch para 23 de outubro, enviada com 16 dias de antecedência: mais que as duas semanas da página sobre destaque, menos que as três da Ajuda.⁹²²²²¹

Por app, onde os apps diferem

Kiradex (aguardando revisão). A versão 1.0 está aguardando revisão, então o app não tem nenhuma versão aprovada e não pode enviar um recurso avulso: até a 1.0 ser aprovada, os recursos vão junto com uma versão, e um recurso atribuído a um item que já está num envio ativo não pode ser enviado sozinho.¹⁷¹² O cabeçalho e o recurso de busca esperam, portanto, a aprovação da 1.0, e depois vão avulsos ou com a versão 1.0.1, para a qual as builds 47 e 48 já foram enviadas.¹⁷¹² A indicação para 23 de outubro fica como foi enviada. O conjunto do Duo existe (a interna em paisagem, a externa em retrato); as outras orientações ficam a critério do agente, conforme as poses que o app suporta.¹⁷ A 1.0 dele não tem conjunto de iPad, e a indicação lista o iPhone como única família de aparelhos; se o app rodar no iPad, o conjunto de 13 polegadas do K3 entra na 1.0.1.⁹⁴ O cabeçalho e o recurso de busca do Kiradex mostram a própria interface do app.

Reps (evento publicado em 7 de outubro). O evento Progress Pics é publicado às 14:00 UTC de 7 de outubro de 2026 e começa em 8 de outubro; a checagem é uma captura do card do evento na página de produto depois desse horário.⁸⁵ A página de produto personalizada dele não tem deep link: acrescente o que o evento já usa, o que manda a página de volta para revisão sem mudar a URL.⁸⁵⁶⁰ O cabeçalho, o recurso de busca e o primeiro teste do Reps devem levar a mesma ideia do Progress Pics, para que o evento, a página personalizada e a página padrão digam a mesma coisa.³ O conjunto de iPad de 13 polegadas dele, 7 quadros de 2064 por 2752 nos 22 idiomas, já passa na leitura de iPad do K3.⁹⁴ Uma reserva do card do evento na biblioteca nunca terminou o upload; remova-a se a API permitir, ou deixe-a, já que ela não posiciona nada.⁸⁵⁸³ O Mac 1.6.2 e o tvOS 1.6.2 publicado do Reps não têm texto promocional; o tvOS 1.6.3, em revisão em 7 de outubro, tem o texto nos 22 idiomas, então a versão de Mac é a que ainda está devendo (K6). Os itens de recursos criativos não se aplicam a nenhuma das duas.⁸⁵⁵

Os apps sem versão publicada. Kiradex, Founder Camera e mais 17 não têm nenhuma, e nenhum deles pode enviar um recurso avulso: o kit vai em cada primeiro envio, ou espera a aprovação dele.³⁰¹² Os 17 que só têm uma 1.0 não enviada se dividem por plataforma, e o kit se divide com eles.³⁰ Os 12 com uma 1.0 de iOS constroem do K1 ao K6 nela antes de enviá-la, com o conjunto de iPad de 13 polegadas do K3 incluído em cada um que rode no iPad, já que a Ajuda põe esse conjunto como condição para o envio, e nada mais até o lançamento; os três que também têm uma 1.0 de Mac ou de tvOS dão a essa versão só as próprias capturas e o texto promocional. Os 4 apps só de Mac recebem o kit de Mac abaixo, não do K1 ao K5: nada do cabeçalho, do recurso de busca, dos conjuntos de iPhone e iPad do K3, do conjunto do Duo nem dos tamanhos de app preview de iPhone e iPad se aplica a um app de Mac. O app só de visionOS ganha uma linha própria: um conjunto de capturas do Apple Vision Pro em 3840 por 2160 (“Required for Apple Vision Pro”, obrigatório para o Apple Vision Pro), um app preview opcional de 3840 por 2160 em paisagem e texto promocional; recursos criativos, páginas de produto personalizadas, testes e eventos são funcionalidades de iPhone e iPad, então nada mais do kit se aplica.^131458921

Founder Camera (aguardando revisão, capturas só em inglês). A versão 1.0.1, a única que o app já teve no App Store Connect, tem 12 idiomas e texto promocional em todos, mas capturas só em inglês; os outros 11 idiomas não têm nenhuma.⁸⁴ Em seguida, na primeira versão depois desta: um conjunto de capturas por idioma, um conjunto de iPad de 13 polegadas em cada um se o app rodar no iPad (a 1.0.1 não tem nenhum), o conjunto do Duo, e o cabeçalho e o recurso de busca; depois da aprovação, os recursos criativos podem ir avulsos.⁸⁴⁹⁴¹²

941 Tiles, ResumeGeni for Safari e os quatro apps só de Mac ainda não lançados. O cabeçalho e o recurso de busca são posições do iOS 27 e do iPadOS 27; as páginas de produto personalizadas são para iPhone e iPad; os testes rodam no iOS e no iPadOS; os eventos no app são só de iPhone e iPad; então nenhum do K1 ao K4 (incluindo o conjunto de iPad do K3), nem os tamanhos de iPhone e iPad do K5, nem o K7, o K8 ou o K9 se aplica.⁵⁸⁹²¹ O kit deles são capturas de Mac (um dos tamanhos 1280 por 800, 1440 por 900, 2560 por 1600 ou 2880 por 1800, todos em 16:10 e em paisagem, em cada idioma; “Required for Mac apps”, obrigatório para apps de Mac), texto promocional, um app preview opcional de 1920 por 1080 e uma indicação quando uma versão se qualificar.¹³¹⁴ Para o 941 Tiles, o primeiro passo é o texto promocional já escrito nos 17 idiomas da 1.3.1 não enviada: o texto promocional pode mudar sem uma versão nova, então pode ir para a 1.3 publicada agora.⁹¹²³

Tappy Color. A segunda página de produto personalizada dele está em Prepare for Submission: envie-a com um deep link, ou exclua-a.⁴⁷ A página na loja tem um só idioma, então o K3 e o K6 são de um idioma cada, e a consulta pública não o marca como universal, então, na minha leitura desse indicador, o K3 é só o conjunto de iPhone dele.⁴⁷⁹⁴

Return, Get Bananas, Ace Citizenship, Randori, ResumeGeni for iOS. O kit completo na versão de iOS; Return e Get Bananas também publicam versões de Mac (e o Return, de tvOS), que levam só capturas e texto.⁸⁶⁸⁷ Return, Get Bananas e ResumeGeni for iOS têm o indicador iosUniversal da consulta pública, na minha leitura o sinal de que rodam no iPad, e já passam na leitura de iPad do K3 em todos os idiomas; Ace Citizenship e Randori não estão marcados como universais, então, por essa leitura, o K3 é só o conjunto de iPhone para eles, a menos que isso mude.⁹⁴ Texto promocional primeiro: Return e Get Bananas não têm nenhum em 27 idiomas, e o Ace Citizenship tem em 2 de 12.⁸⁶⁸⁷⁸⁸ O conjunto de Mac publicado do Get Bananas também precisa ser refeito: as quatro capturas dele, nos 27 idiomas, têm 1800 por 1104, que não é um tamanho de Mac da Ajuda e não se resolve para nenhuma especificação do catálogo (seção 9). Refaça-as num dos tamanhos 1280 por 800, 1440 por 900, 2560 por 1600 ou 2880 por 1800 com a próxima versão de Mac; checagem, leitura: as posições da localização de Mac com filter[placementGroup]=MAC_PROFILE&include=image devolvem imagens cujo specId se resolve para uma de i2880x1800a1, i2560x1600a1, i1440x900a1 ou i1280x800a1.^87131116

A ordem do trabalho

1. 7 de outubro de 2026: capturar o card do evento do Reps na página de produto depois das 14:00 UTC.⁸⁵
2. Texto promocional em toda versão publicada que não tenha (K6). É texto, não precisa de versão nova e alcança o maior número de compradores com o menor trabalho.²³
3. O conjunto de iPad de 13 polegadas (K3) no primeiro envio de todo app que roda no iPad, já que a Ajuda o exige para enviar; os quatro apps publicados que a consulta marca como universais já o têm em todos os idiomas, por essa leitura, então para eles o trabalho é a leitura.¹³⁹⁴
4. Um cabeçalho universal e um recurso de busca por app de iPhone publicado (K1, K2): enviar avulso, conferir na ferramenta de prévia, publicar no console. Na minha leitura, é a maior mudança visível que a Apple lançou, e nenhum dos nossos apps a usou.
5. Conjuntos do Duo para os apps de iPhone publicados (K4), cada um com a próxima versão do app, antes de abril de 2027; quanto antes, melhor, porque o Duo chega às lojas em 23 de outubro e a aparência no Duo de uma página sem conjunto do Duo não está documentada.⁶¹³
6. Um teste por app de iPhone publicado (K8), com o cabeçalho como variável, um por vez.
7. Páginas de produto personalizadas com deep links (K7): corrigir a página existente do Reps e, depois, uma página só para as campanhas que de fato estivermos rodando.
8. App previews (K5), app por app, cada um conferido na página lançada, não só na biblioteca.
9. Eventos e indicações (K9, K10) quando um app tiver algo real a dizer, com três semanas de antecedência.

O que precisa do console

As capturas da ferramenta de prévia; publicar um recurso criativo aprovado numa versão publicada; a opção “Use header asset in search results” (na API, uma segunda posição do arquivo universal); confirmar que um cabeçalho publicado pelo console aparece na leitura de posições, até o primeiro aparecer; e ler o status de um teste no Analytics.^5832820 Todo o resto do kit tem um endpoint na seção 8.

Fora deste brief

• Campanhas do Apple Ads: as posições de anúncio ainda não estão no catálogo em produção, e o Apple Ads revisa as peças dele separadamente.¹¹⁴⁴
• Nomes, subtítulos, palavras-chave e descrições; preços, imagens de compras dentro do app, códigos promocionais e códigos de oferta.
• Testes de ícones alternativos, que precisam de cada ícone no binário publicado.⁹
• Solicitações de relatórios do Analytics, que são escritas.⁹³
• Posições de mensagens de retenção, que o catálogo em produção não oferece.¹¹

Principais conclusões

Se você faz o marketing de um app

• O topo da sua página de produto e o seu resultado de busca agora são seus para desenhar, no iOS 27 e no iPadOS 27: um cabeçalho de 3840 por 1646 e um recurso de busca em 3:2, ou um único PNG de 5244 por 2950 para os dois.⁴⁵
• Aprove os recursos criativos com antecedência na Asset Library; depois de aprovados, uma troca sazonal numa página publicada não precisa de versão nova.⁵³
• As capturas continuam passando no App Review só se mais da metade do conjunto de cada aparelho mostrar o app em uso.⁷²
• Planeje já o conjunto do iPhone Duo: externa de 1398 por 2034, interna de 2007 por 2853, obrigatório nos envios a partir de abril de 2027.¹³⁶
• Use páginas de produto personalizadas (até 70) para os públicos que você manda para algum lugar, com deep link, e um teste (até três tratamentos, até 90 dias) para a página padrão.⁸⁹
• Indique o app com pelo menos três semanas de antecedência, o maior dos dois mínimos que as páginas da Apple informam.²¹²²

Se você constrói a automação

• Capturas, app previews e recursos criativos agora passam por appAssetLibraryImages, appAssetLibraryVideos e appAssetLibraryPlacements; os recursos baseados em conjuntos estão obsoletos, e a Apple documenta os uploads do Duo só pela biblioteca (uma leitura em produção do antigo recurso de conjuntos reportou, sim, um conjunto do Duo; se ele aceita um novo não foi testado).¹⁵¹⁶¹⁷
• Reserve, faça o PUT das partes, confirme só com uploaded: true e depois leia o specId.⁸²
• Leia GET /v1/appAssetLibraryRefData para tamanhos e limites em vez de fixá-los no código, e entregue as imagens de cabeçalho em PNG.⁸³¹¹
• Dê aos app previews uma faixa de áudio (estéreo, segundo a Ajuda) e uma taxa de quadros de 23 a 30 fps, ou o processamento falha.¹¹⁴⁸
• Aplique você mesmo os limites de texto da Ajuda; o esquema da API não tem nenhum.¹⁶²⁴
• Reserve espaço para o console: a ferramenta de prévia e a troca ao vivo de um recurso criativo não têm endpoint. Leia as posições para ver o que uma página carrega, e confirme que um cabeçalho publicado pelo console aparece lá antes de confiar na leitura.^5832728

Perguntas frequentes

Quantas páginas de produto personalizadas um app pode ter?

Setenta. A Apple subiu o limite de 35, o número dado quando as páginas de produto personalizadas foram apresentadas na WWDC21, para 70 numa nota de versão datada de 28 de outubro de 2025 e numa notícia datada de 29 de outubro: “You can now create up to 70 custom product pages per app on the App Store.” (agora você pode criar até 70 páginas de produto personalizadas por app na App Store).¹⁸⁷¹⁹ Elas aparecem no iPhone e no iPad, no iOS 15 ou posterior, e os deep links delas funcionam no iOS 18 ou posterior.⁶⁰⁸

Qual é o tamanho do cabeçalho da página de produto da App Store?

Exatamente 3840 por 1646 pixels em 21:9, como imagem ou como vídeo de 5 a 30 segundos a 30 ou 60 fps. Um PNG de 16:9 com 5244 por 2950 também serve e ainda pode preencher o espaço de resultados de busca. A Ajuda aceita JPEG ou PNG para a imagem de 3840 por 1646; o catálogo de especificações da API aceita só PNG, então PNG é a escolha segura.⁴¹¹

Qual é o tamanho do recurso criativo de resultados de busca da App Store?

Uma imagem ou um vídeo em 3:2 em qualquer tamanho de 1920 por 1280 a 3840 por 2560 pixels, ou o PNG universal de 5244 por 2950. Os vídeos na busca ficam sem som e “can’t currently be unmuted” (por enquanto não dá para ativar o som).⁴ Se você não adicionar nenhum, seus eventos no app, app previews e capturas aparecem como antes.⁴³

As capturas e os recursos criativos da App Store passam pelo App Review?

Sim. Capturas e app previews são revisados com a versão, a página de produto personalizada ou o teste a que pertencem, e os recursos criativos vão junto com uma versão ou num envio avulso pela Asset Library quando o app já tem uma versão aprovada; “Standalone assets are reviewed against your app’s latest version.” (recursos avulsos são revisados em relação à versão mais recente do app).¹²⁵ Para as capturas, a exigência é que “more than half of screenshots show the app in use” (mais da metade das capturas mostre o app em uso) em cada aparelho.⁷²

Quais são os tamanhos de captura do iPhone Duo para a App Store?

1398 por 2034 pixels para a tela externa e 2007 por 2853 para a tela interna, cada um também aceito em paisagem. O app preview do Duo é o mesmo arquivo de 886 por 1920 dos outros iPhones modernos. As capturas do Duo são opcionais até abril de 2027, quando todo app enviado vai precisar delas, e na API a Apple só as documenta pela biblioteca de recursos; uma leitura em produção do recurso obsoleto de conjuntos de capturas devolveu, sim, um conjunto do Duo, mas se esse recurso aceita um novo não foi testado.^131461517

Posso mudar o cabeçalho da minha página de produto sem enviar uma nova versão do app?

Sim, se o novo recurso já estiver aprovado e a versão atual estiver publicada: “If your app’s current version is already live on the App Store, you can update its creative assets with approved assets without submitting a new version.” (se a versão atual do app já está publicada na App Store, você pode atualizar os recursos criativos dela com recursos aprovados sem enviar uma nova versão). Você o escolhe com Browse Assets e clica em Publish.⁵

Quanto tempo dura um teste de otimização da página de produto da App Store?

Até 90 dias, com até três tratamentos contra a original; a Apple recomenda esperar 90% de confiança antes de aplicar um tratamento e rodar por pelo menos uma semana, em incrementos de sete dias.⁹⁷⁰ A página de marketing da Apple diz um teste por vez; a Ajuda do Analytics dela diz que vários podem rodar em elementos diferentes.⁹²⁰

Relacionados neste site: Capturas de tela da App Store que vendem o porquê lê 37 conjuntos de capturas e as regras da Apple sobre elogios e molduras; O que o App Review procura cobre a revisão por que esses recursos passam; e a série do iPhone Duo, de Prepare seu app para o iPhone Duo a Design para o iPhone Duo e iPhone Duo para desenvolvedores, calcula as telas de onde vêm esses tamanhos de captura.

Fontes