Ir para o conteúdo

Esta página foi traduzida automaticamente e pode conter imprecisões. Para relatar um erro de tradução, use o componente de feedback na parte inferior do sumário, à direita da página.

Aviso

AppboyKit (também conhecido como o SDK Objective-C) não é mais suportado e foi substituído pelo Swift SDK. Não receberá mais novos recursos, correções de bugs, atualizações de segurança ou suporte técnico—no entanto, o envio de mensagens e a análise de dados continuarão a funcionar normalmente. Para saber mais, veja Apresentando o Novo SDK Braze Swift.

Definir atributos personalizados para iOS

A Braze fornece métodos para atribuir atributos aos usuários. Você poderá filtrar e segmentar seus usuários de acordo com esses atributos no dashboard.

Antes da implementação, certifique-se de revisar exemplos das opções de segmentação oferecidas por eventos personalizados, atributos personalizados e eventos de compra em nossas melhores práticas, bem como nossas notas sobre convenções de nomenclatura de eventos.

Atribuindo atributos de usuário padrão

Para atribuir atributos de usuário, você precisa definir o campo apropriado no objeto compartilhado ABKUser.

A seguir, um exemplo de como definir o atributo de nome:

objective-c
swift

[Appboy sharedInstance].user.firstName = @"first_name";

Appboy.sharedInstance()?.user.firstName = "first_name"

Os seguintes atributos devem ser definidos no objeto ABKUser:

firstName
lastName
email
dateOfBirth
country
language
homeCity
phone
userID
gender

Atribuindo atributos personalizados ao usuário

Além dos atributos de usuário padrão, a Braze também permite que você defina atributos personalizados usando vários tipos diferentes de dados. Consulte nossa documentação de coleta de dados de usuários para saber mais sobre as opções de segmentação que cada um desses atributos oferece.

Atributo personalizado com valor da string

objective-c
swift

[[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andStringValue:"your_attribute_value"];

Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andStringValue: "your_attribute_value")

[[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andIntegerValue:yourIntegerValue];

Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andIntegerValue: yourIntegerValue)

Atributo personalizado com valor double

A Braze trata valores float e double da mesma forma em nosso banco de dados.

objective-c
swift

[[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andDoubleValue:yourDoubleValue];

Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andDoubleValue: yourDoubleValue)

Atributo personalizado com valor booleano

objective-c
swift

[[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andBOOLValue:yourBOOLValue];

Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andBOOLValue: yourBoolValue)

Atributo personalizado com valor de data

As datas enviadas à Braze com esse método devem estar no formato ISO 8601 (por exemplo, 2013-07-16T19:20:30+01:00) ou no formato yyyy-MM-dd'T'HH:mm:ss:SSSZ (2016-12-14T13:32:31.601-0800).

objective-c
swift

[[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andDateValue:yourDateValue];

Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andDateValue:yourDateValue)

Atributo personalizado com valor de array

O número máximo de elementos em um array é 500 por padrão. Você pode atualizar o número máximo de arrays no dashboard da Braze, em Data Settings > Custom Attributes. Arrays que excedem o número máximo de elementos serão truncados para conter o número máximo de elementos.

objective-c
swift

// Setting a custom attribute with an array value
[[Appboy sharedInstance].user setCustomAttributeArrayWithKey:@"array_name" array:@[@"value1",  @"value2"]];
// Adding to a custom attribute with an array value
[[Appboy sharedInstance].user addToCustomAttributeArrayWithKey:@"array_name" value:@"value3"];
// Removing a value from an array type custom attribute
[[Appboy sharedInstance].user removeFromCustomAttributeArrayWithKey:@"array_name" value:@"value2"];
// Removing an entire array and key
[[Appboy sharedInstance].user setCustomAttributeArrayWithKey:@"array_name" array:nil];

// Setting a custom attribute with an array value
Appboy.sharedInstance()?.user.setCustomAttributeArrayWithKey("array_name", array: ["value1",  "value2"])
// Adding to a custom attribute with an array value
Appboy.sharedInstance()?.user.addToCustomAttributeArrayWithKey("array_name", value: "value3")
// Removing a value from an array type custom attribute
Appboy.sharedInstance()?.user.removeFromCustomAttributeArrayWithKey("array_name", value: "value2")

Removendo a definição de um atributo personalizado

Os atributos personalizados também podem ter sua definição removida usando o seguinte método:

objective-c
swift

[[Appboy sharedInstance].user unsetCustomAttributeWithKey:@"your_attribute_key"];

Appboy.sharedInstance()?.user.unsetCustomAttributeWithKey("your_attribute_key")

Incrementando/decrementando atributos personalizados

Este código é um exemplo de incremento de atributo personalizado. Você pode incrementar o valor de um atributo personalizado por qualquer valor inteiro ou long, positivo ou negativo:

objective-c
swift

[[Appboy sharedInstance].user incrementCustomUserAttribute:@"your_attribute_key" by:incrementIntegerValue];

Appboy.sharedInstance()?.user.incrementCustomUserAttribute("your_attribute_key", by: incrementIntegerValue)

Definindo um atributo personalizado via REST API

Você também pode usar nossa REST API para definir atributos de usuário. Consulte a documentação da API de usuários para mais detalhes.

Limites de valor de atributos personalizados

Os valores de atributos personalizados têm um comprimento máximo de 255 caracteres; valores mais longos serão truncados.

Informações adicionais

Mais detalhes podem ser encontrados no arquivo ABKUser.h.
Consulte a documentação do ABKUser para saber mais.

Configurando inscrições de usuários

Para configurar uma inscrição para seus usuários (e-mail ou push), chame as funções setEmailNotificationSubscriptionType ou setPushNotificationSubscriptionType, respectivamente. Ambas as funções recebem o tipo enum ABKNotificationSubscriptionType como argumento. Esse tipo possui três estados diferentes:

Status da inscrição	Definição
`ABKOptedin`	Inscrito e com aceitação explícita
`ABKSubscribed`	Inscrito, mas sem aceitação explícita
`ABKUnsubscribed`	Inscrição cancelada e/ou recusa explícita

Usuários que concedem permissão para um app enviar notificações por push têm o status padrão ABKOptedin, pois o iOS exige uma aceitação explícita.

Os usuários serão definidos automaticamente como ABKSubscribed ao receberem um endereço de e-mail válido. No entanto, recomendamos que você estabeleça um processo de aceitação explícita e defina esse valor como OptedIn ao receber o consentimento explícito do usuário. Consulte Gerenciamento de inscrições de usuários para mais detalhes.

Configurando inscrições de e-mail

objective-c
swift

[[Appboy sharedInstance].user setEmailNotificationSubscriptionType: ABKNotificationSubscriptionType]

Appboy.sharedInstance()?.user.setEmailNotificationSubscriptionType(ABKNotificationSubscriptionType)

Configurando inscrições de notificações por push

objective-c
swift

[[Appboy sharedInstance].user setPushNotificationSubscriptionType: ABKNotificationSubscriptionType]

Appboy.sharedInstance()?.user.setPushNotificationSubscriptionType(ABKNotificationSubscriptionType)

Consulte Gerenciamento de inscrições de usuários para mais detalhes.

New Stuff!