Acesso antecipadoSó por convite, e os SDKs ainda não foram publicados.Pedir um convite
Ir para o conteúdo
Docs

Configurações do projeto

O nome, as plataformas e o ícone de um projeto, a palavra para as pessoas dele, os ambientes, os apps Apple e Android verificados, a retenção e as chaves.

Um projeto guarda os eventos de um produto: um app, e o site e o backend dele, se houver. Cada projeto tem um id público aleatório, como 3f9a1c7e20bd, que o identifica nos endereços do painel e na API. Ele não diz nada sobre o projeto.

Abra Project settings no menu do projeto ou no menu de comandos. Todas as pessoas da organização do projeto podem ver as configurações; só um proprietário pode alterá-las.

Configurações do projeto

Nome

O nome mostrado em todos os lugares do Lyrelog.

Plataformas

Tudo o que envia eventos para este projeto. Adicione cada uma com Add: iOS app, Mac app, Android app, Website ou Server. Um projeto pode reunir um app, o site e o backend dele, e o painel pode mostrar cada um separadamente (veja Plataformas). Remova uma plataforma com o botão × dela.

Se chegarem eventos de uma plataforma que ainda não foi configurada, a seção avisa e oferece adicioná-la.

Cada plataforma tem os próprios detalhes:

PlataformaDetalhes
iOS app, Mac appA página dele na App Store. Pesquise na App Store, ou cole o link do app (apps.apple.com/…/id1234567890), e escolha o App Store country em que pesquisar. Vincular traz o nome, o link e o ícone do app a partir da página dele. Unlink desfaz isso.
Android appO pacote dele (com.example.app) ou o link do Google Play. Se o app estiver no Google Play, o Lyrelog pega o nome e o ícone dele.
WebsiteO endereço dele (example.com). O Lyrelog pega o ícone do site, se ele tiver um que dê para usar.
ServerA linguagem dele: Node, Python, Go, Java, Kotlin, Swift, Ruby, PHP, .NET, Rust, Elixir ou Other.

É o servidor do Lyrelog que faz as consultas na App Store, no Google Play e nos sites. O seu navegador só carrega as imagens.

Quem usa?

What to call them: a palavra que o Lyrelog usa para as suas pessoas em todas as páginas. Escolha users, players, customers, members, readers, listeners, students ou clients, ou Another word (singular e plural). O padrão é users.

Ícone

Mostrado ao lado do projeto em todos os lugares do Lyrelog. Pegue-o de uma das plataformas do projeto (App Store, Google Play ou Website, quando tiverem um) com Use this one, ou envie o seu: arraste uma imagem ou escolha uma, quadrada, em PNG, JPEG, WebP ou GIF, de até 1 MB (sem SVG). Remove tira um ícone enviado.

Ambientes

Os builds de desenvolvimento, de teste e de produção enviam para o mesmo projeto, e cada evento diz de qual deles veio. Default environment é o ambiente em que o painel abre até alguém escolher outro na barra superior. Ele é production, a menos que seja alterado; o painel também pode abrir em todos os ambientes. A seção explica como cada SDK decide o ambiente de um evento (veja Ambientes).

Alertas

E-mails quando aparece um novo tipo de erro, quando um erro dispara ou quando uma versão começa a falhar, nos planos Pro e Business. Cada pessoa ativa os que quer em Email me; os proprietários escolhem quais o projeto envia e os limiares deles. Veja Alertas.

Eventos verificados dos seus apps Apple

Aparece quando o projeto tem a plataforma iOS app. Adicione o App ID de cada um dos seus apps Apple, até 10: o seu Team ID, um ponto e o bundle id, como ABCDE12345.com.example.app. O Team ID fica na sua conta Apple Developer, em Membership. Com um App ID definido, o SDK Swift (também por baixo do React Native e do Flutter) prova com o App Attest da Apple que os eventos vêm do seu próprio app num iPhone, iPad ou Apple Watch de verdade, e eles chegam verificados. O app também precisa da capability App Attest. Sem App ID, os eventos dos seus apps chegam sem verificação. Remova um com o botão × dele.

Abaixo, Accept only verified events from the iOS app (desativado por padrão, e só disponível depois de definir um App ID) retém os eventos não verificados do app iOS até que eles consigam se provar. Deixe essa opção desativada enquanto ainda houver pessoas usando uma versão sem App Attest: o que ela faz.

Eventos verificados dos seus apps Android

Aparece quando o projeto tem a plataforma Android app. Adicione o package de cada app, como com.example.app (preenchido a partir da plataforma Android app, quando houver), com a SHA-256 fingerprint de um certificado com que ele é assinado (como o Play Console a mostra, AB:CD:...). Adicione o mesmo pacote de novo para cada certificado que assina builds que enviam eventos: até 5 por pacote, e até 10 pacotes. Com um definido, o SDK Android (também por baixo do React Native e do Flutter) prova com o Key Attestation que os eventos vêm do seu próprio app num dispositivo Android de verdade, e eles chegam verificados. Sem nenhum, os eventos dos seus apps Android chegam sem verificação. Remova um certificado com o botão × dele.

Abaixo, Accept only verified events from the Android app (desativado por padrão, e só disponível depois de definir um pacote) retém os eventos não verificados do app Android até que eles consigam se provar. Deixe essa opção desativada enquanto ainda houver pessoas usando uma versão sem Key Attestation: o que ela faz.

Manter os eventos por

7, 14, 30, 60, 90 ou 180 dias, ou 1 ano. Os eventos mais antigos são excluídos automaticamente. Aumentar o prazo vale na hora. Reduzir pede confirmação antes, porque os eventos mais antigos que o novo limite são excluídos para sempre, em poucas horas. Veja Retenção.

Plano

O plano da organização e os eventos dela neste mês. Todos os projetos de uma organização compartilham o plano, então os eventos deles contam juntos. Veja Planos e uso.

Pessoas com acesso

Todas as pessoas da organização do projeto veem todos os projetos dela. Esta seção tem um link para a página da organização, onde os proprietários convidam pessoas e mudam os papéis delas. Veja Organizações.

Chaves de API

API keys: as chaves com que os seus apps enviam eventos, e aquelas com que os scripts os leem. Crie uma com um nome e um escopo (Send events, Send events from a server, Read events, Full access), copie-a enquanto ela é mostrada e revogue-a quando não for mais necessária. Cada chave mostra quando foi usada pela última vez. Veja Chaves.

Detalhes

O id do projeto, o slug dele, por quanto tempo os eventos são mantidos e quando o projeto foi criado.

Os dados de uma pessoa

Encontre uma das suas pessoas pelo id de usuário dela, baixe os eventos dela ou exclua-os, para responder a um pedido de privacidade. O nome da seção usa a palavra do projeto ("A player's data"). Veja Os dados de uma pessoa.

Zona de perigo

Só os proprietários veem esta seção (Danger zone). Exclua o projeto.