Eine benutzerdefinierte berechnete Attributdefinition erstellen

Mithilfe der CreateCalculatedAttributeDefinitionKundenprofile-API können Sie programmgesteuert Ihr eigenes berechnetes Attribut erstellen, das auf einem benutzerdefinierten Objekttyp basiert.

In diesem Thema zeigen wir, wie Sie mithilfe einer benutzerdefinierten JSON-Datei ein berechnetes Attribut erstellen.

Schritt 1: Erstellen Sie eine JSON-Datei

Erstellen Sie eine JSON-Datei mit dem folgenden Inhalt:

{
   "DomainName": "your-domain-name", 
   "CalculatedAttributeName": "your-calculated-attribute-name",
   "DisplayName": "your-display-name",
   "Description": "your-description",
   "AttributeDetails": {
      "Attributes": [
	     {
		    "Name": "your-attribute-name"
	     }
	   ],
	   "Expression": "{your-object-type.your-attribute-name}"
   },
	"Statistic": "your-statistic",
	"Conditions": {
	   "Range": {
	      "Value": your-range-value,
		  "Unit": "days"
		},
		"ObjectCount": your-object-count,
		"Threshold": {
		   "Value": "your-threshold-value",
		   "Operator": "your-threshold-operator"
		}
   }  
}   

Folgen Sie diesen Richtlinien, um das JSON mit Ihren eigenen Werten anzupassen:

• Attribute: Dies sollte den Namen des Felds aus Ihrem Objekttyp enthalten, das Sie für das berechnete Attribut verwenden möchten. Zwei Attribute, auf die in dieser Liste verwiesen wird, werden unterstützt.

• Ausdruck: Grundlegende mathematische Ausdrücke, die zwischen Attributen ausgeführt werden können, werden unterstützt. Wenn Sie nur ein Attribut haben, sollte es dieses Feld sein. {ObjectTypeName.AttributeName} Andernfalls sollte dieses Feld beide Attribute enthalten, wenn Sie einen mathematischen Ausdruck im Sinn haben.

• Statistik: Dies ist der Vorgang, der ausgeführt wird, wenn Sie eine der Berechnungs-APIs aufrufen, die den Aggregationsvorgang tatsächlich durchführt. Die meisten sind selbsterklärend, aber wir haben Erklärungen für diejenigen hinzugefügt, bei denen das nicht der Fall ist.

  Unterstützte Statistiken

  • FIRST_OCCURRENCEgibt das Attribut zurück, das im Ausdruck des frühesten aufgenommenen Objekts angegeben ist.

  • LAST_OCCURRENCEgibt das im Ausdruck des zuletzt aufgenommenen Objekts angegebene Attribut zurück.

  • COUNTgibt die Anzahl der ausgewählten Daten zurück.

  • SUMgibt die Summe aus den ausgewählten Daten zurück.

  • MINIMUMgibt das Minimum aus den ausgewählten Daten zurück.

  • MAXIMUMgibt das Maximum aus den ausgewählten Daten zurück.

  • AVERAGEgibt den Durchschnitt der ausgewählten Daten zurück.

  • MAX_OCCURRENCEgibt den am häufigsten vorkommenden Wert zurück, der im Ausdruck angegeben ist.

• Bereich: Derzeit werden TAGE unterstützt und berechnete Attribute können auf Daten von bis zu 366 Tagen basieren.

• ObjectCount: Gibt an, auf wie vielen Objekten die Berechnung der berechneten Attribute basieren soll. Werte von 1 bis 100 werden unterstützt.

• Schwellenwert: Wenn Sie statt des exakt berechneten Attributwerts stattdessen wissen möchten, ob er beispielsweise über einem bestimmten Wert liegt, können Sie einen Schwellenwert verwenden.

  Der Schwellenwert kann eine beliebige Zeichenfolge sein, und die folgenden Schwellenwertoperatoren werden unterstützt.

  • GREATER_THAN

  • LESS_THAN

  • EQUAL_TO

  • NOT_EQUAL_TO

Schritt 2: Rufen Sie die CreateCalculatedAttributeDefinition API auf

Nachdem Sie die JSON-Datei mit Ihren Werten erstellt und angepasst haben, rufen Sie die CreateCalculatedAttributeDefinitionAPI auf, wie im folgenden Beispiel gezeigt:

aws customer-profiles create-calculated-attribute-definition --cli-input-json file:///custom_calculated_attribute_cli.json --region region_name

Sie können auch den folgenden Endpunkt verwenden:

https://profile.your-region.amazonaws.com/domains/your-domain-name/calculated-attributes