CID substitui DPID e 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 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 Manager e outros serviços ou recursos, não teriam uma forma de corresponder e sincronizar IDs. Essas variáveis às vezes são expressas com ou sem o prefixo d_, conforme mostrado abaixo. Observação: no código, italics indica um espaço reservado variável.

Variável Sintaxe

ID do provedor de dados (DPID)

  • d_dpid=data provider ID
  • dpid=data provider ID

ID de usuário único do provedor de dados (DPUUID)

  • d_dpuuid=data provider unique user ID
  • dpuuid=data provider unique user ID

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: 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. Observação: no código, italics indica um espaço reservado variável.

Variável Sintaxe

ID do cliente (CID)

d_cid=data provider ID%01user ID

Código de integração da 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 por 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.

OBSERVAÇÃO

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

  • 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 Audience Manager UUID (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 pares de valores chave d_cid e d_cid_ic como este:

...?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:

  • user ID (dpuuid)
  • integration code

Observação: Você deve codificar a ID do usuário e o código de integração 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 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.

Nesta página