Enviando eventos

Depois de instalar o SDK, você pode enviar para o Finteza eventos sobre as ações dos usuários em seu aplicativo. Para fazer isso, use o método event, indicando nele o nome da string do evento:

Objective-C:

[Finteza event:@"{EVENT}"];

Swift:

Finteza.event("{EVENT}")

Defina o {EVENT}. Se você usar um prefixo com um nome de aplicativo, ele será adicionado a todos os eventos enviados.

Chame essa função após qualquer evento desejado no aplicativo: ir para uma seção, pressionar um botão, preencher um formulário, etc.

O comprimento máximo permitido para o nome do evento, incluindo o prefixo, é de 128 caracteres.


Dados adicionais nos parâmetros do evento #

Nos eventos enviados para o Finteza, você pode especificar informações adicionais na forma de parâmetros. Por exemplo, o tipo de mercadoria comprada, o valor da compra, a moeda, etc.

Objective-C:

[Finteza event:@"{EVENT}" id:@"{ID}" unit:@"{UNIT}" value:@"{VALUE}"];

Swift:

Finteza.event("{EVENT}", id: "{ID}", unit: "{UNIT}", value: "{VALUE}")

Defina o nome do evento em{EVENT}. A seguir são definidos os parâmetros:

Parâmetros

Tipo

Descrição

id

string

Identificador arbitrário. Comprimento máximo de 64 caracteres. Para evitar o uso do ID, defina .

unit

string

Unidades do parâmetro. Por exemplo, USD, peças, etc. Comprimento máximo de 32 caracteres.

value

number

Valor do parâmetro Comprimento máximo de 64 caracteres.

Exemplos para Objective-C:

[Finteza event:@"Book Load" id:@"CATEGORY_ID" units:@"BOOKS" value:@"BOOK_ID"];
[Finteza event:@"First Book Open" id:nil units:@"Count" value:@(42).stringValue];

Exemplos para Swift:

Finteza.event("Book Load", id: "CATEGORY_ID", unit: "BOOKS", value: "BOOK_ID")
Finteza.event("First Book Open", id: nil, unit: "Count", value: String(42))

Modelos complexos de contabilidade de eventos para compras no aplicativo e comércio eletrônico serão adicionados no futuro.


Desativando o rastreamento de eventos #

Para desabilitar temporariamente o registro de eventos dentro do aplicativo, use o parâmetro tracking com valor No/False (por padrão, Yes/True).

Objective-C:

Finteza.tracking = NO;

Swift:

Finteza.tracking = false

Depois disso, todos os outros eventos registrados através da função event (incluindo com parâmetros) será ignorado e não será enviado para o Finteza.