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 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 détails 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 une 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

Remarque : Tant qu'un ConversionValueRule n'est pas ajouté à un ConversionValueRuleSet, vous ne pourrez pas le voir dans l'UI Google Ads.

Conditions de la règle

Définissez les conditions d'un ConversionValueRule à l'aide des 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 intérêt utilisateur 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 un 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 ou l'autre des listes d'utilisateurs ou des 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 dans ValueRuleDeviceType sont autorisés.

geo_location_condition

 : applique la règle aux impressions dont les informations de localisation correspondent à l'un des geo_target_constants spécifiés pour geo_match_type et ne correspondent pas à l'un 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 de ressources géographiques.

itinerary_condition

 Applique la règle aux impressions dont les termes de recherche incluent des informations spécifiques à l'itinéraire, comme la période de réservation, la durée du voyage ou la date de début du voyage. Pour en savoir plus sur les conditions disponibles, consultez ValueRuleItineraryCondition.

Important : Les règles de valeur de conversion pour les séjours 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 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 remplissent pas les 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 remplit les conditions de la règle. Voici les opérations disponibles :

ADD

Ajoute 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 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 comporte les attributs suivants.

owner_customer

Nom de ressource de l'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 mettre en veille une règle en définissant ce champ sur PAUSED et l'activer en le définissant 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 (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 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 seul 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 status de ENABLED ou PAUSED, l'opération échouera et renverra une erreur DATA_CONSTRAINT_VIOLATION.

dimensions

Liste des 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 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 de l'ensemble de règles est CAMPAIGN, définissez-le sur le nom de ressource auquel l'ensemble 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 est dérivé de ses règles comme suit :

• Si chaque règle référencée par conversion_value_rules a une status de PAUSED, la status de l'ensemble de règles de valeur de conversion 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 :

1. Déterminez le attachment_type d'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 de la conversion, si un tel ensemble de règles existe. Sinon, choisissez l'ensemble de règles où conversion_action_categories est vide.

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

4. Si plusieurs conditions de ciblage géographique correspondent, c'est la zone géographique la plus précise qui est appliquée. Par exemple, si une impression correspond à la fois aux conditions des États-Unis et de la Californie, c'est la Californie qui sera appliquée, car il s'agit d'une zone géographique plus précise.

5. Pour plusieurs conditions d'audience correspondantes, 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. Vous ne pouvez pas appliquer 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, celle qui est utilisée est celle qui définit le plus d'options d'itinéraire, comme "Délai de réservation" 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. Vous pouvez également 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. Voici les valeurs possibles pour ce segment :

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 la première entrée de la collection dimensions de l'ensemble de règles.