Demand Gen-Kampagne erstellen

Prüfen Sie, ob die Asset-Spezifikationen und Richtlinien für Demand Gen erfüllt sind. Da Assets für Demand Gen-Kampagnen auf visuellen, unterhaltungsorientierten Oberflächen wie Discover und YouTube ausgeliefert werden, müssen sie auch den Anforderungen an Anzeigen auf YouTube und im Discover-Feed entsprechen.

So erstellen Sie eine Demand Gen-Kampagne:

  1. Lege ein Budget fest.
  2. Erstellen Sie eine Demand Gen-Kampagne mit einer geeigneten Gebotsstrategie.
  3. Anzeigengruppe ohne Typ erstellen
  4. Zielgruppen-Targeting konfigurieren
  5. Assets und Demand Gen-Anzeigen erstellen

Wir empfehlen, alle erforderlichen Entitäten atomar in einer einzigen API-Anfrage mit GoogleAdsService.Mutate und negativen temporären IDs (z. B. customers/{customer_id}/campaignBudgets/-1) zu erstellen, damit abhängige Ressourcen innerhalb derselben Anfrage aufeinander verweisen können:

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

Budget erstellen

Budget erstellen Für eine Demand Gen-Kampagne kann kein gemeinsames Budget verwendet werden (explicitly_shared muss false sein). Wir empfehlen, ein Tagesbudget festzulegen, das mindestens dem 15-Fachen Ihres erwarteten Ziel-CPA-Gebots entspricht. Weitere Informationen finden Sie in den Richtlinien für Budget und Gebote für Demand Gen-Kampagnen.

Für Demand Gen-Kampagnen gilt ein Mindesttagesbudget (z. B. 5 $ oder der entsprechende Betrag in der Kontowährung). Ab v26 können Sie das Feld demand_gen_info.minimum_budget_per_day_micros von CurrencyConstant abfragen, um das erforderliche Mindesttagesbudget für eine Währung abzurufen:

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

Wenn das Tagesbudget unter diesem Mindestwert liegt, schlägt die Erstellung oder Aktualisierung des Kampagnenbudgets mit CampaignBudgetError.BUDGET_BELOW_PER_DAY_MINIMUM fehl und der erforderliche Mindestbetrag wird in ErrorDetails.budget_per_day_minimum_error_details.minimum_budget_amount_micros zurückgegeben.

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

Gesamtbudget der Kampagne festlegen

Bei Demand Gen-Kampagnen kann ein Gesamtbudget der Kampagne festgelegt werden.

Wenn Sie ein CampaignBudget als Gesamtbudget der Kampagne verwenden möchten, legen Sie das Feld total_amount_micros anstelle des Felds amount_micros fest, setzen Sie das Feld period auf CUSTOM und konfigurieren Sie sowohl start_date als auch end_date für die zugehörige Campaign.

Kampagne und Gebotsstrategie erstellen

Nachdem das Budget erstellt wurde, können Sie eine Kampagne erstellen.

Demand Gen-Kampagnen haben einen AdvertisingChannelType von DEMAND_GEN. Legen Sie AdvertisingChannelSubType nicht fest.

Richten Sie Conversion-Zielvorhaben für Ihre Kampagne ein. Unterstützte Gebotsstrategien sind „Klicks maximieren“, „Ziel-CPA“, „Conversions maximieren“ und „Ziel-ROAS“.

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

Anzeigengruppe erstellen

Erstellen Sie eine Anzeigengruppe ohne AdGroupType und hängen Sie sie an die Demand Gen-Kampagne an.

Bei Demand Gen-Kampagnen können Sie das Zielgruppen-Targeting sowie die Kriterien für das geografische Targeting und das Targeting auf Sprachen auf Anzeigengruppenebene konfigurieren. Beim Erstellen einer Anzeigengruppe können Sie auch Kanaleinstellungen konfigurieren, um festzulegen, wo Ihre Anzeigen ausgeliefert werden sollen.

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

Assets und Anzeigen erstellen

Für Demand Gen-Kampagnen sind vier Anzeigentypen verfügbar:

DemandGenMultiAssetAdInfo unterstützt classic_display_images. Das sind benutzerdefinierte hochgeladene Bilder, die unabhängig ausgeliefert werden, ohne dass zusätzliche Assets erforderlich sind, und nicht als Teil responsiver Anzeigenformate.

Erstellen Sie zuerst Assets und laden Sie Videos für diese Anzeigentypen hoch. Wenn Sie ein DemandGenVideoResponsiveAdInfo erstellen, müssen Sie business_name festlegen. Ab v24 sind auch videos und logo_images erforderlich. Eine Liste der erforderlichen und empfohlenen Assets für die einzelnen Demand Gen-Anzeigentypen finden Sie im Leitfaden Creatives für Demand Gen-Kampagnen: Asset-Spezifikationen und Richtlinien für Anzeigenformate. Wir empfehlen außerdem, die Asset-Leistung zu bewerten, um Creatives zu optimieren. Im Leitfaden zur Berichterstellung wird beschrieben, wie Sie Leistungsmesswerte für Demand Gen-Kampagnen abrufen.

DemandGenCarouselAdInfo verwendet einen speziellen Karten-Asset-Typ namens AdDemandGenCarouselCardAsset.

Nachdem Sie die Assets und Anzeigen erstellt haben, fügen Sie die Anzeigen der Anzeigengruppe hinzu:

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

Zurück
Übersicht
Weiter
Zielgruppen-Targeting