Conteúdo Dinâmico com CSV

• Use um CSV para personalizar em escala – Uma mensagem, experiências personalizadas para todos
• Suporte multi-idioma – Troca automática de idioma por usuário
• Personalização dinâmica – O conteúdo se adapta às propriedades do usuário (idioma, região, ID de campanha)
• Colaboração em equipe – Usuários não técnicos editam conteúdo em arquivos CSV
• Injeção de HTML (email) – Inclua marcação HTML em células CSV para criar dinamicamente conteúdo de email rico
• Compatibilidade cross-channel – Reutilize a lógica CSV entre canais

• Onboarding ou marketing multi-idioma
• Promoções específicas por região
• Anúncios de eventos por localização
• Personalização baseada em campanha

​

Etapas de configuração do Conteúdo Dinâmico com CSV

1. Crie um arquivo CSV com suas variações de conteúdo.
2. Mapeie os dados CSV para a mensagem usando a propriedade dynamic_content na sintaxe Liquid.
3. Crie uma nova mensagem ou template no painel do OneSignal.
4. Selecione o botão Conteúdo Dinâmico ou Personalização.
5. Faça upload do arquivo CSV e envie a mensagem.

​

Requisitos e configuração do CSV

• Tamanho do arquivo: Menos de 200 KB
• Cabeçalhos de coluna:
  • Reserve o primeiro cabeçalho de coluna para a chave de tag ou deixe em branco para referenciar seções
  • Somente caracteres alfanuméricos e underscores
  • Use underscores (_) em vez de espaços
• Codificação: UTF-8

• Multi-idioma – Localize o conteúdo por idioma
• Personalização de conteúdo – Personalize o conteúdo por Tags de Dados

​

Exemplos de CSV

• Exemplo de Template Multi-idioma
• Exemplo de Template de Personalização de Conteúdo

• Mapeie os cabeçalhos de coluna para seus códigos de idioma suportados.
• Adicione suas traduções a cada linha para cada código de idioma.
• Se você tiver várias seções (como em um email), designe a primeira coluna como o nome da seção.

Este exemplo inclui:

• 3 idiomas: inglês, espanhol e francês.
• 2 seções: “section_1” e “section_2”.

• Mapeie o primeiro cabeçalho de coluna para a chave de tag e as linhas subjacentes aos valores que você deseja referenciar. Veja Tags para mais informações sobre como adicionar tags aos usuários.
• Mapeie os cabeçalhos de coluna restantes para as seções ou componentes que você deseja personalizar.

Neste exemplo:

• A chave de tag é campaign_id com valores possíveis de A e B.
• Há 3 componentes: “title”, “message” e “url”.

Importante: Remova espaços e caracteres não alfanuméricos dos cabeçalhos CSV ou use notação hash no Liquid.

​

Mapear dados CSV para o conteúdo da mensagem

<!-- Opção 1: acessar por componente primeiro -->
{{dynamic_content.file_name.message_component[user_property]}}

<!-- Opção 2: acessar por propriedade do usuário primeiro -->
{{dynamic_content.file_name[user_property].message_component}}

• dynamic_content – O nome da propriedade usado para referenciar os dados CSV
• file_name – Nome do arquivo CSV (sem extensão .csv)
• message_component – O componente de mensagem específico que você deseja personalizar. Este é o texto estático no cabeçalho de coluna CSV ou na primeira linha.
• user_property – A propriedade de usuário que você deseja referenciar.

{{ dynamic_content.my_template.header[user.language] | default: "Bem-vindo à nossa última atualização" }}

• O Conteúdo Dinâmico é usado quando disponível
• Uma mensagem codificada aparece se o Conteúdo Dinâmico falhar
• Os usuários nunca recebem conteúdo em branco

• Exemplo de Mensagem Multi-idioma
• Exemplo de Mensagem de Personalização de Conteúdo

translations.csv

Copiar

Perguntar à IA

,en,es,fr
section_1,Hello,Hola,Bonjour
section_2,Thanks for shopping with us...,Gracias por comprar con nosotros...,Merci pour votre achat avec nous...

• O file_name é translations.csv.
• O message_component está nas linhas da primeira coluna section_1 e section_2.
• O user_property é o cabeçalho de coluna correspondente ao código de idioma. Podemos referenciar isso no usuário com a propriedade user.language.

Sintaxe Liquid básica para a mensagem multi-idioma

Copiar

Perguntar à IA

{{dynamic_content.translations.section_1[user.language]}}
{{dynamic_content.translations.section_2[user.language]}}

(Recomendado) Sintaxe Liquid com fallback padrão para a mensagem multi-idioma

Copiar

Perguntar à IA

{% assign supported_langs = "en,es,fr,de" | split: "," %}
{% assign lang = user.language | default: "en" %}

{% unless supported_langs contains lang %}
  {% assign lang = "en" %}
{% endunless %}

{{ dynamic_content.translations.section_1[lang] | default: "Hello" }}
{{ dynamic_content.translations.section_2[lang] | default: "Thanks for shopping with us..." }}

content_personalization_template.csv

Copiar

Perguntar à IA

campaign_id,title,message,url
campaign_123,Flash deal for you,Tap to claim,https://example.com/flash
campaign_456,Weekend picks are here,See what's trending,https://example.com/weekend
default,Our latest offers,See what's new,https://example.com

• O file_name é content_personalization_template.csv.
• O user_property mapeia para a chave de tag: campaign_id.
• O message_component é o cabeçalho de coluna mapeado para a seção da mensagem que você deseja personalizar (title, message ou url).

Sintaxe Liquid para a mensagem de personalização de conteúdo

Copiar

Perguntar à IA

{{ dynamic_content.content_personalization_template[campaign_id].title }}
{{ dynamic_content.content_personalization_template[campaign_id].message }}
{{ dynamic_content.content_personalization_template[campaign_id].url }}

(Recomendado) Sintaxe Liquid com fallback padrão para a mensagem de personalização de conteúdo

Copiar

Perguntar à IA

{% assign cid = campaign_id | default: "default" %}

{% unless dynamic_content.content_personalization_template[cid] %}
  {% assign cid = "default" %}
{% endunless %}

{{ dynamic_content.content_personalization_template[cid].title | default: "Nossas últimas ofertas" }}
{{ dynamic_content.content_personalization_template[cid].message | default: "Veja as novidades" }}
{{ dynamic_content.content_personalization_template[cid].url | default: "https://example.com" }}

​

Usar HTML em células CSV (somente e-mail)

campaign_id,banner_html
spring_sale,<div style="background:#4CAF50;padding:16px;text-align:center;"><a href="https://example.com/spring" style="color:#fff;font-size:18px;">Shop the Spring Sale</a></div>
default,<div style="background:#333;padding:16px;text-align:center;"><a href="https://example.com" style="color:#fff;font-size:18px;">See What's New</a></div>

{{ dynamic_content.promo_banners[campaign_id].banner_html | default: "<p>Check out our latest offers</p>" }}

​

Referência

​

Atualizando templates

​

Caracteres especiais em chaves

{{ dynamic_content.file_name["!the_row!"]["&the_column&"] }}

{{ dynamic_content.file_name.the_row.the_column }}

​

FAQ

​

Como posso testar o Conteúdo Dinâmico com CSV?

• Use endereçamento + em emails para testar múltiplas variações: username+test@example.com.
• Configure tags seguindo os exemplos multi-idioma e de personalização de conteúdo acima.
• Veja Importar para mais informações sobre upload de múltiplos usuários e tags de dados.

​

Quando usar Conteúdo Dinâmico com CSV vs. outras opções de personalização?

​

Páginas relacionadas