Règles d’audience

Les règles d’audience déterminent si une personne est ajoutée à votre audience personnalisée. Les règles sont appliquées soit sur l'URL de référence, soit sur des événements et données spécifiques.

Spécifiez vos règles en tant que chaînes encodées JSON ayant la structure suivante :

• Une règle d’audience contient deux ensembles de règles.
• Chaque ensemble de règles peut contenir une règle d’inclusion ou d’exclusion.
• Chaque règle d’inclusion ou d’exclusion peut contenir des filtres et des fonctions d’agrégation.
• Chaque filtre contient un ensemble de filtres.

Utilisez les règles d’audience pour différents types d’audiences personnalisées, dont les audiences personnalisées de site Web, les audiences personnalisées d’application mobile et les audiences personnalisées hors ligne. Pour les règles d’audience d’interaction, voir Audiences personnalisées d’interaction.

Limites

• Chaque audience peut spécifier jusqu’à 10 règles. Cela comprend le nombre de rules dans les inclusions ou exclusions.
• Chaque règle peut spécifier jusqu’à 100 filtres (nœuds leaf).

Syntaxe des règles d'audience

Pour définir une règle d’audience, il est nécessaire de respecter la structure suivante :

rule: {
   "inclusions": <RULE_SET>,
   "exclusions": <RULE_SET>,
}

Champs disponibles

Syntaxe des ensembles de règles

Pour chaque ensemble de règles, respectez la structure suivante :

{
  "operator" : <BOOLEAN_OPERATOR>,
  "rules" : <JSON_RULE>,
}

Champs disponibles

Syntaxe des règles d'inclusion et d'exclusion

Pour chaque règle d’inclusion ou d’exclusion, respectez la structure suivante :

{
  "event_sources" : <EVENT_SOURCE_DEFINITION>, 
  "retention_seconds" : <SECONDS>,
  "filter" : <FILTER>,
  "aggregation" : <AGGREGATION>, 
}

Champs disponibles

Filtres

Le filtrage obéit à ce format général :

"filter" : {
  "operator": <BOOLEAN_OPERATOR>,
  "filters": <FILTER_SET>,
  }

Champs disponibles

Syntaxe de l’ensemble de filtres

{
    "field": <FIELD>,
    "operator": <COMPARISON_OPERATOR>,
    "value": <VALUE>,
}

Champs disponibles

Fonctions d’agrégation

Vous pouvez créer des audiences personnalisées en fonction de la fréquence et de l’intensité du comportement à l’aide de l’aggregation dans le champ de règle d’audience. Vous définissez ainsi une fonction d’agrégation, par exemple :

"aggregation" : {
  "type":"count",
  "operator":">",
  "value":1
}

Champs disponibles

Par exemple :

"aggregation" : {
  "type":"count",
  "operator":">",
  "value":1
}

Opérateur·ices de comparaison

Exemples

Audiences personnalisées de site Web

Établir une correspondance avec toutes les URL référentes contenant la chaîne « shoes » au cours des 30 derniers jours :

{
    "inclusions": {
        "operator": "or",
        "rules": [
            {
                "event_sources": [
                    {
                        "type": "pixel",
                        "id": "<PIXEL_ID>",
                    }
                ],
                "retention_seconds": 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "url",
                            "operator": "i_contains",
                            "value": "shoes"
                        }
                    ]
                },
            }
        ]
    }
}

Établir une correspondance avec les évènements ViewContent quand le prix de l’article est supérieur ou égal à 100 € au cours des 30 derniers jours. Cette règle peut être utilisée pour l’évènement suivant :

_fbq.push([ 'track', 'ViewContent', { productId: 1234, category: 'Men > Shoes', price: 199 } ]);

{
    "inclusions": {
        "operator": "or",
        "rules": [
            {
                "event_sources": [
                    {
                        "type": "pixel",
                        "id": "<PIXEL_ID>"
                    }
                ],
                "retention_seconds": 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "eq",
                            "value": "ViewContent"
                        },
                        {
                            "operator": "or",
                            "filters": [
                                {
                                    "field": "price",
                                    "operator": ">=",
                                    "value": "100"
                                }
                            ]
                        }
                    ]
                }
            }
        ]
    }
}

Audiences personnalisées d’application mobile

Voir Audiences personnalisées d’application mobile, exemples de règles d’audience personnalisée.

Opérateurs et données ou événements

Les règles comportent les opérateurs et données ou événements suivants :

Fournissez chaque règle sous la forme d’une chaîne encodée JSON.