Convertir des campagnes intelligentes en campagnes PMax

Dans la version v25 et ultérieure, vous pouvez utiliser la SmartCampaignSettingService.GeneratePMaxDraftCampaign méthode pour convertir une campagne intelligente en campagne Performance Max. Cette méthode n'est pas disponible dans la version v24 ni antérieure.

Fonctionnement de la conversion

Lorsque vous appelez SmartCampaignSettingService.GeneratePMaxDraftCampaign, l' API génère une campagne Performance Max brouillon, un budget, un groupe de composants et des composants, en fonction de la configuration de la campagne intelligente fournie dans la requête. Une fois générés, vous devez inspecter, modifier et améliorer les nouvelles ressources avant d'activer la campagne pour diffuser des annonces.

La campagne Performance Max brouillon générée est initialisée avec les valeurs d'état suivantes :

• status est défini sur PAUSED.
• Son éligibilité à la diffusion est reflétée dans primary_status.
• contains_eu_political_advertising est défini par défaut sur DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING (s'il n'est pas déjà spécifié dans la campagne intelligente). Vérifiez et mettez à jour ce champ si votre campagne contient de la publicité à caractère politique dans l'UE.

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.

Composants brouillons

La nouvelle campagne est accompagnée d'un groupe d'images de substitution qui doivent être remplacées avant que la nouvelle campagne ne soit activée. Lorsque le champ image_enabled est compatible et défini sur true dans la requête, l'API génère automatiquement des images au lieu d'utiliser des images de substitution. Vous pouvez inspecter les nouveaux composants dans le champ assets de la réponse et les remplacer en procédant comme suit :

1. Consultez le guide sur les exigences concernant les composants.
2. Importez de nouvelles images en suivant l'exemple d'importation de composants Image.
3. Associez les nouveaux composants au groupe de composants de la campagne brouillon, puis supprimez les AssetGroupAsset liens pour les images de substitution (dans la même requête de modification atomique ou après avoir associé les nouveaux composants afin de continuer à respecter les exigences minimales concernant les composants) en suivant le guide Associer des groupes de composants à des composants.

Paramètres de requête

Attention : Les paramètres gbp_enabled et image_enabled ne sont pas compatibles et entraînent des erreurs s'ils sont définis sur true dans une requête. Laissez les deux champs non définis ou définissez-les sur false.

Le GeneratePMaxDraftCampaignRequest message accepte les champs suivants :

• resource_name (Obligatoire) : nom de ressource du SmartCampaignSetting à régénérer pour la campagne intelligente que vous souhaitez convertir, au format suivant :

  customers/customer_id/smartCampaignSettings/campaign_id
  

• validate_only (facultatif) : si la valeur est true, la requête est validée, mais pas exécutée. Seuls les erreurs, avertissements ou problèmes de conversion potentiels sont renvoyés dans le champ validated_info de la réponse sans créer d'entités brouillons.

• gbp_enabled (non compatible) : facultatif. Indique si vous souhaitez convertir l'établissement de la fiche d'établissement Google associé à la campagne Performance Max. Laissez ce champ non défini ou false. Le définir sur true n'est pas compatible et renvoie une SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED erreur.

• image_enabled (non compatible) : facultatif. Indique si vous souhaitez générer les images requises pour la campagne Performance Max (par exemple, les types d'images horizontales, carrées et de logo). Laissez ce champ non défini ou false ; le définir sur true n'est pas compatible et renvoie une SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED erreur.

Détails de la réponse

Le message GeneratePMaxDraftCampaignResponse renvoie les noms de ressource de la campagne Performance Max brouillon générée et de ses entités associées :

• pmax_campaign : nom de ressource Campaign de la campagne Performance Max brouillon générée.
• campaign_budget : nom de ressource CampaignBudget associé à la campagne Performance Max générée.
• asset_group : nom de ressource AssetGroup associé à la campagne Performance Max générée.
• assets : liste des noms de ressource Asset associés à la campagne Performance Max générée.
• validated_info: informations de validation ou problèmes de conversion potentiels renvoyés par la vérification de la conversion (rempli lorsque validate_only est défini sur true et à côté des noms de ressource d'entité générés lorsque validate_only est false).

Workflow recommandé

Pour convertir une campagne intelligente, suivez le workflow suivant :

1. Générez la campagne brouillon : appelez SmartCampaignSettingService.GeneratePMaxDraftCampaign en définissant uniquement le resource_name requis (laissez gbp_enabled et image_enabled non définis ou définis sur false). Enregistrez les noms de ressource pmax_campaign, campaign_budget, asset_group et assets renvoyés.
2. Examinez et personnalisez la campagne : étant donné que la campagne Performance Max brouillon est créée avec status = PAUSED et creation_status = INCOMPLETE, inspectez et configurez son budget, son groupe de composants et ses composants.
3. Activez la campagne et mettez en veille la campagne d'origine : lorsque vous êtes prêt à diffuser des annonces, définissez le status de la campagne Performance Max sur ENABLED, puis définissez le status de la campagne intelligente d'origine sur PAUSED pour éviter la diffusion en double.

Remarque : Une fois que gbp_enabled et image_enabled seront activés dans une prochaine version, vous pourrez également migrer automatiquement les établissements de la fiche d'établissement Google et les composants Image.