Zielgruppenregeln bestimmen, ob eine Person deiner Custom Audience hinzugefügt wird. Die Regeln werden entweder auf die Referrer-URL oder auf bestimmte Events und Daten angewendet.
Gib deine Regeln als JSON-codierte Strings an, die wie folgt aufgebaut sind:
Verwende Zielgruppenregeln für verschiedene Arten von Custom Audiences, darunter Custom Audiences für Websites, Custom Audiences über mobile App und Offline-Custom Audiences. Mehr über Zielgruppenregeln für Interaktionen erfährst du unter Custom Audiences für Interaktionen.
rules
in inclusions
bzw. exclusions
.Bei der Definition einer Zielgruppenregel muss die folgende Struktur beachtet werden:
rule: { "inclusions": <RULE_SET>, "exclusions": <RULE_SET>, }
Name | Beschreibung |
---|---|
Typ: String | Erforderlich. JSON-String aus dem Regelsatz, der den Einschluss definiert. Siehe Syntax von Regelsätzen. |
Typ: String | Erforderlich. JSON-String aus dem Regelsatz, der den Ausschluss definiert. Siehe Syntax von Regelsätzen. |
Beachte für jeden Regelsatz die folgende Struktur:
{ "operator" : <BOOLEAN_OPERATOR>, "rules" : <JSON_RULE>, }
Name | Beschreibung |
---|---|
Typ: String | Erforderlich.
|
Typ: String | Erforderlich. JSON-String der Regeln (Array von Regeln). Siehe Syntax von Ein- und Ausschlussregeln. |
Beachte für jede Ein- oder Ausschlussregel die folgende Struktur:
{ "event_sources" : <EVENT_SOURCE_DEFINITION>, "retention_seconds" : <SECONDS>, "filter" : <FILTER>, "aggregation" : <AGGREGATION>, }
Die Felder aggregation
und retention_seconds
können bearbeitet werden. Die Bearbeitung von aggregation
und retention_seconds
führt jedoch nicht dazu, dass die Zielgruppe gelöscht wird. Dies bedeutet, dass Personen, die nur mit der alten Regel/Aggregation übereinstimmen, weiterhin bis zum Ablaufzeitpunkt in der Zielgruppe enthalten sind.
Name | Beschreibung |
---|---|
Typ: String | Erforderlich. JSON-Objekt, das
Dem |
Typ: Integer | Erforderlich. Ganzzahl (in Sekunden) für das Kund*innenbindungsfenster der Zielgruppe, sollte weniger als |
Typ: String | Erforderlich. JSON-String der Filterregeln. Siehe Filter. |
Typ: Integer | Optional. JSON-String der Aggregatfunktionen. Siehe Aggregatfunktionen. |
Bei der Filterung ist das folgende allgemeine Format zu beachten:
"filter" : { "operator": <BOOLEAN_OPERATOR>, "filters": <FILTER_SET>, }
Name | Beschreibung |
---|---|
Typ: String | Erforderlich.
|
Typ: String | Erforderlich. Array von JSON-Objekten mit Filterregeln. Siehe Syntax von Filterregeln. |
{ "field": <FIELD>, "operator": <COMPARISON_OPERATOR>, "value": <VALUE>, }
Name | Beschreibung |
---|---|
Typ: String | Erforderlich.
|
Typ: String | Erforderlich.
Wird für |
Typ: String | Erforderlich. Falls das Attribut |
Erstelle Custom Audiences basierend auf der Frequenz und Intensität von Verhalten mithilfe der aggregation
im Feld für Zielgruppenregeln. Hiermit definierst du eine Aggregatfunktion. Beispiel:
"aggregation" : { "type":"count", "operator":">", "value":1 }
Name | Beschreibung |
---|---|
Typ: String | Erforderlich. Art der Aggregatfunktion.
|
| Für einige Aggregatfunktionsarten erforderlich. |
Typ: String | Optional.
|
Typ: String | Erforderlich. Sofern der Typ nicht Der Parameter, auf den die Aggregatfunktion angewendet wird |
Typ: String | Erforderlich.
|
Typ: String | Erforderlich. Erwarteter Wert des Parameters |
Beispiel:
"aggregation" : { "type":"count", "operator":">", "value":1 }
Operator | Beschreibung |
---|---|
| Wahr, wenn der Parameterwert des Events größer ist als der angegebene Wert. |
| Wahr, wenn der Parameterwert des Events größer als oder gleich dem angegebenen Wert ist. |
| Wahr, wenn der Parameterwert des Events kleiner ist als der angegebene Wert. |
| Wahr, wenn der Parameterwert des Events kleiner als oder gleich dem angegebenen Wert ist. |
| Wahr, wenn der Parameterwert des Events gleich dem angegebenen Wert ist. Hinweis: Dies trifft auch dann zu, wenn kein Operator festgelegt wurde, also „'x' : { 'eq' : 'y' }“ ist identisch mit „'x' : 'y' }“. |
| Wahr, wenn der Parameterwert des Events ungleich dem angegebenen Wert ist. |
| Wahr, wenn der Parameterwert des Events als String nicht den angegebenen String enthält. Wert von „shoe12345“ erfüllt „contains“, wenn der angegebene Wert „shoe“ ist. |
| Wahr, wenn der Parameterwert des Events als String nicht den angegebenen String enthält. Wert von „shoe12345“ erfüllt „not_contains“, wenn der angegebene Wert „purse“ ist. |
| „contains“, ohne Beachtung der Groß-/Kleinschreibung |
| „not contains“, ohne Beachtung der Groß-/Kleinschreibung |
| Wahr, wenn der Parameterwert des Events mit beliebigen Strings in einem bestimmten Array übereinstimmt. |
| Wahr, wenn der Parameterwert des Events mit keinen Strings in einem bestimmten Array übereinstimmt. |
| „is_any“, ohne Beachtung der Groß-/Kleinschreibung |
| „is_not_any“, ohne Beachtung der Groß-/Kleinschreibung |
| Wahr, wenn der Parameterwert des Events mit dem genannten String beginnt |
| „starts_with“, Groß-/Kleinschreibung egal |
| Stimmt mit einem regulären Ausdruck überein, z. B. \"example\.com.*purchase$\". Die PCRE-Grammatik wird vollständig unterstützt. |
Übereinstimmung mit allen Verweis-URLs, die in den letzten 30 Tagen den String „shoes“ enthalten:
{ "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" } ] }, } ] } }
Übereinstimmung mit ViewContent
-Events, bei denen der Artikelpreis in den letzten 30 Tagen größer oder gleich 100 USD ist. Erwäge die Verwendung dieser Regel für das folgende Event:
_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" } ] } ] } } ] } }
Siehe Custom Audiences über mobile App, Custom Audience-Beispielregeln.
Regeln haben die folgenden Operatoren und Daten oder Events:
Operatoren | Filtertyp |
---|---|
| Enthält einen Substring, ohne Beachtung der Groß-/Kleinschreibung |
| Enthält keinen Substring, ohne Beachtung der Groß-/Kleinschreibung |
| Enthält einen Substring, mit Beachtung der Groß-/Kleinschreibung |
| Enthält keinen Substring, mit Beachtung der Groß-/Kleinschreibung |
| Ist gleich, mit Beachtung der Groß-/Kleinschreibung |
| Ist ungleich, mit Beachtung der Groß-/Kleinschreibung |
| Kleiner als, nur numerische Felder |
| Kleiner als oder gleich, nur numerische Felder |
| Größer als, nur numerische Felder |
| Größer als oder gleich, nur numerische Felder |
| Stimmt mit einem regulären Ausdruck überein, z. B. |
Daten | Gefilterte Daten |
---|---|
| Vollständig kommentierte URL der besuchten Webseite |
| Domäne der besuchten Webseite |
| Pfad der besuchten Webseite ohne Domäne |
| Name des Pixel- |
| Gerät, das auf die Webseite zugegriffen hat:
|
beliebiges | Jedes zu |
Gib jede Regel als JSON-codierten String an.