Recuperação após instalação
Produto · v1 · Homologação · Revisado em · Markdown
Escolher o mecanismo
Seção intitulada “Escolher o mecanismo”| Mecanismo | Pré-requisito | Limite |
|---|---|---|
| Colagem explícita | Usuário copia o link, instala e confirma colagem no app | Não lê clipboard sem ação explícita; sem garantia se o conteúdo mudou |
| Google Play Install Referrer | App Android/SDK integrado e distribuição pela Google Play | Fluxo depende da loja e do referrer preservado; não cobre todas as instalações |
| Universal/App Links e scheme | Associação de domínio e identidade nativa corretas | Aplicam-se à abertura do app; não equivalem a recuperação após instalação |
| App Clip | Configuração e entrega próprias Apple | Disponibilidade depende do app/domínio e revisão/distribuição; não é habilitada só por criar um link |
| Detecção própria iOS | Opção habilitada por domínio, SDK pronto e contexto elegível | Opcional, desligada por padrão; pode não resolver por ambiguidades, atraso ou ausência de evidência |
No painel, abra Configurações / Domínios / integração nativa e confirme quais capacidades estão disponíveis. Configure identidade Android/iOS, formato de scheme e caminhos associados; habilite recuperação somente quando a integração estiver pronta. Não confunda os experimentos internos com funcionalidades liberadas para todo app.
Integração e confirmação
Seção intitulada “Integração e confirmação”No Flutter, use o SDK público para receber HTTPS/scheme/colagem e registrar abertura/conteúdo com identificadores preservados. Trate ausência de resultado, repetição, expiração e confirmação explícita. Não coloque API key administrativa no app. Teste instalação e abertura em aparelho real pela loja; teste de contrato não comprova instalação.
A API administrativa permite GET/PUT /domains/{domainId}/native-config e /recovery-config, diagnósticos e métricas agregadas. Endpoints de recuperação pública usam seus próprios contratos/capacidades, não uma chave administrativa de usuário. Contratos públicos · SDK Flutter · Diagnóstico.
Erros 403 podem indicar capacidade desligada; estado pendente pode indicar associação/DNS/TLS; resultado vazio de detecção pode ser a decisão correta em contexto ambíguo. Não use preferências do dispositivo como identidade nem trate métricas de recuperação como instalações comprovadas.