Saiba como importar as informações de atribuição de instalação existentes da sua organização para a plataforma Singular.

O que são importações de dados de atribuição?

Quando você muda de um provedor de atribuição diferente para a Singular, nós oferecemos a opção única de importar a base de usuários existente de seus aplicativos.

Essa importação permite que a Singular marque esses usuários como usuários existentes e mantenha os números de instalação precisos. Isso ajuda, mas não impede, um "pico orgânico" ao mudar para a Singular, ao mesmo tempo que protege você de ser cobrado duas vezes pela mesma instalação do aplicativo no respetivo dispositivo.

Tenha em atenção que tem de importar os dados históricos para a sua conta Singular antes de qualquer aplicação estar a receber tráfego em tempo real na Singular. Se você lançar seu aplicativo nas lojas de aplicativos antes de carregar os dados históricos, haverá picos nas instalações orgânicas e a fonte de atribuição para alguns dos dispositivos estará incorreta.

Como seus usuários existentes são identificados pelo Singular?

Para dispositivos Android:

• O Google Advertising ID (GAID) ou o Android App Set ID (ASID) do dispositivo é OBRIGATÓRIO!

Para dispositivos iOS:

• O Identificador de fornecedor (IDFV) do dispositivo é OBRIGATÓRIO!
• O Identificador de Publicidade (IDFA) do dispositivo é opcional , mas deve ser fornecido se o tiver!

A Singular não usa IDs de usuário personalizadospara o processo de importação (ou para qualquer funcionalidade de atribuição), mesmo que você compartilhe IDs de usuário personalizados com a Singular.

Como a Singular faz a ingestão dos dados?

A Singular irá ingerir os dados que você fornecer, desde que os dados estejam formatados de acordo com as especificações de arquivo de dados abaixo:

Especificações do ficheiro de dados:

• O formato do nome do arquivo deve começar com a data de geração do arquivo em AAAAMMDD e especificar o nome do aplicativo e a plataforma. AAAAMMDD_Nome_da_aplicação_Plataforma_Importar.csv
  Exemplo: 20170115_SingularDeviceAssist_iOS_Import.csv
  
• O ficheiro de dados deve estar no formato CSV (separado por vírgulas) codificado por Unix.
• O ficheiro de dados deve estar formatado corretamente, sem erros.
• Os ficheiros de dados devem ter um tamanho ≤ 2 GB cada. Para grandes conjuntos de dados, pode dividir os ficheiros.
• Todos os ficheiros de dados devem incluir a linha de cabeçalho adequada, tal como definido nas especificações.
• Todos os identificadores UUIDv4 (por exemplo, IDFA, IDFV, GAID, ASID) devem ter 36 caracteres de comprimento.
• As linhas duplicadas devem ser removidas.
• As linhas sem um identificador de dispositivo válido não serão importadas.
• Os espaços à esquerda e à direita devem ser removidos de todos os valores.

Especificação do layout do ficheiro de dados

Ficheiros de amostra

20170115_SingularDeviceAssist_Android_Import.csv

20170115_SingularDeviceAssist_iOS_Import.csv

Nome da coluna	Obrigatório	Descrição	Exemplo Valor
app_name		O nome do aplicativo, conforme exibido na página Aplicativos do Singular	Minha aplicação
app_id		Nome do pacote/ID do pacote da aplicação para Android/iOS, respetivamente. Nota: não utilizar o ID da App Store (exemplo: id1441750662 )	com.singular.app
os		Especificar Android ou iOS	Android ou iOS
idfa		ID iOS para anunciantes: Se o IDFA e o IDFV estiverem disponíveis, deve fornecer ambos.	DFC5A647-9043-4699-B2A5-76F03A97064B
idfv		ID iOS para fornecedores	21DB6612-09B3-4ECC-84AC-B353B0AF1334
gaid		ID de publicidade do Google	8ecd7512-2864-440c-93f3-a3cabe62525b
asid		ID do App Set: Apenas necessário se o GAID não for fornecido. Se tanto o GAID como o ASID estiverem disponíveis, deve fornecer ambos.	38400000-8cf0-11bd-b23e-10b96e40000d
android_id		ID Android: só é necessário se o GAID e o ASID não forem fornecidos. Se tanto o GAID como o ASID estiverem disponíveis, não deve fornecer o ID Android.	fc8d449516de0dfb
user_id		ID de utilizador personalizado	jogador_1234
fabricante_do_dispositivo		Apenas para dispositivos Amazon	Amazon