Gerar um arquivo CSV para Notificação por push multilíngue generating-csv-multilingual-push
Fazer upload de um arquivo CSV para gerar conteúdo para entrega é um recurso usado para dar suporte a notificações por push multilíngues. O formato do arquivo CSV precisa seguir determinadas diretrizes para que o upload do arquivo seja bem-sucedido e, consequentemente, possa criar um delivery. As seções a seguir descrevem o formato de arquivo e as considerações a ele relacionadas.
Formato de arquivo file-format
O push multilíngue requer 14 colunas no arquivo CSV:
- título
- messageBody
- som
- adge
- deeplinkURI
- categoria
- iosMediaAttachmentURL
- androidMediaAttachmentURL
- isContentAvailable
- isMutableContent
- customFields
- localidade
- idioma
- silentPush
Verifique a amostra de CSV clicando em Download a sample file na janela Manage Content Variants. Para obter mais informações, consulte esta seção.
- title, messageBody, sound, badge, deeplinkURI, category, iosMediaAttachmentURL, androidMediaAttachmentURL: conteúdo de carga de push regular. Você precisa fornecer essas informações de maneira semelhante à criação de deliveries por push.
- Campos Personalizados: use o formato JSON para os campos personalizados, por exemplo,
{"key1":"value1","key2":"value2"}. Consulte o arquivo de amostra acima para obter um exemplo de campos personalizados. - isContentAvailable: sinalizador para verificação de Conteúdo Disponível; o valor 1 implica verdadeiro; o valor 0 implica falso. O valor padrão é 0. Se você deixar essa coluna em branco, o valor será considerado 0.
- isMutableContent: sinalizador para Conteúdo Mutável, o valor 1 implica verdadeiro, o valor 0 implica falso. O valor padrão é 0. Se você deixar essa coluna em branco, o valor será considerado 0.
- locale: locale é o campo para variantes de idioma, por exemplo, "en_us" para inglês dos EUA e "fr_fr" para francês.
- idioma: nome do idioma associado à localidade. Por exemplo, se o local for "en_us", o nome do idioma deverá ser "English-United States".
- silentPush: sinalizador para o tipo de notificação por push. Se for uma notificação por push regular, o valor deverá ser 0. Se for um push silencioso, o valor deverá ser 1. O valor padrão é 0. Se você deixar essa coluna em branco, o valor será considerado 0.
Restrições e diretrizes para a criação do arquivo csv constraints-guideline-csv
O nome de cada coluna foi corrigido.
Você deve incluir o nome de cada coluna no arquivo CSV. Caso não use nenhuma coluna para o conteúdo, deixe-a em branco.
As colunas "locale" e "language" são obrigatórias e o valor é exclusivo para cada linha.
Um valor em branco para essa coluna resultará em uma falha no upload do arquivo.
A ordem das colunas é importante. A ordem das colunas no arquivo carregado precisa seguir o mesmo formato do arquivo de amostra.
Conteúdo da coluna de aspas. Como esse é um arquivo CSV (significa Valores separados por vírgula), qualquer conteúdo de coluna que inclua vírgula (,) deve ser citado. Por exemplo, "Olá, Tom!"
A codificação UTF-8 é necessária para caracteres internacionais.
Se você gerar o arquivo por texto sem formatação, separe cada coluna por ",".
Incompatibilidade de variante. Se você usa blocos de conteúdo e direciona públicos-alvo com idiomas específicos, é necessário listar cada idioma direcionado no arquivo CSV, caso contrário ocorrerá um erro ao enviar a entrega.
Inserção de um campo de personalização no arquivo csv personalization-field-csv
Se quiser usar campos de personalização, você deve incluir a tag no arquivo.
Para inserir o campo de personalização "firstName" no messageBody, a mensagem precisa ser:
"Hello <span class="nl-dce-field nl-dce-done" data-nl-expr="/context/profile/firstName">First name</span>, this is message".
O campo "firstName" é representado por:
<span class="nl-dce-field nl-dce-done" data-nl-expr="/context/profile/firstName">First name</span>
No span há dois atributos obrigatórios:
-
Uma é a classe que é estática. Não importa qual campo de personalização você planeje usar, ele sempre será class="nl-dce-field nl-dce-done".
-
Outro é data-nl-expr, que é o caminho do campo de personalização. Por exemplo, se você inserir o campo de personalização "firstName" na interface do usuário, o caminho de navegação será Context (context) > Profile (profile) > First name (firstName) (como mostrado na imagem abaixo). Nesse caso, o caminho será
code language-none /context/profile/firstName. data-nl-expr="/context/profile/firstName".
Localidade e nomes de idiomas locale-language-names
Os seguintes idiomas são suportados: