Search Ads 360 转移作业

控制台

1. 转到控制台中的 BigQuery 页面。

   转到 BigQuery 页面

2. 点击转移。

3. 点击创建转移作业。

4. 在创建转移作业页面上：

   • 在来源类型部分的来源中，选择 Search Ads 360（以前称为 DoubleClick Search）。

     

   • 在转移配置名称部分的显示名中，输入转移作业的名称，例如 My Transfer。转移作业名称可以是任何容易辨识的值，方便您以后在需要修改该作业时能轻松识别。

     

   • 在时间表选项部分的时间表中，保留默认值（立即开始）或点击在设置的时间开始。

     • 在重复频率部分中，选择转移作业的运行频率选项。

       • 每日一次（默认值）
       • 每周一次
       • 每月一次
       • 自定义
       • 按需

     • 在开始日期和运行时间部分，输入开始转移作业的日期和时间。如果您选择的是立即开始，则此选项会处于停用状态。

       

   • 在目标设置部分的目标数据集中，选择您创建的用来存储数据的数据集。

     

   • 在数据源详细信息部分，执行以下操作：

     • 在代理机构 ID 部分，输入您的代理机构 ID。
     • 在广告客户 ID 部分，输入您的广告客户 ID。
     • 选中包含已移除的项，以便将已移除的实体及指标包含在转移作业中。

     • （可选）对于表过滤条件 (Table Filter)，将此字段留空可加载所有表。如需仅导入部分支持的表的数据，请列出这些表的名称前缀，并以空白分隔。示例：Account AccountDeviceStats AccountFloodlightAndDeviceStats。如需查看所有受支持的表名称，请参阅 Search Ads 360 报告转换。

       

     • （可选）对于自定义 Floodlight 变量 (Custom Floodlight Variables)，将此字段留空，可仅导入 Search Ads 360 报告转换中预定义的列。
       如需导入您在 Search Ads 360 中创建的自定义 Floodlight 变量，请以 JSON 格式命名这些字段，如以下示例所示：

       • [{
           "cfv_name": "variable_name",
           "cfv_type": "metric or dimension",
           "campaign_manager_type": "number or string",
           "destination_table_name": "table_name",
           "bigquery_column_name": "custom_column_name"
         },{
           "cfv_name": "variable_name_2",
           "cfv_type": "metric or dimension",
           "campaign_manager_type": "number or string",
           "destination_table_name": ["table_name_2","table_name_3"],
           "bigquery_column_name": "custom_column_name_2"
         }]
         

       • 对于 JSON 列表中的每一项，请包含以下字段：
         • cfv_name 是您在 Campaign Manager 中创建自定义 Floodlight 变量时指定的“易记”名称。设置自定义维度和指标时，该易记名称也会显示在 Search Ads 360 界面中。
         • cfv_type 应为 metric 或 dimension。具体取决于您在 Search Ads 360 界面中设置的自定义 Floodlight 变量。
         • campaign_manager_type 应为 number 或 string。具体取决于您在 Search Ads 360 界面中设置自定义 Floodlight 变量。
         • destination_table_name 是您要为其添加自定义 Floodlight 变量的目标表的名称前缀或名称前缀列表。示例：AccountDeviceStats、[AdDeviceStats,CampaignFloodtlightAndDeviceStats]。
         • bigquery_column_name 是此自定义 Floodlight 变量在 BigQuery 目标表中具有的列名。该列名必须遵循 BigQuery 列名的格式要求。

       

   • （可选）在通知选项部分，执行以下操作：

     • 点击切换开关以启用电子邮件通知。启用此选项后，转移作业管理员会在转移作业运行失败时收到电子邮件通知。
     • 在选择 Pub/Sub 主题部分，选择您的主题名称，或点击创建主题。此选项用于为您的转移作业配置 Pub/Sub 运行通知。

5. 点击保存。

bq

输入 bq mk 命令并提供转移作业创建标志 --transfer_config。此外，还必须提供以下标志：

• --data_source
• --target_dataset
• --display_name
• --params

您还可以提供 --project_id 标志以指定具体项目。如果未指定 --project_id，系统会使用默认项目。

bq mk \
--transfer_config \
--project_id=project_id \
--target_dataset=dataset \
--display_name=name \
--params='parameters' \
--data_source=data_source

其中：

• project_id 是项目 ID。
• dataset 是转移作业配置的目标数据集。
• name 是转移作业配置的显示名。转移作业名称可以是任何容易辨识的值，让您以后在需要修改时能够轻松识别。

• parameters 包含所创建转移作业配置的参数（采用 JSON 格式），例如 --params='{"param":"param_value"}'。对于 Search Ads 360，您必须提供 advertiser_id 和 agency_id 参数。您可以选择性地设置以下参数：

  • （可选）设置 table_filter 以仅导入部分支持的表的数据，列出这些表的名称前缀，并以空白分隔。示例：Account AccountDeviceStats AccountFloodlightAndDeviceStats。如需查看所有受支持的表名称，请参阅 Search Ads 360 报告转换。
  • （可选）设置 custom_floodlight_variables 以导入您在 Search Ads 360 中创建的自定义 Floodlight 变量，并以 JSON 格式命名这些字段，如以下示例所示：
    • [{
        "cfv_name": "variable_name",
        "cfv_type": "metric or dimension",
        "campaign_manager_type": "number or string",
        "destination_table_name": "table_name",
        "bigquery_column_name": "custom_column_name"
      },{
        "cfv_name": "variable_name_2",
        "cfv_type": "metric or dimension",
        "campaign_manager_type": "number or string",
        "destination_table_name": "table_name_2",
        "bigquery_column_name": "custom_column_name_2"
      }]
      

    • 对于 JSON 列表中的每一项，请包含以下字段：
      • cfv_name 是您在 Campaign Manager 中创建自定义 Floodlight 变量时指定的“易记”名称。设置自定义维度和指标时，该易记名称也会显示在 Search Ads 360 界面中。
      • cfv_type 应为 metric 或 dimension。具体取决于您在 Search Ads 360 界面中设置的自定义 Floodlight 变量。
      • campaign_manager_type 应为 number 或 string。具体取决于您在 Search Ads 360 界面中设置自定义 Floodlight 变量。
      • destination_table_name 是您要添加自定义 Floodlight 变量的目标表的名称前缀。示例：AccountDeviceStats。
      • bigquery_column_name 是此自定义 Floodlight 变量在 BigQuery 目标表中具有的列名。该列名必须遵循 BigQuery 列名的格式要求。
  • （可选）将 include_removed_entities 设置为 true，可在转移作业中包含已移除的实体及指标。

• data_source 是数据源，即 doubleclick_search。

例如，以下命令使用广告客户 ID 123、代理机构 ID 123 和目标数据集 mydataset 创建名为 My Transfer 的 Search Ads 转移作业。该转移作业将在默认项目中创建：

bq mk \
--transfer_config \
--target_dataset=mydataset \
--display_name='My Transfer' \
--params='{"agency_id":"123", "advertiser_id":"123","include_removed_entities":"true"}' \
--data_source=doubleclick_search

首次运行此命令时，您会收到如下消息：

[URL omitted] Please copy and paste the above URL into your web browser and follow the instructions to retrieve an authentication code.

请按照该消息中的说明操作，并将身份验证代码粘贴到命令行中。

API

使用 projects.locations.transferConfigs.create 方法并提供一个 TransferConfig 资源实例。