Sala limpa liveRamp MAP

O LiveRamp (anteriormente Habu) fornece uma solução segura de colaboração em dados que permite aos anunciantes trabalhar com dados onde quer que residam. Esta solução suporta uma série de casos de utilização em todo o planeamento, filtragem e medição.

Esta capacidade baseia-se na plataforma de Computação Confidencial (ACC) Azure. Permite que os clientes do Microsoft Advertising:

  • Executar consultas personalizadas para analisar cenários de medição
  • Gerar informações acionáveis
  • Criar audiências personalizadas para ativação de campanha

Todo o processamento de dados ocorre em ambientes de execução fidedignos (TEEs) baseados em hardware. Isto garante que os dados permanecem privados e seguros.

Sinais do anunciante carregados para a sala limpa:

  • Permanecer dentro da instância dedicada do LiveRamp do anunciante
  • Não estão acessíveis ou exportáveis pela Microsoft

A análise é executada no TEE em dimensões selecionadas, como campanhas ou intervalos de tempo. Os resultados são agregados e anonimizados para ajudar a cumprir requisitos de privacidade rigorosos.

Origens de dados

Os dados de eventos de campanha do Microsoft Advertising são encriptados e armazenados na infraestrutura de Azure gerida pela Microsoft. Estes dados podem ter origem em campanhas da Plataforma de Publicidade da Microsoft (MAP) ou do Microsoft Monetize.

Pode referenciar estes dados através das seguintes tabelas:

  • Tráfego da Plataforma de Publicidade da Microsoft (MAP)
  • Microsoft Monetize traffic (Rentabilizar tráfego)
  • Tabelas de dados de conversão
  • Associação ao segmento de audiência

Todas as tabelas utilizam um esquema simples. Cada coluna inclui:

  • Name
  • Tipo de dados
  • Descrição

A colaboração de dados ocorre dentro dos limites de preservação de privacidade da sala limpa e segue as restrições de entrada e saída k-min da Microsoft Advertising.

Os dados de eventos encriptados são disponibilizados automaticamente na sala de limpeza LiveRamp diariamente. Os anunciantes ou os respetivos parceiros também podem carregar dados e associá-lo através de consultas SQL (referidas como perguntas).

Atualmente, apenas são suportadas associações exatas no e-mail hash (HEM). Poderão ser suportados identificadores adicionais no futuro.

Tabelas de tráfego da Plataforma de Publicidade da Microsoft (MAP)

Estas tabelas incluem eventos de tráfego (impressões e cliques) de campanhas MAP adicionadas à instância de sala limpa.

Os tipos de campanha suportados incluem:

  • Procurar
  • Audiência
  • Compras
  • Hotel
  • Máximo de Desempenho

map_ad_events tabela

Nome da coluna Tipo de dados Descrição Tipos de campanha suportados
rguid CADEIA Um identificador exclusivo de 128 bits para um pedido de anúncio. Todos
date_time LONG (carimbo de data/hora Unix) A data e hora do evento em UTC. Todos
event_type_id NÚMERO INTEIRO Identificador do tipo de evento. Valores válidos: 1 = Impressões, 2 = Cliques.
hashed_email CADEIA E-mail hash SHA256 que representa o utilizador. Todos
hashed_ip_address CADEIA Endereço IP hash SHA256 que representa o utilizador. Todos
país/região CADEIA Código de país para o evento (por exemplo, E.U.A., AC). Todos
região CADEIA Região geográfica do evento (por exemplo, estado nos E.U.A.). Todos
operating_system CADEIA Sistema operativo do dispositivo. Todos
browser CADEIA Browser utilizado para o evento. Todos
publisher_id NÚMERO INTEIRO Identificador exclusivo do publicador. Todos
publisher_name CADEIA Nome legível por humanos do editor. Todos
site_domain CADEIA Identificador de site mais granular disponível. Todos
advertiser_account_id NÚMERO INTEIRO MAP – identificador exclusivo do anunciante. Todos
campaign_id LONG MAP – identificador exclusivo da campanha. Todos
ad_group_id LONG MAP – identificador exclusivo do grupo de anúncios.
ad_id LONG MAP – identificador exclusivo do anúncio (criativo).
device_type_id NÚMERO INTEIRO Identificador do tipo de dispositivo. Todos
device_type_name CADEIA Tipo de dispositivo legível por humanos (por exemplo, dispositivo móvel, PC). Todos
postal_code CADEIA Código postal onde o evento ocorreu (se disponível). Todos
bidded_keyword CADEIA Palavra-chave visada pela campanha vencedora. Procurar
query_id CADEIA Identificador para uma cadeia de consulta exclusiva. Procurar
gastar DECIMAL Custo do suporte de dados (CPM). Todos
advertiser_account_name CADEIA MAP – nome de anunciante legível por humanos. Todos
campaign_name CADEIA MAP – nome de campanha legível por humanos. Todos
ad_group_name CADEIA MAP – nome do grupo de anúncios legível por humanos.
start_date CARIMBO DE DATA/HORA Data de início da campanha ou grupo de anúncios.
end_date CARIMBO DE DATA/HORA Data de fim da campanha ou grupo de anúncios.
record_date CADEIA Data em que o registo foi recolhido. Todos
campaign_type CADEIA Tipo de campanha (por exemplo, SWF, AWF). Todos
ad_group_type CADEIA Tipo de grupo de anúncios (por exemplo, Padrão de Pesquisa, Pesquisa Dinâmica).
ad_group_price_type CADEIA Tipo de preço do grupo de anúncios (por exemplo, CPC, CPM, CPA).
asset_group_id NÚMERO INTEIRO Identificador do grupo de recursos. PMax
asset_group_name CADEIA Nome do grupo de recursos. PMax
asset_group_start_date CARIMBO DE DATA/HORA Data de início do grupo de recursos. PMax
asset_group_end_date CARIMBO DE DATA/HORA Data de fim do grupo de recursos. PMax
event_type_name CADEIA Nome do tipo de evento legível por humanos (por exemplo, impressão, clique, ver).

Tabelas de tráfego do Microsoft Monetize

Estas tabelas incluem dados de impressão e cliques para itens de linha XBox diretamente vendidos integrados.

monetize_ad_events tabela

Nome da coluna Tipo de dados Descrição
auction_id_64 LONG Um identificador exclusivo de 64 bits para um leilão.
date_time LONG (carimbo de data/hora Unix) A data e hora do evento em UTC.
event_type NÚMERO INTEIRO Identificador do tipo de evento (por exemplo, impressão, clique).
hashed_email CADEIA E-mail hash SHA256 que representa o utilizador.
hashed_ip_address CADEIA Endereço IP hash SHA256 que representa o utilizador.
país/região CADEIA Código de país para o evento (por exemplo, E.U.A., AC).
região CADEIA Região geográfica do evento (por exemplo, estado nos E.U.A.).
operating_system CADEIA Sistema operativo do dispositivo.
browser CADEIA Browser utilizado para o evento.
publisher_id NÚMERO INTEIRO Identificador exclusivo do publicador.
publisher_name CADEIA Nome legível por humanos do editor.
site_domain CADEIA Identificador de site mais granular disponível.
advertiser_id NÚMERO INTEIRO Xandr – identificador exclusivo do anunciante.
insertion_order_id NÚMERO INTEIRO Xandr – identificador exclusivo para a ordem de inserção.
line_item_id NÚMERO INTEIRO Xandr – identificador exclusivo do item de linha.
creative_id NÚMERO INTEIRO Xandr – identificador exclusivo para o criativo.
device_unique_id CADEIA Identificador exclusivo do dispositivo.
device_type_id NÚMERO INTEIRO Identificador do tipo de dispositivo.
device_type_name CADEIA Tipo de dispositivo legível por humanos (por exemplo, móvel, PC).
postal_code CADEIA Código postal onde o evento ocorreu (se disponível).
media_cost DECIMAL Custo do suporte de dados (CPM).
advertiser_name CADEIA Xandr – nome do anunciante.
insertion_order_name CADEIA Xandr – nome da ordem de inserção.
line_item_name CADEIA Xandr – nome do item de linha.
start_date LONG Data de início do item de linha.
end_date LONG Data de fim do item de linha.
line_item_type CADEIA Tipo do item de linha (por exemplo, faixa, nativo).
line_item_price_type CADEIA Tipo de preço utilizado pelo item de linha (por exemplo, CPM).
split_id NÚMERO INTEIRO Identificador da divisão visada pelo leilão.
split_name CADEIA Nome da divisão de destino.
visualizável INT32 Indica se o evento de anúncio foi visualizável.
booked_revenue_usd DUPLO Orçamento entregue para o evento de anúncios.
creative_name CADEIA Nome definido pelo anunciante do criativo.
creative_type CADEIA Tipo de criativo (por exemplo, faixa, nativo, vídeo, áudio).
placement_id NÚMERO INTEIRO Identificador da colocação onde o anúncio foi servido.
placement_group CADEIA Grupo de colocação definido pelo publicador.
placement_name CADEIA Nome definido pelo publicador da colocação.

Tabelas de dados de conversão MAP

Estas tabelas incluem:

  • Conversões expostas por anúncios (atribuídas)
  • Conversões não expostas a anúncios (não atribuídas)

As origens de dados incluem:

  • Controlo de Eventos Universal (UET)
  • Eventos uet server-to-server (S2S)
  • Conversões offline
  • Eventos do SDK UET
  • Eventos da API de Conversão

Uma conversão é considerada atribuída por anúncios se um utilizador tiver recebido um evento de tráfego na janela de pesquisa da campanha (predefinição: 30 dias) antes da conversão.

map_attributed_conversion_events tabela

Nome da coluna Tipo de dados Descrição
RGUID CADEIA RGUID do evento atribuído; corresponde à impressão relacionada ou clique.
event_timestamp LONG Carimbo de data/hora UTC de quando ocorreu o evento original.
conversion_timestamp LONG Carimbo de data/hora UTC de quando ocorreu a conversão.
campaign_id LONG Campanha MAP associada à conversão.
ad_id LONG Anúncio MAP associado à conversão.
goal_id LONG ID do Objetivo do MAP.
goal_name CADEIA Nome do objetivo ou da etiqueta do MAP.
domínio CADEIA Domínio onde o evento ocorreu.
hashed_email CADEIA E-mail com hash associado ao evento (através da pesquisa UMS, se não estiver presente).
goal_value DUPLO Valor de objetivo monetário ou não monetário definido no MAP.
goal_currency_code CADEIA Moeda do valor do objetivo.
goal_value_microcents LONG Valor do objetivo em microcentres.
iso_country_code CADEIA Código de país ISO do utilizador no momento do evento.
goal_lookback_days INT Janela de pesquisa configurada para o objetivo.
ms_click_id CADEIA Clique em ID associado ao evento.

map_raw_conversion_events tabela

Nome da coluna Tipo de dados Descrição
event_timestamp LONG Hora em que o evento UET ocorreu.
collected_timestamp LONG Hora em que o evento UET foi recolhido para eventos S2S e/ou CAPI.
tag_id LONG ID de etiqueta para o evento (mostrado na IU do MAPA).
tag_name CADEIA Nome da etiqueta para o evento (mostrado na IU do MAPA).
event_source CADEIA Origem do evento (por exemplo, UET, UETS2S, CAPI).
domínio CADEIA Domínio onde o evento ocorreu.
hashed_email CADEIA E-mail com hash associado ao evento (através da pesquisa UMS, se ainda não estiver presente).
iso_country_code CADEIA Código de país ISO do utilizador no momento do evento.
ms_click_id CADEIA Clique em ID associado ao evento.

map_goal_achieved_conversion_events tabela

Nome da coluna Tipo de dados Descrição
event_timestamp LONG Hora em que o evento UET ocorreu.
tag_id LONG ID da etiqueta UET associado ao objetivo.
goal_id LONG ID do Objetivo do evento (mostrado na IU do MAPA).
goal_name CADEIA Nome do objetivo do evento (mostrado na IU do MAPA).
goal_value DUPLO Valor de objetivo monetário ou não monetário definido no MAP.
goal_currency_code CADEIA Moeda do objetivo definido no MAP.
goal_value_microcents LONG Valor do objetivo em microcentres.
goal_lookback_days INT Janela de pesquisa de último clique configurada para o objetivo.
event_source CADEIA Origem do evento (por exemplo, UET, UETS2S, CAPI).
domínio CADEIA Domínio onde o evento ocorreu.
hashed_email CADEIA E-mail com hash associado ao evento (através da pesquisa UMS, se ainda não estiver presente).
iso_country_code CADEIA Código de país ISO do utilizador no momento do evento.
ms_click_id CADEIA Clique em ID associado ao evento.

Rentabilizar tabelas de dados de conversão

Esta tabela contém eventos de compra da Loja Xbox associados a itens de linha Monetize.

Estão incluídas conversões expostas por anúncios e não expostas por anúncios.

Uma conversão é considerada atribuída por anúncios se um utilizador tiver recebido um evento de tráfego na janela de pesquisa configurada (1 a 14 dias) antes da conversão.

xbox_conversions tabela

Nome da coluna Tipo de dados PII? (etiqueta k-min necessária) Descrição
data NÚMERO INTEIRO Não Data do evento de conversão no formato YYYYMMDD.
purchase_time LONG Não Carimbo de data/hora unix quando o item foi comprado e preenchido.
line_item_id NÚMERO INTEIRO Não Monetize o ID do item de linha associado ao produto.
advertiser_id NÚMERO INTEIRO Não Monetize o ID do anunciante associado ao item de linha.
hashed_email CADEIA Sim Hash SHA256 utilizado como chave de associação a exposições.
product_id CADEIA Não Identificador exclusivo do produto.
product_name CADEIA Não Nome de produto legível por humanos.
product_category CADEIA Não Categoria ou género do produto (de categoryName).
is_paid_transaction BOOLEANO Não Indica se a compra é paga ou gratuita.
purchase_price_usd DECIMAL Não Preço de compra em USD antes de impostos.
purchase_price_usd_microcents LONG Não Preço de compra em microcentres.
purchase_currency_code CADEIA Não Moeda utilizada para a compra.
device_family CADEIA Não Família de dispositivos (por exemplo, PC, consola, dispositivo móvel).
device_model CADEIA Não Modelo de dispositivo (por exemplo, Xbox One X, Xbox Series S).
in_game_purchase BOOLEANO Não Indica se a compra ocorreu no jogo.
has_xbox_live_subscription BOOLEANO Não Indica se o utilizador tem uma subscrição xbox Live.
has_xbox_game_pass_for_console BOOLEANO Não Indica se o utilizador tem o Xbox Game Pass para a consola.
has_xbox_game_pass_for_pc BOOLEANO Não Indica se o utilizador tem o Xbox Game Pass para PC.
has_xbox_game_pass_ultimate BOOLEANO Não Indica se o utilizador tem o Xbox Game Pass Ultimate.
transaction_type CADEIA Não Tipo de transação (por exemplo, pré-encomenda, compra).
iso_country_code CADEIA Não Código de país onde o evento ocorreu.
order_id CADEIA Não ID de transação exclusivo associado à compra.
hashed_xbox_id LONG Sim XUID associado à compra.

Associação ao segmento de audiência

Esta tabela contém as associações de utilizador para segmento mais recentes para utilizadores ativos. Um utilizador ativo é definido como um utilizador que recebeu uma impressão. Para obter mais informações, veja audiências disponíveis no mercado.

map_ima_segment_exposures tabela

Nome da coluna Tipo de dados Descrição
hashed_email CADEIA E-mail com hash SHA256 que representa o utilizador associado ao registo.
segment_id NÚMERO INTEIRO ID de segmento exclusivo ao qual o utilizador pertence.
segment_name CADEIA Nome de segmento legível por humanos associado ao utilizador.

Carregamento de dados do anunciante

Os anunciantes podem carregar dados originais para a sala de limpeza LiveRamp de duas formas:

  1. Ligar dados de origens de cloud pública suportadas sem mover os dados
  2. Carregar ficheiros de utilizador diretamente

Os conjuntos de dados carregados podem incluir uma variedade de tipos de dados, tais como:

  • Dados de transação offline (por exemplo, visitas à loja ou compras via aplicação não controladas pelo UET ou CAPI)
  • Segmentos de audiência do CRM ou dados do cliente
  • Perfis de cliente (por exemplo, membros do programa de fidelização)
  • Eventos de análise de aplicações ou Web

Os conjuntos de dados que incluem identificadores suportados (como e-mail com hash) podem ser associados a dados da Microsoft para suportar a atribuição personalizada de impressões e cliques.

Todos os ficheiros que contenham informações pessoais (PII), como endereços de e-mail, têm de ser padronizados e hashados antes do carregamento. SHA-256 é o método de hashing suportado.

Formatar e dados hash

Para proteger a privacidade do utilizador, formate e hash dados pessoais antes de carregar.

Formatar dados

Siga estas diretrizes:

  • Formatar números de telefone utilizando a norma E.164

Para endereços de e-mail:

  • Remover espaço em branco à esquerda e à direita
  • Converter todos os carateres em minúsculas
  • Remover texto entre "+" e "@"
    • Exemplo: name+alias@outlook.com → name@outlook.com
  • Remover períodos antes de "@"
    • Exemplo: e.xample@outlook.com → example@outlook.com
  • Certifique-se de que o endereço contém "@"
  • Remover todos os espaços
  • Confirme que está presente um sufixo de domínio (por exemplo, .com)
  • Remover carateres acentuados (por exemplo, à)

Dados hash

  • Utilizar o algoritmo hash SHA-256
  • Não aplicar sal
Tipo de Chave Valor de Exemplo Hash (SHA-256; sem sal; carateres minúsculos)
XUID 1234567890123456 7a51d064a1a216a692f753fcdab276e4ff201a01d8b66f56d50d4d719fd0dc87
E-mail example@outlook.com 912ec7074338e900ecd85cd53cf0e7c3e4e00cb65120eb5a18463a30f0e3e208

Processo de aprovação de consulta (pergunta)

As consultas que incluem os dados de outra parte têm de passar por um processo de aprovação antes da execução.

Este processo ajuda a proteger o PII e garante a conformidade com as salvaguardas de privacidade.

Passos de validação

  1. Validação da sintaxe
    Confirma que as consultas SQL cumprem as restrições de conjuntos de dados definidas pelo proprietário dos dados

  2. Verificações de privacidade e qualidade
    Garante que todas as consultas estão em conformidade com os controlos de privacidade da sala limpa, incluindo limiares k-min de entrada e saída

  3. Aprovação de consultas
    Requer aprovação manual da Microsoft e do anunciante antes da execução

  • Last updated on