Gerenciamento de dados de localização
O que há nesta página
Sobre o gerenciamento de dados de localização
No Qualtrics, você pode estabelecer uma fonte de verdade para os dados de localização da sua organização, que pode ser referenciada em diferentes projetos e painéis. Isso permite que você colete feedback abrangente sobre todos os seus locais e os analise adequadamente. Isso também é especialmente útil se você precisar atualizar sua lista de locais; basta editar uma fonte para fazer atualizações em todo o programa.
Qdica: Diretórios de localização são compartilhados globalmente dentro da sua marca, o que significa que qualquer usuário com acesso à sua marca também tem acesso aos diretórios de localização criados. Quando um diretório é criado, um projeto de dados importados é criado automaticamente usando a seguinte sintaxe: "[ diretório de localização] <directory name>". Por padrão, esses projetos são compartilhados apenas com o criador do diretório. Os IDPs são úteis para usar dados de localização para personalização pesquisa e relatórios dashboard, mas devem ser compartilhados com os usuários necessários para aplicar a esses tipos de projeto. Consulte Projetos de dados importados para obter mais informações.
Qdica: para acessar e gerenciar o diretório localização, é necessário ter a permissão Manage Location Data (Gerenciar dados de localização ). Para criar diretórios de locais, você precisa da permissão Use Imported Data Projetos (Usar projetos de dados importados ).
Criação de um novo Diretório locais
Qdica: Em vez de enviar um arquivo ou usar um fluxo de trabalho, você também pode adicionar um único local por vez.
Carregamento de dados de localização de um arquivo CSV
Quando um arquivo é validado com êxito, ele começa a ser carregado automaticamente no diretório.
Você verá um banner no diretório de locais mostrando o andamento do upload, incluindo se todos os locais foram importados com sucesso ou se foram detectados problemas no arquivo.
Qdica: Consulte “Solução de problemas relacionados ao envio de arquivos ” caso encontre dificuldades ao enviar seu arquivo.
Upload de dados de localização com um Fluxo de trabalho automatizado
Depois de criar um fluxo de trabalho, você poderá gerenciá-lo na seção “Fontes de dados” da guia “Configurações” no diretório de localização da sua localização.
Solução de problemas de upload de arquivos
Esta seção aborda diversos problemas que você pode encontrar ao enviar seu arquivo e como resolvê-los.
Envios com falha
Se o seu arquivo não estiver de acordo com as diretrizes de formatação, você verá a mensagem: “Este arquivo não está no formato esperado.” Consulte as diretrizes de formatação do arquivo e tente enviá-lo novamente após fazer os ajustes necessários.
Se o seu arquivo estiver formatado corretamente, mas houver erros nos dados contidos nele, você verá uma mensagem alertando sobre esses erros. Clique no botão “Baixar relatório de erros ” para baixar um arquivo no seu computador que descreve cada erro. Isso baixa o relatório de erros como um arquivo CSV, e ele está disponível apenas em inglês.
Cada linha do arquivo corresponde a um campo diferente com um erro que precisa ser corrigido. O arquivo contém as seguintes colunas:
- ID de localização: O ID de localização do campo. Se um local apresentar vários erros, eles serão agrupados no arquivo por ID do local.
- Campo: O nome do campo em que ocorreu o erro.
- Tipo de erro: Uma breve descrição do erro.
- Código de erro e mensagem de erro: Um código de erro interno e uma descrição do erro. Os possíveis códigos de erro e suas descrições incluem:
- V_01: O ID do local deve começar com LOC_ e ter de 15 a 19 caracteres.
- V_02: O status deve ser ATIVO, INATIVO ou ENCERRADO, ou pode ser deixado em branco.
- V_03: Todos os campos obrigatórios estão em branco. Preencha pelo menos um campo para continuar.
- V_04: As coordenadas devem ser números. A latitude varia de –90 a 90, e a longitude, de –180 a 180.
- V_05: O valor é muito longo. Encurte o texto e tente novamente.
- V_06: Um local pode ter até 10 concorrentes. Remova as entradas em excesso e tente novamente.
- V_07: O valor deve corresponder ao tipo esperado para o campo (texto, número, data, verdadeiro/falso).
- V_08: Esses campos são obrigatórios para identificar o local.
- V_09: O número de colunas não corresponde ao do cabeçalho. Verifique se há separadores a mais ou faltando.
Depois de corrigir os erros e reenviar seu arquivo, Qualtrics importará os locais para o seu banco de dados. Se você vir a mensagem “Não foi possível adicionar os locais”, isso significa que o envio dos locais falhou.
Existem três possíveis motivos para isso:
- ID de localização inválido: o ID de localização deve corresponder a um local existente ou ser deixado em branco para adicionar um novo.
- Entrada duplicada: este local já existe. Remova ou atualize a duplicata.
- Erro do sistema: ocorreu uma falha interna (por exemplo, problemas de conectividade com o banco de dados). Se você já descartou as outras possibilidades, tente enviar a localização novamente. Se o problema persistir, entre em contato com o suporte.
Uploads parciais
Se apenas alguns locais tiverem sido enviados com sucesso, você verá um resumo do número de locais adicionados, além do número de locais que apresentaram problemas e não puderam ser adicionados.
Você sempre pode baixar seu diretório para ver quais locais foram bem-sucedidos:
Formatação de arquivos
- diretório de localização suporta apenas arquivos TSV ou CSV no formato “ ” com codificação UTF-8. O diretório não é compatível com XLSX ou qualquer outro tipo de arquivo.
- O arquivo máximo que você pode carregar é de 100 MB.
Qdica: para obter ajuda adicional sobre a formatação de arquivos TSV e CSV, consulte Problemas de upload de CSV e TSV.
Regras para evitar locais duplicados
Locais com informações idênticas podem ser mesclados automaticamente, mantendo os dados mais recentes e evitando duplicatas. Para isso, você pode definir um campo com valores exclusivos que possam ser usados para identificar locais específicos, como a “Referência Externa de Localização”.
Atenção:Não é possível alterar a regra para mesclar duplicatas depois que os locais forem adicionadosao diretório. É necessário remover todos os locais do diretório para editar a regra, o que poderia afetar negativamente os projetos conectados. Entre os impactos negativos está a necessidade de recarregar as revisões do ORM, o que poderia afetar os custos. Por esse motivo, recomendamos escolher cuidadosamente um campo com valores únicos (por exemplo, Código da Loja, ID do Google Place) antes de enviar os locais para o diretório.
Exemplo: Você tem um código de identificação exclusivo para cada loja da sua empresa. Você salva esses códigos de loja no campo “Referência externa do local”. Portanto, sua regra para evitar duplicatas seria a “Referência Externa de Localização”.
Exemplo: os IDs do Google Places são exclusivos para cada local. Você não tem outro código de identificação interno que utilize para seus locais, mas eles fazer Cada um deles possui uma ficha no Google Places; portanto, você define o ID do Google Places como regra para evitar duplicatas.
Essas regras não apenas evitam duplicatas, mas também facilitam a atualização de seus locais por meio do envio de um arquivo. Com uma regra definida, o diretório pode identificar um local específico e o atualizará com as informações mais recentes que você fornecer.
Qdica: Se você quiser usar um campo personalizado como uma de suas regras para evitar duplicatas, certifique-se de criar esse campo personalizado antes de começar a enviar locais. Consulte Configurações do esquema.
A regra (ou conjunto de regras) diretório de localização cada diretório de localizaçãoé definida separadamente. Não há como definir uma regra que se aplique a todos os seus diretórios de localização.
Adicionando uma regra adicional
Para adicionar outra regra para mesclar locais duplicados, clique em “Criar próxima regra”. Você pode configurar até 2 regras no total.
Exemplo: Se você tiver duas regras, os locais duplicados precisarão corresponder a ambos os campos antes de serem unificados. Por exemplo:
- Digamos que suas regras levem em conta a “Referência Externa de Localização ” e a “Cidade”.
- Se você tentasse enviar a lista de locais a seguir, eles seriam agrupados:
- Referência externa do local: 10000001; Cidade: Provo
- Referência externa do local: 10000001; Cidade: Provo
- Isso ocorre porque essas linhas têm a mesma referência externa de localização e a mesma cidade.
- No entanto, se você tentasse enviar os seguintes locais, eles não seriam mesclados:
- Referência externa do local: 10000001; Cidade: Provo
- Referência externa do local: 10000001; Cidade: Tampa
- Referência externa do local: 10000222; Cidade: Provo
- Não basta ter a mesma referência externa de localização ou a mesma cidade. Ambos precisam ter valores iguais.
Visualizando a regra Diretório de localização para mesclar duplicatas
Se você quiser verificar qual é a regra diretório de localização já existente para evitar duplicatas, faça o seguinte:
- Acesse o diretório de localização”.
- Selecione Configurações.
Selecione “Gerenciar diretório”.
- Consulte a seção “Regra” para evitar duplicatas.
Qdica: Se você ainda não adicionou locais ao seu diretório, a opção “Gerenciar diretório” também é onde você pode editar sua regra de prevenção de duplicatas.
Adicionando um único local
Você também pode optar por adicionar manualmente um local de cada vez ao seu diretório.
Criação de um diretório de concorrentes
A maioria diretórios de localização funciona como um repositório dos endereços da sua própria marca ou organização. No entanto, você pode criar uma pasta com os endereços dos concorrentes. Isso pode ser útil para associar concorrentes específicos a cada uma das unidades da sua organização, agregando uma perspectiva comparativa aos seus relatórios gerenciamento de reputação.
Para saber mais, consulte “Análises da concorrência”.
Edição de locais
Se quiser remover locais ou alterar a forma como eles aparecem no seletor de locais, você pode retornar ao diretório locais.
Vá até o menu de navegação global, selecione “Diretórios” e, em seguida, selecione Diretório de localização ”.
Em seguida, clique em View locations (Exibir locais ) avançar de um de seus diretórios de locais.
Uma vez lá, você pode fazer o seguinte:
Endereço exibido
Você pode decidir quais informações deseja exibir para cada local no seletor. Você pode escolher 3 de qualquer um dos campos mapeados para o diretório localização. Quando terminar, clique em Salvar.
Configurações de localização
O menu de configurações oferece diferentes configurações que podem ser definidas para o seu diretório.
Fontes de dados
A guia fontes de dados contém uma lista das fontes de dados usadas no diretório localização que você selecionou. Clique em Adicionar ou atualizar dados de localização para carregar uma lista localização.
- Para adicionar um novo local: deixe o campo "LocationID" vazio.
- Para atualizar locais existentes: edite os campos que deseja atualizar, mas mantenha o campo "LocationID" existente inalterado. Para obter mais informações, consulte Upload de locais para um Diretório.
- Para excluir um local: Adicione uma coluna com o título "toBeDeleted" (a ser excluído) e, em seguida, digite "yes" (sim) para as linhas de locations que você gostaria de excluir. Esses valores diferenciam maiúsculas de minúsculas. Consulte Exclusão de locais de um Diretório para obter mais informações.
Qdica: todos os dados existentes não incluídos no arquivo carregado permanecerão os mesmos.
Se você tiver configurado fluxos de trabalho automatizados para importar dados de localização, eles também serão listados na seção de fontes de dados. Você pode ver quais fluxos de trabalho estão ativos no momento e quais foram desativados. Clique em Exibir fluxo de trabalho para ser levado ao editor de fluxo de trabalho para esse fluxo de trabalho específico.
Configurações de esquema
As configurações de esquema contêm os campos de localização usados em seu diretório. Clique em Criar um campo de localização personalizado para adicionar um novo campo ao diretório.
Qdica: os campos personalizados são compartilhados em todos os diretórios de local. É possível criar até 50 campos personalizados por marca. Depois que os campos personalizados são criados, eles não podem ser excluídos.
Endereço exibido
Você pode decidir quais informações deseja exibir para cada local no seletor. Você pode escolher 3 de qualquer um dos campos mapeados para o diretório localização. Quando terminar, clique em Salvar.
Relatório
Apenas diretórios concorrentes que possuam uma seção de Relatórios. É aqui que são reunidas as localizações dos concorrentes e do diretório de empresas. Para saber mais, consulte a seção “Análises da concorrência”.
Excluir diretório
Aviso: a exclusão de um diretório de localização afetará todos dashboards, seletores de localização ou projetos gerenciamento de reputação aos quais ele esteja vinculado. Quando um diretório de local é excluído, ele é irrecuperável, e você precisará criar um novo diretório para se conectar a seletores e projetos.
Projetos ativos
Acesse a guia “Projetos ativos” para visualizar os projetos que, no momento, utilizam dados do seu diretório de localização. Por exemplo, um projeto que usa perguntas do seletor de local estaria aqui. Clique em Ir para o projeto para abrir um projeto específico.
Exclusão de locais de um Diretório
Você pode excluir manualmente locais específicos do seu diretório. Para remover vários locais de uma vez, você pode carregar um arquivo:
Qdica: se você tiver uma automação, como um fluxo de trabalho, configurada para seus locais, recomendamos também excluir o local da fonte de automação (como sua conta do Google Business). Caso contrário, o local será adicionado novamente quando sua automação for executada.
Qdica: como alternativa, você pode excluir um único local clicando no menu de opções avançar do local e selecionando Excluir.
Campos de dados de localização disponíveis
Atenção: É altamente recomendável exportar um arquivo amostra antes de criar um arquivo de dados de localização.
Uma das etapas para configurar um diretório locais é criar um arquivo com os locais que você deseja usar no Qualtrics. A seguir, apresentaremos uma lista de todos os campos que oferecemos suporte.
Qdica: se houver campos de localização adicionais que você gostaria de incluir e que não foram abordados aqui, é possível adicioná-los como campos personalizados. Para obter mais informações, consulte Configurações de esquema.
- LocationName: Fornece um nome reconhecível para cada entrada no diretório, permitindo que os usuários identifiquem e gerenciem facilmente diferentes locais (por exemplo, "Qualtrics Provo"). Esses nomes devem ser profissionais, de marca, voltados para o cliente e, idealmente, devem corresponder ao que aparece no Google Maps. Esse campo é obrigatório para projetos do Search The Web.
LocationID: Esse é um identificador exclusivo atribuído automaticamente pelo sistema Qualtrics. Nas primeiras importações ou ao adicionar novos locais a um diretório existente, certifique-se de incluir essa coluna, mas deixe os valores em branco. Esse campo é obrigatório para projetos do Search The Web.
Aviso: Você deve deixar os IDs de local em branco para carregar um novo local. Faça upload de IDs de locais existentes para fazer atualizações em locais existentes.
Qdica: depois que os IDs de local são gerados, eles assumem o formato LOC_XXXXXX.
Aviso: Os registros com IDs de local existentes terão todos os campos não nulos substituídos pelos valores revisados no novo arquivo CSV quando carregados, incluindo LocationExternalReference.
Referência de localização externa: Baseia-se em um identificador único do seu sistema interno de registro e é frequentemente usada para identificar um local específico em diferentes conjuntos de dados, diretórios e projetos. Certifique-se de que cada linha de seu arquivo tenha um valor exclusivo para esse campo. Esse campo é obrigatório para projetos do Search The Web.
Qdica: Um uso comum para esse campo é o código da loja. Em outras palavras, se você tiver IDs exclusivos que atribui a cada loja, poderá armazená-los em LocationExernalReference.
Aviso: O uso de um campo interno que não funcione como identificador exclusivo para preencher valores na coluna “LocationExternalReference” pode resultar em inconsistências nos dados.
- Cidade: A cidade em que o local se encontra (por exemplo, “Atlanta”). Este campo é obrigatório para projetos do tipo “Pesquisar na Web ”.
- País/Região: O país ou a região em que o local se encontra (por exemplo, “Estados Unidos” ou “Centro-Oeste”). Esse campo é obrigatório para projetos do Search The Web .
- Departamento: O departamento ou tipo de local ao qual o local está associado (por exemplo, “Loja Outlet”).
- Distrito: O distrito em que o local se encontra. Normalmente, essa é a ID do distrito.
- GoogleMapsURL: O URL do Google Maps do local. Esse campo torna os projetos do “Pesquisar na Web ” mais precisos.
- LocationEmail: O e-mail para o qual o feedback do local deve ser enviado.
Latitude do local: As coordenadas de latitude do local (por exemplo, “40,3030”). As coordenadas devem estar em graus decimais, dentro do intervalo de -90 a 90.
Qdica: a pergunta do seletor de local tem um característica "Nearby" (Próximo) que pesquisará qual dos locais fornecidos é o mais próximo do respondente pesquisa. Para ativar esse característica, seu arquivo de dados deve incluir campos de latitude e longitude.
- Longitude do local: As coordenadas longitudinais do local (por exemplo, “111,6634”). As coordenadas devem estar em graus decimais, dentro do intervalo de -180 a 180.
Qdica: Os valores de longitude e latitude são obtidos do campo “latlng” na API do Perfil do Google Business. Se esses valores não estiverem aparecendo no Qualtrics, entre em contato com o Suporte do Google para que a API transmita um valor para latlng. Como alternativa, você pode editar a localização e inserir os valores manualmente no Qualtrics.
- LocationPhoneNumber: O número de telefone usado pelos clientes para chegar a um local específico.
LocationStatus: Indica se esse local está operando no horário comercial normal, se está temporariamente fechado ou se foi permanentemente fechado.
Qdica: os valores só devem ser definidos como ativos, inativos, fechados ou deixados em branco (nulos).
- Ativo: Definido manualmente para lojas abertas.
- Inativo: Defina manualmente quando você decidir parar de obter avaliações para um local específico.
No entanto, os diretórios sincronizados com o Google apresentam apenas os seguintes status:
- Vazio/nulo: Todas as localizações sincronizadas com o Google apresentam esse status.
- Fechado: Será definido automaticamente quando um local for excluído de uma conta do Google conectada.
Aviso: O não uso dos valores predefinidos para esse campo resultará em uma falha no upload de dados para os locais com esse campo atribuído incorretamente.
- PostalCode: O código postal do local. Esse campo é obrigatório para projetos do Search The Web .
- Estado/Província: O país ou região onde se localiza (por exemplo, “Utah” ou “Nova Escócia”). Este campo é obrigatório para projetos do tipo “Pesquisar na Web ”.
- StreetAddress: O endereço da rua de um local físico. Os valores nesse campo devem conter o número do edifício e o nome da rua (por exemplo, "333 River Park Dr.").
- LastUpdateDate (Data da última atualização): Para diretórios que foram atualizados pelo menos uma vez, esse campo indica a data em que uma determinada entrada de local foi atualizada pela última vez.
- CreationDate (data de criação): Quando um diretório é estabelecido, esse campo indica a data em que um determinado registro de local foi criado.
- GoogleAccountName: O nome da conta do Google Business usada para gerenciar o perfil comercial do local.
- GoogleLocationName: O nome usado para representar o local no Google.
- GooglePlaceID: o identificador exclusivo preenchido pelo Google para sua localização. Esse tipo de identificador é criado pelo Google para organizar locais como empresas, pontos turísticos, parques e cruzamentos. O Google Place ID é utilizado pela pergunta “Solicitar avaliações ” para identificar locais do Google. O Google Place ID não é utilizado pelos projetos do “Search the Web”.
- GoogleStoreCode: O identificador exclusivo atribuído a cada local em seu perfil do Google Business.
Atenção: Para saber os campos exigidos por cada solução, consulte Campos obrigatórios de dados de localização para seletores de localização e Campos obrigatórios para gerenciamento de reputação.
Personalização de pesquisas com dados suplementares
O uso de fontes de dados complementares (SDS) em seus projetos pesquisa permite que você utilize dados de localização para personalizar a experiência pesquisa e aprimorar sua análise de dados. Você poderá personalizar o que os clientes veem com base na localização deles e poderá coletar muitos dados de localização sem precisar salvar individualmente cada informação na própria pesquisa.
Depois de configurar os dados complementares na mesma pesquisa em que está a sua perguntade seleção de localização ou de solicitação de avaliações, você poderá usar os seguintes recursos:
Além disso, você poderá salvar seus dados de localização como dados integrados, que podem ser usados em dashboards de resultados, relatórios, Stats iQ e muito mais.
Atenção: Toda a lógica e texto transportado devem ser baseados nos dados integrados que você criou na etapa 19.
Gerenciamento de diretórios de locais a partir de Projetos de dados importados
Atenção: Os diretórios de locais importados diretamente têm várias melhorias de desempenho e funcionalidade que os diretórios projeto de dados importados não têm. Em vez disso, recomendamos a importação direta de seus dados de localização.
Qdica: se estiver usando um projeto de dados importados em vez de carregar um arquivo diretamente, pode levar até 24 horas para que você veja os valores atualizados no seletor de local.
Não é mais possível criar diretórios de localização usando projetos de dados importados. No entanto, se você tiver criado esses diretórios de localização no passado e quiser editá-los ou excluí-los, vá para o diretório de localização e, em seguida, para a guia Data from Imported Data Project (Dados do projeto de dados importados ).
Clique no ícone de edição para ajustar os mapeamentos de campo ou os endereços exibidos para as perguntas do seletor de local.
Formatação de campos de dados importados
No projeto de dados importados, é necessário definir um ID exclusivo. Essa ID exclusiva deve ser um valor de texto, mesmo que seja de fato uma ID numérica.
Se você tiver incluído campos de latitude e longitude, certifique-se de que eles estejam mapeados como valores numéricos.
Qdica: Se, em algum momento, você precisar alterar os locais disponíveis, será necessário editar o arquivo de dados original dos locais e reimportar o arquivo atualizado para este projeto de dados importados. Todos os novos dados devem ser reimportados. Depois que os dados forem reimportados, pode levar até 24 horas para que você veja os valores atualizados no seletor de local.
Mapeamento dos campos Diretório locais
Perguntas frequentes
Como faço para acessar o diretório de localização?
Como faço para acessar o diretório de localização?
Também exibimos um link para o diretório de localização da plataforma quando você cria uma pergunta com seletor de local e quando cria um projeto gerenciamento de reputação com base em pesquisas na web.
Se eu editar os dados de um local em um diretório de localização, essa alteração será aplicada retroativamente aos dados dashboard meu painel?
Se eu editar os dados de um local em um diretório de localização, essa alteração será aplicada retroativamente aos dados dashboard meu painel?
Posso usar meus dados de localização nos relatórios dashboard?
Posso usar meus dados de localização nos relatórios dashboard?
Isso é ótimo! Obrigado pelo seu feedback!
Obrigado pelo seu feedback!