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 aplicativo estar recebendo 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 arquivo 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 arquivo de dados deve estar no formato CSV (separado por vírgulas) codificado por Unix.
• O arquivo de dados deve estar formatado corretamente, sem erros.
• Os arquivos de dados devem ter um tamanho ≤ 2 GB cada. Para grandes conjuntos de dados, pode dividir os arquivos.
• Todos os arquivos 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 arquivo de dados

Arquivos 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	Meu aplicativo
app_id		Nome do pacote/ID do pacote do aplicativo 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 usuário personalizado	jogador_1234
fabricante_do_dispositivo		Apenas para dispositivos Amazon	Amazon