Validação de ID de dispositivo global

Última atualização em 2023-05-20
  • Criado para:
  • Experienced
    Developer

Os Identificadores de publicidade de dispositivos (ou seja, iDFA, GAID, ID Roku) têm padrões de formatação que devem ser atendidos para serem usados no ecossistema de publicidade digital. Hoje, clientes e parceiros podem fazer upload de IDs para nossas fontes de dados globais em qualquer formato sem serem notificados sobre se a ID está formatada corretamente. Esse recurso introduzirá a validação de IDs de dispositivo enviadas às fontes de dados Globais para formatação adequada e fornecerá mensagens de erro quando as IDs estiverem formatadas incorretamente. Oferecemos suporte à validação para iDFA, Google Advertising e Roku IDs no lançamento.

Visão geral dos padrões de formato

A seguir estão os pools globais de IDs de publicidade de dispositivos reconhecidos e suportados atualmente pelo AAM. Eles são implementados como compartilhados Data Sources que podem ser usados por qualquer cliente ou parceiro de dados que trabalhe com dados vinculados aos usuários dessas plataformas.

Plataforma ID da fonte de dados AAM Formato de ID PID AAM Notas
Google Android (GAID) 20914 32 números hex, geralmente apresentados como 8-4-4-4-12exemplo, 97987bca-ae59-4c7d-94ba-ee4f19ab8c21
1352 Essa ID deve ser coletada em uma forma bruta/sem hash/inalterada Referência - https://play.google.com/about/monetization-ads/ads/ad-id/
Apple iOS (IDFA) 20915 32 números hex, geralmente apresentados como 8-4-4-4-12 exemplo, 6D92078A-8246-4BA4-AE5B-76104861E7DC
3560 Essa ID deve ser coletada em uma forma bruta/sem hash/inalterada Referência - https://support.apple.com/en-us/HT205223
Roku (RIDA) 121963 32 números hex, geralmente apresentados como 8-4-4-4-12 exemplo, fcb2a29c-315a-5e6b-bcfd-d889ba19aada 11536 Essa ID deve ser coletada em uma forma bruta/sem hash/inalterada Referência - https://sdkdocs.roku.com/display/sdkdoc/Roku+Advertising+Framework
ID de publicidade da Microsoft (MAID) 389146 String alfanumérica 14593 Essa ID deve ser coletada em uma forma bruta/sem hash/inalterada Referência - https://docs.microsoft.com/en-us/uwp/api/windows.system.userprofile.advertisingmanager.advertisingid
https://msdn.microsoft.com/en-us/library/windows/apps/windows.system.userprofile.advertisingmanager.advertisingid.aspx
Samsung DUID 404660 Exemplo de string alfanumérica, 7XCBNROQJQPYW 15950 Essa ID deve ser coletada em uma forma bruta/sem hash/inalterada Referência - https://developer.samsung.com/tv/develop/api-references/samsung-product-api-references/productinfo-api

Definir um identificador de anúncio no aplicativo

Na verdade, definir a ID do anunciante no aplicativo é um processo de duas etapas: primeiro, recuperar a ID do anunciante e, em seguida, enviá-la para o Experience Cloud. Os links são encontrados abaixo para executar essas etapas.

  1. Recuperar a ID
    1. Apple informações sobre o advertising ID pode ser encontrado AQUI.
    2. Algumas informações sobre a configuração do advertiser ID para Android desenvolvedores podem ser encontrados AQUI.
  2. Envie-o para o Experience Cloud usando o setAdvertisingIdentifier no SDK
    1. Informações para usar o setAdvertisingIdentifier está na documentação para ambos iOS e Android.

// iOS (Swift) example for using setAdvertisingIdentifier:
ACPCore.setAdvertisingIdentifier([AdvertisingId]) // ...where [AdvertisingId] is replaced by the actual advertising ID

Mensagens de erro DCS para IDs incorretas

Quando uma ID de dispositivo global incorreta (IDFA, GAID etc.) é enviada em tempo real para o Audience Manager, um código de erro é retornado na ocorrência. Veja a seguir um exemplo de um erro retornado porque a ID é enviada como uma Apple IDFA, que deve conter apenas letras maiúsculas e, no entanto, há um "x" minúsculo na ID.

imagem de erro

Consulte a documentação para obter a lista de códigos de erro.

IDs de dispositivo global integradas

Além do envio em tempo real de IDs de dispositivos globais, você também pode "onboard" (upload) dados nas IDs também. Esse processo é o mesmo de quando você está integrando dados nas IDs do cliente (normalmente por meio de pares de chave/valor), mas você simplesmente usaria as IDs da fonte de dados apropriadas, para que os dados sejam atribuídos à ID do dispositivo global. A documentação sobre o processo de integração pode ser encontrada no documentação. Lembre-se de usar a ID da fonte de dados global, dependendo da plataforma que você está usando.

Se IDs de dispositivo global incorretas forem enviadas por meio do processo de integração, os erros serão exibidos no Onboarding Status Report.

Veja a seguir um exemplo de erro que apareceria nesse relatório:

imagem de erro

Nesta página