App-Kampagne erstellen

Mit der Google Ads API können Sie App-Kampagnen erstellen, um Ihre mobile App in der Google Suche, bei Google Play, auf YouTube, in AdMob, in Discover und im Google Displaynetzwerk zu bewerben. Kampagnen für Installationen, In-App-Aktionen, Conversion-Wert oder Android-Vorregistrierungen optimieren Für aktivierte Kampagnen fallen die standardmäßigen Google Ads-Gebühren für die Anzeigenbereitstellung bis zur Höhe Ihres Budgets an.

Vorbereitung

Das Ziel Ihrer Kampagne – Cost-per-Install (CPI), Cost-per-Action (CPA), Return on Advertising Spend (ROAS) oder Vorregistrierungen – bestimmt Ihre API-Einstellungen. Suchen Sie Ihr Ziel in der folgenden Tabelle, bevor Sie die Schritte zum Erstellen ausführen. Informationen zu einem Google Ads-UI-Steuerelement finden Sie unter Google Ads-UI-Einstellungen API-Feldern zuordnen oder App-Kampagnen.

Zielvorhaben und Auswahl der Google Ads-Benutzeroberfläche Untertyp und Ziel-Enum Gebotsstrategie Conversion-Einstellungen (conversion_actions)
Mehr Installationen (Ziel-CPI):
Anzahl der Installationen > Alle Nutzer, Ziel-CPI (Cost-per-Install) festlegen (optional) ausgewählt.
APP_CAMPAIGN.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST.
target_cpa (target_cpa_micros = Ziel-CPI). Optional. Bis zu eine DOWNLOAD-Aktion in conversion_actions.
Mehr Installationen ohne Ziel-CPI:
Anzahl der Installationen > Alle Nutzer, Ziel-CPI (Cost-per-Install) festlegen (optional) deaktiviert.
APP_CAMPAIGN.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST.
maximize_conversions (keine target_cpa_micros). Optional. Bis zu eine DOWNLOAD-Aktion.
Installationen mit In-App-Aktion (Ziel-CPI):
Anzahl der Installationen > Nutzer, die wahrscheinlich eine In-App-Aktion durchführen, Ziel-Cost-per-Install.
APP_CAMPAIGN.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST.
target_cpa (target_cpa_micros = Ziel-CPI). Erforderlich. Eine In-App-Aktion plus optionale DOWNLOAD-Aktion.
In-App-Aktionen (Ziel-CPA):
In-App-Aktionen, Zielkosten pro In-App-Aktion festlegen (optional) ausgewählt (oder Ziel-CPA (Cost-per-Action) für Interaktionen).
APP_CAMPAIGN oder APP_CAMPAIGN_FOR_ENGAGEMENT.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST.
target_cpa (target_cpa_micros = Ziel-CPA). Erforderlich. Aktionen nach der Installation. Optional DOWNLOAD auf APP_CAMPAIGN (keine bei Interaktion).
In-App-Aktionen ohne Ziel-CPA:
In-App-Aktionen, Zielkosten pro In-App-Aktion festlegen (optional) deaktiviert.
APP_CAMPAIGN.
OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA.
maximize_conversions (kein target_cpa_micros). Erforderlich. Aktionen nach der Installation sowie die optionale Aktion DOWNLOAD.
Wert der In-App-Aktionen (Ziel-ROAS):
Wert der In-App-Aktion, Ziel-ROAS (Return on Advertising Spend) festlegen (optional) ausgewählt (oder Ziel-ROAS für Interaktionen).
APP_CAMPAIGN oder APP_CAMPAIGN_FOR_ENGAGEMENT.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND.
target_roas (target_roas = Ziel-ROAS). Erforderlich. Wertaktionen (z. B. Firebase oder GOOGLE_PLAY_IN_APP_PURCHASE). Optionaler DOWNLOAD nur für APP_CAMPAIGN.
Wert der In-App-Aktionen ohne Ziel-ROAS:
In-App-Aktionswert, Ziel-ROAS festlegen (optional) deaktiviert.
APP_CAMPAIGN.
OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS.
maximize_conversion_value (keine target_roas). Erforderlich. Wertaktionen (z. B. Firebase oder GOOGLE_PLAY_IN_APP_PURCHASE) sowie optionale DOWNLOAD-Aktion.
App-Vorregistrierungen (nur Android):
Vorregistrierung (Ziel-CPpre (Cost-per-pre-registration)).
APP_CAMPAIGN_FOR_PRE_REGISTRATION (nur GOOGLE_APP_STORE).
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME.
target_cpa (target_cpa_micros = Ziel-CPpre (Cost-per-pre-registration)). Bestimmen Sie selective_optimization nicht. Fügen Sie APP_PRE_REGISTRATION zu optimization_goal_types hinzu.

Schritte

Erstellen Sie alle Ressourcen atomar in einer einzigen GoogleAdsService.Mutate-Anfrage, indem Sie negative temporäre IDs verwenden, oder rufen Sie CampaignService.MutateCampaigns auf.

Kampagne konfigurieren und erstellen

Konfigurieren Sie die Ressource Campaign:

  1. Erstellen Sie ein tägliches CampaignBudget für campaign_budget mit amount_micros und explicitly_shared auf false festgelegt (Standardwert ist true; gemeinsame und CUSTOM_PERIOD-Budgets schlagen fehl). Weitere Informationen finden Sie unter Kampagnenbudgets erstellen.

  2. Legen Sie name fest und optional status auf PAUSED, während Sie Anzeigen anhängen (Standardwert ist ENABLED).

  3. Legen Sie den unveränderlichen Wert advertising_channel_type auf MULTI_CHANNEL und den unveränderlichen Wert advertising_channel_sub_type auf APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT oder APP_CAMPAIGN_FOR_PRE_REGISTRATION fest.

  4. Legen Sie contains_eu_political_advertising auf DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING oder CONTAINS_EU_POLITICAL_ADVERTISING fest. Für eigenständige MutateCampaigns-Aufrufe ist diese Erklärung für die Europäische Union (EU) erforderlich (optional in Version 26 und höher, wenn nur Standorte außerhalb der EU als Targeting festgelegt werden; siehe Politische Werbung in der EU).

  5. Legen Sie für app_campaign_setting ein AppCampaignSetting-Objekt fest (app_store und app_id sind unveränderlich):

    • app_store: AppCampaignAppStore (GOOGLE_APP_STORE oder APPLE_APP_STORE; für die Vorregistrierung ist GOOGLE_APP_STORE erforderlich).
    • app_id: Google Play-Paketname (com.example.app) oder numerische Apple App Store-ID. Für Interaktionen ist eine Mindestanzahl von Installationen erforderlich. Für die Vorregistrierung ist eine noch nicht veröffentlichte App zur Vorregistrierung in der Play Console erforderlich (nicht für APP_CAMPAIGN bis zur Veröffentlichung berechtigt).
    • bidding_strategy_goal_type: AppCampaignBiddingStrategyGoalType für Ihr Ziel (veränderlich).
  6. Legen Sie eine Standardgebotsstrategie für Campaign fest (Portfolio-BiddingStrategy-Ressourcen werden nicht unterstützt). Wenn Sie ein optionales UI-Ziel aktivieren, werden sowohl bidding_strategy_goal_type als auch das Gebotsfeld oneof umgeschaltet:

    • Ziel-CPI, Ziel-CPA oder Vorregistrierung: Legen Sie target_cpa mit positiven target_cpa_micros in Mikros der Kontowährung fest (1500000 = 1,50 Einheiten, z.B.1,50 €).
    • Ziel-ROAS: Legen Sie target_roas mit target_roas von 0.01 bis 1000.0 fest (3.0 = 300 % ROAS).
    • Maximieren ohne Ziel (nur APP_CAMPAIGN): Legen Sie ein leeres maximize_conversions oder maximize_conversion_value fest. Legen Sie nicht maximize_conversions.target_cpa_micros (wird bei MULTI_CHANNEL abgelehnt) oder maximize_conversion_value.target_roas fest.
  7. Conversion- oder Vorregistrierungsziele konfigurieren:

  8. Optional: Ab Version 24 können Sie view_through_conversion_optimization_enabled für Android-APP_CAMPAIGN-Kampagnen auf true festlegen, um Gebote für View-through-Conversions (VTC) abzugeben (Standardwert in der Benutzeroberfläche: true, Standardwert in der API: false).

  9. Optional: Legen Sie start_date_time (00:00:00, heute oder später) und end_date_time (23:59:59) in der Zeitzone des Kontos (yyyy-MM-dd HH:mm:ss) fest. Rufen Sie MutateCampaigns oder GoogleAdsService.Mutate auf.

Optional: Kampagnenausrichtung und ‑ausschlüsse hinzufügen

Sie können das Targeting nach der Erstellung oder in derselben GoogleAdsService.Mutate-Anfrage verfeinern:

Einstellungen der Google Ads-Benutzeroberfläche API-Feldern zuordnen

In dieser Tabelle können Sie Google Ads-UI-Steuerelemente Google Ads API-Feldern zuordnen (Gebote und Budget für App-Installationen oder Budget und Gebote für Interaktionen und Vorregistrierungen).

Google Ads-Benutzeroberfläche – Bereich und Label API-Ressource und -Feld Details
App > Kampagnenuntertyp auswählen (App-Installationen, App-Interaktionen, App-Vorregistrierung (nur Android)). Campaign.advertising_channel_type, Campaign.advertising_channel_sub_type. Unveränderlich: MULTI_CHANNEL mit APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT oder APP_CAMPAIGN_FOR_PRE_REGISTRATION.
Kampagneneinstellungen > Kampagnenname Campaign.name. Erforderlicher Anzeigename im Kundenkonto.
Kampagneneinstellungen > Mobile App. Campaign.app_campaign_setting.app_store, Campaign.app_campaign_setting.app_id. Unveränderlich: GOOGLE_APP_STORE (Paketname; für die Vorregistrierung erforderlich) oder APPLE_APP_STORE (numerische ID).
Kampagneneinstellungen > Standorte und Sprachen. CampaignCriterion (location, language). Wird mit MutateCampaignCriteria oder atomarem GoogleAdsService.Mutate hinzugefügt.
Kampagneneinstellungen > View-through-Conversion-Optimierung > View-through-Conversions aktivieren. Campaign.view_through_conversion_optimization_enabled. Nur Android APP_CAMPAIGN (Version 24 und höher). Die Standardeinstellung ist true in der Benutzeroberfläche und false in der API.
Kampagneneinstellungen > Politische Werbung in der EU (Enthält Ihre Kampagne politische Werbung in der EU?) Campaign.contains_eu_political_advertising. Ja, diese Kampagne enthält politische Werbung in der EU und Nein, diese Kampagne enthält keine politische Werbung in der EU.
Kampagneneinstellungen > Start- und Enddatum. Campaign.start_date_time, Campaign.end_date_time. Optionale Zeitstempel in der Zeitzone des Kontos (00:00:00 heute oder später und 23:59:59).
Gebote und Budget > Budget. CampaignBudget.amount_micros, Campaign.campaign_budget. Tägliche Mikros in der Kontowährung, wobei CampaignBudget.explicitly_shared auf false festgelegt ist.
Gebote und Budget > Gebote > Worauf möchten Sie sich konzentrieren? und Welche Art von Nutzern möchten Sie mit Ihren Anzeigen ansprechen?
Ziel-CPI (Cost-per-Install) festlegen (optional), Zielkosten pro In-App-Aktion festlegen (optional) und Ziel-ROAS festlegen (optional).
Ziel-CPI (Cost-per-Install), Ziel-CPA (Cost-per-Action) und Ziel-ROAS (Return on Advertising Spend).
Campaign.app_campaign_setting.bidding_strategy_goal_type, Campaign.target_cpa.target_cpa_micros, Campaign.target_roas.target_roas, Campaign.maximize_conversions, Campaign.maximize_conversion_value. Legt sowohl das Ziel-Enum als auch das Gebotsfeld oneof fest (siehe Vorbereitung). Strategien ohne Ziel gelten nur für APP_CAMPAIGN. Unter iOS ist Für SKAdNetwork-Conversion-Werte optimieren nur eine UI-Option (Schemas mit CustomerSkAdNetworkConversionValueSchema lesen).
Gebote und Budget > Gebote > Wie möchten Sie die Anzahl der Installationen erfassen?
Welche Aktion ist für Sie am wichtigsten? und Welche Aktionen sind für Sie am wichtigsten?
Campaign.selective_optimization.conversion_actions. Die Installationsauswahl fügt bis zu eine DOWNLOAD-Aktion hinzu (nur APP_CAMPAIGN). Mit Aktionsauswahl-Elementen wird eine (Singular) oder mehrere (Plural) Aktionen hinzugefügt, die mit app_id übereinstimmen.
Budget und Gebote > Gebote > Vorregistrierung und Ziel-CPpre (Cost-per-pre-registration). Campaign.target_cpa.target_cpa_micros, Campaign.optimization_goal_setting.optimization_goal_types. Verwendet OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME und APP_PRE_REGISTRATION (selective_optimization bleibt unbestimmt).

Codebeispiel und nächste Schritte

Fügen Sie eine Anzeigengruppe und Creative-Assets hinzu, damit Anzeigen in Ihrer Kampagne ausgeliefert werden können: