Um dos pedidos muito frequentes de desenvolvedores de aplicativos no Orkut era ter um método para saber qual a origem de uma instalação do aplicativo. Isto é útil, por exemplo, para acompanhar o desempenho de peças de publicidade online (conversion tracking). Outra solicitação comum era permitir que o aplicativo se comportasse de maneira diferente na instalação dependendo da origem do clique que levou o usuário a instalá-lo para possibilitar, por exemplo, fornecer presente virtuais ou fazer outros tipos de personalização da experiência do usuário.

Por esse motivo, recentemente lançamos um mecanismo que possibilita que um aplicativo do Orkut receba um parâmetro arbitrário no momento da instalação. Desta maneira, o desenvolvedor pode embutí-lo no link para o aplicativo, e esse parâmetro pode ser lido pelo aplicativo a fim de contabilizar a instalação, oferecer presentes ou alterar de outras maneiras a experiência do usuário no momento da instalação do aplicativo.

Ao invés de criar um parâmetro novo, utilizamos um parâmetro pré-existente que já era utilizado para comunicar parâmetros dentro do Orkut (mas que não podia, até o momento, ser utilizado na hora das instalações).

Ao invés de criar um parâmetro novo, utilizamos um parâmetro pré-existente mas que não podia, até então, ser utilizado na hora das instalações. Esse parâmetro é denominado appParams. Para passar informações para instalações, basta embutí-lo na URL pública do aplicativo. Por exemplo, se quiséssemos passar o parâmetro "xyz123" para a instalação do nosso aplicativo (neste exemplo, utilizamos o OrkutDevBox, cujo ID é 876096229684), bastaria construir a URL desta maneira:

http://www.orkut.com/PublicAppInfo?appId=876096229684&appParams=xyz123

A partir do aplicativo, esse parâmetro pode ser lido facilmente:

var urlParams = gadgets.util.getUrlParameters();
var appParams = urlParams['view-params'];
// fazer algo com appParams aqui

Vale ressaltar que, se o usuário não estiver logado no Orkut no momento da instalação, ele será redirecionado para a página de login; porém, mesmo assim o parâmetro appParams será preservado e entregue ao seu aplicativo.

Um outro lembrete importante é que o appParams também será entregue mesmo se o usuário já possuia o aplicativo antes. Implementamos desta maneira para que esse mecanismo também possa ser utilizado para personalizar a experiência de usuários existentes quando esses usuários clicam em determinado link que você disponibilizaou. Portanto, se você está contabilizando conversões, talvez seja necessário adaptar sua lógica para determinar se de fato o acesso deve ser contabilizado como uma nova instalação.

Postado por Bruno Oliveira, Equipe de Relacionamento com Desenvolvedores