{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","params":[],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"Ruby Gem","type":"basic","slug":"ruby-gem","excerpt":"","body":"Esta gem automatiza a integração de seu projeto com a Rest API da Dito.\n\nVeja o código no Github: (ditointernet/dito-gem)[https://github.com/ditointernet/dito-gem].\n\n## Instalação\n\nAdicione a linha abaixo no arquivo Gemfile da sua aplicação:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"gem 'dito'\",\n \"language\": \"ruby\"\n }\n ]\n}\n[/block]\nE execute:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"$ bundle\",\n \"language\": \"shell\"\n }\n ]\n}\n[/block]\nOu instale manualmente:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"$ gem install dito\",\n \"language\": \"shell\"\n }\n ]\n}\n[/block]\n## Configurando sua aplicação\n\nAdicione o código abaixo em cada ambiente de configuração da sua aplicação.\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"Dito.configure do |c|\\n c.api_key = 'SUA_API_KEY'\\n c.secret = 'SUA_SECRET'\\nend\",\n \"language\": \"ruby\"\n }\n ]\n}\n[/block]\nAs chaves da sua aplicação podem ser encontradas na área de configuração do seu aplicativo na plataforma da Dito.\n\n## Enviando seus usuários\n\nO método `Dito.identify` é usado para enviar os usuários da sua aplicação para a plataforma da Dito.\n\nO nó `data` é reservado para as informações do usuários relativas a sua aplicação. Fique a vontade para enviar quantas informações quiser.\n\nAs informações enviadas no nó `data` poderão ser utilizadas posteriormente para filtrar seus usuários, sendo possível fazer filtros por data. Veja mais informações sobre os [formatos suportados](doc:formato-de-datas) para saber como enviar datas corretamente.\n\nExemplo:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"Dito.identify({\\n id: Digest::SHA1.hexdigest('marcos.nogueira:::at:::dito.com.br'),\\n name: 'Marcos Nogueira',\\n email: '[email protected]',\\n gender: 'male',\\n location: 'Belo Horizonte',\\n birthday: '1990-02-15',\\n data: {\\n cpf: '101.032.076-95',\\n cargo: 'Desenvolvedor' \\n }\\n})\",\n \"language\": \"ruby\"\n }\n ]\n}\n[/block]\n## Criando eventos\n\nO método `Dito.track` é usado para acompanhar o comportamento dos usuários na forma de eventos em sua aplicação.\n\nO nó `data` é reservado para as informações do evento. Fique a vontade para enviar quantas informações quiser.\n\nAs informações enviadas no nó `data` poderão ser utilizadas posteriormente para filtrar seus usuários, sendo possível fazer filtros por data. Veja mais informações sobre os [formatos suportados](doc:formato-de-datas) para saber como enviar datas corretamente.\n\nATENÇÃO\n\nOs nomes dos eventos **DEVEM** ser enviados para a Dito em letras minúsculas, sem acentuação ou caracteres especiais. Caso o nome de suas ações seja composto por mais de uma palavra, estas devem ser separadas por hífen '-' conforme o exemplo abaixo:\n\nExemplo:\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"Dito.track({\\n id: Digest::SHA1.hexdigest('[email protected]'),\\n event: {\\n action: 'nome-do-evento',\\n revenue: 5.99, # Opcional\\n data: {\\n propriedade_1: 'valor da propriedade 1',\\n propriedade_2: 'valor da propriedade 2'\\n }\\n }\\n})\",\n \"language\": \"ruby\"\n }\n ]\n}\n[/block]","updates":[],"order":1,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5547c963d3427d0d00cd6e28","project":"5538fb24dc5dd00d00e1da91","category":{"sync":{"isSync":false,"url":""},"pages":["5538ff4227f8540d0024f00f","554264348aeff51700a20e44","5547c963d3427d0d00cd6e28","5547c9ea70b82f0d0027c312","5547c9fc70b82f0d0027c314","5547ca09d3427d0d00cd6e2a","555cbc2a15a89b0d00c1af58","5566fa95f579050d00c3d63e"],"title":"SDKs","slug":"sdks","order":1,"from_sync":false,"reference":false,"_id":"5538feec27f8540d0024f00e","createdAt":"2015-04-23T14:17:16.792Z","project":"5538fb24dc5dd00d00e1da91","__v":8,"version":"5538fb25dc5dd00d00e1da94"},"user":"5538fa99545cd90d0011e593","version":{"version":"1.0","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["5538fb25dc5dd00d00e1da95","5538feec27f8540d0024f00e","5547cbd3d3427d0d00cd6e2d","554a574f0b54d30d007fe0f9","55afbdbef202b12100cd9eeb","5c016f198e69b802d4385e25","5c81470b175ad6002457d9fa","5c81472e74fd5a0063420bae","5c81476b2dd69100430ea5a4"],"_id":"5538fb25dc5dd00d00e1da94","createdAt":"2015-04-23T14:01:09.040Z","project":"5538fb24dc5dd00d00e1da91","__v":9,"releaseDate":"2015-04-23T14:01:09.040Z"},"createdAt":"2015-05-04T19:32:51.134Z","__v":5,"githubsync":"","parentDoc":null}