CID substitui DPID e DPUUID

Última atualização em 2023-05-20
  • Tópicos
  • Reference
    Exibir mais informações sobre este tópico

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 a 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 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, Audience Managere outros serviços ou recursos não teriam uma maneira de corresponder e sincronizar IDs. Às vezes, essas variáveis são expressas com ou sem a variável 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

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 use 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 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 e sintaxe de URL para IDs declaradas.

OBSERVAÇÃO

É possível usar códigos de integração para suas próprias fontes de dados e para fontes de dados compartilhadas, à qual 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

  • Novas método de API: .../event?d_cid=123%01987...
  • Obsoleto: .../event?d_dpid=123&d_dpuuid=987...

Sincronização de entrada (IBS)

  • Novas método de API: .../ibs:d_cid=123%01987...
  • Obsoleto: .../ibs:d_dpid=123&d_dpuuid=987

Gerar UUID do Audience Manager (ID)

  • Novas método de API: .../id?d_cid=123%01987...
  • Obsoleto: .../id?d_dpid=123&d_dpuuid=987

Cada chamada também pode incluir vários d_cid e d_cid_ic pares de valores chave, como este:

...?d_cid=123%01456&d_cid=123%01789&d_cid_ic=543%01333...

Considerações importantes para equipes de desenvolvimento

Item

Descrição

Codificação de URL

Suas equipes de desenvolvimento deve aplique a codificação de URL às seguintes variáveis no par de valores chave CID:

  • user ID (dpuuid)
  • integration code

Observação: você deve codificar o código de integração e a ID do usuário do URL antes concatenando-os 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 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 o Tabela de codificação ASCII para referência.

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

É possível usar códigos de integração para suas próprias fontes de dados e para fontes de dados compartilhadas, à qual 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.

Nesta página