Creare una campagna per app

Crea campagne per app con l'API Google Ads per promuovere la tua app mobile su Ricerca, Google Play, YouTube, AdMob, Discover e sulla Rete Display di Google. Ottimizza le campagne per installazioni, azioni in-app, valore di conversione o preregistrazioni Android. Le campagne attivate comportano addebiti standard per la pubblicazione di annunci Google Ads fino al raggiungimento del budget.

Preparazione

L'obiettivo della campagna (costo per installazione (CPI), costo per azione (CPA), ritorno sulla spesa pubblicitaria (ROAS) o preregistrazioni) determina le impostazioni dell'API. Trova il tuo obiettivo nella tabella seguente prima di completare i passaggi di creazione. Per cercare un controllo UI di Google Ads, consulta Mappa le impostazioni della UI di Google Ads ai campi dell'API o Informazioni sulle campagne per app.

Selezione dell'obiettivo e della UI di Google Ads Enum di sottotipo e obiettivo Strategia di offerta Impostazioni conversioni (conversion_actions)
Più installazioni (CPI target).
Volume di installazioni > Tutti gli utenti, Imposta un costo per installazione target (facoltativo) selezionato.
APP_CAMPAIGN.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST.
target_cpa (target_cpa_micros = CPI target). Facoltativo. Fino a un'azione DOWNLOAD in conversion_actions.
Più installazioni senza CPI target.
Volume di installazioni > Tutti gli utenti, Imposta un costo per installazione target (facoltativo) deselezionato.
APP_CAMPAIGN.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST.
maximize_conversions (nessun target_cpa_micros). Facoltativo. Fino a un'azione DOWNLOAD.
Installazioni con azione in-app (CPI target).
Volume di installazioni > Utenti che probabilmente eseguiranno azioni in-app, Costo per installazione target.
APP_CAMPAIGN.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST.
target_cpa (target_cpa_micros = CPI target). Obbligatorio. Un'azione in-app, più un'azione DOWNLOAD facoltativa.
Azioni in-app (CPA target).
Azioni in-app, Imposta un costo per azione in-app target (facoltativo) selezionato (o Costo per azione target per il coinvolgimento).
APP_CAMPAIGN o APP_CAMPAIGN_FOR_ENGAGEMENT.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST.
target_cpa (target_cpa_micros = CPA target). Obbligatorio. Azioni post-installazione. Facoltativo DOWNLOAD su APP_CAMPAIGN (nessuno sul coinvolgimento).
Azioni in-app senza CPA target.
Azioni in-app, (Facoltativo) Imposta un costo per azione in-app target deselezionata.
APP_CAMPAIGN.
OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA.
maximize_conversions (senza target_cpa_micros). Obbligatorio. Azioni post-installazione, più un'azione DOWNLOAD facoltativa.
Valore azioni in-app (ROAS target).
Valore azione in-app, Imposta un ritorno sulla spesa pubblicitaria target (facoltativo) selezionato (o Ritorno sulla spesa pubblicitaria target per il coinvolgimento).
APP_CAMPAIGN o APP_CAMPAIGN_FOR_ENGAGEMENT.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND.
target_roas (target_roas = ROAS target). Obbligatorio. Azioni relative ai valori (ad esempio Firebase o GOOGLE_PLAY_IN_APP_PURCHASE). DOWNLOAD facoltativo solo su APP_CAMPAIGN.
Valore azioni in-app senza ROAS target.
Valore azione in-app, Imposta un ritorno sulla spesa pubblicitaria target (facoltativo) deselezionato.
APP_CAMPAIGN.
OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS.
maximize_conversion_value (nessun target_roas). Obbligatorio. Azioni di valore (come Firebase o GOOGLE_PLAY_IN_APP_PURCHASE), più un'azione DOWNLOAD facoltativa.
Preregistrazioni di app (solo Android).
Preregistrazione (Costo per preregistrazione target).
APP_CAMPAIGN_FOR_PRE_REGISTRATION (solo GOOGLE_APP_STORE).
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME.
target_cpa (target_cpa_micros = costo per preregistrazione target). Lascia selective_optimization non impostato. Aggiungi APP_PRE_REGISTRATION a optimization_goal_types.

Passaggi

Crea tutte le risorse in modo atomico in un'unica richiesta GoogleAdsService.Mutate utilizzando ID temporanei negativi o chiama CampaignService.MutateCampaigns.

Configura e crea la campagna

Configura la risorsa Campaign:

  1. Crea un CampaignBudget giornaliero per campaign_budget con amount_micros e explicitly_shared impostati su false (il valore predefinito è true; i budget condivisi e CUSTOM_PERIOD non vanno a buon fine). Consulta Crea i budget delle campagne.

  2. Imposta name e, facoltativamente, imposta status su PAUSED durante il collegamento degli annunci (il valore predefinito è ENABLED).

  3. Imposta l'immutabile advertising_channel_type su MULTI_CHANNEL e l'immutabile advertising_channel_sub_type su APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT o APP_CAMPAIGN_FOR_PRE_REGISTRATION.

  4. Imposta contains_eu_political_advertising su DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING o CONTAINS_EU_POLITICAL_ADVERTISING. Le chiamate MutateCampaigns autonome richiedono questa dichiarazione dell'Unione Europea (UE) (facoltativa nella versione 26 e successive se il targeting è atomico solo per località non appartenenti all'UE; consulta Annunci politici dell'UE).

  5. Imposta app_campaign_setting su un oggetto AppCampaignSetting (app_store e app_id sono immutabili):

    • app_store: AppCampaignAppStore (GOOGLE_APP_STORE o APPLE_APP_STORE; la preregistrazione richiede GOOGLE_APP_STORE).
    • app_id: nome del pacchetto Google Play (com.example.app) o ID numerico dell'App Store di Apple. Il coinvolgimento richiede un numero minimo di installazioni; la preregistrazione richiede un'app di preregistrazione di Play Console non rilasciata (non idonea per APP_CAMPAIGN fino al lancio).
    • bidding_strategy_goal_type: AppCampaignBiddingStrategyGoalType per il tuo obiettivo (modificabile).
  6. Imposta una strategia di offerta standard su Campaign (le risorse di portafoglio BiddingStrategy non sono supportate). L'attivazione/disattivazione di un target UI facoltativo cambia sia bidding_strategy_goal_type sia il campo oneof delle offerte:

    • CPI, CPA o preregistrazione target: imposta target_cpa con target_cpa_micros positivi in micro della valuta dell'account (1500000 = 1,50 unità, ad esempio 1,50 $).
    • ROAS target: imposta target_roas con target_roas da 0.01 a 1000.0 (3.0 = 300% ROAS).
    • Massimizza senza target (solo APP_CAMPAIGN): imposta un valore vuoto per maximize_conversions o maximize_conversion_value. Non impostare maximize_conversions.target_cpa_micros (rifiutato su MULTI_CHANNEL) o maximize_conversion_value.target_roas.
  7. Configura gli obiettivi di conversione o preregistrazione:

  8. (Facoltativo) A partire dalla versione 24, imposta view_through_conversion_optimization_enabled su true nelle campagne Android APP_CAMPAIGN per l'offerta per conversioni view-through (VTC) (valore predefinito della UI true, valore predefinito dell'API false).

  9. (Facoltativo) Imposta start_date_time (00:00:00, oggi o in un secondo momento) e end_date_time (23:59:59) nel fuso orario dell'account (yyyy-MM-dd HH:mm:ss). Chiama MutateCampaigns o GoogleAdsService.Mutate.

(Facoltativo) Aggiungi targeting ed esclusioni per la campagna

Perfeziona il targeting dopo la creazione o nella stessa richiesta GoogleAdsService.Mutate:

Mappa le impostazioni della UI di Google Ads ai campi dell'API

Utilizza questa tabella per mappare i controlli UI di Google Ads ai campi dell'API Google Ads (Offerte e budget per i download di app o Budget e offerte per il coinvolgimento e la preregistrazione).

Sezione ed etichetta della UI di Google Ads Risorsa e campo API Dettagli
App > Seleziona un sottotipo di campagna (Installazioni di app, Coinvolgimento con l'app, Preregistrazione di app (solo Android)). Campaign.advertising_channel_type, Campaign.advertising_channel_sub_type. Immutabile: MULTI_CHANNEL con APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT o APP_CAMPAIGN_FOR_PRE_REGISTRATION.
Impostazioni campagna > Nome campagna. Campaign.name. Nome visualizzato obbligatorio nell'account cliente.
Impostazioni della campagna > App mobile. Campaign.app_campaign_setting.app_store, Campaign.app_campaign_setting.app_id. Immutabile: GOOGLE_APP_STORE (nome del pacchetto; obbligatorio per la preregistrazione) o APPLE_APP_STORE (ID numerico).
Impostazioni campagna > Località e Lingue. CampaignCriterion (location, language). Aggiunto con MutateCampaignCriteria o GoogleAdsService.Mutate atomico.
Impostazioni campagna > Ottimizzazione delle conversioni view-through > Attiva le conversioni view-through. Campaign.view_through_conversion_optimization_enabled. Solo Android APP_CAMPAIGN (v24 e versioni successive). Il valore predefinito è true nell'interfaccia utente e false nell'API.
Impostazioni campagna > Annunci politici dell'UE (La tua campagna include annunci politici dell'Unione Europea?). Campaign.contains_eu_political_advertising. Mappa Sì, questa campagna include annunci politici dell'UE e No, questa campagna non include annunci politici dell'UE.
Impostazioni campagna > Date di inizio e di fine. Campaign.start_date_time, Campaign.end_date_time. Timestamp facoltativi del fuso orario dell'account (00:00:00 oggi o successivo e 23:59:59).
Offerte e budget > Budget. CampaignBudget.amount_micros, Campaign.campaign_budget. Micro giornalieri nella valuta dell'account con CampaignBudget.explicitly_shared impostato su false.
Offerte e budget > Offerte > Su cosa vuoi concentrarti? e Quale tipo di utenti vuoi scegliere come target?
Imposta un costo per installazione target (facoltativo), Imposta un costo per azione in-app target (facoltativo) e Imposta un ritorno sulla spesa pubblicitaria target (facoltativo).
Costo per installazione target, Costo per azione target e Ritorno sulla spesa pubblicitaria target.
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. Imposta sia l'enum dell'obiettivo sia il campo oneof delle offerte (consulta la sezione Preparazione). Le strategie non target si applicano solo a APP_CAMPAIGN. Su iOS, Ottimizza per i valori di conversione di SKAdNetwork è disponibile solo nell'interfaccia utente (leggi gli schemi con CustomerSkAdNetworkConversionValueSchema).
Offerte e budget > Offerte > In che modo vuoi monitorare il volume di installazioni?
Qual è l'azione più importante per te? e Quali sono le azioni più importanti per te?
Campaign.selective_optimization.conversion_actions. Il selettore di installazione aggiunge fino a un'azione DOWNLOAD (solo APP_CAMPAIGN). I selettori di azioni aggiungono una (singolare) o più (plurale) azioni corrispondenti a app_id.
Budget e offerte > Offerte > Preregistrazione e Costo per preregistrazione target. Campaign.target_cpa.target_cpa_micros, Campaign.optimization_goal_setting.optimization_goal_types. Utilizza OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME e APP_PRE_REGISTRATION (lascia selective_optimization non impostato).

Esempio di codice e passaggi successivi

Collega un gruppo di annunci e gli asset della creatività in modo che la campagna possa pubblicare annunci: