Gebote

In AdWords gibt es je nach dem Schwerpunkt Ihres Unternehmens mehrere Möglichkeiten, Gebote für Anzeigen abzugeben.

In der AdWords API werden sämtliche Gebotsparameter über eines oder beide der folgenden Objekte verwaltet:

Bei beiden Objekten können Sie das Feld biddingStrategyType, das Feld biddingScheme oder beide Felder zur Angabe eines Gebotstyps verbinden. Bei biddingScheme können Sie zusätzliche Parameter angeben, die spezifisch für den jeweiligen Gebotstyp sind. Werden beide Felder verwendet, müssen die angegebenen Typen übereinstimmen.

Strategietypen

In der Tabelle unten wird in der Spalte Gültige Kontexte angegeben, ob in einem oder beiden der oben genannten Kontexte ein bestimmter BiddingStrategyType mit dem zugehörigen BiddingScheme-Typ verwendet werden kann:

  • Eine Standardstrategie mit einem BiddingStrategyConfiguration-Objekt
  • Eine Portfoliostrategie mit einem SharedBiddingStrategy-Objekt
BiddingStrategyType BiddingScheme Beschreibender Name Gültige Kontexte
BUDGET_OPTIMIZER

Eingestellt. Verwenden Sie stattdessen TARGET_SPEND.

BudgetOptimizerBiddingScheme Budget Optimizer Standard
CONVERSION_OPTIMIZER

Eingestellt. Verwenden Sie stattdessen TARGET_CPA.

ConversionOptimizerBiddingScheme Focus on conversions ‒ use CPA bids Standard
ENHANCED_CPC EnhancedCpcBiddingScheme Auto-optimierter CPC Portfolio
MANUAL_CPC ManualCpcBiddingScheme Schwerpunkt auf Klicks – max. CPC-Gebote verwenden Standard
MANUAL_CPM ManualCpmBiddingScheme Schwerpunkt auf Impressionen Standard
PAGE_ONE_PROMOTED PageOnePromotedBiddingScheme Ausrichtung auf Suchseitenposition Portfolio
TARGET_CPA TargetCpaBiddingScheme Ziel-CPA (Cost-per-Acquisition) – müssen Eignungsvoraussetzungen erfüllen Portfolio
Standard
TARGET_OUTRANK_SHARE TargetOutrankShareBiddingScheme Kompetitive Auktionsposition Portfolio
TARGET_ROAS TargetRoasBiddingScheme Ziel-ROAS (Return on Advertising Spend) – müssen Eignungsvoraussetzungen erfüllen Portfolio
TARGET_SPEND TargetSpendBiddingScheme Klicks maximieren Portfolio
Standard

Fehler entstehen, wenn Sie BiddingStrategyType oder BiddingScheme im falschen Kontext verwenden:

  • Wenn Sie einen Typ oder ein Schema, der bzw. das nur für eine Portfoliostrategie geeignet ist, im Kontext einer Standardstrategie verwenden, wird ein BiddingErrors-Fehler mit dem Grund INVALID_ANONYMOUS_BIDDING_STRATEGY_TYPE ausgelöst.
  • Wenn Sie einen Typ oder ein Schema, der bzw. das nur für eine Standardstrategie geeignet ist, im Kontext einer Portfoliostrategie verwenden, wird ein BiddingErrors-Fehler mit dem Grund BIDDING_STRATEGY_NOT_SUPPORTED ausgelöst.

Gebote festlegen

Gebote können auf der Ebene der Anzeigengruppe oder des Anzeigengruppenkriteriums festgelegt werden. Ein Kriteriumsgebot hat höhere Priorität als ein Anzeigengruppengebot.

Mehrere Gebote mit unterschiedlichen Typen können gleichzeitig in einer einzigen Strategie festgelegt werden (z. B. CpcBid und CpmBid). Es wird jedoch nur das Gebot verwendet, das mit dem ausgewählten biddingStrategyType übereinstimmt.

In Berichten wird ebenfalls nur das derzeit aktive Gebot zurückgegeben. Beim Wechsel zu einem anderen Gebotstyp wird das entsprechend zugehörige Gebot verwendet.

Im folgenden Codebeispiel wird ein mutate-Aufruf verwendet, um ein CPC-Gebot auf Anzeigengruppenebene hinzuzufügen.

// Create ad group bid.
BiddingStrategyConfiguration biddingStrategyConfiguration =
    new BiddingStrategyConfiguration();
CpcBid bid = new CpcBid();
bid.setBid(new Money(null, 10000000L));

// You can optionally provide this field.
bid.setContentBid(new Money(null, 20000000L));

biddingStrategyConfiguration.setBids(new Bids[] {bid});
adGroup.setBiddingStrategyConfiguration(biddingStrategyConfiguration);

// Create operation.
AdGroupOperation operation = new AdGroupOperation();
operation.setOperand(adGroup);
operation.setOperator(Operator.SET);
AdGroupOperation[] operations = new AdGroupOperation[] {operation};

// Update ad group.
AdGroupReturnValue result = adGroupService.mutate(operations);

Gebote entfernen

Wenn Sie ein Gebot aus einer BiddingStrategyConfiguration (Gebotsstrategiekonfiguration) entfernen möchten, ändern Sie ihr Feld bid in ein Money-Objekt, bei dem microAmount den Wert 0 hat.

Gebotsstrategie wechseln

Verwenden Sie zum Wechseln der Gebotsstrategie einen mutate()-Aufruf, in dem Sie die aktualisierten Felder für die Strategie übergeben. Im folgenden Beispiel wird veranschaulicht, wie der Gebotstyp für eine Kampagne durch Festlegen eines anderen biddingScheme geändert wird.

// Create a new local Campaign object.
Campaign campaign = new Campaign();
campaign.setId(campaignId);

// Create a new biddingStrategyConfiguration.
BiddingStrategyConfiguration biddingStrategyConfiguration =
    new BiddingStrategyConfiguration();

// You can specify either type or scheme, or both.
biddingStrategyConfiguration.setBiddingScheme(new ManualCpcBiddingScheme());
campaign.setBiddingStrategyConfiguration(biddingStrategyConfiguration);

// Create SET operation.
CampaignOperation operation = new CampaignOperation();
operation.setOperand(campaign);
operation.setOperator(Operator.SET);
CampaignOperation[] operations = new CampaignOperation[] {operation};

// Update the campaign.
CampaignReturnValue result = campaignService.mutate(operations);

Portfolio-Gebotsstrategien

Sie können für Kampagnen, Anzeigengruppen oder Keywords Portfolio-Gebotsstrategien verwenden.

Erstellen Sie mit BiddingStrategyService eine SharedBiddingStrategy (gemeinsame Gebotsstrategie) und legen Sie ihre Parameter fest. Wenn Sie beispielsweise eine vorhandene Portfolio-Gebotsstrategie für eine Kampagne verwenden möchten, aktualisieren Sie die biddingStrategyConfiguration der Kampagne und geben Sie die ID der betreffenden Strategie an:

BiddingStrategyConfiguration biddingStrategyConfiguration = new BiddingStrategyConfiguration();
biddingStrategyConfiguration.setBiddingStrategyId(strategyId);

campaign.setBiddingStrategyConfiguration(biddingStrategyConfiguration);

Kriterien für Dimensionen im Displaynetzwerk

Für Anzeigen im Displaynetzwerk ist eine Reihe von Dimensionen verfügbar, für die ein Anzeigengruppengebot festgelegt werden kann. Bei Angabe mehrerer Gebote in unterschiedlichen Dimensionen kann mit dem Feld contentBidCriterionTypeGroup die Dimension angegeben werden, die für absolute Gebote verwendet werden soll. Für Anzeigen im Suchnetzwerk werden immer Keyword-Gebote verwendet.

Sie können auch eine Gebotsanpassung festlegen, die verwendet wird, wenn das Kriterium nicht in einer absoluten Gebotsdimension liegt. Eine solche Anpassung kann über das Feld bidModifier von BiddableAdGroupCriterion vorgenommen werden.

Gebotsanpassungen

Mit Gebotsanpassungen auf Kampagnen- und Anzeigengruppenebene erhalten Sie mehr Kontrolle über Ihre Gebote in AdWords-Kampagnen, da sie die Möglichkeit bieten, Gebote für bestimmte Kriterien zu erhöhen oder zu senken.

In der AdWords API kann auf Kampagnenebene über CampaignCriterionService und auf Anzeigengruppenebene über AdGroupBidModifierService auf Anpassungen zugegriffen werden.

Gebotsanpassungen abrufen

Verwenden Sie zum Abrufen bestehender Gebotsanpassungen die Methode get() oder query() von CampaignCriterionService oder AdGroupBidModifierService. Ähnlich wie andere Dienste akzeptiert die get()-Methode einen generischen Selektor, über den Sie Antwortfelder auswählen und die Ergebnissätze filtern können.

Mit dem folgenden Code werden die ersten zehn vorhandenen Plattformkriterien auf Kampagnenebene aller Kampagnen abgerufen:

// Get the CampaignCriterionService.
CampaignCriterionServiceInterface campaignCriterionService =
    adWordsServices.get(session, CampaignCriterionServiceInterface.class);

// Create a selector that limits to the first 10 platform criteria found.
Selector selector =
    new SelectorBuilder()
        .fields(
            CampaignCriterionField.CampaignId,
            CampaignCriterionField.Id,
            CampaignCriterionField.CriteriaType,
            CampaignCriterionField.BidModifier)
        .equals(CampaignCriterionField.CriteriaType, "PLATFORM")
        .equals(CampaignCriterionField.IsNegative, "false")
        .limit(10)
        .build();

// Make a 'get' request.
CampaignCriterionPage campaignCriterionPage = campaignCriterionService.get(selector);

// Display the results.
if (campaignCriterionPage.getEntries() != null) {
  for (CampaignCriterion campaignCriterion : campaignCriterionPage.getEntries()) {
    String value =
        campaignCriterion.getBidModifier() == null
            ? "unset"
            : String.format("%.2f", campaignCriterion.getBidModifier());
    System.out.printf(
        "Campaign ID %d, criterion ID %d has campaign level bid modifier %s.%n",
        campaignCriterion.getCampaignId(), campaignCriterion.getCriterion().getId(), value);
  }
} else {
  System.out.println("No campaign criteria found.");
}

Gebotsanpassungen hinzufügen, aktualisieren und entfernen

Verwenden Sie die mutate()-Methode von CampaignCriterionService oder AdGroupBidModifierService, um eine Gebotsanpassung hinzuzufügen oder zu ändern.

  • Verwenden Sie den Operator ADD, um eine neue Gebotsanpassung hinzuzufügen.
  • Verwenden Sie den Operator SET, um eine Gebotsüberschreibung auf einen neuen Wert zu aktualisieren.
  • Verwenden Sie den Operator REMOVE, um die Überschreibung einer Gebotsanpassung zu entfernen.

In diesem Beispiel wird gezeigt, wie Sie eine neue Gebotsanpassung für Mobilgeräte auf Kampagnenebene hinzufügen:

// Get the CampaignCriterionService.
CampaignCriterionServiceInterface campaignCriterionService =
    adWordsServices.get(session, CampaignCriterionServiceInterface.class);

// Create mobile platform. The ID can be found in the documentation.
// https://developers.google.com/adwords/api/docs/appendix/platforms
Platform mobile = new Platform();
mobile.setId(30001L);

// Create criterion with modified bid.
CampaignCriterion campaignCriterion = new CampaignCriterion();
campaignCriterion.setCampaignId(campaignId);
campaignCriterion.setCriterion(mobile);
campaignCriterion.setBidModifier(BID_MODIFIER);

// Create SET operation.
CampaignCriterionOperation operation = new CampaignCriterionOperation();
operation.setOperand(campaignCriterion);
operation.setOperator(Operator.SET);

// Update campaign criterion.
CampaignCriterionReturnValue result =
    campaignCriterionService.mutate(new CampaignCriterionOperation[] {operation});
for (CampaignCriterion campaignCriterionResult : result.getValue()) {
  System.out.printf("Campaign criterion with campaign ID %d, criterion ID %d, "
      + "and type '%s' was modified with bid %.4f.%n",
      campaignCriterionResult.getCampaignId(),
      campaignCriterionResult.getCriterion().getId(),
      campaignCriterionResult.getCriterion().getType(),
      campaignCriterionResult.getBidModifier());
}

Feedback geben zu...