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:
Crea un
CampaignBudgetgiornaliero percampaign_budgetconamount_microseexplicitly_sharedimpostati sufalse(il valore predefinito ètrue; i budget condivisi eCUSTOM_PERIODnon vanno a buon fine). Consulta Crea i budget delle campagne.Imposta
namee, facoltativamente, impostastatussuPAUSEDdurante il collegamento degli annunci (il valore predefinito èENABLED).Imposta l'immutabile
advertising_channel_typesuMULTI_CHANNELe l'immutabileadvertising_channel_sub_typesuAPP_CAMPAIGN,APP_CAMPAIGN_FOR_ENGAGEMENToAPP_CAMPAIGN_FOR_PRE_REGISTRATION.Imposta
contains_eu_political_advertisingsuDOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISINGoCONTAINS_EU_POLITICAL_ADVERTISING. Le chiamateMutateCampaignsautonome 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).Imposta
app_campaign_settingsu un oggettoAppCampaignSetting(app_storeeapp_idsono immutabili):app_store:AppCampaignAppStore(GOOGLE_APP_STOREoAPPLE_APP_STORE; la preregistrazione richiedeGOOGLE_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 perAPP_CAMPAIGNfino al lancio).bidding_strategy_goal_type:AppCampaignBiddingStrategyGoalTypeper il tuo obiettivo (modificabile).
Imposta una strategia di offerta standard su
Campaign(le risorse di portafoglioBiddingStrategynon sono supportate). L'attivazione/disattivazione di un target UI facoltativo cambia siabidding_strategy_goal_typesia il campooneofdelle offerte:- CPI, CPA o preregistrazione target: imposta
target_cpacontarget_cpa_microspositivi in micro della valuta dell'account (1500000= 1,50 unità, ad esempio 1,50 $). - ROAS target: imposta
target_roascontarget_roasda0.01a1000.0(3.0= 300% ROAS). - Massimizza senza target (solo
APP_CAMPAIGN): imposta un valore vuoto permaximize_conversionsomaximize_conversion_value. Non impostaremaximize_conversions.target_cpa_micros(rifiutato suMULTI_CHANNEL) omaximize_conversion_value.target_roas.
- CPI, CPA o preregistrazione target: imposta
Configura gli obiettivi di conversione o preregistrazione:
APP_CAMPAIGNeAPP_CAMPAIGN_FOR_ENGAGEMENT: aggiungi i nomi delle risorseConversionActioncorrispondenti aapp_idaselective_optimization.conversion_actions(nonCampaignConversionGoalooptimization_goal_setting; consulta Obiettivi di conversione della campagna). SuAPP_CAMPAIGN, includi fino a un'azioneDOWNLOAD, comeGOOGLE_PLAY_DOWNLOADo Firebasefirst_open(obbligatoria per l'UI, facoltativa per l'API, vietata per il coinvolgimento).APP_CAMPAIGN_FOR_PRE_REGISTRATION: lasciaselective_optimizationnon impostato e aggiungiAPP_PRE_REGISTRATIONaoptimization_goal_setting.optimization_goal_types.
(Facoltativo) A partire dalla versione 24, imposta
view_through_conversion_optimization_enabledsutruenelle campagne AndroidAPP_CAMPAIGNper l'offerta per conversioni view-through (VTC) (valore predefinito della UItrue, valore predefinito dell'APIfalse).(Facoltativo) Imposta
start_date_time(00:00:00, oggi o in un secondo momento) eend_date_time(23:59:59) nel fuso orario dell'account (yyyy-MM-dd HH:mm:ss). ChiamaMutateCampaignsoGoogleAdsService.Mutate.
(Facoltativo) Aggiungi targeting ed esclusioni per la campagna
Perfeziona il targeting dopo la creazione o nella stessa richiesta GoogleAdsService.Mutate:
- Località e lingue: aggiungi risorse
CampaignCriterionconCampaignCriterionService.MutateCampaignCriteria, ad esempio i criterilanguageelocation(consulta Criteri). - Elenchi di parole chiave escluse: collega un
CampaignSharedSeta unNEGATIVE_KEYWORDSSharedSet(consulta Insiemi condivisi). - Segmenti di pubblico: associa i criteri
UserListInfo(APP_CAMPAIGN_FOR_ENGAGEMENT) obbligatori o gli indicatoriAudienceInfo(APP_CAMPAIGN) facoltativi ai gruppi di annunci (consulta Crea un gruppo di annunci per app e un annuncio).
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:
- Crea un gruppo di annunci per app e un annuncio: aggiungi una risorsa
AdGroup(con i criteriUserListInfoobbligatori suAPP_CAMPAIGN_FOR_ENGAGEMENT) e un annuncio per app. - Esempio di codice per una campagna per app: esamina l'esempio multilingue
AddAppCampaignper creare un budget, una campagna, criteri, un gruppo di annunci e un annuncio. - Report sulle campagne per app: esegui query sulle metriche relative a campagne, asset, installazioni e SKAdNetwork con Google Ads Query Language.