Règles de valeur de conversion

Les règles de valeur de conversion vous permettent de définir des actions qui modifieront la valeur d'une conversion en fonction de la catégorie de l'ConversionAction et des dimensions suivantes d'une impression :

  • Appartenance à une audience
  • Emplacement physique ou lieu d'intérêt
  • Appareil
  • Itinéraire de voyage

Vous pouvez utiliser l'API Google Ads pour définir des règles de valeur de conversion, les combiner dans un ensemble de règles de valeur de conversion, puis appliquer cet ensemble à l'ensemble de votre compte Google Ads ou à une campagne spécifique. Les segments des rapports de l'API Google Ads fournissent des répartitions qui vous permettent de comparer les parties d'origine, non ajustées et ajustées de vos valeurs de conversion.

Créer des règles

La première étape pour utiliser les règles de valeur de conversion consiste à créer au moins un ConversionValueRule, qui se compose des éléments suivants :

  • Les conditions qui déterminent quand la règle est appliquée
  • Action à effectuer lorsque la règle est appliquée

Par exemple, la charge utile JSON suivante pour ConversionValueRuleService.MutateConversionValueRules crée une règle qui multiplie les valeurs de conversion par 1.5 pour les impressions sur mobile :

{
  "operations": [
    {
      "create": {
        "action": {
          "operation": "MULTIPLY",
          "value": 1.5
        },
        "deviceCondition": {
          "deviceTypes": ["MOBILE"]
        }
      }
    }
  ]
}

Conditions de la règle

Définissez les conditions d'un ConversionValueRule avec les champs suivants :

audience_condition
Applique la règle aux impressions associées à une ou plusieurs audiences. Spécifiez les noms de ressources de chaque liste d'utilisateurs ou centre d'intérêt des utilisateurs à l'aide des champs user_lists ou user_interests. Pour récupérer les noms de ressources des listes d'utilisateurs ou des centres d'intérêt des utilisateurs disponibles, envoyez une requête searchStream ou search de GoogleAdsService, où la clause FROM de la requête est respectivement user_list ou user_interest.
Si un audience_condition contient plusieurs listes d'utilisateurs ou centres d'intérêt des utilisateurs, une impression correspondra à la règle si elle est associée à l'un des centres d'intérêt ou l'une des listes d'utilisateurs.
device_condition
Applique la règle si l'appareil de l'impression correspond à l'un des device_types spécifiés. Seuls les types d'appareils de ValueRuleDeviceType sont autorisés.
geo_location_condition
Applique la règle aux impressions pour lesquelles les informations de localisation correspondent à l'un des geo_target_constants spécifiés pour geo_match_type, et ne correspondent à aucun des excluded_geo_target_constants pour excluded_geo_match_type. Consultez le guide sur le ciblage géographique pour savoir comment récupérer les noms des ressources de localisation.
itinerary_condition
Applique la règle aux impressions pour lesquelles les termes de recherche incluent des informations spécifiques au séjour, comme la période de réservation, la durée du voyage ou le jour de début du voyage. Pour en savoir plus sur les conditions disponibles, consultez ValueRuleItineraryCondition.

Vous pouvez spécifier au maximum deux des éléments audience_condition, device_condition, geo_location_condition ou itinerary_condition sur chaque ConversionValueRule.

Une règle sans condition spécifiée s'applique aux impressions qui ne répondent pas aux conditions d'une règle plus spécifique du même ensemble de règles.

Action de règle

Une règle doit comporter un seul action, qui se compose d'un operation et d'un value. L'action définit comment ajuster la valeur d'une conversion qui remplit les conditions de la règle. Les opérations disponibles sont les suivantes :

ADD
Ajoute value à la valeur d'origine de la conversion. La valeur value doit être supérieure à 0.
MULTIPLY
Multiplie la valeur d'origine de la conversion par le value spécifié. La valeur de value doit être supérieure ou égale à 0.5, et inférieure ou égale à 10.
SET

Définit la valeur de conversion sur la valeur value spécifiée. La valeur value doit être supérieure à 0.

Vous ne pouvez utiliser une règle avec l'action SET que dans un ensemble de règles qui remplit les conditions décrites dans Créer un ensemble de règles.

Autres attributs de règle

En plus des conditions et d'une action, un ConversionValueRule possède les attributs suivants.

owner_customer
Nom de ressource de l'élément Customer propriétaire de la règle. Utilisez cette option pour déterminer si une règle est définie dans le compte ou dans l'un de ses comptes administrateur.
status
État de la règle. Vous pouvez suspendre une règle en définissant ce champ sur PAUSED et activer une règle suspendue en définissant ce champ sur ENABLED.

Créer des ensembles de règles

Une fois que vous disposez d'au moins un ConversionValueRule, vous pouvez créer un ConversionValueRuleSet, qui se compose des éléments suivants :

conversion_action_categories

Liste des catégories d'actions de conversion auxquelles cet ensemble de règles s'applique. Si la liste est vide, l'ensemble de règles s'applique à toutes les catégories. Si la liste n'est pas vide, elle doit contenir une seule entrée de type STORE_VISIT ou STORE_SALE.

Vous ne pouvez définir la liste des catégories d'actions de conversion que lors de la création de l'ensemble de règles.

conversion_value_rules

Noms de ressources des règles à inclure dans l'ensemble.

Cette liste ne peut contenir une règle qui utilise l'action SET que si l'une des conditions suivantes est remplie :

  • Votre compte figure sur la liste d'autorisation et le champ conversion_action_categories de l'ensemble de règles est vide.
  • Le conversion_action_categories de l'ensemble ne contient qu'une seule entrée de STORE_VISIT ou STORE_SALE, le dimensions de l'ensemble ne contient qu'une entrée pour NO_CONDITION, et aucun des champs de condition de la règle n'est défini.
dimensions

Liste de valeurs d'énumération ValueRuleSetDimension qui indique les conditions que les règles de l'ensemble peuvent utiliser. Par exemple, si dimensions contient GEO_LOCATION et DEVICE, vous pouvez ajouter des règles avec geo_location_condition ou device_condition à l'ensemble, mais vous ne pouvez pas ajouter de règle avec audience_condition.

Cette liste ne peut pas être vide et peut contenir au maximum deux entrées.

La première entrée de cette liste détermine la valeur qui s'affiche pour segments.conversion_value_rule_primary_dimension dans metrics.

Si cette liste contient une entrée pour NO_CONDITION, alors :

  • NO_CONDITION doit être la seule entrée de la liste.
  • La liste des conversion_action_categories de l'ensemble ne doit contenir qu'une seule entrée de STORE_VISIT ou STORE_SALE.
  • La liste de conversion_value_rules ne peut contenir aucune règle pour laquelle audience_condition, device_condition ou geo_location_condition est défini.
attachment_type

Définissez cette valeur sur CUSTOMER pour créer un ensemble de règles qui s'applique à l'ensemble du compte, ou sur CAMPAIGN pour créer un ensemble de règles pour une campagne spécifique.

campaign

Si le attachment_type de l'ensemble de règles est CAMPAIGN, définissez-le sur le nom de la ressource à laquelle l'ensemble de règles s'applique.

Comme les règles, un ensemble de règles possède également un owner_customer et un status. Toutefois, le status d'un ensemble de règles est en lecture seule et est dérivé de ses règles comme suit :

  • Si chaque règle référencée par conversion_value_rules a un status de PAUSED, l'ensemble de règles de valeur de conversion status sera PAUSED.
  • Sinon, l'ensemble de règles de valeur de conversion status sera ENABLED.

Supprimer des règles et des ensembles de règles

  • Un ConversionValueRuleSet doit comporter au moins une règle de valeur de conversion PAUSED ou ENABLED.

  • La suppression d'un ConversionValueRule référencé dans le conversion_value_rules d'un ConversionValueRuleSet PAUSED ou ENABLED échouera.

  • La suppression d'un ConversionValueRuleSet ne modifie pas le status de chaque ConversionValueRule référencé par l'ensemble.

  • Une fois qu'un ConversionValueRuleSet est supprimé, les requêtes search et searchStream pour la ressource conversion_value_rule_set ne renvoient plus l'ensemble supprimé.

Priorité des règles et des ensembles de règles

Google Ads utilise la logique suivante pour sélectionner et appliquer au maximum une règle à chaque conversion. Pour en savoir plus sur ces règles, consultez le Centre d'aide Google Ads :

  1. Déterminez le attachment_type des ensembles de règles à prendre en compte. S'il existe des ensembles de règles avec attachment_type = CAMPAIGN et campaign définis sur la campagne associée à l'impression, ne tenez compte que des ensembles de règles au niveau de la campagne. Sinon, ne tenez compte que des ensembles de règles au niveau du client.

  2. Parmi les ensembles de règles à prendre en compte, choisissez celui où conversion_action_categories n'est pas vide et contient la catégorie de l'action de conversion, s'il existe un tel ensemble de règles. Sinon, choisissez l'ensemble de règles où conversion_action_categories est vide.

  3. Évaluez les règles de l'ensemble de règles choisi dans l'ordre dans lequel elles apparaissent dans conversion_value_rules, puis sélectionnez la première règle dont les conditions correspondent à l'impression.

  4. Si plusieurs conditions de géolocalisation correspondent, la position la plus précise est appliquée. Par exemple, si une impression correspond à la fois aux conditions "États-Unis" et "Californie", la condition "Californie" sera appliquée, car elle est plus précise.

  5. Si plusieurs conditions d'audience correspondent, la hiérarchie d'attribution d'audience existante sera appliquée. En cas d'égalité entre deux règles d'un ensemble, une règle "Multiplier" est sélectionnée en priorité par rapport à une règle "Ajouter". Si la situation d'égalité persiste (autrement dit, s'il existe plusieurs règles "Multiplier"), c'est la règle dont l'ajustement de multiplication est le plus élevé qui est sélectionnée.

  6. Il ne peut pas y avoir plusieurs conditions d'appareil correspondantes, car les catégories d'appareils s'excluent mutuellement.

  7. Pour les conditions de séjour, la règle la plus spécifique s'applique. Cela signifie que si plusieurs règles correspondent à une conversion donnée, la règle utilisée est celle qui comporte le plus grand nombre d'options de séjour définies, telles que "Période de réservation à l'avance" ou "Durée du voyage".

Métriques

Les champs metrics.conversions_value et metrics.all_conversions_value, ainsi que les champs dérivés de ces métriques, reflètent les modifications apportées par les ensembles de règles de valeur de conversion. En outre, vous pouvez inclure segments.conversion_value_rule_primary_dimension dans votre requête pour obtenir plus d'informations sur la façon dont les règles ont été appliquées. Les valeurs possibles pour ce segment sont les suivantes :

NO_RULE_APPLIED
Valeurs des conversions auxquelles aucune règle n'a été appliquée.
ORIGINAL
Valeur d'origine des conversions auxquelles une règle a été appliquée.
GEO_LOCATION, DEVICE, AUDIENCE ou NO_CONDITION
Valeur des conversions après l'application d'une règle, regroupées par la première entrée de la collection dimensions de l'ensemble de règles.