设置 Openflow Connector for Google Ads

备注

使用该连接器需遵守 连接器条款。

本主题介绍设置 Openflow Connector for Google Ads 的步骤。

先决条件

  1. 确保您已查看 Openflow Connector for Google Ads。

  2. 确保您已 设置 Openflow。

获取凭据

作为 Google Ads 管理员，请执行以下步骤：

  • 确保您可以访问 Google Cloud 项目或 创建一个新 Google Cloud 项目 (https://developers.google.com/workspace/guides/create-project)。

  • 确保您的 Google Cloud 项目已启用 Google Ads API (https://cloud.google.com/endpoints/docs/openapi/enable-api)。需要 Google Ads API 访问权限才能引入数据。

  • 为 Google Ads 配置 (https://developers.google.com/google-ads/api/docs/oauth/service-accounts) 服务账户身份验证。

  • 按照 说明 (https://developers.google.com/google-ads/api/docs/get-started/dev-token) 为您的组织获取开发者令牌。

备注

开发者令牌的访问权限级别应为“Basic”或“Standard”。有关访问权限级别的更多信息，请参阅 文档 (https://developers.google.com/google-ads/api/docs/access-levels)。

设置 Snowflake 账户

作为 Snowflake 账户管理员，请执行以下任务：

  1. 创建新角色或使用现有角色并授予 数据库权限。

  2. 创建类型为 SERVICE 的新 Snowflake 服务用户。

  3. 向该 Snowflake 服务用户授予您在前面步骤中创建的角色。

  4. 为第 2 步中创建的 Snowflake SERVICE 用户配置 密钥对身份验证。

  5. Snowflake 强烈建议执行此步骤。配置 Openflow 支持的密钥管理器（例如 AWS、Azure 和 Hashicorp），并将公钥和私钥存储在密钥存储库中。

    备注

    如果您出于任何原因不希望使用密钥管理器，则您有责任根据组织的安全策略保护用于密钥对身份验证的公钥和私钥文件。

    1. 配置密钥管理器后，确定如何对其进行身份验证。在 AWS 中，建议您使用与 Openflow 关联的 EC2 实例角色，因为这样就无需保留其他密钥。

    2. 在 Openflow 中，从右上角的汉堡菜单中配置与此密钥管理器关联的参数提供商。导航到 Controller Settings » Parameter Provider，然后提取您的参数值。

    3. 此时，可以使用关联的参数路径引用所有凭据，无需在 Openflow 中保留敏感值。

  6. 如果任何其他 Snowflake 用户需要访问连接器引入的原始文档和表（例如，在 Snowflake 中进行自定义处理），则授予这些用户在步骤 1 中创建的角色。

  7. 指定一个仓库供连接器使用。从最小的仓库规模开始，然后根据要复制的表数量和传输的数据量来测试规模。相较于扩大仓库规模，采用 多集群仓库 通常能更有效地应对海量表数量的扩展需求。

设置连接器

作为数据工程师，执行以下任务以安装和配置连接器：

安装连接器

#.在 Snowflake 中为连接器创建数据库和架构，以存储引入的数据。向第一步中创建的角色授予所需的 数据库权限。用实际值替换角色占位符，然后使用以下 sql 命令：

CREATE DATABASE GOOGLE_ADS_DESTINATION_DB;
CREATE SCHEMA GOOGLE_ADS_DESTINATION_DB.GOOGLE_ADS_DESTINATION_SCHEMA;
GRANT USAGE ON DATABASE GOOGLE_ADS_DESTINATION_DB TO ROLE <GOOGLE_ADS_CONNECTOR_ROLE>;
GRANT USAGE ON SCHEMA GOOGLE_ADS_DESTINATION_DB.GOOGLE_ADS_DESTINATION_SCHEMA TO ROLE <GOOGLE_ADS_CONNECTOR_ROLE>;
GRANT CREATE TABLE ON SCHEMA GOOGLE_ADS_DESTINATION_DB.GOOGLE_ADS_DESTINATION_SCHEMA TO ROLE <GOOGLE_ADS_CONNECTOR_ROLE>;
Copy

  1. 导航到 Openflow“Overview”页面。在 Featured connectors 部分中，选择 View more connectors。

  2. 在 Openflow 连接器页面上，找到连接器并选择 Add to runtime。

  3. 在 Select runtime 对话框中，从 Available runtimes 下拉列表中选择您的运行时。

  4. 选择 Add。

    备注

    在安装连接器之前，请确保在 Snowflake 中为连接器创建了数据库和架构，用于存储引入的数据。

  5. 使用您的 Snowflake 账户凭据对部署进行身份验证，并在系统提示时选择 Allow，以允许运行时应用程序访问您的 Snowflake 账户。连接器安装过程需要几分钟才能完成。

  6. 使用您的 Snowflake 账户凭据进行运行时身份验证。

此时将显示 Openflow 画布，其中添加了连接器进程组。

配置连接器

  1. 右键点击导入的进程组并选择 Parameters。

  2. 按照 流参数 中所述填充所需的参数值。

流参数

有三个参数上下文。Google Ads 目标参数 和 Google Ads 源参数 分别负责允许与 GoogleAds API 和 Snowflake 建立连接。Google Ads 提取参数 用于定义从 Google Ads 下载的数据的重新配置。Google Ads 参数 将所有这些参数汇总在一起。

运行流

  1. 右键点击“飞机”图标并选择 Enable all Controller Services。

  2. 右键点击导入的进程组并选择 Start。连接器开始数据引入。

如何重置连接器

要将连接器完全重置为初始状态，请执行以下操作：

  1. 确保队列中没有其他 FlowFile。

  2. 停止所有处理器。

  3. 清除初始处理器的状态。

    1. 右键点击处理器 Get Google Ads Report 并选择 View State。

    2. 选择选项 Clear State。这会重置处理器的状态。

  4. 将目标表拖放到 Snowflake 中。

语言: 中文