Kochava

A Kochava oferece atribuição e análises de dados móveis para ajudá-lo a aproveitar seus dados para crescer. Com a Kochava Audience Platform, é possível planejar, direcionar, ativar, medir e otimizar suas campanhas de apps.

Essa integração é mantida pela Kochava.

Sobre a integração

A integração da Braze com a Kochava ajuda a potencializar uma compreensão mais holística das suas Campaigns, enviando dados de atribuição para a Braze para entender melhor quais Campaigns estão gerando instalações, atividade no app e muito mais.

Pré-requisitos

Integração

Etapa 1: Mapear IDs de usuário

Esta etapa requer o SDK da Braze no seu app. Dependendo da sua plataforma, seu app pode precisar passar o identificador de dispositivo da Braze (device_id) do SDK da Braze para a Kochava, para que, quando a Kochava enviar dados de atribuição de volta para a Braze, a Braze possa associar esses dados ao perfil de usuário correto. Consulte as seções de Android e iOS para saber quando o mapeamento é necessário.

Android

O SDK da Braze gera um identificador de dispositivo (device_id). Seu app deve recuperar esse identificador e passá-lo para o método IdentityLink da Kochava. Isso permite que a Kochava inclua o device_id nos dados de atribuição que ela envia de volta para a Braze, para que a Braze possa associar eventos de atribuição ao perfil de usuário correto.

Recupere o device_id da Braze com o seguinte método:

1

Braze.getInstance(context).getDeviceId();

iOS

Importante

Antes de fevereiro de 2023, nossa integração de atribuição com a Kochava usava o Identifier for Vendor (IDFV) como identificador principal para associar dados de atribuição do iOS. Clientes da Braze que usam Objective-C não precisam buscar o device_id da Braze e enviá-lo para a Kochava na instalação, pois não há interrupção do serviço.

A partir do Swift SDK v5.7.0, você pode configurar se a Braze usa o IDFV ou um UUID gerado aleatoriamente como o ID do dispositivo. No Swift SDK v7.0.0+, useUUIDAsDeviceId tem como padrão true, então novos usuários recebem um device_id UUID, a menos que você defina esse campo como false. Para saber mais, consulte Coleta de IDFV.

• Para manter o IDFV como identificador mútuo com a Kochava, defina useUUIDAsDeviceId como false.
• Se useUUIDAsDeviceId for true (o padrão na v7.0.0+), passe o device_id da Braze para a Kochava na instalação do app, para que a Braze possa associar as atribuições do iOS.

Use uma das seguintes APIs não bloqueantes para recuperar o device_id da Braze e, em seguida, passe esse valor para a Kochava conforme as instruções do SDK iOS da Kochava. Para ajuda adicional, entre em contato com o suporte da Kochava.

Completion handler

1
2
3

AppDelegate.braze?.getDeviceId { deviceId in
  // Pass `deviceId` to Kochava
}

Swift concurrency

1

let deviceId = await AppDelegate.braze?.getDeviceId()

Etapa 2: Obter a chave de importação de dados da Braze

Na Braze, acesse Integrações com Parceiros > Parceiros de Tecnologia e selecione Kochava.

Aqui, você encontra o endpoint REST e pode gerar sua chave de importação de dados da Braze. Após a geração da chave, você pode criar uma nova chave ou invalidar uma existente. A chave de importação de dados e o endpoint REST são usados na próxima etapa ao configurar um postback no dashboard da Kochava.

Etapa 3: Configurar um postback a partir da Kochava

Adicione um postback no seu dashboard da Kochava. Será solicitada a chave de importação de dados e o endpoint REST que você encontrou no dashboard da Braze.

Etapa 4: Confirmar a integração

Na página de parceiros de tecnologia da Kochava na Braze, o indicador de conexão mostra Not Connected até que você gere uma chave de API de importação de dados na Etapa 2. Após gerar a chave, o indicador muda para Connected e exibe um timestamp. Esse timestamp reflete quando a integração foi configurada pela primeira vez na Braze (quando a chave de importação de dados foi criada), não quando a Kochava enviou o último postback.

Para confirmar que os dados de atribuição de instalação estão fluindo da Kochava, verifique se dados de instalação não orgânica aparecem nos filtros de Segment da Braze. A Braze ignora instalações orgânicas dos postbacks da Kochava quando a fonte de atribuição é organic e não os armazena como dados de instalação atribuída.

Dados de atribuição do Facebook e do X (antigo Twitter)

Os dados de atribuição de campanhas do Facebook e do X (antigo Twitter) não estão disponíveis por meio de nossos parceiros. Essas fontes de mídia não permitem que seus parceiros compartilhem dados de atribuição com terceiros e, portanto, nossos parceiros não podem enviar esses dados para a Braze.

URLs de rastreamento de cliques da Kochava na Braze (opcional)

Os links de rastreamento de cliques nas suas campanhas da Braze permitem que você veja quais Campaigns estão gerando instalações de app e reengajamento. Com isso, você pode medir seus esforços de marketing de maneira mais eficaz e tomar decisões orientadas por dados sobre onde investir mais recursos para obter o máximo ROI.

Para começar a usar os links de rastreamento de cliques da Kochava, acesse a documentação deles. Você pode inserir os links de rastreamento de cliques da Kochava diretamente nas suas campanhas da Braze. A Kochava então usa suas metodologias de atribuição probabilística para atribuir o usuário que clicou no link. Recomendamos adicionar um identificador de dispositivo aos seus links de rastreamento da Kochava para melhorar a precisão das atribuições das suas campanhas da Braze. Isso atribui de forma determinística o usuário que clicou no link.

• android
• ios

1
2
3

{% if most_recently_used_device.${platform} == 'android' %}
aifa={{most_recently_used_device.${google_ad_id}}}
{% endif %}

1
2
3

{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}

Nota

Esta recomendação é totalmente opcional
Se você atualmente não usa nenhum identificador de dispositivo — como o ID de dispositivo da Braze ou o GAID — nos seus links de rastreamento de cliques, ou não planeja usar no futuro, a Kochava ainda pode atribuir esses cliques por meio de sua modelagem probabilística.