Show Menu
THEMEN×

Segmentsuche

Die Segmentsuche wird verwendet, um konfigurierbare Felder zu suchen und zu indizieren, die in verschiedenen Datenquellen enthalten sind, und sie in Echtzeit zurückzugeben.
Dieses Handbuch enthält Informationen zum besseren Verständnis der Segmentsuche und enthält Beispiel-API-Aufrufe zum Ausführen grundlegender Aktionen mit der API.

Erste Schritte

Die in diesem Handbuch verwendeten API-Endpunkte sind Teil der Segmentierungs-API. Bevor Sie fortfahren, lesen Sie bitte das Entwicklerhandbuch für die Segmentierung .
Insbesondere enthält der Abschnitt "Erste Schritte"des Segmentierungsentwicklerhandbuchs Links zu verwandten Themen, eine Anleitung zum Lesen der Beispiel-API-Aufrufe in diesem Dokument und wichtige Informationen zu erforderlichen Kopfzeilen, die für die erfolgreiche Durchführung von Aufrufen der Experience Platform-API erforderlich sind.
Zusätzlich zu den erforderlichen Kopfzeilen, die im Abschnitt "Erste Schritte"beschrieben werden, benötigen alle Anforderungen an die Segmentsuche-API die folgende zusätzliche Kopfzeile:
  • x-ups-search-version: "1.0"

Mehrere Namensraum durchsuchen

Dieser Suchendpunkt kann verwendet werden, um über verschiedene Namensraum hinweg zu suchen und eine Liste der Suchzählergebnisse zurückzugeben. Es können mehrere Parameter verwendet werden, die durch das kaufmännische Und (&) getrennt werden.
API-Format
GET /search/namespaces?schema.name={SCHEMA}
GET /search/namespaces?schema.name={SCHEMA}&s={SEARCH_TERM}

Parameter
Beschreibung
schema.name={SCHEMA}
(Erforderlich) Dabei stellt den Schema-Klassenwert dar, der den Suchobjekten zugeordnet ist. Derzeit wird nur _xdm.context.segmentdefinition unterstützt.
s={SEARCH_TERM}
(Optional) Wobei eine Abfrage darstellt, die der Implementierung der Lucene-Suchsyntax durch Microsoft entspricht. Wenn kein Suchbegriff angegeben ist, werden alle damit verbundenen Datensätze zurückgegeben schema.name . Eine ausführlichere Erläuterung finden Sie im Anhang dieses Dokuments.
Anfrage
curl -X GET \
    https://platform.adobe.io/data/core/ups/search/namespaces?schema.name=_xdm.context.segmentdefinition \
    -H 'Authorization: Bearer {ACCESS_TOKEN}' \
    -H 'Content-Type: application/json' \
    -H 'x-api-key: {API_KEY}' \
    -H 'x-gw-ims-org-id: {IMS_ORG}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}' \
    -H 'x-ups-search-version: 1.0' 

Antwort
Eine erfolgreiche Antwort gibt HTTP-Status 200 mit den folgenden Informationen zurück.
{
  "namespaces": [
    {
      "namespace": "AAMTraits",
      "displayName": "AAMTraits",
      "count": 45
    },
    {
      "namespace": "AAMSegments",
      "displayName": "AAMSegment",
      "count": 10
    },
    {
      "namespace": "SegmentsAISegments",
      "displayName": "SegmentSAISegment",
      "count": 3
    }
  ],
  "totalCount": 3,
  "status": {
    "message": "Success"
  }
}

Einzelne Entitäten suchen

Mit diesem Suchendpunkt kann eine Liste aller im Volltext indexierten Objekte innerhalb des angegebenen Namensraums abgerufen werden. Es können mehrere Parameter verwendet werden, die durch das kaufmännische Und (&) getrennt werden.
API-Format
GET /search/entities?schema.name={SCHEMA}&namespace={NAMESPACE}
GET /search/entities?schema.name={SCHEMA}&namespace={NAMESPACE}&s={SEARCH_TERM}
GET /search/entities?schema.name={SCHEMA}&namespace={NAMESPACE}&entityId={ENTITY_ID}

Parameter
Beschreibung
schema.name={SCHEMA}
(Erforderlich) Dabei enthält den mit den Suchobjekten verknüpften Schema-Klassenwert. Derzeit wird nur _xdm.context.segmentdefinition unterstützt.
namespace={NAMESPACE}
(Erforderlich) Dabei enthält den Namensraum, in dem Sie suchen möchten.
s={SEARCH_TERM}
(Optional) Wobei eine Abfrage enthält, die der Implementierung der Lucene-Suchsyntax durch Microsoft entspricht. Wenn kein Suchbegriff angegeben ist, werden alle damit verbundenen Datensätze zurückgegeben schema.name . Eine ausführlichere Erläuterung finden Sie im Anhang dieses Dokuments.
entityId={ENTITY_ID}
(Optional) Schränkt Ihre Suche auf den mit angegebenen Ordner ein.
limit={LIMIT}
(Optional) Dabei stellt die Anzahl der zurückzugebenden Suchergebnisse dar. Der Standardwert lautet 50.
page={PAGE}
(Optional) Dabei steht für die Seitenzahl, die zur Paginierung der Ergebnisse der gesuchten Abfrage verwendet wird. Bitte beachten Sie, dass die Seitenzahl um 0 Beginn ist.
Anfrage
curl -X GET \
    https://platform.adobe.io/data/core/ups/search/entities?schema.name=_xdm.context.segmentdefinition&namespace=AAMSegments \
    -H 'Authorization: Bearer {ACCESS_TOKEN}' \
    -H 'Content-Type: application/json' \
    -H 'x-api-key: {API_KEY}' \
    -H 'x-gw-ims-org-id: {IMS_ORG}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}' \
    -H 'x-ups-search-version: 1.0' 

Antwort
Eine erfolgreiche Antwort gibt HTTP-Status 200 zurück, wobei die Ergebnisse mit der Abfrage der Suche übereinstimmen.
{
  "entities": [
    {
       "id": "1012667",
       "base64EncodedSourceId": "RFVGamdydHpEdy01ZTE1ZGJlZGE4YjAxMzE4YWExZWY1MzM1",
       "sourceId": "DUFjgrtzDw-5e15dbeda8b01318aa1ef533",
       "isFolder": true,
       "parentFolderId": "974139",
       "name": "aam-47995 verification (100)"
    },
    {
       "id": "14653311",
       "base64EncodedSourceId": "REVGamduLVgzdy01ZTE2ZjRhNjc1ZDZhMDE4YThhZDM3NmY1",
       "sourceId": "DEFjgn-X3w-5e16f4a675d6a018a8ad376f",
       "isFolder": false,
       "parentFolderId": "324050",
       "name": "AAM - Heavy equipment",
       "description": "AAM - Acme Equipment"
    }
 
 ],
  "page": {
    "totalCount": 2,
    "totalPages": 1,
    "pageOffset": 0,
    "pageSize": 10
  },
  "status": {
    "message": "Success"
  }
}

Abrufen von Strukturinformationen zu einem Suchobjekt

Mit diesem Suchendpunkt können Sie die Strukturinformationen zum angeforderten Suchobjekt abrufen.
API-Format
GET /search/taxonomy?schema.name={SCHEMA}&namespace={NAMESPACE}&entityId={ENTITY_ID}

Parameter
Beschreibung
schema.name={SCHEMA}
(Erforderlich) Dabei enthält den mit den Suchobjekten verknüpften Schema-Klassenwert. Derzeit wird nur _xdm.context.segmentdefinition unterstützt.
namespace={NAMESPACE}
(Erforderlich) Dabei enthält den Namensraum, in dem Sie suchen möchten.
entityId={ENTITY_ID}
(Erforderlich) Die ID des Suchobjekts, über das Sie die Strukturinformationen abrufen möchten, angegeben mit .
Anfrage
curl -X GET \
    https://platform.adobe.io/data/core/ups/search/taxonomy?schema.name=_xdm.context.segmentdefinition&namespace=AAMSegments&entityId=porsche11037 \
    -H 'Authorization: Bearer {ACCESS_TOKEN}' \
    -H 'Content-Type: application/json' \
    -H 'x-api-key: {API_KEY}' \
    -H 'x-gw-ims-org-id: {IMS_ORG}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}' \
    -H 'x-ups-search-version: 1.0' 

Antwort
Eine erfolgreiche Antwort gibt HTTP-Status 200 mit detaillierten Strukturinformationen zum angeforderten Suchobjekt zurück.
{
    "taxonomy": [
        {
            "id": "0",
            "base64EncodedSourceId": "RFVGZ01BLTVlNjgzMGZjMzk3YjQ1MThhYWExYTA4Zg2",
            "name": "AAMTraits for Cars",
            "parentFolderId": "root"
        },
        {
            "id": "150561",
            "base64EncodedSourceId": "RFVGamdpRk1BZy01ZTY4MzBmYzM5N2I0NTE4YWFhMWEwOGY1",
            "name": "Fast Cars",
            "parentFolderId": "carTraits"
        },
        {
            "id": "porsche11037",
            "base64EncodedSourceId": "REFGZ01CLTVlNjczMGZjMzk3YjQ1MThhZGIxYTA4Zg==",
            "name": "Porsche",
            "parentFolderId": "redCarsFolderId"
        }
    ],
    "status": {
        "message": "Success"
    }
}

Nächste Schritte

Nach dem Lesen dieses Handbuchs haben Sie nun ein besseres Verständnis dafür, wie die Segmentsuche funktioniert. Weitere Informationen zur Segmentierung finden Sie in der Segmentierungsübersicht .

Anhang

Die folgenden Abschnitte enthalten zusätzliche Informationen zur Funktionsweise von Suchbegriffen. Suchbegriffe werden wie folgt geschrieben: s={FieldName}:{SearchExpression} . Um beispielsweise nach einem Segment namens AAM oder Platform zu suchen, würden Sie die folgende Abfrage verwenden: s=segmentName:AAM%20OR%20Platform .
! Für Best Practices sollte der Ausdruck für die Suche wie oben gezeigt HTML-kodiert sein.

Suchfelder

In der folgenden Tabelle werden die Felder Liste, die im Suchparameter "Abfrage"durchsucht werden können.
Feldname
Beschreibung
folderId
Der oder die Ordner, die die Ordner-ID der angegebenen Suche enthalten.
folderLocation
Der Speicherort bzw. die Orte, an denen sich der Ordnerspeicherort der angegebenen Suche befindet/befinden.
parentFolderId
Das Segment oder der Ordner, das bzw. der die übergeordnete Ordner-ID der angegebenen Suche enthält.
segmentId
Das Segment stimmt mit der Segment-ID Ihrer angegebenen Suche überein.
segmentName
Das Segment stimmt mit dem Segmentnamen Ihrer angegebenen Suche überein.
segmentDescription
Das Segment stimmt mit der Segmentbeschreibung Ihrer angegebenen Suche überein.

Ausdruck suchen

In der folgenden Tabelle werden die Einzelheiten der Funktionsweise von Abfragen bei der Segmentsuche-API Liste.
! Die folgenden Beispiele werden in einem nicht-HTML-kodierten Format angezeigt, um mehr Klarheit zu schaffen. Für Best Practices kodieren Sie Ihren Ausdruck mit HTML.
Beispiel für einen Ausdruck
Beschreibung
foo
Suchen Sie nach einem beliebigen Wort. Dadurch werden Ergebnisse zurückgegeben, wenn das Wort "foo"in einem der durchsuchbaren Felder gefunden wird.
foo AND bar
Eine boolesche Suche. Dadurch werden Ergebnisse zurückgegeben, wenn beide Wörter "foo"und "bar"in einem der durchsuchbaren Felder gefunden werden.
foo OR-Leiste
Eine boolesche Suche. Dadurch werden Ergebnisse zurückgegeben, wenn entweder das Wort "foo"oder das Wort "bar"in einem der durchsuchbaren Felder gefunden werden.
foo NOT-Leiste
Eine boolesche Suche. Dadurch werden Ergebnisse zurückgegeben, wenn das Wort "foo"gefunden wird, das Wort "bar"jedoch in keinem der durchsuchbaren Felder gefunden wird.
name: foo AND bar
Eine boolesche Suche. Dies gibt Ergebnisse zurück, wenn beide Wörter "foo"und "bar"im Feld "name"gefunden werden.
run*
Eine Platzhaltersuche. Die Verwendung eines Sternchen (*) entspricht 0 oder mehr Zeichen. Das bedeutet, dass Ergebnisse zurückgegeben werden, wenn der Inhalt eines durchsuchbaren Feldes ein Wort enthält, das Beginn mit "run"haben. Dies gibt beispielsweise Ergebnisse zurück, wenn die Wörter "läuft", "running", "runner"oder "runt"angezeigt werden.
Cam?
Eine Platzhaltersuche. Verwenden eines Fragezeichens (?) entspricht nur genau einem Zeichen. Das bedeutet, dass Ergebnisse zurückgegeben werden, wenn der Inhalt eines durchsuchbaren Felds mit "cam"und einem zusätzlichen Brief Beginn wird. Dies gibt beispielsweise Ergebnisse zurück, wenn die Wörter "Camp"oder "Cams"angezeigt werden, gibt jedoch keine Ergebnisse zurück, wenn die Wörter "Camera"oder "Campfire"angezeigt werden.
"blauer Schirm"
Eine Wortsuche. Dadurch werden Ergebnisse zurückgegeben, wenn der Inhalt eines durchsuchbaren Feldes den vollständigen Satz "blauer Schirm"enthält.
blue\~
Eine unscharfe Suche. Optional können Sie eine Zahl zwischen 0 und 2 nach der Tilde (~) setzen, um den Bearbeitungsabstand anzugeben. "blue\~1"wäre beispielsweise "blue", "blues"oder "glue". Die unscharfe Suche kann nur auf Begriffe angewendet werden, nicht auf Ausdrücke. Sie können jedoch an das Ende jedes Wortes in einer Wortgruppe Tildes anhängen. So würde z.B. "camping\~ in\~ the\~ Summer\~" mit "camping im Sommer" übereinstimmen.
"hotel flughafen"\~5
Eine Suche nach der Nähe. Diese Art der Suche wird verwendet, um Begriffe zu finden, die in einem Dokument nahe beieinander liegen. So "hotel airport"~5 werden beispielsweise die Begriffe "hotel"und "flughafen"in einem Dokument innerhalb von 5 Wörtern voneinander getrennt.
/a[0-9]+b$/
Eine regelmäßige Suche nach Ausdrücken. Dieser Suchtyp findet eine Übereinstimmung basierend auf dem Inhalt zwischen Schrägstrichen "/", wie in der RegExp-Klasse dokumentiert. Wenn Sie z. B. Dokumente mit "motel"oder "hotel"suchen möchten, geben Sie /[mh]otel/ an. Regelmäßige Suchvorgänge mit Ausdrücken werden mit einzelnen Wörtern abgeglichen.
Weitere Informationen zur Syntax der Abfrage finden Sie in der Lucene-Abfrage-Syntaxdokumentation .