Snowflake Data Clean Rooms: conectores de ativação¶
Nota
Snowflake Data Clean Rooms atualmente não oferecem suporte ao gerenciamento do consentimento do titular dos dados. Os clientes são responsáveis por garantir que obtiveram todos os direitos e consentimentos necessários para usar os dados vinculados em suas salas limpas. Os clientes também devem garantir a conformidade com todas as leis e regulamentos aplicáveis ao usar o Data Clean Rooms, inclusive em conexão com conectores de terceiros.
Você pode usar conectores para integrar seu ambiente de sala limpa com o que seus parceiros de ecossistema fornecem. Este tópico descreve como o administrador da sala limpa pode configurar um conector para que os usuários da sala limpa possam enviar o resultado de uma análise para um parceiro de ativação.
Se você for um provedor que deseja controlar quais conectores aparecem como opções quando um usuário de sala limpa executa uma análise, consulte Personalize os conectores disponíveis.
Importante
Conectores de terceiros não são oferecidos pela Snowflake e podem estar sujeitos a termos adicionais. Essas integrações são disponibilizadas para sua conveniência, mas você é responsável por qualquer conteúdo enviado ou recebido das integrações.
Os clientes são responsáveis por obter todos os consentimentos necessários em conexão com o uso das Snowflake Data Clean Rooms. Certifique-se de estar em conformidade com as leis e regulamentações aplicáveis ao usar os Snowflake Data Clean Rooms, inclusive em conexão com conectores de terceiro para fins de ativação.
Conector Google Ads¶
O Google Ads é uma plataforma de publicidade online onde os anunciantes fazem lances para exibir anúncios breves, ofertas de serviços, listagens de produtos ou vídeos para usuários da Web.
Você deve ter a função MANAGE_DCR_CONNECTORS para configurar esse conector.
Para configurar o conector para que seu ambiente de sala limpa seja integrado à sua conta Google Ads:
Na navegação à esquerda do aplicativo da Web, selecione Connectors.
Selecione a guia Activation.
Expanda o Google Ads.
Insira suas credenciais Google.
No campo Account ID, insira o ID associado à sua conta Google Ads.
Especifique sua preferência de API. Se você selecionar My Developer Token, insira seu token de desenvolvedor para a API Google Ads.
Selecione Save.
Consulte a guia user guide para saber como ativar os resultados usando esse conector.
Veja como ativar os resultados da análise com o Google Ads. Estas instruções pressupõem que esse conector tenha sido instalado e configurado corretamente.
Para enviar os resultados de uma análise ao Google Ads para ativação:
Execute uma análise que retorne dados que podem ser ativados. Por exemplo, as análises que usam o modelo Audience Overlap & Segmentation podem ser ativadas.
Para obter mais informações sobre como executar uma análise, consulte Execução de uma análise como provedor ou Execução de uma análise como consumidor.
Na seção Results, selecione Activate.
Na caixa de diálogo Activation Hub, selecione Google Ads.
No campo Account ID, insira o identificador da conta para onde você deseja enviar o segmento.
No campo Segment Name, insira um nome descritivo para seus resultados.
No campo Description, insira uma descrição dos dados que você está enviando para o Google Ads.
Na seção Activation IDs, selecione as colunas que contêm identificadores de e-mail com hash e/ou identificadores de telefone com hash.
Selecione Push Data.
Conector Google Display & Vídeo 360-PAIR¶
Google Display & Video 360-PAIR é uma plataforma de publicidade online em que os anunciantes dão lances para exibição. PAIR oferece aos editores e anunciantes a opção de reconciliar de forma segura e privada seus dados primários para públicos que visitaram tanto o site de um anunciante quanto o de um editor.
Você deve ter a função MANAGE_DCR_CONNECTORS para configurar esse conector.
Para integrar o ambiente de sua clean room com o Display & Video 360-PAIR, você deve configurar esse conector da seguinte forma:
Antes de configurar o conector, vincule seu ID de conta no Google Display & Video 360 a CMU: Snowflake.
Na navegação à esquerda da UI da clean room, selecione Connectors.
Selecione a guia Activation.
Expanda o Google DV360 - PAIR.
Em Account ID, digite o ID de sua conta Display & Video 360-PAIR. Entre em contato com o suporte Snowflake para obter informações sobre o ID.
Em Account Type, selecione Advertiser ou Publisher, conforme apropriado. (O anunciante é o consumidor, e o editor é o provedor)
Se quiser que os usuários da clean room de dados Snowflake possam ativar os resultados para várias contas Display & Video 360-PAIR, selecione + Account e insira o novo ID de conta e o tipo de conta para cada conta adicional. Entre em contato com o suporte Snowflake para obter a conta correta do ID do parceiro de dados para sua sala limpa.
Selecione Save.
Veja a seguir as etapas que o provedor (editor) e consumidor (anunciante) devem seguir para ativar os resultados de uma análise do consumidor na conta de provedor do Display & Video 360-PAIR.
Diretrizes gerais
Ao usar o Google Display & Video 360-PAIR, o editor é o provedor e o anunciante é o consumidor.
O único modelo compatível com esse conector é Audience Overlap & Segmentation. Tanto o provedor quanto o consumidor se unem em uma única tabela em uma versão PAIR de um e-mail ou telefone com hash.
As tabelas de provedor e consumidor devem incluir dados de e-mail ou telefone com hash de acordo com os requisitos PAIR do Google.
Se 4 milhões ou mais de linhas distintas estiverem vinculadas à clean room, recomendamos usar o maior tamanho de warehouse (4XL).
Não exceda 100 milhões de linhas exclusivas em um conjunto de dados em uma clean room PAIR para análise e ativação.
Quando você adiciona o conector do Google Display & Video 360-PAIR a uma clean room, a clean room não permite outros conectores de ativação. O único conector de identidade permitido na clean room é o Google DV360 - PAIR.
Esse conector não oferece suporte à análise ou ativação executada pelo provedor.
Visão geral
Aqui está uma breve visão geral de como usar esse conector:
O provedor cria uma clean room que usa os conectores de ativação e identidade PAIR Display & Video 360 Identity e vincula uma tabela que contém uma coluna de e-mail ou telefone com hash.
O provedor usa o conector de identidade para gerar uma coluna de ID PAIR com base na coluna de e-mail com hash ou telefone com hash em sua tabela.
O provedor especifica a coluna PAIR gerada como a coluna de junção.
O provedor especifica o modelo Audience Overlap & Segmentation (o único permitido para Display & Video 360-PAIR), configura o modelo, compartilha e publica a clean room.
O consumidor entra na clean room, especifica tabelas, seleciona o conector PAIR Display & Video 360 Identity e gera uma coluna PAIR a partir de sua coluna de e-mail ou telefone com hash.
O consumidor une sua coluna PAIR à coluna PAIR do provedor, executa a análise e ativa os resultados (a coluna PAIR ID) para o Google.
O provedor faz o download de uma tabela de mapeamento que correlaciona cada valor de e-mail ou telefone com hash com seu valor PAIR equivalente. O provedor envia essa tabela ao servidor de anúncios ou à Sell-Side Platform (SSP) para corresponder aos valores PAIR que o consumidor ativa para Display & Video 360.
Para obter detalhes, leia a seção Provider ou Consumer abaixo.
O provedor segue as seguintes etapas para usar o Display & Video 360-PAIR em uma clean room:
Configure sua conta do Display & Video 360 para se vincular a Snowflake Data Clean Rooms. Para obter instruções, consulte a documentação do Google.
Instale e configure o conector do Google Display & Video 360-PAIR conforme descrito na guia Configuration guide.
Crie uma clean room que criptografe colunas de identificação com o Google PAIR e, em seguida, compartilhe a clean room com o consumidor (descrito abaixo).
Forneça uma tabela de mapeamento das versões originais e PAIR correspondentes da coluna de junção na solicitação de oferta enviada à sua SSP (descrito abaixo).
Crie e compartilhe uma clean room
Faça login na UI da clean room e crie uma nova clean room.
Na etapa Add Data, selecione as tabelas a serem compartilhadas com o consumidor. Suas tabelas devem ter colunas de e-mail e/ou número de telefone com hash de acordo com os requisitos do Google.
Na etapa Specify Join Policies, defina os seguintes valores:
Expanda Identity Hub e selecione PAIR Display & Video 360.
Na seção PAIR Join Columns, selecione sua coluna de e-mail ou telefone com hash. O conector gera uma versão PAIR dessa coluna com
_PAIRanexado ao nome original da coluna:Selecione Generate Preview para ver a nova coluna.
Selecione Add Identity para adicionar a nova coluna ao seu conjunto de dados.
Na seção Join Policies, selecione a coluna
_PAIRgerada. Não faça a junção em nenhuma outra coluna.
Na seção Configure Analysis & Query, configure o modelo Audience Overlap & Segmentation.
Selecione a tabela que contém o e-mail ou telefone com hash.
Defina os valores de Segmentation & Attribute Columns que desejar.
Em Privacy Settings, mantenha o Threshold Value igual ou acima de 1.000, conforme exigido pelo Google.
Na seção Share Clean Room, selecione o consumidor como colaborador e, em seguida, selecione Finish para publicar e compartilhar sua clean room.
Recupere sua tabela de mapeamento PAIR ID conforme descrito abaixo. Essa tabela foi gerada em sua conta Snowflake, e você só precisa saber o nome totalmente qualificado dessa tabela de tradução para baixá-la ou exportá-la em massa. Envie essa tabela com sua solicitação de lance à SSP ou ao servidor de anúncios.
Prepare e envie uma solicitação de lance
Envie a tabela de tradução exportada, contendo as colunas PAIR de e-mail ou telefone original e criptografado correspondentes com hash, para sua SSP. A SSP usa esses dados para encontrar o valor com hash correspondente para os valores criptografados enviados pelo consumidor. A prática recomendada é usar um formato seguro de URL, como a codificação Base64, ao fornecer esses IDs em sua solicitação de lance.
O nome de tabela com escopo completo tem o seguinte formato:
SAMOOHA_CLEANROOM_<cleanroom ID>.SHARED_SCHEMA.PROVIDER_<source database>__<source schema>__<source table>_PAIR<digit>
cleanroom IDEste é o ID de clean room, e não o nome da clean room. Você pode encontrar o ID de clean room para um determinado nome de clean room realizando a seguinte chamada:
CALL samooha_by_snowflake_local_db.provider.view_cleanrooms();
source database,source schema,source tableO banco de dados, o esquema e o nome da tabela de origem vinculada à clean room usada no modelo. Observe a separação por sublinhados simples ou duplos, conforme mostrado, e não por pontos.
PAIRdigitUm único dígito, geralmente 0 ou 1.
Aqui está um exemplo de nome de tabela com escopo total:
SAMOOHA_CLEANROOM_MY_CLEANROOM.SHARED_SCHEMA.PROVIDER_SAMPLE_DATABASE__AUDIENCE_OVERLAP__CUSTOMERS_PAIR0
Consulte a tabela conforme mostrado abaixo ou use a exportação em massa para fazer o download dos dados como um arquivo de texto simples para um estágio ou para o seu computador.
SELECT * FROM SAMOOHA_CLEANROOM_MY_CLEANROOM.SHARED_SCHEMA.PROVIDER_SAMPLE_DATABASE__AUDIENCE_OVERLAP__CUSTOMERS_PAIR0;
O consumidor segue as seguintes etapas para ativar os dados de sobreposição PAIR no Google:
Configure sua conta do Display & Video 360 para se vincular a Snowflake Data Clean Rooms. Para obter instruções, consulte a documentação do Google.
Instale e configure o conector do Google Display & Video 360-PAIR conforme descrito na guia Configuration guide.
Instale a clean room de modo que ela fique habilitada para PAIR (descrito abaixo).
Ative os resultados de sua análise em sua conta Display & Video 360 (descrito abaixo).
Como ingressar na clean room e configurá-la
Faça login na UI de clean room e ingresse na clean room apropriada.
Na seção Add Data, selecione as tabelas que deseja incluir na clean room. Suas tabelas devem ter colunas de e-mail e/ou número de telefone com hash de acordo com os requisitos do Google.
Na etapa Specify Join Policies, defina os seguintes valores:
Na seção PAIR Join Columns, selecione sua coluna de e-mail ou telefone com hash. O conector gera uma versão PAIR dessa coluna com _PAIR anexado ao nome original da coluna:
Selecione Generate Preview para ver as novas colunas.
Selecione Add Identity para adicionar essas novas colunas ao seu esquema. Se você repetir essa etapa, serão geradas colunas idênticas adicionais.
Na seção Políticas de junção, faça a correspondência entre as colunas
_PAIRe as colunas_PAIRcorrespondentes do provedor e, em seguida, defina quaisquer políticas de junção adicionais.
Na seção Configure Analysis & Query, configure o modelo Audience Overlap & Segmentation.
Defina os valores de Tables para sua tabela.
Defina os valores de Segmentation & Attribute Columns que desejar.
Selecione Finish e execute sua análise, conforme descrito a seguir.
Execute a análise e ative os resultados
Execute a clean room em sua guia Joined.
Execute a análise Audience Overlap & Segmentation, preenchendo todas as informações necessárias para análise. Faça junção na coluna _PAIR que você gerou.
Quando a consulta for concluída com êxito, abra a página de resultados e selecione Activate.
Selecione Google Display & Video 360 - PAIR.
No campo Account ID, selecione uma conta Display & Video 360.
No campo Segment Name, insira um nome descritivo para seus resultados.
No campo Description, digite uma descrição dos dados que você está enviando ao Display & Video 360.
Em Publisher Name, digite o nome do provedor com o qual está colaborando.
Selecione as colunas de ID de PAIR e o tipo desses identificadores.
Selecione Push Data para ativar os resultados no Google.
Conector LiveRamp¶
LiveRamp é uma plataforma de conectividade líder, alavancada por marcas e seus parceiros para fornecer produtos e experiências. LiveRamp RampID conecta pessoas, dados e dispositivos no mundo digital e físico, impulsionando o marketing baseado em pessoas e permitindo que os consumidores se conectem com segurança com marcas e produtos.
Nota
Se você optar por configurar o conector LiveRamp para que os dados sejam carregados usando um compartilhamento Snowflake, o LiveRamp deverá definir a ingestão de compartilhamento antes que os usuários possam ativar usando o LiveRamp.
Você deve ter a função MANAGE_DCR_CONNECTORS para configurar esse conector.
Para configurar o conector para que seu ambiente limpo seja integrado à sua conta do LiveRamp:
Na navegação à esquerda do aplicativo da Web, selecione Connectors.
Selecione a guia Activation.
Expanda o LiveRamp.
Use a lista suspensa Select Upload Type para executar uma das seguintes ações:
Se você deseja compartilhar dados com LiveRamp usando SFTP:
Selecione SFTP.
Digite o nome de usuário e a senha fornecidos pelo LiveRamp para usar seu SFTP.
Se você deseja compartilhar dados com LiveRamp usando o compartilhamento de dados Snowflake:
Selecione Snowflake Share.
Use o menu suspenso Account para selecionar a conta Snowflake do LiveRamp.
Selecione Generate Share.
Envie ao seu representante do LiveRamp o nome da sua conta e o compartilhamento gerado.
Selecione Authenticate.
Consulte a guia user guide para saber como ativar os resultados usando esse conector.
Veja como ativar os resultados da análise com o conector LiveRamp. Estas instruções pressupõem que esse conector tenha sido instalado e configurado corretamente.
Para enviar os resultados de uma análise ao LiveRamp para ativação:
Execute uma análise que retorne dados que podem ser ativados. Por exemplo, as análises que usam o modelo Audience Overlap & Segmentation podem ser ativadas.
Para obter mais informações sobre como executar uma análise, consulte Execução de uma análise como provedor ou Execução de uma análise como consumidor.
Na seção Results, selecione Activate.
Na caixa de diálogo Activation Hub, selecione LiveRamp.
No campo Segment Name, insira um nome descritivo para seus resultados. Este nome deve começar com uma letra e pode conter apenas letras, números e sublinhados.
A cadeia de caracteres
_SNOWDCRserá anexada a este nome.No menu suspenso RampID, selecione a coluna da sua tabela que contém seu RampID.
Selecione Push Data.
Conector do Gerenciador de Anúncios da Meta¶
O Gerenciador de Anúncios da Meta é uma plataforma de anúncios que permite criar campanhas segmentadas e otimizar os gastos com anúncios.
Você deve ter a função MANAGE_DCR_CONNECTORS para configurar esse conector.
Para configurar o conector para que seu ambiente de sala limpa seja integrado à sua conta do Gerenciador de Anúncios da Meta:
Na navegação à esquerda do aplicativo da Web, selecione Connectors.
Selecione a guia Activation.
Expanda o Meta Ads Manager.
Insira suas credenciais do Gerenciador de Anúncios da Meta.
No campo Meta Ads Manager Account ID, insira o ID de sua conta do Gerenciador de Anúncios da Meta.
Selecione Save.
Consulte a guia user guide para saber como ativar os resultados usando esse conector.
Estas instruções pressupõem que esse conector tenha sido instalado e configurado corretamente.
Para enviar os resultados de uma análise ao Gerenciador de Anúncios da Meta para ativação:
Execute uma análise que retorne dados que podem ser ativados. Por exemplo, as análises que usam o modelo Audience Overlap & Segmentation podem ser ativadas.
Para obter mais informações sobre como executar uma análise, consulte Execução de uma análise como provedor ou Execução de uma análise como consumidor.
Na seção Results, selecione Activate.
Na caixa de diálogo Activation Hub, selecione Meta Ads Manager.
No campo Account ID, insira o identificador da conta para onde você deseja enviar o segmento.
No campo Segment Name, insira um nome descritivo para seus resultados.
No campo Description, insira uma descrição dos dados que você está enviando para o Google Ads.
Na seção Activation IDs, selecione as colunas que contêm identificadores e, em seguida, selecione o tipo desses identificadores.
Selecione Push Data.
Conector do The Trade Desk - CRM¶
O The Trade Desk CRM integra dados de gerenciamento de relacionamento com o cliente (CRM) para ativar e direcionar segmentos de público-alvo na plataforma do The Trade Desk para campanhas publicitárias personalizadas.
Você deve ter a função MANAGE_DCR_CONNECTORS para configurar esse conector.
Para configurar o conector para que seu ambiente de sala limpa seja integrado à sua conta do The Trade Desk - CRM:
Na navegação à esquerda do aplicativo da Web, selecione Connectors.
Selecione a guia Activation.
Expanda o The Trade Desk - CRM.
No campo Username, insira o nome de usuário associado à sua conta do The Trade Desk.
No campo Password, digite a senha da sua conta do The Trade Desk.
No campo Advertiser ID, insira o ID do anunciante associado à sua conta do The Trade Desk.
No campo Region, selecione a região da sua conta do The Trade Desk.
Selecione Authenticate.
Consulte a guia user guide para saber como ativar os resultados usando esse conector.
Estas instruções pressupõem que esse conector tenha sido instalado e configurado corretamente.
Para enviar os resultados de uma análise ao The Trade Desk - CRM para ativação:
Execute uma análise que retorne dados que podem ser ativados. Por exemplo, as análises que usam o modelo Audience Overlap & Segmentation podem ser ativadas.
Para obter mais informações sobre como executar uma análise, consulte Execução de uma análise como provedor ou Execução de uma análise como consumidor.
Na seção Results, selecione Activate.
Na caixa de diálogo Activation Hub, selecione The Trade Desk - CRM.
No campo Segment Name, insira um nome descritivo para seus resultados.
Na seção Activation IDs, selecione uma coluna que contenha identificadores e, em seguida, selecione o tipo desses identificadores.
Selecione Push Data.
Conector do The Trade Desk - UID 2.0¶
O The Trade Desk - UID 2.0 é uma plataforma de demanda (DSP) que fornece uma plataforma tecnológica para que os anunciantes planejem, comprem e gerenciem campanhas de publicidade digital em vários canais.
Você deve ter a função MANAGE_DCR_CONNECTORS para configurar esse conector.
Para configurar o conector para que seu ambiente de sala limpa seja integrado à sua conta do The Trade Desk - UID 2.0:
Na navegação à esquerda do aplicativo da Web, selecione Connectors.
Selecione a guia Activation.
Expanda o The Trade Desk - UID 2.0.
No campo Advertiser ID, insira o ID do anunciante associado à sua conta do The Trade Desk.
No campo Secret Key, insira a chave secreta associada à sua conta do The Trade Desk.
Use a lista suspensa Data Center para selecionar um data center do The Trade Desk.
Selecione Authenticate.
Consulte a guia user guide para saber como ativar os resultados usando esse conector.
Estas instruções pressupõem que esse conector tenha sido instalado e configurado corretamente.
Para enviar os resultados de uma análise ao The Trade Desk - CRM para ativação:
Execute uma análise que retorne dados que podem ser ativados. Por exemplo, as análises que usam o modelo Audience Overlap & Segmentation podem ser ativadas.
Para obter mais informações sobre como executar uma análise, consulte Execução de uma análise como provedor ou Execução de uma análise como consumidor.
Na seção Results, selecione Activate.
Na caixa de diálogo Activation Hub, selecione The Trade Desk - UID 2.0.
No campo Segment Name, insira um nome descritivo para seus resultados.
Na seção Activation IDs, selecione uma coluna que contenha identificadores e, em seguida, selecione o tipo desses identificadores.
Selecione Push Data.
Conector Yahoo DSP¶
O Yahoo DSP é uma plataforma de demanda que permite que anunciantes comprem e otimizem programaticamente o inventário de anúncios digitais em vários canais.
Você deve ter a função MANAGE_DCR_CONNECTORS para configurar esse conector.
Para configurar o conector para que seu ambiente de sala limpa seja integrado ao Yahoo DSP:
Na navegação à esquerda do aplicativo da Web, selecione Connectors.
Selecione a guia Activation.
Expanda o Yahoo DSP.
Insira o ID MDM associado à sua conta do Yahoo.
Selecione Authenticate.
Consulte a guia user guide para saber como ativar os resultados usando esse conector.
Estas instruções pressupõem que esse conector tenha sido instalado e configurado corretamente.
Para enviar os resultados de uma análise ao Yahoo DSP para ativação:
Execute uma análise que retorne dados que podem ser ativados. Por exemplo, as análises que usam o modelo Audience Overlap & Segmentation podem ser ativadas.
Para obter mais informações sobre como executar uma análise, consulte Execução de uma análise como provedor ou Execução de uma análise como consumidor.
Na seção Results, selecione Activate.
Na caixa de diálogo Activation Hub, selecione Yahoo DSP.
No campo Segment Name, insira um nome descritivo para seus resultados.
No campo Description, insira uma descrição dos dados que você está enviando para o Yahoo DSP.
Na seção Activation IDs, selecione as colunas que contêm identificadores e, em seguida, selecione o tipo desses identificadores.
Selecione Push Data.