Créez des campagnes pour applications avec l'API Google Ads afin de promouvoir votre application mobile sur le Réseau de Recherche, Google Play, YouTube, AdMob, Discover et le Réseau Display de Google. Optimisez vos campagnes pour les installations, les actions dans l'application, la valeur de conversion ou les préinscriptions Android. Les campagnes activées entraînent des frais de diffusion d'annonces Google Ads standards, dans la limite de votre budget.
Préparation
L'objectif de votre campagne (coût par installation (CPI), coût par action (CPA), retour sur les dépenses publicitaires (ROAS) ou préinscriptions) détermine les paramètres de votre API. Recherchez votre objectif dans le tableau suivant avant de suivre les étapes de création. Pour rechercher une commande d'interface utilisateur Google Ads, consultez Mapper les paramètres de l'interface utilisateur Google Ads avec les champs de l'API ou À propos des campagnes pour applications.
| Sélection de l'objectif et de l'UI Google Ads | Énumération des sous-types et des objectifs | Stratégie d'enchères | Paramètres des conversions (conversion_actions) |
|---|---|---|---|
|
Plus d'installations (CPI cible). Nombre d'installations > Tous les utilisateurs, Définir un coût par installation cible (facultatif) sélectionné. |
APP_CAMPAIGN.OPTIMIZE_INSTALLS_TARGET_INSTALL_COST.
|
target_cpa
(target_cpa_micros
= CPI cible).
|
Facultatif. Au maximum une action DOWNLOAD dans conversion_actions.
|
|
Plus d'installations sans CPI cible. Nombre d'installations > Tous les utilisateurs, Définir un coût par installation cible (facultatif) décoché. |
APP_CAMPAIGN.OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST.
|
maximize_conversions
(pas de target_cpa_micros).
|
Facultatif. Jusqu'à une action DOWNLOAD.
|
|
Installations avec action dans l'application (CPI cible). Nombre d'installations > Utilisateurs susceptibles de réaliser des actions dans l'application, Coût par installation cible. |
APP_CAMPAIGN.OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST.
|
target_cpa (target_cpa_micros = CPI cible).
|
Obligatoire. Une action dans l'application, plus une action DOWNLOAD facultative.
|
|
Actions dans l'application (CPA cible) Actions dans l'application, Définir un coût par action dans l'application cible (facultatif) sélectionné (ou Coût par action cible pour l'engagement). |
APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT.OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST.
|
target_cpa (target_cpa_micros = CPA cible).
|
Obligatoire. Actions post-installation. Facultatif : DOWNLOAD sur APP_CAMPAIGN (aucun sur l'engagement).
|
|
Actions dans l'application sans CPA cible Actions dans l'application, Définir un coût par action dans l'application cible (facultatif) désactivé. |
APP_CAMPAIGN.OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA.
|
maximize_conversions (pas de target_cpa_micros).
|
Obligatoire. Actions post-installation, plus l'action DOWNLOAD facultative.
|
|
Valeur des actions dans l'application (ROAS cible). Valeur d'action dans l'application, Définir un objectif de retour sur les dépenses publicitaires (facultatif) sélectionné (ou ROAS cible pour l'engagement). |
APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT.OPTIMIZE_RETURN_ON_ADVERTISING_SPEND.
|
target_roas (target_roas = ROAS cible).
|
Obligatoire. Actions de valeur (telles que Firebase ou GOOGLE_PLAY_IN_APP_PURCHASE). DOWNLOAD facultatif sur APP_CAMPAIGN uniquement.
|
|
Valeur des actions dans l'application sans ROAS cible Valeur de l'action dans l'application, Définir un objectif de retour sur les dépenses publicitaires (facultatif) désactivé. |
APP_CAMPAIGN.OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS.
|
maximize_conversion_value
(pas de target_roas).
|
Obligatoire. Actions de valeur (telles que Firebase ou GOOGLE_PLAY_IN_APP_PURCHASE), plus l'action DOWNLOAD facultative.
|
|
Préinscription à une application (Android uniquement) Préinscription (Coût par préinscription cible). |
APP_CAMPAIGN_FOR_PRE_REGISTRATION (GOOGLE_APP_STORE uniquement).OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME.
|
target_cpa (target_cpa_micros = coût par préinscription cible).
|
Ne définissez pas selective_optimization. Ajoutez APP_PRE_REGISTRATION à optimization_goal_types.
|
Étapes
Créez toutes les ressources de manière atomique dans une requête GoogleAdsService.Mutate à l'aide d'ID temporaires négatifs, ou appelez CampaignService.MutateCampaigns.
Configurer et créer la campagne
Configurez la ressource Campaign :
Créez un
CampaignBudgetquotidien pourcampaign_budgetavecamount_microsetexplicitly_shareddéfinis surfalse(la valeur par défaut esttrue; les budgets partagés etCUSTOM_PERIODéchouent). Consultez Créer des budgets de campagne.Définissez
nameet, éventuellement, définissezstatussurPAUSEDlors de l'association des annonces (la valeur par défaut estENABLED).Définissez l'élément immuable
advertising_channel_typesurMULTI_CHANNELet l'élément immuableadvertising_channel_sub_typesurAPP_CAMPAIGN,APP_CAMPAIGN_FOR_ENGAGEMENTouAPP_CAMPAIGN_FOR_PRE_REGISTRATION.Définissez
contains_eu_political_advertisingsurDOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISINGouCONTAINS_EU_POLITICAL_ADVERTISING. Les appelsMutateCampaignsautonomes nécessitent cette déclaration pour l'Union européenne (UE) (facultative dans la version 26 et les versions ultérieures lorsque vous ciblez de manière atomique uniquement des zones géographiques hors UE ; consultez Annonces à caractère politique dans l'UE).Définissez
app_campaign_settingsur un objetAppCampaignSetting(app_storeetapp_idsont immuables) :app_store:AppCampaignAppStore(GOOGLE_APP_STOREouAPPLE_APP_STORE; la préinscription nécessiteGOOGLE_APP_STORE).app_id: nom du package Google Play (com.example.app) ou ID numérique du magasin d'applications Apple. L'engagement nécessite un nombre minimal d'installations. La préinscription nécessite une application de préinscription non publiée dans la Play Console (non éligible àAPP_CAMPAIGNjusqu'au lancement).bidding_strategy_goal_type:AppCampaignBiddingStrategyGoalTypepour votre objectif (modifiable).
Définissez une stratégie d'enchères standard sur
Campaign(les ressources de portefeuilleBiddingStrategyne sont pas acceptées). L'activation/La désactivation d'une cible d'UI facultative modifie à la foisbidding_strategy_goal_typeet le champ d'enchèresoneof:- CPI cible, CPA cible ou préinscription : définissez
target_cpaavec untarget_cpa_microspositif en micros de la devise du compte (1500000= 1,50 unité, par exemple 1,50 USD). - ROAS cible : définissez
target_roasavectarget_roasde0.01à1000.0(3.0= ROAS de 300 %). - Maximiser sans cible (
APP_CAMPAIGNuniquement) : définissez un champmaximize_conversionsoumaximize_conversion_valuevide. Ne définissez pasmaximize_conversions.target_cpa_micros(rejeté surMULTI_CHANNEL) oumaximize_conversion_value.target_roas.
- CPI cible, CPA cible ou préinscription : définissez
Configurez des objectifs de conversion ou de préinscription :
APP_CAMPAIGNetAPP_CAMPAIGN_FOR_ENGAGEMENT: ajoutez des noms de ressourcesConversionActioncorrespondant àapp_idàselective_optimization.conversion_actions(et non àCampaignConversionGoalouoptimization_goal_setting; consultez Objectifs de conversion de la campagne). SurAPP_CAMPAIGN, incluez au maximum une actionDOWNLOAD, telle queGOOGLE_PLAY_DOWNLOADou Firebasefirst_open(obligatoire pour l'UI, facultatif pour l'API, interdit pour l'engagement).APP_CAMPAIGN_FOR_PRE_REGISTRATION: laissezselective_optimizationnon défini et ajoutezAPP_PRE_REGISTRATIONàoptimization_goal_setting.optimization_goal_types.
Facultatif : À partir de la v24, définissez
view_through_conversion_optimization_enabledsurtruedans les campagnes AndroidAPP_CAMPAIGNpour les enchères basées sur les conversions après affichage (VTC) (valeur par défaut de l'UI :true, valeur par défaut de l'API :false).Facultatif : définissez
start_date_time(00:00:00, aujourd'hui ou plus tard) etend_date_time(23:59:59) dans le fuseau horaire du compte (yyyy-MM-dd HH:mm:ss). AppelezMutateCampaignsouGoogleAdsService.Mutate.
Facultatif : Ajoutez des ciblages et des exclusions à la campagne
Affinez le ciblage après la création ou dans la même requête GoogleAdsService.Mutate :
- Zones géographiques et langues : ajoutez des ressources
CampaignCriterionavecCampaignCriterionService.MutateCampaignCriteria, telles que les critèreslanguageetlocation(voir Critères). - Listes de mots clés à exclure : associez un
CampaignSharedSetà unNEGATIVE_KEYWORDSSharedSet(voir Ensembles partagés). - Audiences : associez les critères
UserListInforequis (APP_CAMPAIGN_FOR_ENGAGEMENT) ou les signauxAudienceInfofacultatifs (APP_CAMPAIGN) aux groupes d'annonces (voir Créer un groupe d'annonces et une annonce pour une application).
Mapper les paramètres de l'UI Google Ads avec les champs de l'API
Utilisez ce tableau pour mapper les commandes d'interface utilisateur Google Ads aux champs de l'API Google Ads (Enchères et budget pour les installations d'applications, ou Budget et enchères pour l'engagement et la préinscription).
| Section et libellé de l'UI Google Ads | Ressource et champ de l'API | Détails |
|---|---|---|
| Application > Sélectionnez un sous-type de campagne (Installations d'applications, Engagement avec l'application, Préinscription à une application (Android uniquement)). |
Campaign.advertising_channel_type,
Campaign.advertising_channel_sub_type.
|
Immuable : MULTI_CHANNEL avec APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT ou APP_CAMPAIGN_FOR_PRE_REGISTRATION.
|
| Paramètres de la campagne > Nom de la campagne. |
Campaign.name.
|
Nom à afficher obligatoire dans le compte client. |
| Paramètres de la campagne > Application mobile. |
Campaign.app_campaign_setting.app_store,
Campaign.app_campaign_setting.app_id.
|
Immuable : GOOGLE_APP_STORE (nom du package ; requis pour la préinscription) ou APPLE_APP_STORE (ID numérique).
|
| Paramètres de la campagne > Zones géographiques et Langues. |
CampaignCriterion
(location,
language).
|
Ajouté avec MutateCampaignCriteria ou GoogleAdsService.Mutate atomique.
|
| Paramètres de la campagne > Optimisation des conversions après affichage > Activer les conversions après affichage. |
Campaign.view_through_conversion_optimization_enabled.
|
Android APP_CAMPAIGN uniquement (v24 et versions ultérieures). La valeur par défaut est true dans l'interface utilisateur et false dans l'API.
|
| Paramètres de la campagne > Annonces à caractère politique dans l'UE (Votre campagne comporte-t-elle des annonces à caractère politique dans l'Union européenne ?). |
Campaign.contains_eu_political_advertising.
|
Mappez Oui, cette campagne comporte des annonces à caractère politique dans l'UE et Non, cette campagne ne comporte pas d'annonces à caractère politique dans l'UE. |
| Paramètres de la campagne > Dates de début et de fin. |
Campaign.start_date_time,
Campaign.end_date_time.
|
Horodatages facultatifs du fuseau horaire du compte (00:00:00 aujourd'hui ou plus tard, et 23:59:59).
|
| Enchères et budget > Budget. |
CampaignBudget.amount_micros,
Campaign.campaign_budget.
|
Micro-unités quotidiennes dans la devise du compte, avec CampaignBudget.explicitly_shared défini sur false.
|
|
Enchères et budget > Enchères > Quel est votre objectif ? et Quel type d'utilisateurs souhaitez-vous cibler ? Définir un coût par installation cible (facultatif), Définir un coût par action dans l'application cible (facultatif) et Définir un ROAS cible (facultatif). Coût par installation cible, coût par action cible et ROAS cible. |
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.
|
Définit à la fois l'énumération de l'objectif et le champ d'enchères oneof (voir Préparation). Les stratégies non ciblées ne s'appliquent qu'à APP_CAMPAIGN. Sur iOS, Optimiser les valeurs de conversion SKAdNetwork est une fonctionnalité réservée à l'interface utilisateur (lire les schémas avec CustomerSkAdNetworkConversionValueSchema).
|
|
Enchères et budget > Enchères > Comment souhaitez-vous suivre le volume d'installations ? Quelle action est la plus importante pour vous ? et À quelles actions accordez-vous le plus d'importance ? |
Campaign.selective_optimization.conversion_actions.
|
Le sélecteur d'installation ajoute jusqu'à une action DOWNLOAD (APP_CAMPAIGN uniquement). Les sélecteurs d'actions ajoutent une (singulier) ou plusieurs (pluriel) actions correspondant à app_id.
|
| Budget et enchères > Enchères > Préinscription et Coût par préinscription cible. |
Campaign.target_cpa.target_cpa_micros,
Campaign.optimization_goal_setting.optimization_goal_types.
|
Utilise OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME et APP_PRE_REGISTRATION (ne définissez pas selective_optimization).
|
Exemple de code et étapes suivantes
Associez un groupe d'annonces et des assets de création pour que votre campagne puisse diffuser des annonces :
- Créer un groupe d'annonces et une annonce pour une application : ajoutez une ressource
AdGroup(avec les critèresUserListInforequis surAPP_CAMPAIGN_FOR_ENGAGEMENT) et une annonce pour une application. - Exemple de code de campagne pour applications : examinez l'exemple multilingue
AddAppCampaignqui crée un budget, une campagne, des critères, un groupe d'annonces et une annonce. - Rapports sur les campagnes pour applications : interrogez les métriques de campagne, de composant, d'installation et SKAdNetwork avec le langage de requête Google Ads.