{"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}

Começando a usar

SDKs

Plugins

APIs

Tutoriais

Ruby Gem

Esta gem automatiza a integração de seu projeto com a Rest API da Dito. Veja o código no Github: (ditointernet/dito-gem)[https://github.com/ditointernet/dito-gem]. ## Instalação Adicione a linha abaixo no arquivo Gemfile da sua aplicação: [block:code] { "codes": [ { "code": "gem 'dito'", "language": "ruby" } ] } [/block] E execute: [block:code] { "codes": [ { "code": "$ bundle", "language": "shell" } ] } [/block] Ou instale manualmente: [block:code] { "codes": [ { "code": "$ gem install dito", "language": "shell" } ] } [/block] ## Configurando sua aplicação Adicione o código abaixo em cada ambiente de configuração da sua aplicação. [block:code] { "codes": [ { "code": "Dito.configure do |c|\n c.api_key = 'SUA_API_KEY'\n c.secret = 'SUA_SECRET'\nend", "language": "ruby" } ] } [/block] As chaves da sua aplicação podem ser encontradas na área de configuração do seu aplicativo na plataforma da Dito. ## Enviando seus usuários O método `Dito.identify` é usado para enviar os usuários da sua aplicação para a plataforma da Dito. O nó `data` é reservado para as informações do usuários relativas a sua aplicação. Fique a vontade para enviar quantas informações quiser. As 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. Exemplo: [block:code] { "codes": [ { "code": "Dito.identify({\n id: Digest::SHA1.hexdigest('[email protected]'),\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})", "language": "ruby" } ] } [/block] ## Criando eventos O método `Dito.track` é usado para acompanhar o comportamento dos usuários na forma de eventos em sua aplicação. O nó `data` é reservado para as informações do evento. Fique a vontade para enviar quantas informações quiser. As 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. ATENÇÃO Os 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: Exemplo: [block:code] { "codes": [ { "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})", "language": "ruby" } ] } [/block]