制作智能广告系列和智能广告系列设置

智能广告系列依赖于名为 SmartCampaignSetting 的资源,该资源包含主 Campaign 资源中没有的其他配置选项。

智能广告系列设置必须与广告系列相关联,因此最好在同一 mutate 请求中创建这两个对象。

制作广告系列

由于智能广告系列主要由 Google 的广告技术自动管理,因此您无需为其设置许多字段。

智能广告系列的主要要求:

请注意,我们使用临时资源名称为相应广告系列的资源名称设置值。这样一来,在后端中存在之前,变异请求中的其他对象就可以引用相应广告系列。

Java

private MutateOperation createSmartCampaignOperation(long customerId) {
  MutateOperation.Builder builder = MutateOperation.newBuilder();
  builder
      .getCampaignOperationBuilder()
      .getCreateBuilder()
      .setName("Smart campaign " + CodeSampleHelper.getShortPrintableDateTime())
      .setStatus(CampaignStatus.PAUSED)
      .setAdvertisingChannelType(AdvertisingChannelType.SMART)
      .setAdvertisingChannelSubType(AdvertisingChannelSubType.SMART_CAMPAIGN)
      // Assigns the resource name with a temporary ID.
      .setResourceName(ResourceNames.campaign(customerId, SMART_CAMPAIGN_TEMPORARY_ID))
      .setCampaignBudget(ResourceNames.campaignBudget(customerId, BUDGET_TEMPORARY_ID))
      // Declares whether this campaign serves political ads targeting the EU.
      .setContainsEuPoliticalAdvertising(DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING);
  return builder.build();
}
      

C#

/// <summary>
/// Creates a MutateOperation that creates a new Smart campaign.
/// A temporary ID will be assigned to this campaign so that it can be referenced by other
/// objects being created in the same Mutate request.
/// </summary>
/// <param name="customerId">The Google Ads customer ID.</param>
/// <returns>A MutateOperation that creates a campaign.</returns>
private MutateOperation CreateSmartCampaignOperation(long customerId)
{
    return new MutateOperation
    {
        CampaignOperation = new CampaignOperation
        {
            Create = new Campaign
            {
                Name = $"Smart campaign #{ExampleUtilities.GetRandomString()}",
                // Set the campaign status as PAUSED. The campaign is the only entity in
                // the mutate request that should have its status set.
                Status = CampaignStatus.Paused,
                // AdvertisingChannelType must be SMART.
                AdvertisingChannelType = AdvertisingChannelType.Smart,
                // AdvertisingChannelSubType must be SMART_CAMPAIGN.
                AdvertisingChannelSubType = AdvertisingChannelSubType.SmartCampaign,
                // Assign the resource name with a temporary ID.
                ResourceName =
                    ResourceNames.Campaign(customerId, SMART_CAMPAIGN_TEMPORARY_ID),
                // Set the budget using the given budget resource name.
                CampaignBudget =
                    ResourceNames.CampaignBudget(customerId, BUDGET_TEMPORARY_ID),

                // Declare whether or not this campaign contains political ads targeting the EU.
                ContainsEuPoliticalAdvertising = EuPoliticalAdvertisingStatus.DoesNotContainEuPoliticalAdvertising,
            }
        }
    };
}
      

PHP

private static function createSmartCampaignOperation(int $customerId): MutateOperation
{
    // Creates the campaign object.
    $campaign = new Campaign([
        'name' => "Smart campaign #" . Helper::getPrintableDatetime(),
        // Sets the campaign status as PAUSED. The campaign is the only entity in the mutate
        // request that should have its' status set.
        'status' => CampaignStatus::PAUSED,
        // The advertising channel type is required to be SMART.
        'advertising_channel_type' => AdvertisingChannelType::SMART,
        // The advertising channel sub type is required to be SMART_CAMPAIGN.
        'advertising_channel_sub_type' => AdvertisingChannelSubType::SMART_CAMPAIGN,
        // Assigns the resource name with a temporary ID.
        'resource_name' =>
            ResourceNames::forCampaign($customerId, self::SMART_CAMPAIGN_TEMPORARY_ID),
        // Sets the budget using the given budget resource name.
        'campaign_budget' =>
            ResourceNames::forCampaignBudget($customerId, self::BUDGET_TEMPORARY_ID),
        // Declare whether or not this campaign serves political ads targeting the EU.
        'contains_eu_political_advertising' =>
            EuPoliticalAdvertisingStatus::DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
    ]);

    // Creates the MutateOperation that creates the campaign.
    return new MutateOperation([
        'campaign_operation' => new CampaignOperation(['create' => $campaign])
    ]);
}