Show Menu
TÓPICOS×

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 funcionando, mas você deve considerá-las obsoletas. Isso inclui variantes DPID e DPUUID sem o d_ prefix .

DPID e DPUUID: Uma revisão

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 valores-chave emparelham as IDs do provedor de link com as 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, Audience Managere outros serviços ou recursos, não haveria uma forma de corresponder e sincronizar IDs. Essas variáveis às vezes são expressas com ou sem o d_ prefixo, conforme mostrado abaixo. Observação: no código, o itálico indica um espaço reservado variável.
Variável Sintaxe
ID do provedor de dados (DPID)
  • d_dpid=ID do provedor de dados
  • dpid=ID do provedor de dados
ID de usuário único do provedor de dados (DPUUID)
  • d_dpuuid=ID de usuário exclusiva do provedor de dados
  • dpuuid=ID de usuário exclusiva do provedor de dados
Esses pares de valor chave ainda funcionam, mas estão obsoletos. Você deve atualizar seu código para usar CID ou CID_IC.

CID e CID_IC: 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 dos valores relacionados.
  • O caractere ASCII não imprimível %01 separa os valores.
d_cid e d_cid_ic use a sintaxe mostrada abaixo. Observação: no código, o itálico indica um espaço reservado variável.
Variável Sintaxe
ID do cliente (CID)
d_cid=ID do provedor de dados%01ID do usuário
Código de integração da ID do cliente (CID_IC)
d_cid_ic=código de integração%01 ID do usuário
Um código de integração é uma ID alternativa que você pode usar em vez da ID da Fonte de Dados, atribuída pelo Audience Manager . Consulte Criar uma fonte de dados se precisar configurar um código de integração.
Consulte também Variáveis de URL e Sintaxe para IDs declaradas.
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 d_cid e d_cid_ic chaves como:
...?d_cid=123%01456&d_cid=123%01789&d_cid_ic=543%01333...

Considerações importantes para as equipes de desenvolvimento

Item
Descrição
Codificação de URL
Suas equipes de desenvolvimento devem aplicar a codificação de URL às seguintes variáveis no par de valores chave CID:
  • ID do usuário (dpuuid)
  • código de integração
Observação: É necessário codificar a ID do usuário e o código de integração em URL antes de concatená-los em uma string. 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 as IDs de usuário e os 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 ASCII para referência.
Uso de códigos de integração para fontes de dados compartilhadas globais
Você pode usar códigos de integração para suas próprias fontes de dados e para fontes de dados globais compartilhadas, à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.