效果最大化广告系列可选组件

转化目标

创建效果最大化广告系列时，系统会自动创建一系列与账号中的 CustomerConversionGoal 相匹配的转化目标。您可以通过更新这些设置，为每个效果最大化广告系列单独进行自定义。

为此，您首先需要提取所有客户转化目标的列表。

const searchResults = AdsApp.search(
  `SELECT
     customer_conversion_goal.category,
     customer_conversion_goal.origin
   FROM customer_conversion_goal`
);

然后，您可以迭代返回的所有转化目标，并为当前的效果最大化广告系列创建更新操作，以自定义每个目标的定位条件。以下代码会将所有这些维度都设置为可出价，但您需要自定义该部分逻辑，以便与您希望通过广告系列实现的目标相符。

在运行此代码之前，您需要提取效果最大化广告系列的广告系列 ID。

我们建议您在广告系列制作流程的其余部分之外单独进行转化目标设置。CampaignConversionGoalOperation 要求将请求的 partialFailure 设置为 false。如果您想在首次制作广告系列时在同一事务中运行此代码，则必须将整组操作设置为关闭部分失败。此示例代码演示了如何在单独的事务中执行此操作。

operations = [];
while (searchResults.hasNext()) {
  const row = searchResults.next();
  const conversionGoal = row.customerConversionGoal;

  operations.push({
    "campaignConversionGoalOperation": {
      "update": {
        "resourceName": `customers/${customerId}/campaignConversionGoals/${campaignId}~${conversionGoal.category}~${conversionGoal.origin}`,
        // Insert your logic here to determine whether you want this particular
        // campaign conversion goal to be biddable or not.
        // This code will just default everything to being biddable, but that
        // is not necessarily best for your use case.
        "biddable": true
      },
      "updateMask": "biddable"
    }
  });
}

AdsApp.mutateAll(operations, {partialFailure: false});

广告系列定位

如需了解效果最大化广告系列中的广告系列定位条件，请务必参阅 API 指南，查看允许的条件类型的完整列表。

制作效果最大化广告系列时无需额外条件，但额外条件有助于您根据自己的用例限制定位条件。以下代码示例展示了如何设置地理位置目标。如需了解其他条件类型的格式，请参阅 CampaignCriterion 文档。

您可以在同一 mutateAll 调用中创建这些条件以及广告系列本身，此代码示例假定您将代码结构为这样。

operations.push({
  "campaignCriterionOperation": {
    "create": {
      "campaign": campaignOperation.campaignOperation.create.resourceName,
      "negative": false,
      "location": {
        // 1023191 represents New York City
        "geoTargetConstant": "geoTargetConstants/1023191"
      }
    }
  }
});

素材资源组信号

在开始使用之前，请先阅读 API 文档中的素材资源组信号部分。您可以通过将素材资源组关联到现有的 AudienceInfo 或 SearchThemeInfo 条件来设置这些条件。如果您想改为使用受众群体，请使用受众群体的资源名称指定 audience 字段（而非 searchTheme 字段）。

operations.push({
  "assetGroupSignalOperation": {
    "create": {
      "assetGroup": assetGroupOperation.assetGroupOperation.create.resourceName,
      "searchTheme": {
        "text": "mars cruise"
      }
    }
  }
});