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.

Variável
Sintaxe
ID do provedor de dados (DPID)
  • d_dpid=data provider ID
  • dpid=data provider ID
ID de usuário exclusiva (DPUUID) do provedor de dados
  • d_dpuuid=data provider unique user ID
  • dpuuid=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.

Variável
Sintaxe
ID do cliente (CID)
d_cid=data provider ID%01user ID
Código de integração de ID do cliente (CID_IC)

d_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.

NOTE
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.

Exemplos

A tabela a seguir fornece exemplos por tipo de evento.

Tipo de evento
Exemplo
Evento
  • Novo: .../event?d_cid=123%01987...
  • Obsoleto: .../event?d_dpid=123&d_dpuuid=987...
Sincronização de entrada (IBS)
  • Novo: .../ibs:d_cid=123%01987...
  • Obsoleto: .../ibs:d_dpid=123&d_dpuuid=987
Gerar UUID do Audience Manager (ID)
  • 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

Item
Descrição
Codificação de URL

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.

Uso de códigos de integração para fontes de dados globais compartilhadas

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.
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695