CID substitui DPID e DPUUID cid-replaces-dpid-and-dpuuid
Atualize seu código para usar d_cid ou d_cid_ic em vez de d_dpid e d_dpuuid. As variáveis DPID e DPUUID continuarão a funcionar, mas você deve considerá-las obsoletas. Isso inclui as variantes DPID e DPUUID sem o d_ prefix.
DPID e DPUUID: uma revisão dpid-dpuuid-review
A DPID e a DPUUID são pares de valores chave que contêm uma ID de provedor de dados e uma ID de usuário. Esses pares de valor-chave vinculam IDs do provedor às IDs do usuário. Eles enviam dados durante chamadas de evento, para eventos de sincronização de entrada e para chamadas de ID. Sem eles, o Audience Manager e outros serviços ou recursos não teria uma maneira de corresponder e sincronizar IDs. Às vezes, essas variáveis são expressas com ou sem o prefixo d_, como mostrado abaixo. Observe que, no código, itálico indica um espaço reservado para variável.
d_dpid=data provider IDdpid=data provider ID
d_dpuuid=data provider unique user IDdpuuid=data provider unique user ID
Esses pares de valor-chave ainda funcionam, mas foram descontinuados. Em vez disso, você deve atualizar seu código para usar CID ou CID_IC.
CID e CID_IC: sobre cid-cidic-about
Os pares de valores-chave CID e CID_IC substituem DPID e DPUUID. Elas fornecem as mesmas funções que a DPID e a DPUUID, mas são mais eficientes porque incluem a ID do provedor de dados (ou código de integração) e a ID do usuário em um único par de valores chave. Em cada par de valor-chave:
- O símbolo = separa a chave de seus valores relacionados.
- O caractere ASCII não imprimível %01 separa os valores.
d_cid e d_cid_ic usam a sintaxe mostrada abaixo. Observe que, no código, itálico indica um espaço reservado para variável.
d_cid=data provider ID%01user IDd_cid_ic=integration code%01user ID
Um código de integração é uma ID alternativa que você pode usar em vez da ID de Source de Dados, atribuída por Audience Manager. Consulte Criar um Source de dados se precisar configurar um código de integração.
Consulte também Sintaxe e variáveis de URL para IDs declaradas.
- DSID_20914 para GAID, representando dispositivos que executam o sistema operacional Android.
- DSID_20915 para IDFA, representando dispositivos que executam o sistema operacional iOS.
Exemplos
A tabela a seguir fornece exemplos por tipo de evento.
- Novo:
.../event?d_cid=123%01987... - Obsoleto:
.../event?d_dpid=123&d_dpuuid=987...
- Novo:
.../ibs:d_cid=123%01987... - Obsoleto:
.../ibs:d_dpid=123&d_dpuuid=987
- Novo:
.../id?d_cid=123%01987... - Obsoleto:
.../id?d_dpid=123&d_dpuuid=987
Cada chamada também pode incluir vários pares de valores principais d_cid e d_cid_ic, desta forma:
...?d_cid=123%01456&d_cid=123%01789&d_cid_ic=543%01333...
Considerações importantes para equipes de desenvolvimento dev-considerations
As equipes de desenvolvimento devem aplicar codificação de URL às seguintes variáveis no par de valores chave CID:
user ID(dpuuid)integration code
Observação: você deve codificar a ID de usuário e o código de integração antes da concatenação em uma cadeia de caracteres. Isso ocorre porque o caractere ASCII %01 que separa as duas variáveis não deve ser capturado na codificação do URL.
A codificação de URL garante que suas IDs de usuário e códigos de integração que contêm caracteres reservados ou não seguros, como, mas não limitados a, + ou =, sejam transmitidos corretamente para nossos servidores.
Use a tabela de codificação ASCIIpara referência.
Você pode usar códigos de integração para suas próprias fontes de dados e para fontes de dados compartilhadas globais, às quais você tem acesso. Por exemplo, você pode usar códigos de integração ao trabalhar com fontes de dados de identificadores móveis. Use os seguintes códigos de integração, exatamente como especificado abaixo:
- DSID_20914 para GAID, representando dispositivos que executam o sistema operacional Android.
- DSID_20915 para IDFA, representando dispositivos que executam o sistema operacional iOS.