Communitygithub.com

cameronalexander720/overseas-ad-attribution-link-skill

Uma habilidade de agente para projetar e solucionar problemas de links de atribuição de anúncios no exterior, deep links, landing pages, temporização SDK, callbacks PushAPI, fluxos de Install Referrer, mapeamento de parâmetros de anúncios e problemas de roteamento pós-instalação.

O que é overseas-ad-attribution-link-skill?

Esta habilidade capacita agentes de IA a projetar soluções técnicas e responder perguntas complexas sobre a cadeia de atribuição de anúncios no exterior, cobrindo links de atribuição, deep links, landing pages, SDKs de MMP, PushAPI e Google Install Referrer. Ela opera em dois modos: design de solução (para criar arquiteturas de integração e fluxos técnicos) e Q&A (para diagnosticar problemas de comportamento, métricas e parâmetros). O agente carrega seletivamente documentos de referência especializados (modelo de solução técnica, conhecimento de atribuição e playbook de Q&A) com base na solicitação do usuário, garantindo foco e eficiência. Ele segue fluxos de trabalho estruturados: no modo de design, o agente clarifica o cenário, define atores e módulos, especifica temporização e comportamento, e valida com casos de teste; no modo de Q&A, ele mapeia sintomas para estágios da cadeia, explica causas prováveis com base em prioridade de fonte e temporização, e fornece listas de verificação. Diretrizes de domínio evitam confusões comuns (atribuição vs. roteamento, pré vs. pós-atribuição) e enfatizam regras explícitas de prioridade de fonte. Diretrizes de contexto sensível exigem anonimização de dados proprietários, nomes de projetos e identificadores internos, retendo apenas nomes públicos de plataformas (Facebook, Google) quando relevante, garantindo que as respostas geradas sejam reutilizáveis e seguras.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add cameronalexander720/overseas-ad-attribution-link-skill

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Habilidade de Link de Atribuição de Anúncios no Exterior

Modo de Operação

Use esta habilidade para dois tipos de saída:

  1. Design de solução técnica para capacidades de link de atribuição de anúncios no exterior.
  2. 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:

  1. Esclareça o cenário: deep link, landing page, atribuição SDK, PushAPI, Google Install Referrer ou cadeia mista.
  2. 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.
  3. 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.
  4. Especifique fontes de dados e prioridade. Documente a temporização, confiabilidade, chave de correspondência, comportamento de fallback e uso permitido de cada fonte.
  5. 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.
  6. 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.
  7. 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.
  8. 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:

  1. Reafirme o sintoma observado ou ponto de decisão.
  2. 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.
  3. Mapeie para regras conhecidas em references/attribution-knowledge.md.
  4. Explique a causa provável com prioridade de fonte e temporização, especialmente quando PushAPI, Google Install Referrer ou dados SDK chegam atrasados.
  5. 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.
  6. 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.

Habilidades Relacionadas