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 ConversionAction et des dimensions d'impression suivantes:

• Appartenance à une audience
• Situation géographique ou lieu d'intérêt
• Appareil

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. Dans les rapports de l'API Google Ads, les segments 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

Pour utiliser des règles de valeur de conversion, la première étape consiste à créer au moins un ConversionValueRule, qui comprend les éléments suivants:

• Les conditions qui déterminent le moment où 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'une ConversionValueRule à l'aide des champs suivants:

audience_condition

Cette règle s'applique 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 à l'aide des champs user_lists ou user_interests. Pour récupérer les noms de ressources des listes d'utilisateurs disponibles ou des centres d'intérêt des utilisateurs, envoyez une requête searchStream ou search de GoogleAdsService, où la clause FROM de la requête correspond respectivement à user_list ou user_interest.

Si un audience_condition contient plusieurs listes d'utilisateurs ou centres d'intérêt, une impression correspond à la règle si elle est associée à l'une des listes d'utilisateurs ou des centres d'intérêt.

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 dans 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 l'élément geo_match_type, mais ne correspondent à aucun des excluded_geo_target_constants pour le excluded_geo_match_type. Consultez le guide du ciblage géographique pour découvrir comment récupérer les noms des ressources de lieu.

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

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

Action de règle

Une règle doit avoir un seul élément action, composé d'un élément operation et d'un élément value. L'action définit comment ajuster la valeur d'une conversion répondant aux 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 la valeur value spécifiée. La valeur value doit être supérieure ou égale à 0.5, et inférieure ou égale à 10.

SET

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

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

Autres attributs de règles

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

owner_customer

Nom de la ressource de l'élément Customer auquel appartient la règle. Il vous permet de déterminer si une règle est définie dans le compte ou 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éation d'un jeu de règles

Une fois que vous disposez d'au moins un élément ConversionValueRule, vous pouvez créer un élément ConversionValueRuleSet comprenant les é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 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 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 est ajouté à 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.

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

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 est obligatoire et peut contenir deux entrées au maximum.

Si cette liste contient une entrée pour NO_CONDITION:

• 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 entrée de STORE_VISIT ou STORE_SALE.
• La liste de conversion_value_rules ne peut contenir aucune règle dans laquelle audience_condition, device_condition ou geo_location_condition est défini.

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

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 la valeur attachment_type de l'ensemble de règles est CAMPAIGN, indiquez le nom de la ressource à laquelle l'ensemble de règles s'applique.

À l'instar du rôle rules, un ensemble de règles possède également un owner_customer et un status. Cependant, le status d'un jeu 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 une valeur 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.

Suppression de règles et de jeux de règles

• Un élément ConversionValueRuleSet doit comporter au moins une règle de valeur de conversion définie sur PAUSED ou ENABLED.

• La suppression d'un ConversionValueRule référencé dans l'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'une ConversionValueRuleSet est supprimée, les requêtes search et searchStream pour la ressource conversion_value_rule_set ne renvoient plus l'ensemble supprimé.

Précédence des règles et des jeux de règles

Google Ads utilise la logique suivante pour sélectionner et appliquer au maximum une règle à chaque conversion:

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

2. Parmi les ensembles de règles à prendre en compte, choisissez celui dans lequel conversion_action_categories n'est pas vide et qui contient la catégorie de l'action de conversion de la conversion, le cas échéant. Sinon, choisissez le jeu de règles pour lequel 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.

Rapports

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. Vous pouvez également inclure segments.conversion_value_rule_primary_dimension dans votre requête pour en savoir plus 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 pour lesquelles 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 la première entrée de la collection dimensions de l'ensemble de règles.