Habilidade de Link de Atribuição de Anúncios no Exterior
Modo de Operação
Use esta habilidade para dois tipos de saída:
- Design de solução técnica para capacidades de link de atribuição de anúncios no exterior.
- Q&A e solução de problemas para atribuição, parâmetros, temporização SDK, PushAPI, landing pages, deep links, callbacks de evento, controles de relatório e comportamento de roteamento pós-instalação.
Identifique o modo primeiro. Use o modo de design de solução quando o usuário solicitar uma solução técnica, plano de integração, revisão técnica/de produto, design de funcionalidade ou arquitetura. Use o modo Q&A quando o usuário perguntar por que uma cadeia se comporta de certa forma, como julgar uma fonte, de onde um parâmetro vem, como um estágio de link funciona ou como solucionar um problema de métrica ou sintoma de comportamento.
Carregamento de Referência Necessário
Carregue apenas as referências necessárias para a solicitação:
- Para solução técnica ou arquitetura funcional: leia
references/technical-solution-template.md. - Para regras de atribuição, prioridade de fonte de dados, temporização de interface, mapeamento de parâmetros ou callbacks de evento: leia
references/attribution-knowledge.md. - Para perguntas de uso, diagnóstico ou explicação: leia
references/qa-playbook.md.
Não carregue ou cite documentos de fontes específicas do cliente, a menos que o usuário os forneça explicitamente para a tarefa atual.
Fluxo de Trabalho de Design de Solução
Ao elaborar uma solução de link de atribuição de anúncios no exterior:
- Esclareça o cenário: deep link, landing page, atribuição SDK, PushAPI, Google Install Referrer ou cadeia mista.
- Identifique o objetivo de negócio: conclusão de atribuição, preenchimento de hierarquia de anúncios, callback de evento, roteamento pós-instalação para conteúdo promovido, sinal de aprendizado de modelo, controle de relatório ou reconciliação de métricas.
- Defina atores e módulos: plataforma de mídia, gerador de link de anúncio, script inteligente de landing page, aplicativo cliente, SDK/MMP, serviço de atribuição backend, serviço de relatório, configuração de administração e data warehouse.
- Especifique fontes de dados e prioridade. Documente a temporização, confiabilidade, chave de correspondência, comportamento de fallback e uso permitido de cada fonte.
- Especifique a temporização do cliente: inicialização a frio, primeira abertura pós-instalação, consentimento de privacidade, temporização do callback SDK, timeout de fallback, polling curto, inicialização a quente e limites de sessão.
- Especifique o comportamento do backend: correspondência, deduplicação, mapeamento de propagação, preenchimento de hierarquia de anúncios, elegibilidade de evento e roteamento de callback.
- Especifique o comportamento voltado ao usuário: roteamento automático, prompt de roteamento, supressão de roteamento quando o usuário já está consumindo conteúdo ou atraso até a chegada do resultado de atribuição.
- Especifique a validação: casos por fonte/canal, exemplos de parâmetros, logs esperados, callbacks de evento, verificações de métricas, liberação gradual e interruptores de reversão.
Use references/technical-solution-template.md como estrutura. Remova seções irrelevantes para uma solicitação restrita.
Fluxo de Trabalho de Q&A
Ao responder perguntas de uso:
- Reafirme o sintoma observado ou ponto de decisão.
- Nomeie o estágio relevante da cadeia: clique no anúncio, landing page, instalação, primeira abertura, callback SDK, pré-atribuição, pós-atribuição, solicitação de informações do anúncio, callback de evento ou reconciliação de análise.
- Mapeie para regras conhecidas em
references/attribution-knowledge.md. - Explique a causa provável com prioridade de fonte e temporização, especialmente quando PushAPI, Google Install Referrer ou dados SDK chegam atrasados.
- Forneça uma lista de verificação: logs, campos, temporização da solicitação, estado do usuário, campos de propagação/hierarquia de anúncios, elegibilidade de evento e interruptor de relatório.
- Separe fatos confirmados de suposições. Se o projeto atual tiver suas próprias regras, peça ao usuário a regra ou trecho de documento relevante antes de substituir o padrão genérico.
Diretrizes de Domínio
- Diferencie conclusão de atribuição de sucesso de roteamento/reprodução pós-instalação; um usuário pode ser atribuído, mas não roteado para conteúdo promovido.
- Diferencie pré-atribuição e pós-atribuição. A pré-atribuição afeta o comportamento imediato do aplicativo; a pós-atribuição pode completar a atribuição mais tarde, mas pode exigir polling ou compensação de roteamento.
- Trate o Google Install Referrer como orientado para a primeira abertura pós-instalação. Não presuma que ele seja atualizado para cada novo clique de anúncio após a instalação.
- Prefira regras explícitas de prioridade de fonte em vez de "o campo mais recente vence", a menos que o usuário declare uma regra específica do projeto.
- Ao discutir callback de evento, separe o mapeamento de evento de mídia, regras de elegibilidade, deduplicação e interruptores de relatório.
- Quando um problema de métrica aparecer, inspecione tanto a temporização da atribuição quanto a experiência do aplicativo antes de concluir que a lógica de atribuição está errada.
Diretrizes de Contexto Sensível
- Não inclua nomes de empresas, nomes de projetos, nomes de documentos, datas históricas, nomes pessoais, caminhos de arquivo locais, tokens, URLs, nomes de pacotes, nomes de campanhas ou exemplos de logs brutos em orientação reutilizável gerada.
- Nomes públicos de plataformas/mídia como Facebook, TikTok, Snapchat e Google podem ser mantidos quando relevantes para design de solução ou solução de problemas.
- Nomes internos de empresas, nomes de projetos, títulos de documentos, nomes de campanhas, nomes de pacotes e identificadores de conta brutos devem ser removidos ou generalizados.
- Use categorias genéricas como "SDK de mídia", "SDK MMP", "canal de mídia social", "rede de anúncios", "log de landing page" ou "API de fonte de instalação" quando a fonte for interna, específica do cliente ou não for necessária para a resposta.
- Use temporização relativa como "solicitação inicial", "timeout de fallback" e "janela de polling curta"; evite datas históricas, a menos que o usuário forneça datas para a entrega atual.