À partir de la version v25_2, l'API Google Ads introduit la méthode SmartCampaignSettingService.GeneratePMaxDraftCampaign pour vous aider à convertir une campagne intelligente en campagne Performance Max.
Fonctionnement des conversions
Lorsque vous appelez SmartCampaignSettingService.GeneratePMaxDraftCampaign, l'API génère une campagne Performance Max provisoire basée sur la configuration d'une campagne intelligente existante.
L'état de la campagne Performance Max brouillon générée est initialisé avec les valeurs suivantes :
statusest défini surPAUSED.creation_statusest défini surINCOMPLETE.
Vous pouvez ainsi inspecter, modifier et améliorer la campagne Performance Max, le budget, le groupe de composants et les composants générés avant d'activer la campagne pour diffuser des annonces.
Paramètres de requête
Le message GeneratePMaxDraftCampaignRequest accepte les champs suivants :
resource_name(obligatoire) : nom de ressource de l'SmartCampaignSettingassociée à la campagne intelligente existante que vous souhaitez convertir, au format suivant :customers/customer_id/smartCampaignSettings/campaign_idvalidate_only(facultatif) : si la valeur esttrue, la requête est validée, mais pas exécutée. Seules les erreurs ou les avertissements de validation, ou les problèmes de conversion potentiels, sont renvoyés dans le champvalidated_infode la réponse.gbp_enabled(Non compatible actuellement) : indique si le lieu de la fiche d'établissement Google associée à la campagne intelligente doit être converti et associé à la campagne Performance Max générée. La définition de ce champ surtruen'est actuellement pas implémentée et renverra une erreurGBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.image_enabled(Non compatible actuellement) : indique si les images requises pour la campagne Performance Max (telles que les composants Image au format horizontal, carré et logo) doivent être générées automatiquement. La définition de ce champ surtruen'est actuellement pas implémentée et renverra une erreurIMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.
Détails de la réponse
Le message GeneratePMaxDraftCampaignResponse renvoie les noms de ressources de la campagne Performance Max brouillon nouvellement générée et de ses entités associées :
pmax_campaign: nom de ressourceCampaignde la campagne Performance Max brouillon générée.campaign_budget: nom de ressourceCampaignBudgetassocié à la campagne Performance Max générée.asset_group: nom de ressourceAssetGroupassocié à la campagne Performance Max générée.assets: liste des noms de ressourcesAssetassociés à la campagne Performance Max générée.validated_info: informations de validation supplémentaires ou problèmes de conversion potentiels renvoyés lorsquevalidate_onlyest défini surtrue.
Workflow recommandé
Pour convertir une campagne intelligente, suivez la procédure ci-dessous :
- Générez la campagne brouillon : appelez
SmartCampaignSettingService.GeneratePMaxDraftCampaignavec uniquement l'ensembleresource_namerequis (laissezgbp_enabledetimage_enablednon définis ou définissez-les surfalse). Enregistrez les noms de ressourcespmax_campaign,campaign_budget,asset_groupetassetsrenvoyés. - Vérifiez et personnalisez la campagne : comme la campagne Performance Max brouillon est créée avec
status = PAUSEDetcreation_status = INCOMPLETE, vérifiez et configurez son budget, son groupe de composants et ses composants. - Activez la campagne : lorsque vous êtes prêt à diffuser des annonces, définissez
statussurENABLEDetcreation_statussurCOMPLETE.