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:
Erstellen Sie ein tägliches
CampaignBudgetfürcampaign_budgetmitamount_microsundexplicitly_sharedauffalsefestgelegt (Standardwert isttrue; gemeinsame undCUSTOM_PERIOD-Budgets schlagen fehl). Weitere Informationen finden Sie unter Kampagnenbudgets erstellen.Legen Sie
namefest und optionalstatusaufPAUSED, während Sie Anzeigen anhängen (Standardwert istENABLED).Legen Sie den unveränderlichen Wert
advertising_channel_typeaufMULTI_CHANNELund den unveränderlichen Wertadvertising_channel_sub_typeaufAPP_CAMPAIGN,APP_CAMPAIGN_FOR_ENGAGEMENToderAPP_CAMPAIGN_FOR_PRE_REGISTRATIONfest.Legen Sie
contains_eu_political_advertisingaufDOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISINGoderCONTAINS_EU_POLITICAL_ADVERTISINGfest. Für eigenständigeMutateCampaigns-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).Legen Sie für
app_campaign_settingeinAppCampaignSetting-Objekt fest (app_storeundapp_idsind unveränderlich):app_store:AppCampaignAppStore(GOOGLE_APP_STOREoderAPPLE_APP_STORE; für die Vorregistrierung istGOOGLE_APP_STOREerforderlich).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ürAPP_CAMPAIGNbis zur Veröffentlichung berechtigt).bidding_strategy_goal_type:AppCampaignBiddingStrategyGoalTypefür Ihr Ziel (veränderlich).
Legen Sie eine Standardgebotsstrategie für
Campaignfest (Portfolio-BiddingStrategy-Ressourcen werden nicht unterstützt). Wenn Sie ein optionales UI-Ziel aktivieren, werden sowohlbidding_strategy_goal_typeals auch das Gebotsfeldoneofumgeschaltet:- Ziel-CPI, Ziel-CPA oder Vorregistrierung: Legen Sie
target_cpamit positiventarget_cpa_microsin Mikros der Kontowährung fest (1500000= 1,50 Einheiten, z.B.1,50 €). - Ziel-ROAS: Legen Sie
target_roasmittarget_roasvon0.01bis1000.0fest (3.0= 300 % ROAS). - Maximieren ohne Ziel (nur
APP_CAMPAIGN): Legen Sie ein leeresmaximize_conversionsodermaximize_conversion_valuefest. Legen Sie nichtmaximize_conversions.target_cpa_micros(wird beiMULTI_CHANNELabgelehnt) odermaximize_conversion_value.target_roasfest.
- Ziel-CPI, Ziel-CPA oder Vorregistrierung: Legen Sie
Conversion- oder Vorregistrierungsziele konfigurieren:
APP_CAMPAIGNundAPP_CAMPAIGN_FOR_ENGAGEMENT: Fügen SieConversionAction-Ressourcennamen, die mitapp_idübereinstimmen, zuselective_optimization.conversion_actionshinzu (nicht zuCampaignConversionGoaloderoptimization_goal_setting; siehe Conversion-Zielvorhaben für Kampagnen). Fügen Sie aufAPP_CAMPAIGNbis zu eineDOWNLOAD-Aktion ein, z. B.GOOGLE_PLAY_DOWNLOADoder Firebasefirst_open(für die Benutzeroberfläche erforderlich, für die API optional, für die Interaktion unzulässig).APP_CAMPAIGN_FOR_PRE_REGISTRATION: Lassen Sieselective_optimizationleer und fügen SieAPP_PRE_REGISTRATIONzuoptimization_goal_setting.optimization_goal_typeshinzu.
Optional: Ab Version 24 können Sie
view_through_conversion_optimization_enabledfür Android-APP_CAMPAIGN-Kampagnen auftruefestlegen, um Gebote für View-through-Conversions (VTC) abzugeben (Standardwert in der Benutzeroberfläche:true, Standardwert in der API:false).Optional: Legen Sie
start_date_time(00:00:00, heute oder später) undend_date_time(23:59:59) in der Zeitzone des Kontos (yyyy-MM-dd HH:mm:ss) fest. Rufen SieMutateCampaignsoderGoogleAdsService.Mutateauf.
Optional: Kampagnenausrichtung und ‑ausschlüsse hinzufügen
Sie können das Targeting nach der Erstellung oder in derselben GoogleAdsService.Mutate-Anfrage verfeinern:
- Standorte und Sprachen: Fügen Sie
CampaignCriterion-Ressourcen mitCampaignCriterionService.MutateCampaignCriteriahinzu, z. B.language- undlocation-Kriterien (siehe Kriterien). - Listen mit auszuschließenden Keywords: Verknüpfen Sie eine
CampaignSharedSetmit einerNEGATIVE_KEYWORDSSharedSet(siehe Freigegebene Sätze). - Zielgruppen: Hängen Sie die erforderlichen
UserListInfo-Kriterien (APP_CAMPAIGN_FOR_ENGAGEMENT) oder optionalenAudienceInfo-Signale (APP_CAMPAIGN) an Anzeigengruppen an (siehe Anzeigengruppe und Anzeige für App-Kampagnen erstellen).
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:
- App-Anzeigengruppe und App-Anzeige erstellen: Fügen Sie eine
AdGroup-Ressource (mit den erforderlichenUserListInfo-Kriterien fürAPP_CAMPAIGN_FOR_ENGAGEMENT) und eine App-Anzeige hinzu. - Codebeispiel für App-Kampagnen: Sehen Sie sich das mehrsprachige
AddAppCampaign-Beispiel an, in dem ein Budget, eine Kampagne, Kriterien, eine Anzeigengruppe und eine Anzeige erstellt werden. - Berichte zu App-Kampagnen: Mit der Google Ads Query Language können Sie Messwerte zu Kampagnen, Assets, Installationen und SKAdNetwork abfragen.