Snowflake Data Clean Rooms：激活连接器¶
备注
Snowflake Data Clean Rooms 目前不支持数据主体同意管理。客户有责任确保其已获得使用其 Clean Room 中关联的数据的所有必要权利和同意。客户在使用 Data Clean Room 时，还必须确保遵守所有适用的法律和法规，包括与第三方连接器相关的法律法规。
您可以使用连接器将 Clean Room 环境与生态系统合作伙伴提供的内容集成。本主题介绍 Clean Room 管理员如何配置连接器，以便 Clean Room 用户将分析结果推送给激活合作伙伴。
如果您是提供商，希望在 Clean Room 用户运行分析时控制哪些连接器显示为选项，请参阅 自定义可用连接器。
重要
第三方连接器不由 Snowflake 提供，并可能受附加条款的约束。 提供这些集成是为了方便您的使用，但您必须对从这些集成发送或接收的任何内容负责。
客户有责任获得与使用 Snowflake Data Clean Room 有关的任何必要同意。请确保您在使用 Snowflake Data Clean Room 时遵守适用的法律和法规，包括与用于激活目的的第三方连接器相关的法律和法规。
Google Ads 连接器¶
Google Ads 是一个在线广告平台，广告商可在该平台上通过竞价向 Web 用户展示简短的广告、服务产品、产品列表或视频。
您必须具有 MANAGE_DCR_CONNECTORS 角色才能配置此连接器。
要配置连接器，以便将您的 Clean Room 环境与 Google Ads 账户集成，请执行以下步骤：
在 Web 应用程序的左侧导航中，选择 Connectors。
选择 Activation 选项卡。
展开 Google Ads。
输入您的 Google 凭据。
在 Account ID 字段中，输入与您的 Google Ads 账户相关联的 ID。
指定您的 API 偏好。如果您选择 My Developer Token，请输入 Google Ads API 的开发人员令牌 。
选择 Save。
请参阅 user guide 选项卡，了解如何使用该连接器激活结果。
下面介绍如何使用 Google Ads 激活分析结果。这些说明假定此连接器已正确安装和配置。
将分析结果推送到 Google Ads 以进行激活：
运行分析，返回可以激活的数据。例如，可以激活使用 Audience Overlap & Segmentation 模板的分析。
在 Results 部分中，选择 Activate。
在 Activation Hub 对话框中，选择 Google Ads。
在 Account ID 字段中，输入您要推送细分的账户标识符。
在 Segment Name 字段中，输入结果的描述性名称。
在 Description 字段中，输入您要推送到 Google Ads 的数据的描述。
在 Activation IDs 部分，选择包含哈希电子邮件和/或哈希电话标识符的列。
选择 Push Data。
Google Display & Video 360-PAIR 连接器¶
Google Display & Video 360-PAIR 是一个在线广告平台，广告商可通过竞价来展示广告。PAIR 为发布商和广告商提供了一种选择，让他们可以安全、私密地核对同时访问广告商和发布商网站的受众的第一方数据。
您必须具有 MANAGE_DCR_CONNECTORS 角色才能配置此连接器。
要将 Clean Room 环境与 Display & Video 360-PAIR 集成，必须按如下步骤配置此连接器：
在配置连接器之前，将您在 Google Display & Video 360 (https://support.google.com/displayvideo/answer/15478755) 中的账户 ID 链接到 CMU: Snowflake。
在 Clean Room UI 的左侧导航栏中，选择 Connectors。
选择 Activation 选项卡。
展开 Google DV360 - PAIR。
在 Account ID 中，输入您 Display & Video 360-PAIR 账户的 ID。有关此 ID 的问题，请联系 Snowflake 支持部门。
在 Account Type 中，根据情况选择 Publisher 或 Advertiser。（广告商始终是使用者，而发布商始终是提供商。）
如果您希望 Snowflake 的 Data Clean Room 用户能够激活多个 Display & Video 360-PAIR 账户的结果，请选择 + Account 并输入其他各个账户的新账户 ID 和账户类型。联系 Snowflake 支持部门，以获取您的 Clean Room 的正确数据合作伙伴账户 ID。
选择 Save。
以下是提供商（发布商）和使用者（广告商）必须采取的步骤，以便向提供商的 Display & Video 360-PAIR 激活账户使用者的分析结果。
一般准则
在使用 Google Display & Video 360-PAIR 时，发布商始终是提供商，而广告商始终是使用者。
此连接器支持的唯一模板是 Audience Overlap & Segmentation。提供商和使用者都在经过哈希处理的电子邮件或电话的某个 PAIR 版本上联接一个表。
提供商和使用者表都必须包含根据 Google PAIR 要求 (https://support.google.com/admanager/answer/15067908) 经过哈希处理的电子邮件或电话数据。
如果将 400 万行或更多不同的行链接到 Clean Room，我们建议使用最大仓库大小 (4XL)。
在 PAIR Clean Room 中，数据集中的唯一行数不要超过 1 亿行，以供分析和激活。
当您将 Google Display & Video 360-PAIR 连接器添加到 Clean Room 时，该 Room 不允许使用其他激活连接器。Clean Room 中允许的唯一身份连接器是 Google DV360 - PAIR。
此连接器不支持提供商运行的分析或激活。
概述
以下简要概述了使用此连接器的方法：
提供商创建了一个使用 PAIR Display & Video 360 Identity 激活和身份连接器的 Clean Room，并链接至包含经过哈希处理的电子邮件或电话号码列的表。
提供商使用身份连接器根据其表中经过哈希处理的电子邮件或电话列生成 PAIR ID 列。
提供商将生成的 PAIR 列指定为联接列。
提供商指定 Audience Overlap & Segmentation 模板（Display & Video 360-PAIR 唯一允许使用的模板）、配置模板、共享和发布 Clean Room。
使用者联接 Clean Room、指定表、选择 PAIR Display & Video 360 Identity 连接器，并从其经过哈希处理的电子邮件或电话列生成 PAIR 列。
使用者联接提供商 PAIR 列中的 PAIR 列、运行分析，然后向 Google 激活结果（PAIR ID 列）。
提供商下载一个映射表，将每个经过哈希处理的电子邮件或电话值与其等效 PAIR 值相关联。提供商将此表发送到广告服务器或卖方平台 (SSP)，以匹配使用者激活的 PAIR 值与 Display & Video 360。
有关详细信息，请阅读下面的 Provider 或 Consumer 部分。
提供商采取以下步骤在 Clean Room 中使用 Display & Video 360-PAIR：
配置您的 Display & Video 360 账户以链接至 Snowflake Data Clean Rooms。有关说明，请参阅 Google 的文档 (https://support.google.com/displayvideo/answer/9649053)。
按照 Configuration guide 选项卡中的说明，安装和配置 Google Display & Video 360-PAIR 连接器。
创建 Clean Room，该 Clean Room 使用 Google PAIR 加密识别列，然后与使用者共享 Clean Room（如下所述）。
在发送给您的 SSP 的出价请求中，提供联接列的相应原版本和 PAIR 版本（*如下所述）。
创建和共享 Clean Room
登录 Clean Room UI 并创建一个新的 Clean Room。
在 Add Data 步骤中，选择要与使用者共享的表。您的表必须按照 Google 的要求对电子邮件和/或电话号码列进行哈希处理。
在 Specify Join Policies 步骤中，设置以下值：
展开 Identity Hub 并选择 PAIR Display & Video 360。
在 PAIR Join Columns 部分中，选择经过哈希处理的电子邮件或电话列。连接器生成此列的 PAIR 版本，并将
_PAIR追加到原始列名称：选择 Generate Preview，查看新列。
选择 Add Identity，将新列添加到您的数据集中。
在 Join Policies 部分中，选择生成的
_PAIR列。不要联接任何其他列。
在 Configure Analysis & Query 部分中，配置 Audience Overlap & Segmentation 模板。
选择包含经过哈希处理的电子邮件或电话的表。
设置任何您想要的 Segmentation & Attribute Columns 值。
在 Threshold Value 下方，按照 Google 的要求，将 Privacy Settings 保持在 1,000 或以上。
在 Share Clean Room 部分中，选择使用者作为协作者，然后选择 Finish 发布和共享您的 Clean Room。
按如下所述检索您的 PAIR ID 映射表。此表是在您的 Snowflake 账户中生成的，您只需要知道该转换表的完全限定名称即可下载或 批量导出。将此表格连同您的出价请求一起发送到您 SSP 或您的广告服务器。
准备并发送出价请求
将包含相应原始和加密且经过哈希处理的电子邮件或电话 PAIR 列的导出转换表发送至 SSP。您的 SSP 使用这些数据来查找使用者发送的加密值的相应哈希值。 最佳实践是在出价请求中提供这些 IDs 时使用 URL 安全格式，如 Base64 编码。
全作用域表名的格式如下：
SAMOOHA_CLEANROOM_<cleanroom ID>.SHARED_SCHEMA.PROVIDER_<source database>__<source schema>__<source table>_PAIR<digit>
cleanroom ID这是 Clean Room ID，不是 Clean Room 的名称。您可以通过以下调用找到给定 Clean Room 名称的 Clean Room ID：
CALL samooha_by_snowflake_local_db.provider.view_cleanrooms();
source database、source schema、source table链接到模板中所用 Clean Room 的源表的数据库、架构和名称。注意如图所示，用单下划线或双下划线分隔，而不是用点分隔。
PAIRdigit一个数字，通常为 0 或 1。
以下是全作用域表名的示例：
SAMOOHA_CLEANROOM_MY_CLEANROOM.SHARED_SCHEMA.PROVIDER_SAMPLE_DATABASE__AUDIENCE_OVERLAP__CUSTOMERS_PAIR0
按如下所示查询表，或使用 批量导出 将数据以平面文本文件的形式下载到暂存区或您的计算机。
SELECT * FROM SAMOOHA_CLEANROOM_MY_CLEANROOM.SHARED_SCHEMA.PROVIDER_SAMPLE_DATABASE__AUDIENCE_OVERLAP__CUSTOMERS_PAIR0;
使用者采取以下步骤向 Google 激活 PAIR 重叠数据：
配置您的 Display & Video 360 账户以链接至 Snowflake Data Clean Rooms。有关说明，请参阅 Google 的文档 (https://support.google.com/displayvideo/answer/9649053)。
按照 Configuration guide 选项卡中的说明，安装和配置 Google Display & Video 360-PAIR 连接器。
安装 Clean Room，使其启用 PAIR（如下所述）。
向您的 Display & Video 360 账户激活分析结果（如下所述）。
联接和配置 Clean Room
登录 Clean Room UI 并联接相应的 Clean Room。
在 Add Data 部分中，选择您要包括在 Clean Room 中的表。您的表必须按照 Google 的要求对电子邮件和/或电话号码列进行哈希处理。
在 Specify Join Policies 步骤中，设置以下值：
在 PAIR Join Columns 部分中，选择经过哈希处理的电子邮件或电话列。连接器生成此列的 PAIR 版本，并将 _PAIR 追加到原始列名称：
选择 Generate Preview，查看新列。
选择 Add Identity，将这些新列添加到您的架构中。如果您重复此步骤，它将生成其他相同的列。
在 联接策略 部分，将
_PAIR列与提供商的相应_PAIR列匹配，然后定义任何其他联接策略。
在 Configure Analysis & Query 部分中，配置 Audience Overlap & Segmentation 模板。
为您的表设置 Tables 值。
设置任何您想要的 Segmentation & Attribute Columns 值。
选择 Finish 并运行分析，如下所述。
运行分析并激活结果
在 Joined 选项卡中运行 Clean Room。
运行 Audience Overlap & Segmentation 分析，填写分析所需的任何信息。联接您生成的 _PAIR 列。
查询成功完成后，打开结果页并选择 Activate。
选择 Google Display & Video 360 - PAIR。
在 Account ID 字段中，选择 Display & Video 360 账户。
在 Segment Name 字段中，输入结果的描述性名称。
在 Description 字段中，输入您发送到 Display & Video 360 的数据的描述。
在 Publisher Name 中，输入您要协作的提供商名称。
选择 PAIR ID 列以及这些标识符的类型。
选择 Push Data 向 Google 激活结果。
LiveRamp 连接器¶
LiveRamp 是一个领先的连接平台，由品牌及其合作伙伴用于提供产品和体验。LiveRamp RampID 跨数字世界和现实世界连接人、数据和设备，推动以人为本的营销，允许使用者安全地与品牌和产品连接。
备注
如果您选择配置 LiveRamp 连接器，以便通过 Snowflake 共享上传数据，则 LiveRamp 必须设置共享引入，用户才能使用 LiveRamp 激活。
您必须具有 MANAGE_DCR_CONNECTORS 角色才能配置此连接器。
要配置连接器，以便 Clean Room 环境与 LiveRamp 账户集成，请执行以下步骤：
在 Web 应用程序的左侧导航中，选择 Connectors。
选择 Activation 选项卡。
展开 LiveRamp。
使用 Select Upload Type 下拉列表执行以下任一操作：
如果您想使用 SFTP 与 LiveRamp 共享数据：
选择 SFTP。
输入 LiveRamp 提供的用户名和密码，以便使用他们的 SFTP。
如果您想使用 Snowflake 数据共享与 LiveRamp 共享数据，请执行以下步骤：
选择 Snowflake Share。
使用 Account 下拉菜单选择 LiveRamp Snowflake 账户。
选择 Generate Share。
向您的 LiveRamp 代表发送账户名称和生成的共享。
选择 Authenticate。
请参阅 user guide 选项卡，了解如何使用该连接器激活结果。
下面介绍如何使用 LiveRamp 连接器激活分析结果。这些说明假定此连接器已正确安装和配置。
要将分析结果推送到 LiveRamp 以进行激活，请执行以下操作：
Meta Ads Manager 连接器¶
Meta Ads Manager 是一个广告平台，可让您构建有针对性的广告活动并优化广告支出。
您必须具有 MANAGE_DCR_CONNECTORS 角色才能配置此连接器。
要配置连接器，以便将 Clean Room 与 Meta Ads Manager 账户集成，请执行以下步骤：
在 Web 应用程序的左侧导航中，选择 Connectors。
选择 Activation 选项卡。
展开 Meta Ads Manager。
输入您的 Meta Business Manager 凭据。
在 Meta Ads Manager Account ID 字段中，输入 Meta Ads Manager 账户的 ID。
选择 Save。
请参阅 user guide 选项卡，了解如何使用该连接器激活结果。
这些说明假定此连接器已正确安装和配置。
要将分析结果推送到 Meta Ads Manager 以进行激活，请执行以下操作：
运行分析，返回可以激活的数据。例如，可以激活使用 Audience Overlap & Segmentation 模板的分析。
在 Results 部分中，选择 Activate。
在 Activation Hub 对话框中，选择 Meta Ads Manager。
在 Account ID 字段中，输入您要推送细分的账户标识符。
在 Segment Name 字段中，输入结果的描述性名称。
在 Description 字段中，输入您要推送到 Google Ads 的数据的描述。
在 Activation IDs 部分，选择包含标识符的列，然后选择这些标识符的类型。
选择 Push Data。
The Trade Desk - CRM 连接器¶
The Trade Desk CRM 集成了客户关系管理 (CRM) 数据，以在 The Trade Desk 的平台上激活和定位受众细分，以便进行个性化广告活动。
您必须具有 MANAGE_DCR_CONNECTORS 角色才能配置此连接器。
要配置连接器，以便通过 The Trade Desk - CRM 2.0 将 Clean Room 环境与账户集成，请执行以下步骤：
在 Web 应用程序的左侧导航中，选择 Connectors。
选择 Activation 选项卡。
展开 The Trade Desk - CRM。
在 Username 字段中，输入与您在 The Trade Desk 上的账户关联的用户名。
在 Password 字段中，输入与您在 The Trade Desk 上的账户关联的密码。
在 Advertiser ID 字段中，输入与您在 The Trade Desk 上的账户相关联的广告商 ID。
在 Region 字段中，选择您的 The Trade Desk 账户的区域。
选择 Authenticate。
请参阅 user guide 选项卡，了解如何使用该连接器激活结果。
这些说明假定此连接器已正确安装和配置。
将分析结果推送至 Trade Desk - CRM 以激活：
The Trade Desk - UID 2.0 连接器¶
The Trade Desk - UID 2.0 是一个需求方平台 (DSP)，该平台用于为广告商提供技术平台，以便规划、购买和管理各种通道的数字广告活动。
您必须具有 MANAGE_DCR_CONNECTORS 角色才能配置此连接器。
要配置连接器，以便通过 The Trade Desk - UID 2.0 将 Clean Room 环境与账户集成，请执行以下步骤：
在 Web 应用程序的左侧导航中，选择 Connectors。
选择 Activation 选项卡。
展开 The Trade Desk - UID 2.0。
在 Advertiser ID 字段中，输入与您在 The Trade Desk 上的账户相关联的广告商 ID。
在 Secret Key 字段中，输入与您在 The Trade Desk 上的账户关联的密钥。
使用 Data Center 下拉列表选择一个 The Trade Desk 数据中心。
选择 Authenticate。
请参阅 user guide 选项卡，了解如何使用该连接器激活结果。
这些说明假定此连接器已正确安装和配置。
将分析结果推送至 Trade Desk - CRM 以激活：
Yahoo DSP 连接器r¶
Yahoo DSP 是一个需求方平台，允许广告商以程序化方式购买和优化各种渠道的数字广告资源。
您必须具有 MANAGE_DCR_CONNECTORS 角色才能配置此连接器。
要配置连接器，以便将您的 Clean Room 环境与 Yahoo DSP 集成，请执行以下步骤：
在 Web 应用程序的左侧导航中，选择 Connectors。
选择 Activation 选项卡。
展开 Yahoo DSP。
输入与您的 Yahoo 账户关联的 MDM ID。
选择 Authenticate。
请参阅 user guide 选项卡，了解如何使用该连接器激活结果。
这些说明假定此连接器已正确安装和配置。
要将分析结果推送到 Yahoo DSP 以进行激活，请执行以下操作：