IntegraçãoEnviando eventos

Enviando eventos

O SDK permite enviar para o Finteza qualquer evento do lado do servidor de seu site: informações sobre ações do usuário, status do banco de dados, indicadores de desempenho, etc. Para fazer isso, é fornecido o método FintezaAnalytics::event().

// importação
include"{SDK_PATH}\finteza-analytics.php" );
 
// envio de evento
FintezaAnalytics::event( array(
    'name' => 'Server+Track+Test',
    'websiteId' => 'sbnopromrvdebluwjzylmbhfkrmiabtqpc'
) );

Insira o arquivo SDK, especificando em {SDK_PATH} o caminho para ele e, depois, chame FintezaAnalytics::event() com os seguintes parâmetros:

Parâmetros

Tipo

Descrição

name *

string

Nome do evento. O tamanho máximo é de 128 caracteres.

websiteId *

string

Identificador do site. Ele pode ser obtido no painel do Finteza na seção de configurações do site (campo 'ID').

url

string

Endereço do servidor do Finteza. Normalmente, não é necessário alterá-lo.

referer

string

Todos os eventos estão ligados a contadores (sites) no lado do Finteza por identificador websiteId. Além disso, o sistema verifica adicionalmente se o host do qual chega o evento corresponde ao host do contador (especificado nas configurações do site no painel do Finteza). Isso ajuda a evitar o tráfego fraudulento.

 

Por padrão, ao enviar eventos, é especificado o host no qual funciona o SDK (determinado automaticamente). Se necessário, você pode substitui-lo através do parâmetro referer.

* – parâmetros obrigatórios.

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.

FintezaAnalytics::event( array(
    'name' => '{EVENT}',
    'websiteId' => '{WEBSITE_ID}'
    'unit' => '{UNIT}',
    'value' => '{VALUE}'
) );

Especifique o nome do evento e o identificador do site, e especifique mais parâmetros adicionais:

Parâmetros

Tipo

Descrição

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.

Exemplo:

FintezaAnalytics::event( array(
    'name' => 'SERVER+TRACK+PURCHASE',
    'websiteId' => 'sbnopromrvdebluwjzylmbhfkrmiabtqpc'
    'unit' => 'USD',
    'value' => '100'
) );