Sobald Sie das Skript-Tag erfolgreich zu Ihrer Website hinzugefügt haben (siehe „Hinzufügen von Knowledge Tags zu Ihrer Website“), können Sie mithilfe von Einbettungscodes kundenorientierte Inhalte zu Ihren Seiten hinzufügen. Damit können Sie Inhalte von Entitäten, die in Yext gespeichert sind, auf Ihrer Website darstellen. Wenn Sie also den Inhalt einer Entität aktualisieren, wird diese Aktualisierung automatisch auf Ihrer Website angezeigt.

Hinweis: Sie müssen das <script>-Tag zu Ihrer Seite hinzufügen, bevor Sie die eingebetteten Codes zum Hinzufügen von Inhalten verwenden können.

So fügen Sie Ihrer Website kundenorientierte Inhalte hinzu:

1. Klicken Sie in der Navigationsleiste auf Pages und dann auf Knowledge-Tags.
2. Klicken Sie auf die Schaltfläche Knowledge Tags auf Website hinzufügen.
3. Klicken Sie auf die Schaltfläche Entität auswählen  und wählen Sie die gewünschte Entität aus.
4. Wählen Sie ggf. die gewünschte Sprache aus.
5. Wählen Sie ggf. die gewünschten Analytics-Einstellungen aus. 
6. Rufen Sie die eingebetteten Codes für die Felder ab, die von Yext Knowledge Graph hervorgehoben werden sollen. Wenn weitere Entitätsfelder angezeigt werden sollen, klicken Sie auf den Link „Weitere Felder“. 
7. Fügen Sie die eingebetteten Codes überall dort hinzu, wo sie auf Ihrer Website erscheinen sollen.

Beispiel

Sie können das folgende Einbettungs-Tag verwenden, um beliebige Inhalte von Yext-Entitäten direkt auf einer Webseite anzuzeigen. 

<span data-yext-field="name"></span>

Aktualisieren Sie zum Auswählen eines Felds aus Yext den Wert von data-yext-field auf den API-Namen des Felds, das angezeigt werden soll. In dem obigen Beispiel wird das Feld „Name“ angezeigt. Unter „Den API-Namen eines Feldes anzeigen“ finden Sie die API-Namen für Entitätsfelder.

Seiten mit mehreren Entitäten

Wenn Ihre Seite Inhalte für mehrere Entitäten anzeigt, stellen Sie sicher, dass Ihre Einbettungscodes auch die Eigenschaft data-yext-id enthalten, die angibt, welche Daten der Entität im Tag verwendet werden sollen. Zum Beispiel:

Wenn Ihre Seite Inhalte für mehrere Entitäten anzeigt, stellen Sie sicher, dass Ihre Einbettungscodes auch die Eigenschaft data-yext-id enthalten, die angibt, welche Daten der Entität im Tag verwendet werden sollen. Zum Beispiel:

• Wenn Ihre Seite für eine einzige Entität gedacht ist, wird der Adresscode etwa so aussehen:

 <span data-yext-field="address.line1"></span>

• Wenn Ihre Seite mehrere Adressfelder anzeigt, sieht der Adresscode für jede Adresse wie folgt aus:

<span data-yext-field="address.line1" data-yext-id="815"></span>

Um Daten von mehreren Entitäten abzurufen, müssen Sie einen „entity_id“-Parameter pro Entität in Ihre Knowledge-Tag-Anfrage aufnehmen (z. B. entity_id=example1&entity_id=example2).

Benutzerdefinierte Felder

Um Inhalte, die in benutzerdefinierten Feldern gespeichert sind, auf Ihren Seiten anzuzeigen, können Sie Einbettungscodes mit dem folgenden Format erstellen:

<span data-yext-field="c_myCustomField"></span>

Hier ist c_myCustomField der API-Name des benutzerdefinierten Feldes. Das HTML-Tag (im Beispiel das <span>) wird je nach Feldtyp unterschiedlich sein.

Listenfelder

Um ein Listenfeld auf Ihrer Seite anzuzeigen, können Sie eines der folgenden HTML-Tags verwenden, um Inhalte aus Listenfeldtypen auf Ihrer Seite anzuzeigen:

• <ul> – Aufzählungslisten
• <ol> – nummerierte Listen
• <span> – eine durch Komma getrennte Liste in einer Zeile
• <div> – erzeugt eine Reihe von <div>-Elementen, die sich jeweils auf einer separaten Zeile befinden

Zur Anzeige einer Stichpunktliste Ihrer Produkte würden Sie z. B. folgendes Einbettungs-Tag verwenden:

<ul data-yext-field=”products”></ul>

Um ein benutzerdefiniertes Feld anzuzeigen, das eine Liste enthält, würden Sie Folgendes verwenden:

<ul data-yext-field="c_listField"></ul>

Zusätzliche Felder

Nachstehend finden Sie eine Liste mit einigen der Felder, die zum Einbetten von Inhalten in Seiten verwendet werden können. Diese Felder werden hervorgehoben, da Knowledge-Tags die Daten in einem bestimmten Format liefert.

 

Eine vollständige Liste zur Benennung und Formatierung aller anderen Entitätsdaten finden Sie in unserer Dokumentation zur Content-Delivery-API.