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
• Position géographique 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 l'ensemble de règles à 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 afin que vous puissiez comparer les portions d'origine, non ajustées et ajustées de vos valeurs de conversion.

Créer des règles

Pour utiliser les règles de valeur de conversion, vous devez d'abord 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

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 de chaque centre d'intérêt des utilisateurs avec les 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 disponibles, envoyez une requête searchStream ou search de GoogleAdsService, où la clause FROM de la requête est user_list ou user_interest, respectivement.

Si une audience_condition contient plusieurs listes d'utilisateurs ou centres d'intérêt des utilisateurs, une impression correspond à la règle si elle est associée à l'une des listes d'utilisateurs ou centres d'intérêt des 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 où les informations de localisation correspondent à l'un des geo_target_constants spécifiés pour le geo_match_type et ne correspondent pas à l'un des excluded_geo_target_constants pour le excluded_geo_match_type. Consultez le guide du ciblage géographique pour savoir comment récupérer les noms des ressources d'établissement.

itinerary_condition

Applique la règle aux impressions où les termes de recherche incluent des informations spécifiques à l'itinéraire, telles que la période de réservation, la durée du voyage ou le jour de début du voyage. Consultez ValueRuleItineraryCondition pour en savoir plus sur les conditions disponibles.

Important:Les règles de valeur de conversion pour les voyages ne sont disponibles que pour les comptes ajoutés à la liste d'autorisation. Contactez votre représentant Google si vous avez besoin d'accéder à cette fonctionnalité.

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

Une règle sans conditions spécifiées 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 de conversion d'une conversion qui répond aux conditions de la règle. Les opérations disponibles sont les suivantes.

ADD

Ajoute l'value à la valeur d'origine de la conversion. value doit être supérieur à 0.

MULTIPLY

Multiplie la valeur d'origine de la conversion par le value spécifié. value doit être supérieur ou égal à 0.5 et inférieur ou égal à 10.

SET

Définit la valeur de conversion sur le value spécifié. value doit être supérieur à 0.

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

Autres attributs de règle

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

owner_customer

Nom de la ressource de l'Customer propriétaire de la règle. Utilisez-le 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 mettre en veille une règle en définissant ce champ sur PAUSED et activer une règle mise en veille en définissant ce champ sur ENABLED.

Créer des ensembles de règles

Une fois que vous avez 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 s'applique cet ensemble de règles. 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 STORE_VISIT ou STORE_SALE.

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

conversion_value_rules

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

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

• Votre compte figure sur la liste d'autorisation, et le 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.

Important :Vous ne pouvez inclure chaque règle de valeur de conversion que dans un ensemble de règles de valeur de conversion. Si le conversion_value_rules contient le nom de ressource d'une règle qui se trouve dans le conversion_value_rules d'un autre ensemble de règles avec status de ENABLED ou PAUSED, l'opération échoue avec une erreur DATA_CONSTRAINT_VIOLATION.

dimensions

Liste des valeurs d'énumération ValueRuleSetDimension qui indiquent 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 doit pas être vide et ne 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 les métriques.

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 des conversion_value_rules ne peut contenir aucune règle où 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 du jeu de règles est CAMPAIGN, définissez-le sur le nom de la ressource à laquelle le jeu de règles s'applique.

Comme les règles, un ensemble de règles comporte également un owner_customer et un status. Toutefois, le status d'un ensemble de règles est en lecture seule et 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, la valeur status de la règle de valeur de conversion définie est 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:

1. Déterminez les attachment_type des ensembles de règles à prendre en compte. Si quelque ensemble de règles avec attachment_type = CAMPAIGN et campaign est défini sur la campagne associée à l'impression, seuls les ensembles de règles au niveau de la campagne sont pris en compte. Sinon, n'examinez que les 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 de la conversion, le cas échéant. Sinon, choisissez l'ensemble de règles où conversion_action_categories est vide.

3. Évaluez les règles du jeu 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. Pour plusieurs conditions de géolocalisation correspondantes, l'emplacement le plus précis est appliqué. Par exemple, si une impression correspond à la fois aux conditions "États-Unis" et "Californie", la Californie s'applique, car il s'agit d'une zone géographique plus précise.

5. Pour plusieurs conditions d'audience correspondant, la hiérarchie d'attribution d'audience existante est 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. Vous ne pouvez pas avoir plusieurs conditions d'appareil correspondant, car les catégories d'appareils s'excluent mutuellement.

7. Pour les conditions d'un itinéraire de voyage, la règle d'itinéraire la plus spécifique est appliquée. 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 d'itinéraire définies, telles que "Période de réservation anticipée" ou "Durée du trajet".

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 en savoir plus sur l'application des règles. 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ée par première entrée de la collection dimensions de l'ensemble de règles.