デマンド ジェネレーション キャンペーンを作成する

デマンド ジェネレーションのアセットの仕様とガイドラインを満たしていることを確認します。デマンド ジェネレーション キャンペーンのアセットは、Discover や YouTube など、エンターテイメントを重視したビジュアル サーフェスに配信されるため、YouTube と Discover フィードの広告要件も遵守する必要があります。

デマンド ジェネレーション キャンペーンを作成するには:

  1. 予算を作成する。
  2. 適切な入札戦略を使用してデマンド ジェネレーション キャンペーンを作成します。
  3. タイプを指定せずに広告グループを作成します。
  4. オーディエンス ターゲティングを設定する。
  5. アセットとデマンド ジェネレーション広告を作成します。

必要なすべてのエンティティを、負の一時 ID（customers/{customer_id}/campaignBudgets/-1 など）を使用して GoogleAdsService.Mutate で 1 つの API リクエストにまとめて作成することをおすすめします。これにより、依存関係のあるリソースが同じリクエスト内で相互に参照できるようになります。

Java

// The below methods create and return MutateOperations that we later provide to
// the GoogleAdsService.Mutate method in order to create the entities in a single
// request. Since the entities for a Demand Gen campaign are closely tied to one-another
// it's considered a best practice to create them in a single Mutate request; the
// entities will either all complete successfully or fail entirely, leaving no
// orphaned entities. See:
// https://developers.google.com/google-ads/api/docs/mutating/overview
List<MutateOperation> operations = new ArrayList<>();
// A utility to create temporary IDs for the resources.
AtomicLong tempId = new AtomicLong(-1);

// Creates a new campaign budget operation and adds it to the list of operations.
String budgetResourceName = ResourceNames.campaignBudget(customerId, tempId.getAndDecrement());
operations.add(
    MutateOperation.newBuilder()
        .setCampaignBudgetOperation(createCampaignBudgetOperation(budgetResourceName))
        .build());

// Creates a new campaign operation and adds it to the list of operations.
String campaignResourceName = ResourceNames.campaign(customerId, tempId.getAndDecrement());
operations.add(
    MutateOperation.newBuilder()
        .setCampaignOperation(
            createDemandGenCampaignOperation(campaignResourceName, budgetResourceName))
        .build());

// Creates a new ad group operation and adds it to the list of operations.
String adGroupResourceName = ResourceNames.adGroup(customerId, tempId.getAndDecrement());
operations.add(
    MutateOperation.newBuilder()
        .setAdGroupOperation(
            createDemandGenAdGroupOperation(adGroupResourceName, campaignResourceName))
        .build());

// Creates the asset operations for the ad.
Map<String, String> assetResourceNames = new HashMap<>();
operations.addAll(
    createAssetOperations(customerId, youTubeVideoId, tempId, assetResourceNames));

// Creates a new ad group ad operation and adds it to the list of operations.
operations.add(
    MutateOperation.newBuilder()
        .setAdGroupAdOperation(
            createDemandGenAdGroupAdOperation(adGroupResourceName, assetResourceNames))
        .build());

// Creates the service client.
try (GoogleAdsServiceClient googleAdsServiceClient =
    googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
  // Sends the mutate request.
  MutateGoogleAdsResponse response =
      googleAdsServiceClient.mutate(String.valueOf(customerId), operations);

  // Prints the results.
  System.out.printf(
      "Created campaign with resource name: %s%n",
      response
          .getMutateOperationResponses(1)
          .getCampaignResult()
          .getResourceName());
  System.out.printf(
      "Created ad group with resource name: %s%n",
      response
          .getMutateOperationResponses(2)
          .getAdGroupResult()
          .getResourceName());
  for (Map.Entry<String, String> entry : assetResourceNames.entrySet()) {
    System.out.printf(
        "Created asset with temporary resource name '%s' and final resource name '%s'.%n",
        entry.getValue(),
        response
            .getMutateOperationResponses(
                operations.indexOf(getOperationForAsset(operations, entry.getValue())))
            .getAssetResult()
            .getResourceName());
  }
  System.out.printf(
      "Created ad group ad with resource name: %s%n",
      response
          .getMutateOperationResponses(operations.size() - 1)
          .getAdGroupAdResult()
          .getResourceName());
}

C#

// The below methods create and return MutateOperations that we later provide to
// the GoogleAdsService.Mutate method in order to create the entities in a single
// request. Since the entities for a Demand Gen campaign are closely tied to one-another
// it's considered a best practice to create them in a single Mutate request; the
// entities will either all complete successfully or fail entirely, leaving no
// orphaned entities. See:
// https://developers.google.com/google-ads/api/docs/mutating/overview
MutateOperation campaignBudgetOperation =
    CreateCampaignBudgetOperation(budgetResourceName);
MutateOperation campaignOperation =
    CreateDemandGenCampaignOperation(campaignResourceName, budgetResourceName);
MutateOperation adGroupOperation =
    CreateAdGroupOperation(adGroupResourceName, campaignResourceName);

// Send the operations in a single mutate request.
MutateGoogleAdsRequest mutateGoogleAdsRequest = new MutateGoogleAdsRequest
{
    CustomerId = customerId.ToString()
};
// It's important to create these entities in this order because they depend on
// each other, for example the ad group depends on the
// campaign, and the ad group ad depends on the ad group.
mutateGoogleAdsRequest.MutateOperations.Add(campaignBudgetOperation);
mutateGoogleAdsRequest.MutateOperations.Add(campaignOperation);
mutateGoogleAdsRequest.MutateOperations.Add(adGroupOperation);

mutateGoogleAdsRequest.MutateOperations.AddRange(
    CreateAssetOperations(
        videoAssetResourceName,
        videoId,
        logoResourceName,
        client.Config
    )
);

mutateGoogleAdsRequest.MutateOperations.Add(
    CreateDemandGenAdOperation(
        adGroupResourceName,
        videoAssetResourceName,
        logoResourceName
    )
);

MutateGoogleAdsResponse response =
        googleAdsServiceClient.Mutate(mutateGoogleAdsRequest);

PHP

This example is not yet available in PHP; you can take a look at the other languages.

Python

# The below methods create and return MutateOperations that we later provide
# to the GoogleAdsService.Mutate method in order to create the entities in a
# single request. Since the entities for a Demand Gen campaign are closely
# tied to one-another it's considered a best practice to create them in a
# single Mutate request; the entities will either all complete successfully
# or fail entirely, leaving no orphaned entities. See:
# https://developers.google.com/google-ads/api/docs/mutating/overview
mutate_operations: List[MutateOperation] = [
    # It's important to create these entities in this order because they
    # depend on each other, for example the ad group depends on the
    # campaign, and the ad group ad depends on the ad group.
    create_campaign_budget_operation(client, budget_resource_name),
    create_demand_gen_campaign_operation(
        client, campaign_resource_name, budget_resource_name
    ),
    create_ad_group_operation(
        client, ad_group_resource_name, campaign_resource_name
    ),
    *create_asset_operations(  # Use iterable unpacking
        client,
        video_asset_resource_name,
        video_id,
        logo_asset_resource_name,
    ),
    create_demand_gen_ad_operation(
        client,
        ad_group_resource_name,
        video_asset_resource_name,
        logo_asset_resource_name,
    ),
]

# Send the operations in a single mutate request.
googleads_service.mutate(
    customer_id=customer_id, mutate_operations=mutate_operations
)

Ruby

operations = []

operations << client.operation.mutate do |m|
  m.campaign_budget_operation = create_campaign_budget_operation(client, budget_resource_name)
end

operations << client.operation.mutate do |m|
  m.campaign_operation = create_demand_gen_campaign_operation(client, campaign_resource_name, budget_resource_name)
end

operations << client.operation.mutate do |m|
  m.ad_group_operation = create_ad_group_operation(client, ad_group_resource_name, campaign_resource_name)
end

operations += create_asset_operations(client, video_asset_resource_name, video_id, logo_asset_resource_name).map do |asset_op|
  client.operation.mutate do |m|
    m.asset_operation = asset_op
  end
end

operations << client.operation.mutate do |m|
  m.ad_group_ad_operation = create_demand_gen_ad_operation(client, ad_group_resource_name, video_asset_resource_name, logo_asset_resource_name)
end

response = client.service.google_ads.mutate(
  customer_id: customer_id,
  mutate_operations: operations,
)

Perl

# The below methods create and return MutateOperations that we later provide to
# the GoogleAdsService.Mutate method in order to create the entities in a single
# request. Since the entities for a Demand Gen campaign are closely tied to one-another
# it's considered a best practice to create them in a single Mutate request; the
# entities will either all complete successfully or fail entirely, leaving no
# orphaned entities. See:
#  https://developers.google.com/google-ads/api/docs/mutating/overview
my $campaign_budget_operation =
  create_campaign_budget_operation($budget_resource_name);
my $campaign_operation =
  create_demand_gen_campaign_operation($campaign_resource_name,
  $budget_resource_name);
my $ad_group_operation =
  create_ad_group_operation($ad_group_resource_name, $campaign_resource_name);
my $asset_operations =
  create_asset_operations($video_asset_resource_name, $video_id,
  $logo_resource_name);
my $demand_gen_ad_operation =
  create_demand_gen_ad_operation($ad_group_resource_name,
  $video_asset_resource_name, $logo_resource_name);

# Send the operations in a single mutate request.
my $response = $api_client->GoogleAdsService()->mutate({
    customerId       => $customer_id,
    mutateOperations => [(
        $campaign_budget_operation, $campaign_operation,
        $ad_group_operation,        @$asset_operations,
        $demand_gen_ad_operation
      )]});

curl

予算の作成

予算を作成する。デマンド ジェネレーション キャンペーンでは共有予算を使用できません（explicitly_shared は false にする必要があります）。1 日の予算は、想定される目標アクション単価入札単価の 15 倍以上に設定することをおすすめします。詳しくは、デマンド ジェネレーションの予算と入札単価のガイドラインをご覧ください。

デマンド ジェネレーション キャンペーンでは、1 日の最小予算額の要件（5 米ドルまたはアカウントの通貨での同等額など）が適用されます。v26 以降、CurrencyConstant の demand_gen_info.minimum_budget_per_day_micros フィールドをクエリして、通貨に必要な最小 1 日の予算を取得できます。

SELECT
  currency_constant.code,
  currency_constant.demand_gen_info.minimum_budget_per_day_micros
FROM currency_constant
WHERE currency_constant.code = 'USD'

1 日の予算がこの下限を下回っている場合、キャンペーンの予算の作成または更新は CampaignBudgetError.BUDGET_BELOW_PER_DAY_MINIMUM で失敗し、必要な最小金額が ErrorDetails.budget_per_day_minimum_error_details.minimum_budget_amount_micros で返されます。

Java

private static String addCampaignBudget(GoogleAdsClient googleAdsClient, long customerId) {
  CampaignBudget budget =
      CampaignBudget.newBuilder()
          .setName("Interplanetary Cruise Budget #" + getPrintableDateTime())
          .setDeliveryMethod(BudgetDeliveryMethod.STANDARD)
          .setAmountMicros(500_000)
          .build();

  CampaignBudgetOperation op = CampaignBudgetOperation.newBuilder().setCreate(budget).build();

  try (CampaignBudgetServiceClient campaignBudgetServiceClient =
      googleAdsClient.getLatestVersion().createCampaignBudgetServiceClient()) {
    MutateCampaignBudgetsResponse response =
        campaignBudgetServiceClient.mutateCampaignBudgets(
            Long.toString(customerId), ImmutableList.of(op));
    String budgetResourceName = response.getResults(0).getResourceName();
    System.out.printf("Added budget: %s%n", budgetResourceName);
    return budgetResourceName;
  }
}

C#

private static string CreateBudget(GoogleAdsClient client, long customerId)
{
    // Get the BudgetService.
    CampaignBudgetServiceClient budgetService = client.GetService(
        Services.V26.CampaignBudgetService);

    // Create the campaign budget.
    CampaignBudget budget = new CampaignBudget()
    {
        Name = "Interplanetary Cruise Budget #" + ExampleUtilities.GetRandomString(),
        DeliveryMethod = BudgetDeliveryMethod.Standard,
        AmountMicros = 500000
    };

    // Create the operation.
    CampaignBudgetOperation budgetOperation = new CampaignBudgetOperation()
    {
        Create = budget
    };

    // Create the campaign budget.
    MutateCampaignBudgetsResponse response = budgetService.MutateCampaignBudgets(
        customerId.ToString(), new CampaignBudgetOperation[] { budgetOperation });
    return response.Results[0].ResourceName;
}

PHP

private static function addCampaignBudget(GoogleAdsClient $googleAdsClient, int $customerId)
{
    // Creates a campaign budget.
    $budget = new CampaignBudget([
        'name' => 'Interplanetary Cruise Budget #' . Helper::getPrintableDatetime(),
        'delivery_method' => BudgetDeliveryMethod::STANDARD,
        'amount_micros' => 500000
    ]);

    // Creates a campaign budget operation.
    $campaignBudgetOperation = new CampaignBudgetOperation();
    $campaignBudgetOperation->setCreate($budget);

    // Issues a mutate request.
    $campaignBudgetServiceClient = $googleAdsClient->getCampaignBudgetServiceClient();
    $response = $campaignBudgetServiceClient->mutateCampaignBudgets(
        MutateCampaignBudgetsRequest::build($customerId, [$campaignBudgetOperation])
    );

    /** @var CampaignBudget $addedBudget */
    $addedBudget = $response->getResults()[0];
    printf("Added budget named '%s'%s", $addedBudget->getResourceName(), PHP_EOL);

    return $addedBudget->getResourceName();
}

Python

# Create a budget, which can be shared by multiple campaigns.
campaign_budget_operation: CampaignBudgetOperation = client.get_type(
    "CampaignBudgetOperation"
)
campaign_budget: CampaignBudget = campaign_budget_operation.create
campaign_budget.name = f"Interplanetary Budget {uuid.uuid4()}"
campaign_budget.delivery_method = (
    client.enums.BudgetDeliveryMethodEnum.STANDARD
)
campaign_budget.amount_micros = 500000

# Add budget.
campaign_budget_response: MutateCampaignBudgetsResponse
try:
    budget_operations: List[CampaignBudgetOperation] = [
        campaign_budget_operation
    ]
    campaign_budget_response = (
        campaign_budget_service.mutate_campaign_budgets(
            customer_id=customer_id,
            operations=budget_operations,
        )
    )
except GoogleAdsException as ex:
    handle_googleads_exception(ex)

Ruby

# Create a budget, which can be shared by multiple campaigns.
campaign_budget = client.resource.campaign_budget do |cb|
  cb.name = "Interplanetary Budget #{(Time.new.to_f * 1000).to_i}"
  cb.delivery_method = :STANDARD
  cb.amount_micros = 500000
end

operation = client.operation.create_resource.campaign_budget(campaign_budget)

# Add budget.
return_budget = client.service.campaign_budget.mutate_campaign_budgets(
  customer_id: customer_id,
  operations: [operation],
)

Perl

# Create a campaign budget, which can be shared by multiple campaigns.
my $campaign_budget =
  Google::Ads::GoogleAds::V26::Resources::CampaignBudget->new({
    name           => "Interplanetary budget #" . uniqid(),
    deliveryMethod => STANDARD,
    amountMicros   => 500000
  });

# Create a campaign budget operation.
my $campaign_budget_operation =
  Google::Ads::GoogleAds::V26::Services::CampaignBudgetService::CampaignBudgetOperation
  ->new({create => $campaign_budget});

# Add the campaign budget.
my $campaign_budgets_response = $api_client->CampaignBudgetService()->mutate({
    customerId => $customer_id,
    operations => [$campaign_budget_operation]});

curl

キャンペーンの合計予算を設定する

デマンド ジェネレーション キャンペーンでは、キャンペーンの合計予算を設定できます。

CampaignBudget をキャンペーンの合計予算として使用するには、amount_micros フィールドではなく total_amount_micros フィールドを設定し、period フィールドを CUSTOM に設定して、関連付けられた Campaign で start_date と end_date の両方を構成します。

キャンペーンと入札戦略を作成する

予算を作成したら、キャンペーンを作成できます。

デマンド ジェネレーション キャンペーンの AdvertisingChannelType は DEMAND_GEN です。AdvertisingChannelSubType を設定しないでください。

キャンペーンのコンバージョン目標を設定します。サポートされている入札戦略は、クリック数の最大化、目標アクション単価、コンバージョン数の最大化、目標広告費用対効果です。

Java

// Creates the campaign.
Campaign campaign =
    Campaign.newBuilder()
        .setResourceName(campaignResourceName)
        .setName("Demand Gen campaign " + System.currentTimeMillis())
        // Demand Gen campaigns are supported in the DEMAND_GEN channel.
        .setAdvertisingChannelType(AdvertisingChannelType.DEMAND_GEN)
        // Sets the campaign status to PAUSED. The campaign is enabled later.
        .setStatus(CampaignStatus.PAUSED)
        .setCampaignBudget(budgetResourceName)
        // Declares whether this campaign serves political ads targeting the EU.
        .setContainsEuPoliticalAdvertising(DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING)
        // Sets the bidding strategy.
        .setTargetCpa(TargetCpa.newBuilder().setTargetCpaMicros(10_000_000L).build())
        .build();

// Creates the operation.
return CampaignOperation.newBuilder().setCreate(campaign).build();

C#

private MutateOperation CreateDemandGenCampaignOperation(
    string campaignResourceName, string budgetResourceName)
{
    return new MutateOperation
    {
        CampaignOperation = new CampaignOperation
        {
            Create = new Campaign
            {
                Name = $"Demand Gen #{ExampleUtilities.GetRandomString()}",
                // Set the campaign status as PAUSED.
                Status = CampaignStatus.Paused,

                // AdvertisingChannelType must be DEMAND_GEN.
                AdvertisingChannelType = AdvertisingChannelType.DemandGen,

                // Assign the resource name with a temporary ID.
                ResourceName = campaignResourceName,

                // Set the budget using the given budget resource name.
                CampaignBudget = budgetResourceName,

                // Use the Target CPA bidding strategy.
                TargetCpa = new TargetCpa()
                {
                    TargetCpaMicros = 1_000_000,
                },

                ContainsEuPoliticalAdvertising =
                    EuPoliticalAdvertisingStatus.DoesNotContainEuPoliticalAdvertising
            }
        }
    };
}

PHP

This example is not yet available in PHP; you can take a look at the other languages.

Python

def create_demand_gen_campaign_operation(
    client: GoogleAdsClient,
    campaign_resource_name: str,
    budget_resource_name: str,
) -> MutateOperation:
    """Creates a MutateOperation that creates a new 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.

    Args:
        client: An initialized GoogleAdsClient instance.
        campaign_resource_name: The temporary resource name of the campaign.
        budget_resource_name: The resource name of the budget to assign.

    Returns:
        A MutateOperation for creating a Campaign.
    """
    mutate_operation: MutateOperation = client.get_type("MutateOperation")
    campaign_operation: CampaignOperation = mutate_operation.campaign_operation
    campaign: Campaign = campaign_operation.create
    campaign.name = f"Demand Gen #{uuid4()}"
    # Set the campaign status as PAUSED. The campaign is the only entity in the
    # mutate request that should have its status set.
    campaign.status = client.enums.CampaignStatusEnum.PAUSED
    # AdvertisingChannelType must be DEMAND_GEN.
    campaign.advertising_channel_type = (
        client.enums.AdvertisingChannelTypeEnum.DEMAND_GEN
    )
    # Assign the resource name with a temporary ID.
    campaign.resource_name = campaign_resource_name
    # Set the budget using the given budget resource name.
    campaign.campaign_budget = budget_resource_name
    # Use the Target CPA bidding strategy.
    campaign.bidding_strategy_type = (
        client.enums.BiddingStrategyTypeEnum.TARGET_CPA
    )
    campaign.target_cpa.target_cpa_micros = 1_000_000
    return mutate_operation

Ruby

def create_demand_gen_campaign_operation(client, campaign_resource_name, budget_resource_name)
  client.operation.create_resource.campaign do |c|
    c.name = "Demand Gen ##{Time.now.to_f}"

    # Recommendation: Set the campaign to PAUSED when creating it to
    # prevent the ads from immediately serving. Set to ENABLED once you've
    # added targeting and the ads are ready to serve.
    c.status = :PAUSED

    # AdvertisingChannelType must be DEMAND_GEN.
    c.advertising_channel_type = :DEMAND_GEN

    # Assign the resource name with a temporary ID.
    c.resource_name = campaign_resource_name

    # Set the budget using the given budget resource name.
    c.campaign_budget = budget_resource_name

    # Use the Target CPA bidding strategy.
    c.bidding_strategy_type = :TARGET_CPA
    c.target_cpa = client.resource.target_cpa do |tc|
      tc.target_cpa_micros = 1_000_000
    end

    # Declare whether or not this campaign serves political ads targeting the EU.
    # Valid values are CONTAINS_EU_POLITICAL_ADVERTISING and
    # DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING.
    c.contains_eu_political_advertising = :DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING

    # Optional fields
    c.start_date_time = DateTime.parse((Date.today + 1).to_s).strftime('%Y%m%d %H:%M:%S')
    c.end_date_time = DateTime.parse(Date.today.next_year.to_s).strftime('%Y%m%d %H:%M:%S')
  end
end

Perl

sub create_demand_gen_campaign_operation {
  my ($campaign_resource_name, $budget_resource_name) = @_;

  my $campaign_operation =
    Google::Ads::GoogleAds::V26::Services::CampaignService::CampaignOperation->
    new({
      create => Google::Ads::GoogleAds::V26::Resources::Campaign->new({
          name => "Demand Gen #" . uniqid(),
          # Advertising channel type must be DEMAND_GEN.
          advertisingChannelType => DEMAND_GEN,
          # Set the campaign to PAUSED.
          status => PAUSED,
          # Use the Target CPA bidding strategy.
          targetCpa => Google::Ads::GoogleAds::V26::Common::TargetCpa->new({
              targetCpaMicros => 1000000,
            }
          ),
          # Assign the resource name with a temporary ID.
          resourceName => $campaign_resource_name,
          # Set the budget using the given budget resource name.
          campaignBudget => $budget_resource_name,
          # Declare whether or not this campaign serves political ads targeting the EU
          # Valid values are CONTAINS_EU_POLITICAL_ADVERTISING and
          # DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
          containsEuPoliticalAdvertising =>
            DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING,
        })});

  # Create a campaign operation.
  return
    Google::Ads::GoogleAds::V26::Services::GoogleAdsService::MutateOperation->
    new({campaignOperation => $campaign_operation});
}

curl

広告グループの作成

AdGroupType を指定せずに広告グループを作成し、デマンド ジェネレーション キャンペーンにアタッチします。

デマンド ジェネレーションでは、オーディエンス ターゲティング、地域、ターゲット言語のターゲティング条件を広告グループ単位で設定できます。広告グループを作成する際に、チャネル コントロールを設定して、広告の表示場所を選択することもできます。

Java

// Creates the ad group.
AdGroup adGroup =
    AdGroup.newBuilder()
        .setResourceName(adGroupResourceName)
        .setName("Demand Gen ad group " + System.currentTimeMillis())
        .setCampaign(campaignResourceName)
        .setStatus(AdGroupStatus.ENABLED)
        // Selects the specific channels for the ad group.
        // For further information on Demand Gen channel controls, see
        // https://developers.google.com/google-ads/api/docs/demand-gen/channel-controls
        .setDemandGenAdGroupSettings(
            DemandGenAdGroupSettings.newBuilder()
                .setChannelControls(
                    DemandGenChannelControls.newBuilder()
                        .setSelectedChannels(DemandGenSelectedChannels.newBuilder()
                            .setGmail(false)
                            .setDiscover(false)
                            .setDisplay(false)
                            .setYoutubeInFeed(true)
                            .setYoutubeInStream(true)
                            .setYoutubeShorts(true)
                        .build())
                    .build())
            .build())
        .build();

// Creates the operation.
return AdGroupOperation.newBuilder().setCreate(adGroup).build();

C#

private MutateOperation CreateAdGroupOperation(
    string adGroupResourceName,
    string campaignResourceName
)
{
    return new MutateOperation
    {
        AdGroupOperation = new AdGroupOperation
        {
            // Creates an ad group.
            Create = new AdGroup
            {
                ResourceName = adGroupResourceName,
                Name = $"Earth to Mars Cruises #{ExampleUtilities.GetRandomString()}",
                Status = AdGroupStatus.Enabled,
                Campaign = campaignResourceName,

                // Select the specific channels for the ad group.
                // For further information on Demand Gen channel controls, see
                // https://developers.google.com/google-ads/api/docs/demand-gen/channel-controls
                DemandGenAdGroupSettings = new DemandGenAdGroupSettings
                {
                    ChannelControls = new DemandGenChannelControls
                    {
                        SelectedChannels = new DemandGenSelectedChannels
                        {
                            Gmail = false,
                            Discover = false,
                            Display = false,
                            YoutubeInFeed = true,
                            YoutubeInStream = true,
                            YoutubeShorts = true,
                        }
                    }
                }
            }
        }
    };
}

PHP

This example is not yet available in PHP; you can take a look at the other languages.

Python

def create_ad_group_operation(
    client: GoogleAdsClient,
    ad_group_resource_name: str,
    campaign_resource_name: str,
) -> MutateOperation:
    """Creates a MutateOperation that creates a new AdGroup.

    Args:
        client: An initialized GoogleAdsClient instance.
        ad_group_resource_name: The temporary resource name of the ad group.
        campaign_resource_name: The temporary resource name of the campaign the
            ad group will belong to.

    Returns:
        A MutateOperation for creating an AdGroup.
    """
    mutate_operation: MutateOperation = client.get_type("MutateOperation")
    ad_group_operation: AdGroupOperation = mutate_operation.ad_group_operation
    # Creates an ad group.
    ad_group: AdGroup = ad_group_operation.create
    ad_group.resource_name = ad_group_resource_name
    ad_group.name = f"Earth to Mars Cruises #{uuid4()}"
    ad_group.status = client.enums.AdGroupStatusEnum.ENABLED
    ad_group.campaign = campaign_resource_name

    # Select the specific channels for the ad group. For further information on
    # Demand Gen channel controls, see:
    # https://developers.google.com/google-ads/api/docs/demand-gen/channel-controls
    selected_channel_controls = (
        ad_group.demand_gen_ad_group_settings.channel_controls.selected_channels
    )
    selected_channel_controls.gmail = False
    selected_channel_controls.discover = False
    selected_channel_controls.display = False
    selected_channel_controls.youtube_in_feed = True
    selected_channel_controls.youtube_in_stream = True
    selected_channel_controls.youtube_shorts = True

    return mutate_operation

Ruby

def create_ad_group_operation(client, ad_group_resource_name, campaign_resource_name)
  # Creates an ad group.
  client.operation.create_resource.ad_group do |ag|
    ag.resource_name = ad_group_resource_name
    ag.name = "Earth to Mars Cruises ##{Time.now.to_f}"
    ag.status = :ENABLED
    ag.campaign = campaign_resource_name

    # Select the specific channels for the ad group.
    # For further information on Demand Gen channel controls, see
    # https://developers.google.com/google-ads/api/docs/demand-gen/channel-controls
    ag.demand_gen_ad_group_settings = client.resource.demand_gen_ad_group_settings do |dgas|
      dgas.channel_controls = client.resource.demand_gen_channel_controls do |dcc|
        dcc.selected_channels = client.resource.demand_gen_selected_channels do |dsc|
          dsc.gmail = false
          dsc.discover = false
          dsc.display = false
          dsc.youtube_in_feed = true
          dsc.youtube_in_stream = true
          dsc.youtube_shorts = true
        end
      end
    end
  end
end

Perl

sub create_ad_group_operation {
  my ($ad_group_resource_name, $campaign_resource_name) = @_;

  my $ad_group_operation =
    Google::Ads::GoogleAds::V26::Services::AdGroupService::AdGroupOperation->
    new({
      create => Google::Ads::GoogleAds::V26::Resources::AdGroup->new({
          name     => "Earth to Mars Cruises #" . uniqid(),
          status   => ENABLED,
          campaign => $campaign_resource_name,
          # Select the specific channels for the ad group.
          # For more information on Demand Gen channel controls, see:
          # https://developers.google.com/google-ads/api/docs/demand-gen/channel-controls
          demandGenAdGroupSettings =>
            Google::Ads::GoogleAds::V26::Resources::DemandGenAdGroupSettings->
            new({
              channelControls =>
                Google::Ads::GoogleAds::V26::Resources::DemandGenChannelControls
                ->new({
                  selectedChannels =>
                    Google::Ads::GoogleAds::V26::Resources::DemandGenSelectedChannels
                    ->new({
                      gmail           => "false",
                      discover        => "false",
                      display         => "false",
                      youtubeInFeed   => "true",
                      youtubeInStream => "true",
                      youtubeShorts   => "true",
                    }
                    ),
                }
                ),
            }
            ),
          resourceName => $ad_group_resource_name,
        })});

  return
    Google::Ads::GoogleAds::V26::Services::GoogleAdsService::MutateOperation->
    new({
      adGroupOperation => $ad_group_operation
    });
}

curl

アセットと広告を作成する

デマンド ジェネレーション キャンペーンでは、次の 4 種類の広告を使用できます。

DemandGenMultiAssetAdInfo は classic_display_images をサポートしています。これらは、追加のアセットを必要とせず、レスポンシブ広告フォーマットの一部としてではなく、独立して配信されるカスタム アップロード画像です。

まず、これらの広告タイプ用のアセットを作成し、動画をアップロードします。DemandGenVideoResponsiveAdInfo を作成するときは、business_name を設定する必要があります（v24 以降では、videos と logo_images も必要です）。デマンド ジェネレーション広告のタイプごとに必要なアセットと推奨されるアセットのリストについては、デマンド ジェネレーション キャンペーンのアセットの仕様とベスト プラクティスのガイドをご覧ください。また、アセットのパフォーマンスを評価してクリエイティブを微調整することをおすすめします。レポート ガイドでは、デマンド ジェネレーション キャンペーンのパフォーマンス指標を取得する方法について説明しています。

DemandGenCarouselAdInfo は、AdDemandGenCarouselCardAsset という特殊なカードアセット タイプを使用します。

アセットと広告を作成したら、広告を広告グループに追加します。

Java

DemandGenVideoResponsiveAdInfo.Builder videoResponsiveAdbuilder =
    DemandGenVideoResponsiveAdInfo.newBuilder()
        .setBusinessName(
            AdTextAsset.newBuilder()
            .setText("Interplanetary Cruises")
            .build()
        )
        .addVideos(
            AdVideoAsset.newBuilder()
            .setAsset(assetResourceNames.get("Video"))
            .build()
        )
        .addAllLongHeadlines(
            Arrays.asList("Long headline 1").stream()
            .map(s -> AdTextAsset.newBuilder().setText(s).build())
            .collect(Collectors.toList())
        )
        .addAllHeadlines(
            Arrays.asList("Headline 1", "Headline 2", "Headline 3").stream()
                .map(s -> AdTextAsset.newBuilder().setText(s).build())
                .collect(Collectors.toList()))
        .addAllDescriptions(
            Arrays.asList("Description 1", "Description 2").stream()
                .map(s -> AdTextAsset.newBuilder().setText(s).build())
                .collect(Collectors.toList()))
        .addLogoImages(AdImageAsset.newBuilder().setAsset(assetResourceNames.get("LogoImage")));

AdGroupAd adGroupAd =
    AdGroupAd.newBuilder()
        .setAdGroup(adGroupResourceName)
        .setAd(
            Ad.newBuilder()
                .setName("Demand gen video responsive ad")
                .addFinalUrls("https://www.example.com")
                .setDemandGenVideoResponsiveAd(videoResponsiveAdbuilder.build())
                .build())
        .build();

return AdGroupAdOperation.newBuilder().setCreate(adGroupAd).build();

C#

private MutateOperation CreateDemandGenAdOperation(
    string adGroupResourceName,
    string videoAssetResourceName,
    string logoResourceName
)
{

    Ad ad = new Ad
    {
        Name = "Demand gen video responsive ad",
        FinalUrls = { "http://example.com" },
        DemandGenVideoResponsiveAd = new DemandGenVideoResponsiveAdInfo
        {
            BusinessName = new AdTextAsset
            {
                Text = "Interplanetary Cruises"
            },

        }
    };

    ad.DemandGenVideoResponsiveAd.Videos.Add(new AdVideoAsset
    {
        Asset = videoAssetResourceName
    });

    ad.DemandGenVideoResponsiveAd.LogoImages.Add(new AdImageAsset
    {
        Asset = logoResourceName
    });

    ad.DemandGenVideoResponsiveAd.Headlines.Add(new AdTextAsset
    {
        Text = "Interplanetary cruises"
    });

    ad.DemandGenVideoResponsiveAd.LongHeadlines.Add(new AdTextAsset
    {
        Text = "Travel the World"
    });

    ad.DemandGenVideoResponsiveAd.Descriptions.Add(new AdTextAsset
    {
        Text = "Book now for an extra discount"
    });


    return new MutateOperation
    {
        AdGroupAdOperation = new AdGroupAdOperation
        {
            Create = new AdGroupAd
            {
                AdGroup = adGroupResourceName,
                Ad = ad
            }
        }
    };
}

PHP

This example is not yet available in PHP; you can take a look at the other languages.

Python

def create_demand_gen_ad_operation(
    client: GoogleAdsClient,
    ad_group_resource_name: str,
    video_asset_resource_name: str,
    logo_asset_resource_name: str,
) -> MutateOperation:
    """Creates a MutateOperation that creates a new Demand Gen Ad.

    Args:
        client: An initialized GoogleAdsClient instance.
        ad_group_resource_name: The ad group the ad will belong to.
        video_asset_resource_name: The video asset resource name.
        logo_asset_resource_name: The logo asset resource name.

    Returns:
        A MutateOperation for creating an AdGroupAd.
    """
    mutate_operation: MutateOperation = client.get_type("MutateOperation")
    ad_group_ad_operation: AdGroupAdOperation = (
        mutate_operation.ad_group_ad_operation
    )
    ad_group_ad: AdGroupAd = ad_group_ad_operation.create
    ad_group_ad.ad_group = ad_group_resource_name
    ad_group_ad.status = client.enums.AdGroupAdStatusEnum.ENABLED

    ad: Ad = ad_group_ad.ad
    ad.name = "Demand gen multi asset ad"
    ad.final_urls.append(DEFAULT_FINAL_URL)

    demand_gen_ad: DemandGenVideoResponsiveAdInfo = (
        ad.demand_gen_video_responsive_ad
    )
    # Ensure business_name is an AssetLink and assign text to its text_asset.text
    demand_gen_ad.business_name.text = "Interplanetary Cruises"
    # If it needs to be an AssetLink to a text asset,
    # that would require creating another asset.

    # Create AssetLink for video
    video_asset_link: AdVideoAsset = client.get_type("AdVideoAsset")
    video_asset_link.asset = video_asset_resource_name
    demand_gen_ad.videos.append(video_asset_link)

    # Create AssetLink for logo
    logo_image_asset_link: AdImageAsset = client.get_type("AdImageAsset")
    logo_image_asset_link.asset = logo_asset_resource_name
    demand_gen_ad.logo_images.append(logo_image_asset_link)

    # Create AssetLink for headline
    headline_asset_link: AdTextAsset = client.get_type("AdTextAsset")
    headline_asset_link.text = "Interplanetary cruises"
    demand_gen_ad.headlines.append(headline_asset_link)

    # Create AssetLink for long headline
    long_headline_asset_link: AdTextAsset = client.get_type("AdTextAsset")
    long_headline_asset_link.text = "Travel the World"
    demand_gen_ad.long_headlines.append(long_headline_asset_link)

    # Create AssetLink for description
    description_asset_link: AdTextAsset = client.get_type("AdTextAsset")
    description_asset_link.text = "Book now for an extra discount"
    demand_gen_ad.descriptions.append(description_asset_link)

    return mutate_operation

Ruby

def create_demand_gen_ad_operation(client, ad_group_resource_name, video_asset_resource_name, logo_asset_resource_name)
  client.operation.create_resource.ad_group_ad do |aga|
    aga.ad_group = ad_group_resource_name
    aga.status = :ENABLED
    aga.ad = client.resource.ad do |ad|
      ad.name = "Demand gen video responsive ad"
      ad.final_urls << DEFAULT_FINAL_URL
      ad.demand_gen_video_responsive_ad = client.resource.demand_gen_video_responsive_ad_info do |dgv|
        dgv.business_name = client.resource.ad_text_asset do |ata|
          ata.text = "Interplanetary Cruises"
        end
        dgv.videos << client.resource.ad_video_asset do |ava|
          ava.asset = video_asset_resource_name
        end
        dgv.logo_images << client.resource.ad_image_asset do |aia|
          aia.asset = logo_asset_resource_name
        end
        dgv.headlines << client.resource.ad_text_asset do |ata|
          ata.text = "Interplanetary cruises"
        end
        dgv.long_headlines << client.resource.ad_text_asset do |ata|
          ata.text = "Travel the World"
        end
        dgv.descriptions << client.resource.ad_text_asset do |ata|
          ata.text = "Book now for an extra discount"
        end
      end
    end
  end
end

Perl

sub create_demand_gen_ad_operation {
  my ($ad_group_resource_name, $video_asset_resource_name, $logo_resource_name)
    = @_;

  my $ad_group_ad_operation =
    Google::Ads::GoogleAds::V26::Services::AdGroupAdService::AdGroupAdOperation
    ->new({
      create => Google::Ads::GoogleAds::V26::Resources::AdGroupAd->new({
          # Set the ad group.
          adGroup => $ad_group_resource_name,
          ad      => Google::Ads::GoogleAds::V26::Resources::Ad->new({
              name                       => "Demand gen multi asset ad",
              finalUrls                  => ["http://example.com/demand_gen"],
              demandGenVideoResponsiveAd =>
                Google::Ads::GoogleAds::V26::Common::DemandGenVideoResponsiveAdInfo
                ->new({
                  businessName =>
                    Google::Ads::GoogleAds::V26::Common::AdTextAsset->new({
                      text => "Interplanetary Cruises"
                    }
                    ),
                  videos => [
                    Google::Ads::GoogleAds::V26::Common::AdVideoAsset->new({
                        asset => $video_asset_resource_name
                      })
                  ],
                  logoImages => [
                    Google::Ads::GoogleAds::V26::Common::AdImageAsset->new({
                        asset => $logo_resource_name
                      })
                  ],
                  headlines => [
                    Google::Ads::GoogleAds::V26::Common::AdTextAsset->new({
                        text => "Interplanetary Cruises"
                      })
                  ],
                  longHeadlines => [
                    Google::Ads::GoogleAds::V26::Common::AdTextAsset->new({
                        text => "Travel the World"
                      })
                  ],
                  descriptions => [
                    Google::Ads::GoogleAds::V26::Common::AdTextAsset->new({
                        text => "Book now for an extra discount"
                      })]})})})});

  return
    Google::Ads::GoogleAds::V26::Services::GoogleAdsService::MutateOperation->
    new({
      adGroupAdOperation => $ad_group_ad_operation
    });
}

curl

前へ
概要
次へ
オーディエンス ターゲティング