API do Gerador de deep links
A API do Gerador de deep links está disponível para clientes com os planos TrueLink Core e TrueLink Enterprise. Entre em contato com sales@adjust.com para fazer o upgrade agora.
A API do Gerador de deep links (DLG) permite que você crie e gerencie deep links da Adjust de forma programática. Em vez de gerar links manualmente no painel da Adjust, você pode usar a API para construir fluxos de trabalho flexíveis e escaláveis de geração de links que são compatíveis com a criação de links individuais ou em massa.
- Escalone a criação de links automatizando sua geração por meio de APIs em vez de fluxos de trabalho manuais.
- Integre a geração de deep links às suas ferramentas atuais, como sistemas de CRM ou plataformas de gerenciamento de campanhas.
- Crie e gerencie links curtos ou longos, individualmente ou em massa.
- Crie painéis ou scripts personalizados de geração de links para casos de uso internos.
O que faz
A API DLG replica a funcionalidade do Gerador de Deep Links da Adjust, dando a você controle programático sobre a criação de links. Você pode:
- Gerar um ou vários deep links em uma única requisição.
- Criar links curtos ou longos dependendo das necessidades da sua campanha.
- Atualizar os tokens de links encurtados existentes.
- Criar ferramentas ou fluxos de trabalho que se conectem diretamente aos endpoints de automação da Adjust.
Usando a API, as equipes podem automatizar processos repetitivos de criação de links e manter precisão e consistência na mensuração de campanhas.
Casos de uso
Como funciona?
A API DLG usa requisições HTTPS para endpoints de automaçāo da Adjust. Todas as chamadas são autorizadas usando o seu token da API da Adjust.
Visão geral dos endpoints:
- Gerar um único deep link: POST
https://automate.adjust.com/engage/deep-links - Gerar deep links em massa: POST
https://automate.adjust.com/engage/deep-links/bulk - Atualizar um token de link encurtado: PUT
https://automate.adjust.com/engage/deep-links/{short_token} - Recuperar dados do link encurtado: GET
https://automate.adjust.com/engage/deep-links/short-link?short_token={short_token}&app_token={app_token}
Como começar
Requisitos
- Pacote Core ou Enterprise do TrueLink.
- Um domínio com marca para iOS e Android.
- Ajuste o token da API da Adjust com acesso à API do Deep Link Generator.
Resumo da configuração
- Configure seu domínio com marca para iOS e Android.
- Obtenha seu token da API da Adjust e o token de link.
- Crie e teste chamadas de API, seguindo a documentação do desenvolvedor da Adjust.
- Integre scripts ou macros de automação para gerar links em escala.
Para obter detalhes completos sobre como começar, use o guia oficial da documentação do desenvolvedor da Adjust para a API do Deep Link Generator.
Best practices
- Mantenha seu SDK da Adjust atualizado para garantir a compatibilidade com a resolução de links encurtados.
- Use endpoints em massa para grandes campanhas para evitar problemas de limite de taxa (máximo de 200 requisições/segundo).
- Armazene os metadados da campanha de forma centralizada e automatize a criação de links com macros ou scripts.
- Valide as respostas da API e tente novamente as requisições falhas.
- Use um domínio com marca para ambas as plataformas para redirecionamentos consistentes.
- Mantenha os tokens da API em segredo e altere-os periodicamente para garantir a segurança.
Relatório e monitoramento de uso
A API do Gerador de deep links inclui limites para a criação de links curtos. Você pode monitorar o uso pelo painel da Adjust e pelas respostas da API.
Cota de links curtos
- Os limites de links curtos são definidos por conta.
- Os limites são baseados no número de tokens curtos gerados.
- Requisições idênticas retornarão links existentes e não aumentarão o uso
O que conta no limite de uso
A cota se aplica apenas a:
- Links curtos criados via API
A cota não se aplica a:
- Links longos
- Links curtos criados via painel
Visualização do uso no painel da Adjust
Você pode visualizar os dados de uso no painel da Adjust:
- Vá para Configurações da conta
- Selecione Plano e uso
Essa seção exibe:
- A cota total de links curtos
- Os links curtos restantes
- Informações do contrato
Se deseja ver os dados de uso no Datascape, alterar intervalos de datas e ver a diferença no uso por diferentes apps, pode fazer isso por este link direto.
Visualizar o uso nos cabeçalhos da API
Cada resposta da API inclui um cabeçalho com informações sobre a cota e o contrato. Para saber mais sobre a estrutura de payload da API, confira a documentação do Gerador de deep links no Developer Hub
Estes são os cabeçalhos:
x-shortlink-quota-limit
x-shortlink-quota-remaining
x-contract-status
x-contract-start-date
x-contract-end-date