Esta página foi traduzida automaticamente e pode conter imprecisões. Para relatar um erro de tradução,
abra um issue no GitHub.
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 está um exemplo de configuração do atributo nome:
1
| [Appboy sharedInstance].user.firstName = @"first_name";
|
1
| Appboy.sharedInstance()?.user.firstName = "first_name"
|
Os seguintes atributos devem ser definidos no objeto ABKUser:
firstNamelastNameemaildateOfBirthcountrylanguagehomeCityphoneuserIDgender
Atribuindo atributos personalizados ao usuário
Além dos atributos de usuário padrão, a Braze também permite definir atributos personalizados usando vários tipos de dados diferentes. Consulte nossa coleta de dados de usuários para saber mais sobre as opções de segmentação que cada um desses atributos oferece.
1
| [[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andStringValue:"your_attribute_value"];
|
1
| Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andStringValue: "your_attribute_value")
|
1
| [[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andIntegerValue:yourIntegerValue];
|
1
| Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andIntegerValue: yourIntegerValue)
|
A Braze trata os valores float e double da mesma forma no banco de dados.
1
| [[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andDoubleValue:yourDoubleValue];
|
1
| Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andDoubleValue: yourDoubleValue)
|
1
| [[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andBOOLValue:yourBOOLValue];
|
1
| Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andBOOLValue: yourBoolValue)
|
As datas passadas para a Braze com esse método devem estar no formato ISO 8601 (e.g 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).
1
| [[Appboy sharedInstance].user setCustomAttributeWithKey:@"your_attribute_key" andDateValue:yourDateValue];
|
1
| Appboy.sharedInstance()?.user.setCustomAttributeWithKey("your_attribute_key", andDateValue:yourDateValue)
|
O número máximo de elementos padrão em um array é 500. 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 são truncados para conter o número máximo de elementos.
1
2
3
4
5
6
7
8
| // 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];
|
1
2
3
4
5
6
| // 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 um atributo personalizado
Atributos personalizados também podem ser removidos usando o seguinte método:
1
| [[Appboy sharedInstance].user unsetCustomAttributeWithKey:@"your_attribute_key"];
|
1
| Appboy.sharedInstance()?.user.unsetCustomAttributeWithKey("your_attribute_key")
|
Incrementando/decrementando atributos personalizados
Este código é um exemplo de um atributo personalizado de incremento. Você pode incrementar o valor de um atributo personalizado por qualquer valor inteiro ou longo positivo ou negativo:
1
| [[Appboy sharedInstance].user incrementCustomUserAttribute:@"your_attribute_key" by:incrementIntegerValue];
|
1
| Appboy.sharedInstance()?.user.incrementCustomUserAttribute("your_attribute_key", by: incrementIntegerValue)
|
Definindo um atributo personalizado por meio da API REST
Você também pode usar nossa API REST para definir atributos de usuário. Consulte a documentação da API de usuários para obter detalhes.
Limites de valores de atributos personalizados
Os valores de atributos personalizados têm um comprimento máximo de 255 caracteres; valores mais longos serão truncados.
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 usam o tipo de enum ABKNotificationSubscriptionType como argumentos. Esse tipo tem três estados diferentes:
| Status da inscrição |
Definição |
ABKOptedin |
Inscrito, com aceitação explícita |
ABKSubscribed |
Inscrito, mas sem aceitação explícita |
ABKUnsubscribed |
Inscrição cancelada e/ou recusa explícita |
Os usuários que concedem permissão para um app enviar notificações por push têm o status padrão de ABKOptedin, pois o iOS exige uma aceitação explícita.
Os usuários serão configurados como ABKSubscribed automaticamente após o recebimento de um endereço de e-mail válido; no entanto, sugerimos que você estabeleça um processo de aceitação explícita e defina esse valor para OptedIn após o recebimento do consentimento explícito do seu usuário. Para saber mais, consulte Gerenciar inscrições de usuários.
Configurando inscrições de e-mail
1
| [[Appboy sharedInstance].user setEmailNotificationSubscriptionType: ABKNotificationSubscriptionType]
|
1
| Appboy.sharedInstance()?.user.setEmailNotificationSubscriptionType(ABKNotificationSubscriptionType)
|
Configurando inscrições de notificação por push
1
| [[Appboy sharedInstance].user setPushNotificationSubscriptionType: ABKNotificationSubscriptionType]
|
1
| Appboy.sharedInstance()?.user.setPushNotificationSubscriptionType(ABKNotificationSubscriptionType)
|
Para saber mais, consulte Gerenciar inscrições de usuários.
Editar esta página no GitHub