Nous mettons à jour notre documentation continuellement, mais certaines publications peuvent ne pas encore être disponibles dans votre langue. Pour accéder aux informations les plus récentes, utilisez la version en anglais.

Configurer des règles de conversion

Les règles de conversion sont une fonctionnalité avancée du volet de protection .Elles vous permettent de valider les installations et les engagements utilisateur en appliquant des règles personnalisées que vous définissez.

Solution de croissance :

Pour activer les règles de conversion pour votre compte, contactez sales@adjust.com.

Niveaux des règles de conversion

Les règles de conversion sont disponibles à différents niveaux, chacun offrant un niveau de validation et une profondeur de reporting différents en fonction de vos besoins.

A graphic showing the different pricing tiers for conversion rules.
Base
Core
Suite Protect complète

Ce niveau inclut les fonctionnalités de base de validation de règles :

  • Configuration générale des règles (store, région, version, paramètre, match entre région et campagnes, match entre version et campagnes)
  • Comportement d’attribution des appareils non vérifiés
  • Comportements ignorer l’attribution
  • Rapports de cohorte et de rejet pour les installations et les réattributions
  • Partage de données (callbacks et exportation CSV) pour les installations et les réattributions

Idéal pour : filtrer les boutiques non valides, les régions ou les engagements de campagne non concordants, et signaler le trafic suspect pour examen sans le rejeter purement et simplement.

Avant de commencer

Voici ce que vous devez savoir avant de commencer.

Prérequis

Définir une règle de conversion

Pour configurer une règle de conversion, procédez comme suit :

  1. Sous Protection, sélectionnez Règles de conversion.

  2. Sélectionnez Nouvelle règle de conversion.

  3. Saisissez un nom pour votre règle.

  4. Choisissez l'un des statuts suivants :

    • Live - La règle est appliquée aux attributions immédiatement lorsque les conditions sont remplies.
    • Test - Utilisez ce mécanisme pour tester votre règle de conversion. Pour les règles de conversion avec le statut Test, nous ne modifions pas la source d'attribution.
    • Pause - Votre règle n'est appliquée à aucune attribution.
  5. Sélectionnez le type de la règle. Il détermine les conditions et paramètres disponibles :

  6. Pour les règles Store, Région, Version et Paramètre, choisissez le comportement du fallback d'attribution (appareils non vérifiés ou appareils non approuvés), et si cette option est disponible pour votre type de règle, indiquez si la validation de la règle doit également s'appliquer aux activités post-installation. Les règles Région et campagnes correspondent et Version et campagnes correspondent utilisent plutôt l'option Ignorer l'attribution. Cette étape ne s'applique donc pas à ces règles.

  7. Sous Appliquer la règle à , sélectionnez votre application et, selon le type de règle, les canaux, les filtres de ciblage ou le segment de campagne (canal/campagne/ad group) auquel la règle s'applique.

  8. Sous Définition de la règle , définissez vos conditions ( Si cela se produit ) et choisissez Accepter ou Refuser ( Alors faire ceci ) afin de déterminer à quel résultat de la condition appliquer le traitement de fallback de l'attribution.

  9. Sélectionnez Créer une règle .

Lorsque votre règle est Live , Adjust vérifie les données d'attribution et les compare à la configuration de la règle. Cette action peut modifier vos résultats d'attribution. Ces changements apparaissent dans vos exports de données brutes et dans Datascape. Pour les règles avec le statut Test , nous ne modifions pas la source d'attribution. Les résultats rejetés et non vérifiés sont signalés et visibles dans les rapports Datascape et les données brutes (rappels et exportations CSV). Contrairement au mode en direct, les résultats rejetés ne sont pas partagés avec les partenaires, même si le partage avec les partenaires est configuré pour les rejets. Pour distinguer les résultats des tests des résultats réels, ajoutez l'espace réservé {conversion_rule_status} (test / live) à votre configuration.

Comportements d'attribution

Accepter et refuser

Chaque condition de la règle est évaluée comme Si cela se produit (la condition) → Alors faire ceci (l'action). L'action détermine quel résultat de la condition est soumis au comportement d'attribution défini par la règle.

  • Accepter — Les éléments qui répondent à ces conditions continuent de suivre le flux d'attribution normal. Tout ce qui n'y répond pas est soumis au comportement d'attribution sélectionné.
  • Refuser — Les éléments qui répondent à ces conditions sont soumis au comportement d'attribution sélectionné. Tout ce qui y répond continue poursuit le flux d'attribution normal.

La signification de « soumis au comportement d'attribution » dépend du type de règle :

Remarque:

Les types de règles Store ne prennent actuellement en charge que la valeur Accepter. Tous les autres types de règles ci-dessus prennent en charge Accepter et Refuser.

Appareils non vérifiés

  • Les installations provenant d'appareils non vérifiés sont non vérifiées .

  • Adjust conserve les postbacks et les données agrégées.

    • Les données brutes sont partagées sous forme d'une activité unverified_install pour les appareils non vérifiés.
    • Les sources reçoivent des callbacks install standard sans modifier l'attribution de l'installation .
    • Le reporting des cohortes est disponible jusqu'au niveau des campagnes .
  • Les appareils non vérifiés peuvent être réattribués.

Appareils non approuvés

  • Il s'agit du niveau le plus élevé.

  • Les installations provenant des appareils non approuvés sont rejetés .

    • Les postbacks d'installation sont envoyés, mais l'installation est signalée comme non attribuée .
    • Les sources peuvent recevoir des callbacks rejected_install qui peuvent inclure des champs tels que click_id et le motif de rejet. Ces données sont fournies à des fins de diagnostic et d'analyse de la fraude.
    • Le reporting des cohortes est limité aux totaux de haut niveau uniquement . Il n'y a pas de répartition par canal, canal ou d'autres dimensions granulaires.
  • Les appareils non approuvés ne peuvent pas être réattribués.

Important:

Pour utiliser ce comportement d'attribution en mode Live ou Test, votre compte doit avoir la fonctionnalité Conversion Rules Core activée.
Pour obtenir de l'aide, contactez sales@adjust.com.

Ignorer l'attribution

Le comportement d'attribution pour les règles Région et campagnes correspondent et Version et campagnes correspondent. Contrairement à Appareils non vérifiés et Appareils non approuvés, il ne s'agit pas d'un choix que vous faites, mais du comportement utilisé systématiquement par ces types de règles.

  • La source liée au résultat ignoré de la condition (voir Accepter et Refuser) est exclue de l'attribution de cette installation.
  • Adjust recherche alors le meilleur engagement précédent éligible. Si un engagement est trouvé, l'attribution est affectée à cette source.
  • Si aucun engagement éligible n'est trouvé, alors l'installation est attribuée à Organique .

Étendre la validation des règles aux activités post-installation

Disponible pour les règles Région, Version et Paramètre.

Les activités post-installation ne sont pas réattribuées. Elles sont classées comme rejetées pour la même source que celle à laquelle l'installation est attribuée.

Active l'application de la règle à toutes les activités post-installation (sessions, événements et revenus publicitaires) dans l'application. Y compris l'activité des utilisateurs existants et des installations attribuées antérieurement.

Lorsque cette option est activée, la description Accepter/Refuser est étendue pour s'appliquer également aux activités de post-installation :

  • Accepter + option activée : les installations qui remplissent ces conditions resteront dans le flux d'attribution. Les autres seront attribuées au comportement d'attribution sélectionné. Les activités post-installation qui ne remplissent pas ces conditions sont classées comme refusées.
  • Refuser + option activée : Les installations qui remplissent ces conditions seront attribuées au comportement d'attribution sélectionné. Les autres resteront dans le flux d'attribution. Les activités post-installation qui remplissent ces conditions sont classées comme refusées.
  • Si l'installation a été attribuée à une source valide (c'est-à-dire, non classée comme un appareil non approuvé ) :
    • Les données brutes sont partagées sous la forme d'une activité rejected_session, rejected_event ou rejected_ad_revenue .
    • Les activités sont exposées dans le reporting sous les buckets Sessions rejetées , Événements rejetés ou Revenus publicitaires rejetés .
Remarque:

Pour les règles en cours de Test , les activités rejetées sont signalées et visibles dans les rapports Datascape et les données brutes (callback et exportations CSV). Pour distinguer les résultats des tests des résultats réels, ajoutez l'espace réservé {conversion_rule_status} (test / live) à votre configuration.

Important:

Pour utiliser cette option en mode Live ou Test, votre compte doit avoir la fonctionnalité Conversion Rules Core activée.Pour obtenir de l'aide, contactez sales@adjust.com.

Appliquer la règle à

Chaque type de règle inclut une section Appliquer la règle à qui vous permet de limiter le trafic concerné par la règle :

  • Application — l'application à laquelle la règle s'appliquer. Cette valeur ne peut pas être modifiée une fois la règle créée.
  • Canaux — limitez la règle à des canaux spécifiques ou conservez la valeur Tous pour appliquer la règle à tous les canaux.
  • Filtres cibles (type de règle de version, facultatif) — une ou plusieurs conditions, combinées avec AND , qui déterminent le trafic auquel les conditions de la règle s'appliquent.
Remarque:

Les filtres cibles limitent uniquement les installations concernées par l'application de la règle ; ils n'influent pas sur le résultat Accepter/Refuser de la règle. Une installation qui ne correspond pas à un filtre cible est entièrement hors de la portée de la règle ; elle n'est ni acceptée ni refusée par cette règle.

Pour les règles Région et campagnes correspondent et Version et campagnes correspondent , le champ Appliquer la règle à affiche Application , Canal , Campagne et Ad group à la place, car ces types de règles se limitent à un segment de campagne spécifique plutôt qu'aux seuls canaux.

Types de règle

Store

La règle de type «  Store » permet les installations d'applications depuis le Google Play Store ou l'Apple App Store.

Important:

Le contrôle du store d'applications requiert que votre application intègre le SDK V5 et, au minimum, la version 3.32 de Signature.

Si vous souhaitez configurer la règle du store, procédez comme suit :

  1. Choisissez votre comportement de fallback d'attribution — Appareils non vérifiés ou appareils non approuvés.
  2. Sous Appliquer la règle à , sélectionnez votre application et, éventuellement, limitez la règle à des canaux spécifiques.
  3. Dans Définition de la règle , choisissez le ou les stores autorisés sous Si cela se produit . Pour les applications monoplateformes, seuls les stores correspondant à la plateforme sont affichés.
  4. Sélectionnez Créer une règle .

Avec cette règle, les installations hors des stores autorisés sont attribuées à Appareils non vérifiés ou Appareils non approuvés .

Remarque:

Actuellement, les types de règles de store prennent en charge uniquement Accepter — voir Accepter et Refuser.

Région

La règle de type 'Région' autorise les appareils et les installations provenant de régions spécifiques.

Si vous souhaitez configurer la règle de région, procédez comme suit :

  1. Choisissez votre comportement de fallback d'attribution — Appareils non vérifiés ou appareils non approuvés. Cette règle prend également en charge Étendre la validation des règles aux activités post-installation.

  2. Sous Appliquer la règle à , sélectionnez votre application et, éventuellement, limitez la règle à des canaux spécifiques.

  3. Sous Définition de la règle , choisissez plusieurs régions en définissant des conditions pour Pays :

    1. Type de condition - Défini sur Égal à ou Différent de .
    2. Valeur - Choisissez une valeur dans la liste.
  4. Choisissez Accepter ou Refuser sous Alors faire ceci .

  5. Sélectionnez Créer une règle .

Exemple : Une règle 'Région' avec

  • Type de condition : Égal à
  • Valeur de pays : Japon
  • Alors faire ceci : Accepter
  • Étendre la validation des règles aux activités post-installation : Activé

Interpretation : En qualité de marketeur, je veux uniquement accepter des activités provenant de la région du Japon.

Comportement :
Les installations provenant de l'extérieur du Japon sont traitées comme étant non vérifiées , et toutes les activités de post-installation sont rejetées.

Version

La règle de version vous permet de définir des conditions basées sur les champs spécifiques à la version, comme :

  • Version de l'application
  • Version du SDK
  • Version de Signature
  • Version de l'OS

Vous pouvez utiliser cette règle pour restreindre l'attribution aux appareils exécutant des versions spécifiques. Selon que la règle est définie sur Accepter ou Refuser , les installations qui ne remplissent pas les conditions (ou qui les remplissent, pour Refuser) sont attribuées à votre fallback sélectionné, Non vérifié ou Non approuvé.

Si vous souhaitez configurer la règle de version, procédez comme suit :

  1. Choisissez votre comportement de fallback d'attribution — Appareils non vérifiés ou appareils non approuvés. Cette règle prend également en charge Étendre la validation des règles aux activités post-installation.

  2. Sous Appliquer la règle à , sélectionnez votre application, limitez éventuellement la règle à des canaux spécifiques et, facultativement, ajoutez un ou plusieurs Filtres cibles pour limiter le trafic auquel les conditions de la règle s'appliquent.

    Par exemple, pour appliquer cette règle uniquement aux appareils Android dans une application multiplateforme, ajoutez le filtre cible suivant :

    • Condition : nom de l'OS
    • Type de condition : Égal à
    • Valeur : Android
  3. Dans Définition de la règle , ajoutez une ou plusieurs conditions basées sur la version sous Si cela se produit . Les conditions d'un groupe sont combinées à l'aide de l'opérateur logique AND . Utilisez des groupes distincts pour appliquer l'opérateur logique OR .

  4. Choisissez Accepter ou Refuser sous Alors faire ceci .

  5. Sélectionnez Créer une règle .

Exemple :
En tant que marketeur, je souhaite définir une règle qui suit les exigences de l'équipe de sécurité pour mon application multiplateforme. Il faut uniquement autoriser les installations (la règle ne doit pas s'appliquer aux activités post-installation) sur Android si :

  • La version de l'application est 2.2.1+ et la version de l'OS de l'appareil est 6.0.0+, ou
  • La version de l'application est 2.9.1+ et la version de l'OS est 7.1.2+

Comportement du fallback d'attribution : Appareils non approuvés
Alors faire ceci : Accepter
Étendre les règles de validation aux activités post-installation : Désactivé

Filtres cibles : [Nom de l'OS] [Égal à] [Android]

Définition de la règle :

Groupe 1 [Version de l'application] [Supérieure ou égale à] [2.2.1] [Version de l'OS] [Supérieure ou égale à] [6.0.0]

Groupe 2 [Version de l'application] [Supérieure ou égale à] [2.9.1] [Version de l'OS] [Supérieure ou égale à] [7.1.2]

  • Case 1 : Le nom de l'OS d'installation est iOS

    • Résultat : la règle est ignorée — le filtre cible ne correspond pas, alors la règle ne s'applique pas du tout.
Remarque:

Si la règle n'avait pas inclus le filtre cible du nom de l'OS, l'attribution de l'installation aurait été rejetée car aucune condition ne correspondait.

  • Cas 2 : Le nom de l'OS d'installation est Android, la version de l'application est 2.3, la version de l'OS est 6.1

    • Résultat : La condition correspondait (Groupe 1) Accepté — aucun refus.
  • Cas 3 : Le nom de l'OS d'installation est Android, la version de l'application est 2.1, la version de l'OS est 6.1

    • Résultat : La condition ne correspondait à aucun groupe. Attribution refusée du fait du comportement de fallback.

Détails des conditions

Important:

Faites attention lorsque vous utilisez des opérateurs qui réduisent la condition de façon trop stricte, par exemple : App version = 1.2.1 Si votre application publie une nouvelle version (par exemple, 1.2.2), la règle ne correspondra plus et les nouvelles installations risqueraient d'être rejetées ou non vérifiées.

✅ Une solution plus sécurisée consiste à utiliser une plage ou une limite inférieure, par exemple : App version ≥ 1.2.1

Veillez toujours à ce que vos conditions soient compatibles avec les futures versions de l'application, sauf si vous ciblez volontairement une build spécifique.

Si vous souhaitez cibler une build très spécifique, envisagez de déplacer cette condition vers Filtres cibles . Vous améliorez ainsi la lisibilité des règles et en faciliter la maintenance sur le long terme.

Paramètre

La règle de type 'Paramètre' vérifie si les paramètres du SDK spécifique (par exemple, product_id) sont inclus dans la charge utile et applique l'action sélectionnée s'ils viennent à manquer.

Consultez également:

Paramètres des callbacks de session

Si vous souhaitez configurer la règle de paramètre, procédez comme suit :

  1. Choisissez votre comportement de fallback d'attribution — Appareils non vérifiés ou appareils non approuvés. Cette règle prend également en charge Étendre la validation des règles aux activités post-installation.
  2. Sous Appliquer la règle à , sélectionnez votre application et, éventuellement, limitez la règle à des canaux spécifiques.
  3. Sous Définition de la règle , indiquez les noms des paramètres du SDK à vérifier pour Si cela se produit . Vous pouvez indiquer plusieurs paramètres ; lorsque plusieurs paramètres sont définis, ils doivent tous exister pour que l'activité réussisse le contrôle.
  4. Choisissez Accepter ou Refuser sous Alors faire ceci .
  5. Sélectionnez Créer une règle .
Remarque:

Pour créer des règles de paramètres requis pour chaque instance d'un événement, vous pouvez utiliser la condition Paramètre requis de la règle d'événement avec le contrôle de flux.

Exemple : Une règle 'Paramètre' avec

  • Nom du paramètre : product_id
  • Alors faire ceci : Accepter

Interprétation : En qualité de marketeur, je souhaite accepter uniquement les activités qui incluent le paramètre product_id dans la charge utile.

Comportement :
Les installations qui n'incluent pas le paramètre requis product_id sont considérées Non approuvées , et toutes les activités de post-installation (sessions, événements et revenus publicitaires) qui n'incluent pas le paramètre requis product_id sont rejetées.

Correspondance entre région et campagnes

La règle de type 'Correspondance région et campagnes' autorise les appareils et les installations provenant de la région et des campagnes choisies.

Si vous souhaitez configurer la règle de correspondance région et campagnes, procédez comme suit :

  1. Sous Appliquer la règle à , sélectionnez les valeurs de Application , Canal , Campagne et Ad group pour choisir le segment de campagne.

  2. Sous Définition de la règle , choisissez plusieurs régions en définissant des conditions pour Pays :

    1. Type de condition - Défini sur Égal à ou Différent de .
    2. Valeur - Choisissez une valeur dans la liste.
  3. Choisissez Accepter ou Refuser sous Alors faire ceci .

  4. Sélectionnez Créer une règle .

Exemple : Pour une règle 'Correspondance région & campagnes' avec

  • Valeur de Campagne ‘Canal’ : Moloco
  • Valeur de pays : USA
  • Alors faire ceci : Accepter

Interprétation : Pour la campagne Moloco, je souhaite attribuer les installations provenant de la région des USA.

Comportement : Si une installation provient de l'extérieur du Japon, elle ne sera attribuée à aucune campagne Moloco, même si le dernier engagement (qui a remporté l'attribution) provient de Moloco. Voir Ignorer l'attribution pour savoir comment Adjust traite la recherche de fallback.

Correspondance entre version et campagnes

La règle Correspondance entre version et campagne permet l'attribution uniquement pour les installations qui correspondent à la fois à une version d'application et à une campagne spécifiques.

Vous pouvez utiliser cette règle pour garantir que seules les installations de versions d'application spécifiques sont attribuées aux réseaux choisis. Par exemple :

  • Le réseau A doit uniquement recevoir l'attribution si la version de l'application est 3.0.5.
  • Le réseau B doit uniquement recevoir l'attribution si la version de l'application est 3.0.6 ou 3.0.7.
  • Le réseau WW doit uniquement recevoir l'attribution si la version de l'application contient le suffixe « _ww » (par exemple, 3.0.8_ww).

Pour configurer une règle de correspondance entre version et campagne :

  1. Sous Appliquer la règle à , sélectionnez les valeurs de Application , Canal , Campagne et Ad group pour la campagne que vous souhaitez faire correspondre. Si vous utilisez une application multiplateforme, sélectionnez également les plateformes auxquelles la règle doit s'appliquer.

  2. Sous Définition de la règle , choisissez un Type de condition et une Valeur :

    • Le type de condition doit être une chaîne ou un versionnage sémantique.
    • Pour la valeur, saisissez une ou plusieurs valeurs en fonction du type sélectionné.
    • Adjust compare les valeurs avec :
      • app_version_short sur iOS
      • app_version sur toutes les autres plateformes
  3. Choisissez Accepter ou Refuser sous Alors faire ceci .

  4. Sélectionnez Créer une règle .

Types de condition

Exemple

Pour une règle Correspondance entre version et campagne :

  • Valeur Canal de la campagne : WW
  • Condition de version de l'application : [Contient] _ww

Interprétation : Pour le canal WW, je souhaite attribuer uniquement les installations dont les versions d'application se terminent par _ww.

Comportement : Si une application présente une version qui ne contient pas _ww, elle ne sera attribuée à aucune campagne WW, même si le dernier engagement provenait de WW. Voir Ignorer l'attribution pour savoir comment Adjust traite la recherche de fallback.

Gérer votre règle de conversion

Sur la page Règles de conversion , vous pouvez :

  • Afficher une liste de vos règles de conversion.

  • Afficher le statut de la règle et modifier son statut.

  • Sélectionner (icône d'édition) pour modifier la règle. Vous pouvez modifier le nom, le statut et le type de la règle, ainsi que ses paramètres.

    • Vous ne pouvez pas modifier l'application pour laquelle vous avez créé la règle.
  • Sélectionner (icône de suppression) pour supprimer la règle.

Reporting

Vous trouverez ici des détails sur la façon dont Adjust reporte les données de règles de conversion dans Datascape. Les rapports sont structurés de la façon suivante :

Attribution modifiée à Appareils non vérifiés

Niveau de structure de campagneValeur de reporting
Canal
  • Appareils non vérifiés
CampagneType de règle
    • Règle de store, règle de région ou règle de version
Ad group
  • Nom du réseau avec token de lien auquel l'engagement avait d'abord été attribué.
Créatif
  • Campagne à laquelle l'engagement avait d'abord été attribué.

Attribution modifiée à Appareils non approuvés

Niveau de structure de campagneValeur de reporting
Canal
  • Appareils non approuvés
CampagneType de règle
  • Règle de store, règle de région ou règle de version
Ad group
  • Inconnu
Créatif
  • Inconnu

Dimensions

  • Appareils non vérifiés
  • Appareils non approuvés

Métriques

Comportements d'attribution des appareils non vérifiés et non approuvés

  • Installations

    1. Installations refusées par une règle de store
    2. Installations non vérifiées par une règle régionale
    3. Installations non vérifiées par une règle de version
    4. Installations non vérifiées par une règle de paramètre
    5. Installations refusées par une règle de store
    6. Installations refusées par une règle régionale
    7. Installations refusées par une règle de version
    8. Installations rejetées par une règle de paramètre
  • Réattributions

    1. Réattributions non vérifiées par une règle de store
    2. Réattributions non vérifiées par une règle régionale
    3. Réattributions non vérifiées par une règle de version
    4. Réattributions non vérifiées par une règle de paramètre
    5. Réattributions refusées Règle de store
    6. Réattributions refusées Règle de région
    7. Réattributions refusées par une règle de version
    8. Réattributions refusées de la règle de paramètre

Activités de post-installation rejetées

  1. Sessions rejetées par une règle régionale
  2. Événements refusés par une règle régionale
  3. Revenus publicitaires rejetés par une règle régionale
  4. Sessions rejetées par une règle de version
  5. Événements rejetés par une règle de version
  6. Revenus publicitaires rejetés par une règle de version
  7. Réattributions rejetées par une règle de paramètre
  8. Événement rejetés par une règle de paramètre
  9. Revenus publicitaires rejetés par une règle de paramètre

Ignorer l'attribution — métriques

  1. Engagements non vérifiés par une règle de campagne régionale
  2. Clics non vérifiés par une règle de campagne régionale
  3. Impressions non vérifiées par une règle de campagne régionale
  4. Engagements non vérifiés par une règle de campagne de version
  5. Clics non vérifiés par une règle de campagne de version
  6. Impressions non vérifiées par une règle de campagne de version
Consultez également:

Dashboard Protection