Studio

Domini personalizzati

Con un dominio personalizzato, la tua landing page, le pagine legali, il press kit, i codici QR e i deep link vengono serviti da un dominio di tua proprietà, come get.habitly.app, con HTTPS configurato per te. I domini personalizzati fanno parte del piano Studio, che include fino a 25 domini per workspace. Possono aggiungerli i proprietari e gli admin del workspace.

Cosa mostra un dominio personalizzato

Ogni dominio è collegato a una sola app:

URL	Mostra
`https://get.habitly.app/`	Landing page
`/go/{store}`	Reindirizzamento tracciato a uno store, come `/go/google_play`
`/open/{path}`	Deep link
`/privacy`, `/terms`	Informativa sulla privacy e termini, con `/{language}` facoltativo
`/press`, `/press.zip`	Press kit
`/qr.svg`, `/qr.png`	Codice QR
`/.well-known/apple-app-site-association` `/.well-known/assetlinks.json`	File di associazione per Universal Links e Android App Links

La radice mostra la landing page a tutti. A differenza di mapps.one/habitly, non reindirizza i telefoni a uno store. Usa lo smart link quando vuoi il rilevamento del dispositivo, oppure get.habitly.app/go/app_store quando vuoi uno store specifico. Gli URL dello smart link e del codice QR mostrati nella dashboard e nell'API continuano a usare mapps.one.

Prima di iniziare

Usa un sottodominio, come get., download. o app.. Lo standard DNS non consente record CNAME su un dominio radice come habitly.app.
Ti serve l'accesso alle impostazioni DNS del dominio, presso il tuo registrar o provider DNS.
Un dominio può essere collegato una sola volta in tutto mapps.one.

1. Aggiungi il dominio

Nella dashboard, apri Domini, scegli Aggiungi dominio, inserisci get.habitly.app e scegli l'app che deve mostrare. La dashboard mostra poi i record DNS da creare, incluso un token di verifica unico per il tuo dominio.

2. Crea i record DNS

Tipo	Nome	Valore	Scopo
TXT	`_mapps-verify.get.habitly.app`	`mapps-verify=your-token`	Dimostra che controlli il dominio
CNAME	`get.habitly.app`	`domains.mapps.one`	Invia il traffico a mapps.one

Se il tuo provider DNS non consente di creare un record CNAME per quel nome, crea invece un record A che punti all'indirizzo IP mostrato nella dashboard.

Molti provider DNS aggiungono automaticamente il dominio radice. In questo caso, inserisci solo la parte che lo precede: _mapps-verify.get per il record TXT e get per il record CNAME.

Usi Cloudflare? Imposta il record CNAME su DNS only (nuvola grigia). Se il record passa attraverso il proxy, il certificato non può essere emesso e i visitatori vedono un errore.

3. Verifica

Scegli Verifica ora accanto al dominio. Controlliamo il record TXT e dove punta il dominio. I domini in attesa vengono controllati anche automaticamente ogni 10 minuti, quindi puoi chiudere la pagina e tornare più tardi. Le modifiche DNS di solito compaiono in pochi minuti, ma alcuni provider impiegano qualche ora.

Stato	Significato
In attesa	In attesa che compaiano i record DNS
Verificato	Il dominio sta mostrando la tua app
Non riuscito	Un record manca o è errato. La dashboard mostra il motivo. Correggi il record e verifica di nuovo.

Quando la verifica riesce, viene inviato un webhook domain.verified.

HTTPS

Un certificato TLS viene emesso automaticamente la prima volta che qualcuno apre il dominio in HTTPS dopo la verifica. Quella prima richiesta può richiedere qualche secondo, mentre le successive sono veloci. Non c'è nulla da caricare o rinnovare.

Risoluzione dei problemi

Controlla cosa vede il resto del mondo con dig, o con un qualsiasi strumento online di lookup DNS:

dig +short TXT _mapps-verify.get.habitly.app
"mapps-verify=your-token"

dig +short CNAME get.habitly.app
domains.mapps.one.

Il nome è duplicato, come in get.habitly.app.habitly.app: il tuo provider ha aggiunto il dominio radice. Inserisci solo get.
Esiste un altro record per lo stesso nome, come un vecchio record A. Rimuovilo, perché un CNAME non può condividere il nome con altri record.
Proxy o CDN davanti al dominio: imposta il record su DNS only.
Record CAA sul tuo dominio che consentono solo una specifica autorità di certificazione possono bloccare il certificato. Rimuovili o estendili.

Rimuovi un dominio

Rimuovi il dominio nella dashboard, poi elimina i record DNS presso il tuo provider. Se il workspace lascia il piano Studio, i suoi domini personalizzati smettono di mostrare le pagine finché non passi di nuovo a un piano superiore. I link su mapps.one continuano a funzionare.