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 suivantes d'une impression:

• 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 ce dernier à l'ensemble de votre compte Google Ads ou à une campagne spécifique. Dans les rapports de l'API Google Ads, les segments fournissent des données de répartition 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 les règles de valeur de conversion, la première étape consiste à créer au moins un élément ConversionValueRule, qui comprend les é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

La règle s'applique 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 élément 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

La règle s'applique aux impressions pour lesquelles les informations sur l'établissement correspondent à l'un des geo_target_constants spécifiés pour le geo_match_type, et à aucun des excluded_geo_target_constants pour le excluded_geo_match_type. Consultez le guide sur le ciblage géographique pour savoir comment récupérer les noms des ressources de localisation.

Vous pouvez spécifier un maximum de deux valeurs parmi audience_condition, device_condition ou geo_location_condition pour 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 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 de value doit être supérieure à 0.

MULTIPLY

Multiplie la valeur d'origine de la conversion par la valeur value spécifiée. 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 le value spécifié. La valeur de 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 la section Créer un ensemble de règles ci-dessous.

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 auquel appartient la règle. Il vous permet de 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éation d'un jeu de règles

Une fois que vous disposez d'au moins un ConversionValueRule, vous pouvez créer un ConversionValueRuleSet, qui comprend les é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 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 utilisant l'action SET que si l'une des conditions suivantes est remplie:

• Votre compte est sur la liste d'autorisation et le champ conversion_action_categories de l'ensemble de règles est vide.
• La propriété conversion_action_categories de l'ensemble ne contient qu'une seule entrée STORE_VISIT ou STORE_SALE, la propriété 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 le conversion_value_rules d'un autre ensemble de règles avec la valeur status 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 ne peut pas être vide et peut contenir deux entrées au maximum.

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 que contenir une seule entrée 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.

La première entrée de cette liste détermine la valeur qui apparaît 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 le paramètre attachment_type de l'ensemble de règles est défini sur CAMPAIGN, définissez ce paramètre sur le nom de la ressource à laquelle l'ensemble de règles s'applique.

À l'instar des rules, un ensemble de règles possède également un owner_customer et un status. Cependant, la valeur status d'un ensemble de règles est en lecture seule et dérivée de ses règles, comme suit:

• Si chaque règle référencée par conversion_value_rules présente une 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 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 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 les jeux de règles (attachment_type) à prendre en compte. S'il existe au moins des ensembles de règles dont les paramètres attachment_type = CAMPAIGN et campaign sont définis sur la campagne associée à l'impression, seuls les ensembles de règles au niveau de la campagne sont pris en compte. 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, sélectionnez celui dans lequel 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 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 avec des conditions correspondant à l'impression.

Fréquence

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 manière 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.