Ihren Produktkatalog-Feed importieren - Kameleoon Documentation

Dies ist eine Premium-Funktion. Wenden Sie sich an Ihren Customer Success Manager, um sie in Ihrem Kameleoon-Konto zu aktivieren.

Es gibt vier einfache Methoden zur Synchronisation Ihres Produktkatalogs mit Kameleoon:

Mit einer XML-Datei, die alle erforderlichen Metadaten für jedes Ihrer Produkte enthält. Verwenden Sie diese Methode, wenn Sie keinen Data Layer haben und Ihr Katalog weniger als 50.000 Produkte enthält. Sie können die Häufigkeit, mit der Kameleoon Ihren Katalog synchronisieren soll, einfach auf der Seite der Shop-Einstellungen wählen. Sie sollten einmal alle 24 bis 72 Stunden einen XML-Import durchführen, um Kameleoon mit Ihrem Produktbestand zu aktualisieren.
Mit einer Google Merchant Feed-URL. Verwenden Sie diese Methode, wenn Sie Ihr Produkt bereits in Google Merchant Center hochgeladen haben und Ihr Katalog weniger als 50.000 Produkte enthält. Wenden Sie sich an Ihren Kameleoon Customer Success Manager, um diese Methode zu aktivieren. Folgen Sie diesen Schritten, um Google Merchant mit Kameleoon zu synchronisieren.
Über die REST API von Kameleoon. Nutzen Sie die REST API von Kameleoon zur Aktualisierung Ihres Katalogs, wenn Sie regelmäßige Updates benötigen, insbesondere bei Produkten, die aufgrund begrenzter Verfügbarkeit schnell ausverkauft sind.
Über die Product API von Kameleoon. Sie sollten diese Methode verwenden, wenn Sie einen Data Layer haben, der detaillierte Informationen über Ihre Produkte und Produktkategorien enthält. Die Arbeit mit der Kameleoon-API erfordert, dass Sie Metadaten für Produkte und Kategorien aus Ihren Produktseiten (zum Beispiel in einem Data Layer) zur Verfügung haben, die Kameleoon lesen und in unsere Produktempfehlungsalgorithmen einspeisen kann.

Beachten Sie, dass die Begrenzung (gzip-komprimierte Datei) zwar auf 2 GB festgelegt ist, je größer Ihr Katalog jedoch ist, desto länger dauert die Verarbeitung des Feeds, entscheiden Sie sich daher für eine Synchronisation von 6+ Stunden.

Kameleoon markiert automatisch alle nicht im Feed vorhandenen Produkte als nicht vorrätig. Um die Verarbeitungsgeschwindigkeit des Feeds zu verbessern und seine Größe zu reduzieren, empfehlen wir, nicht vorrätige Produkte aus Ihrem Feed auszuschließen.Es ist wichtig zu beachten, dass ein Nachteil der Product-API-Methode darin besteht, dass Kameleoon möglicherweise keine Kenntnis von Produkten hat, wenn diese nicht aktiv von Besuchern gesucht oder durchsucht werden, und sie daher möglicherweise nicht in Produktempfehlungsblöcken vorgeschlagen werden.

Ihren Produkt-Feed mit der Kameleoon Product API synchronisieren

Die Product API betreibt die Produktempfehlungsalgorithmen von Kameleoon und Social-Proofing-Nachrichten, wie zum Beispiel Zähler für Produktimpressionen und -käufe und erweiterte Targeting-Bedingungen. Sobald die Methoden der Product API von Kameleoon auf Ihrer Website aktiviert sind, beginnt Kameleoon mit dem Senden von Produktdetail-Ereignissen, sobald Ihre Besucher eine Produkt- oder Kategorieseite durchsuchen, ein Produkt zu ihrem Warenkorb hinzufügen oder einen Kauf tätigen. Dies ermöglicht auch das Sammeln von Statistiken über ein bestimmtes Produkt (zum Beispiel die Anzahl der Käufe oder Aufrufe in der letzten Stunde oder am letzten Tag) und unterstützt die Erstellung von Zielgruppen, die Sie in unserem Segment-Builder mit vordefinierten Produkt-Targeting-Kriterien verwenden können. Sie müssen unsere Snippets für Produktseite, Kategorieseite, Warenkorbseite und Dankesseite zu Ihrem Quellcode hinzufügen, um Interaktionen mit Ihren Produkten zu verfolgen und unseren Product-Recommendations-Algorithmus zu informieren. Sie können sie auch über unsere Global-Custom-Script-Funktion einfügen.

trackProductView()

Verwenden Sie die Methode trackProductView() auf Produktseiten, um zu verfolgen, wann ein Besucher ein Produkt ansieht. Lesen Sie mehr über die Methode hier.

Stellen Sie sicher, dass Sie alle für Ihre Social-Proofing-Einrichtung erforderlichen Daten bereitstellen. Nur die über die Methode trackProductView() gesendeten Daten können später über den Endpoint obtainProductData() abgerufen werden.

trackCategoryView()

Verwenden Sie die Methode trackCategoryView() auf Kategorieseiten, um zu verfolgen, wann ein Besucher eine Produktkategorie ansieht. Lesen Sie mehr über die Methode hier. Stellen Sie sicher, dass die hier verwendete Kategorie-ID mit der mit der Methode trackProductView() gesendeten übereinstimmt. Lesen Sie mehr über das Category-Objekt hier.

trackAddToCart()

Verwenden Sie die Methode trackAddToCart() auf jeder Seite, auf der ein Besucher ein Produkt zu seinem Warenkorb hinzufügen kann — zum Beispiel die Startseite, Produktseite, Kategorieseite oder Warenkorbseite. Lesen Sie mehr über die Methode trackAddToCart() hier.

trackTransaction()

Verwenden Sie die Methode trackTransaction() auf jeder Seite, die nach Abschluss eines Kaufs oder einer Transaktion durch einen Besucher angezeigt wird. Lesen Sie mehr über die Methode hier.

Kameleoon synchronisiert Ihren gesamten Produktkatalog alle zwei Stunden und markiert nicht vorrätige Produkte automatisch alle 12 Stunden als “nicht verfügbar”. Ein Produkt gilt als nicht verfügbar, wenn das mit der Methode addProductView übergebene Attribut availableQuantity gleich null ist, was sicherstellt, dass die Produktempfehlungen von Kameleoon nur Produkte enthalten, die auf Lager sind. Sie können auch ein Produkt mit dem Attribut availableQuantity als nicht vorrätig festlegen, wenn Sie die Methode addProductView verwenden.

Ihren Produkt-Feed mit einer XML-Datei synchronisieren

Die Synchronisation Ihres Produktkatalogs mit einer XML-Datei umfasst die folgenden Schritte:

Erstellen Sie eine XML-Datei mit allen erforderlichen Metadaten für jedes Ihrer Produkte, Kategorien und Standorte (zum Beispiel Länder oder Standorte, in denen Sie tätig sind und für die unterschiedliche Preise, Lagerbestände oder Details für Ihre Produkte gelten). Die Datei muss von einer entfernten URL aus verfügbar sein. Stellen Sie sicher, dass Sie sie in einem sicheren Bereich (zum Beispiel S3-Bucket) hosten, der für Kameleoon zugänglich ist.
Synchronisieren Sie die XML-Datei mit Kameleoon und wählen Sie das Aktualisierungsintervall, das Ihren Anforderungen entspricht (zum Beispiel stündlich, alle drei Stunden, alle sechs Stunden)
Verfolgen Sie die Ereignisse Ihrer Besucher.

Mehrsprachige Websites werden nicht unterstützt; Sie müssen ein separates Projekt für jede Sprache erstellen und einen Feed für jedes bereitstellen.

Setzen Sie die folgenden IP-Adressen auf die Whitelist, um einen nahtlosen Bildherunterladevorgang sicherzustellen:

95.216.99.81/26
95.216.99.220/26
95.216.23.145/26
95.216.10.183/26
95.216.114.218/26
95.217.32.105/26
95.216.4.144/26
95.216.102.29/26

Schritt 1: Ihren Produkt-Feed erstellen

Der Produkt-Feed muss grundlegende Informationen über Ihren Katalog enthalten. Beachten Sie die folgenden Tabellen für die obligatorischen Attribute, die Sie einbeziehen müssen.

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2022-10-03 22:00">
  <shop>
    <categories>
      <category id="270821163172" parentId="2708" url="https://myurl.com">Adidas</category>
       .......
    </categories>
    <offers>
      <offer id="6737859641508" available="true" leftovers="lot"></offer>
      ......	
    </offers>
   </shop>
</yml_catalog>

Element: yml_catalog

Attribut	Erforderlich	Beschreibung
`date`	Ja	Datum der Generierung des XML-Dokuments. Format sollte sein: YYYY-MM-DD hh:mm

Element: yml_catalog > shop

Element	Erforderlich	Beschreibung
`categories`	Ja	Liste der Shop-Kategorien
`locations`	Ja	Liste der Standorte/Länder, an denen der Shop vertreten ist
`offers`	Ja	Liste der Shop-Produkte

Element: yml_catalog > shop > categories

Das Element categories enthält eine Liste von Kategorie-Elementen. Jede Produktkategorie, die Sie zum Gruppieren oder Taggen Ihrer Produkte verwenden, wird durch ein separates category-Element beschrieben.

Attribut	Erforderlich	Beschreibung
`id`	Ja	Kategorie-ID
`parentId`	Nein	ID der übergeordneten Kategorie
`url`	Nein	Link zur Kategorieseite
`alias`	Nein	Der Alias-Identifikator der Kategorie

Beispiel:

<categories>
  <category id="2" url="http://my-store.com/categories/discount/"> Category level 1</category>
  <category id="8" url="http://my-store.com/categories/men/">Category level 1</category>
  <category id="13" parentId="8" url="http://my-store.com/categories/men/shoes/">Category level 2</category>
  <category id="97" parentId="13" alias="men/shoes/leather" url="http://my-store.com/categories/men/shoes/leather">Category level 3</category>
</categories>

Element: yml_catalog > shop > locations

Das Element locations enthält eine Liste Ihrer Shop-Standorte. Jeder Standort wird durch ein separates location-Element beschrieben. Sie können die folgenden Attribute für das Element locations verwenden:

Attribut	Erforderlich	Beschreibung
`id`	Ja	Standort-ID
`parentId`	Nein	ID des übergeordneten Standorts
`type`	Nein	Standorttyp. Verfügbare Werte: state, city, store
`name`	Nein	Standortname

Beispiel:

<locations>
   <location id="1" type="city" name="New York" />
   <location id="2" type="city" name="Los Angeles" />
   <location id="145" parentId="1" type="store" name="New York City main store" />
</locations>

Element: yml_catalog > shop > offers

Das Element offers enthält Ihre Liste von Produkten. Jedes Produkt wird durch ein separates offer-Element beschrieben.

Wenn alle Varianten eines Produkts in Ihrem Shop unter derselben URL verfügbar sind und es keinen gemeinsamen Identifikator für Produktvarianten gibt, wählt Kameleoon die günstigste Produktvariante aus, wenn dieses Produkt Ihren Besuchern empfohlen wird. Die Verfügbarkeitsflagge in diesem Fall sollte in die folgende Logik passen: Wenn mindestens eine Produktvariante auf Lager ist, gilt das Produkt als auf Lager.

Element: yml_catalog > shop > offers > offer

Sie können die folgenden Attribute für das Element offer verwenden:

Attribut	Erforderlich	Beschreibung
`id`	Ja	Produkt-ID / SKU / EAN
`group_id`	Nein	Produktgruppen-ID. Erforderlich, um Produktvarianten in einer Gruppe zusammenzufassen. Kameleoon wählt die günstigste Variante aus, wenn dieses Produkt Besuchern empfohlen wird
`available`	Ja	Angabe, ob das Produkt auf Lager ist (‘true/false’). Kameleoon macht alle nicht im Feed vorhandenen Produkte automatisch nicht vorrätig. Um die Feed-Verarbeitung zu beschleunigen und ihre Größe zu reduzieren, fügen Sie keine nicht vorrätigen Produkte in Ihren Feed ein.
`leftovers`	Nein	Angabe, wie viel Lagerbestand eines bestimmten Produkts verfügbar ist. Kann einen der folgenden Werte annehmen: one (Produkt ist in einer einzigen Kopie verfügbar), few (Produkt ist in begrenzten Mengen verfügbar — bis zu 10 Einheiten), lot (verfügbar ab 10+ Einheiten des Produkts)

Das Element offer kann die folgenden Tags annehmen:

Element	Erforderlich	Beschreibung
`name`	Ja	Produktname
`picture`	Ja	Produkthauptbild
`price`	Ja	Basispreis des Produkts
`url`	Ja	URL zur Produktdetailseite (beginnend mit HTTP/HTTPS)
`categoryId`	Ja	Produktkategorie. Wenn das Produkt mehreren Kategorien zugeordnet ist, fügen Sie so viele `categoryId`-Elemente wie nötig hinzu
`locations`	Nein	Erforderlich, wenn die Eigenschaften des Produkts (Preis, Verfügbarkeit) je nach Standort unterschiedlich sind. Siehe Tabelle und Beispiel unten
`accessories`	Nein	Liste von Produkten, die ergänzend oder gleichwertig zum aktuellen Produkt sein können. Sie ermöglicht es Ihnen, Produkte zu empfehlen, die in Kombination mit dem aktuellen Produkt (oder als Ersatz dafür) verwendet werden können. Sie wird normalerweise für einen Mode- oder Autoshop benötigt, und dieses Tag ist nur mit dem Algorithmus Store Recommendations kompatibel.
`oldprice`	Nein	Der vorherige Preis des Artikels. Wird verwendet, um den rabattierten Produktpreis in Produktempfehlungsblöcken anzuzeigen.
`price_margin`	Nein	Ein Gewichtungsfaktor der Produkt-Preismarge zwischen 0 und 100. Wird verwendet, um Produkte mit einer höheren Marge in Produktempfehlungsblöcken anzuzeigen.
`barcode`	Nein	Produkt-Barcode oder SKU. Wird für die Suchalgorithmen von Kameleoon verwendet.
`typePrefix`	Nein	Produkttyp (zum Beispiel “mobile phone”, “washing machine”, “corner sofa”). Wird für die Suchalgorithmen von Kameleoon verwendet.
`vendor`	Nein	Hersteller/Marke
`vendorCode`	Nein	Der Code des Herstellers/der Marke. Wird für die Suchalgorithmen von Kameleoon verwendet.
`model`	Nein	Modell und Produktname (zum Beispiel iPhone 17 128GB). Wird für die Suchalgorithmen von Kameleoon verwendet.
`seasonality`	Nein	Saisonalität von Waren. Ermöglicht es Ihnen, dieses Produkt nur in einigen Monaten des Jahres zu empfehlen. Fügen Sie so viele Elemente wie nötig hinzu. Siehe Beispiel unten
`is_new`	Nein	Muss “1” sein, wenn das Produkt neu ist. Erforderlich, wenn Sie den Algorithmus “New arrivals” verwenden
`rating`	Nein	Produktbewertung. Muss einen Wert von null bis fünf annehmen. Muss null sein, wenn das Produkt keine Bewertung hat
`description`	Nein	Produktbeschreibung
`stock_quantity`	Nein	Angabe der Produktbestandsmenge
`tags`	Nein	Alle zusätzlichen Informationen, die das Produkt beschreiben. Wird für die Suchalgorithmen von Kameleoon verwendet. Sie können maximal fünf Tags hinzufügen. Siehe Tabelle und Beispiel unten
`param`	Nein	Wird verwendet, um Filteroptionen auf der von Kameleoon bereitgestellten Suchergebnisseite anzubieten. Fügen Sie so viele param-Elemente wie nötig hinzu. Siehe Beispiel unten
`author`	Nein	Nur erforderlich, wenn Sie Bücher online verkaufen
`publisher`	Nein	Nur erforderlich, wenn Sie Bücher online verkaufen
`series`	Nein	Nur erforderlich, wenn Sie Bücher online verkaufen
`year`	Nein	Nur erforderlich, wenn Sie Bücher online verkaufen
`ISBN`	Nein	Nur erforderlich, wenn Sie Bücher online verkaufen

Beispiel:

<accessories>
    <accessory id="5574" />
    <accessory id="131" />
    <accessory id="99444" />
    <accessory id="334411" />
</accessories>

Element: yml_catalog > shop > offers > offer > locations

Das Element locations enthält eine Liste von Standorten und die Verfügbarkeit und den Preis des aktuellen Produkts an diesen Standorten. Jeder Standort wird durch ein separates Element location innerhalb des offer-Tags beschrieben. Sie können die folgenden Attribute für das Element locations verwenden:

Attribut	Erforderlich	Beschreibung
`id`	Ja	ID des Standorts, an dem das Produkt derzeit gelistet ist. Muss eine ID aus einem der `locations`-Elemente im Shop-Element sein (siehe Abschnitt oben). Fügen Sie so viele Elemente wie nötig hinzu.

Das Produkt wird nur an den im offer-Element aufgeführten Standorten als zum Kauf verfügbar betrachtet. An allen anderen, nicht aufgeführten Standorten wird das Produkt als nicht vorrätig betrachtet. Sie müssen keine Standorte hinzufügen, wenn Ihr Produkt an allen Standorten verfügbar ist, da Kameleoon das Produkt automatisch an allen als vorrätig betrachtet.

Das Element locations kann die folgenden Tags annehmen (nur erforderlich, wenn das Produkt an einigen Ihrer Standorte einen anderen Preis/eine andere Lagerbestandsmenge hat).

Element	Erforderlich	Beschreibung
`price`	Nein	Der Preis des Produkts am aufgeführten Standort
`oldprice`	Nein	Der vorherige Preis des Produkts am Standort
`stock_quantity`	Nein	Lagerbestandsmenge des Produkts am Standort

Element: yml_catalog > shop > offers > offer > fashion

Verwenden Sie das fashion-Tag, wenn Sie Bekleidungsprodukte verkaufen. Das Element fashion kann die folgenden Tags annehmen:

Element	Erforderlich	Beschreibung
`gender`	nein	Produktgeschlecht. Muss “f” (Female) oder “m” (Male) sein.
`type`	nein	Produkttyp. Siehe Tabelle unten für die zulässigen Werte.
`sizes`	nein	Verfügbare Größen des Produkts. Siehe Tabelle unten für die zulässigen Werte.
`color`	nein	Produktfarbe. Siehe Beispiel unten.
`feature`	nein	Produktbesonderheiten. Verwenden Sie dieses Element, um anzugeben, ob das Produkt nur für Erwachsene oder Kinder bestimmt ist. Muss den Wert “child” oder “adult” annehmen.

Geben Sie das Element gender nicht an, wenn es irrelevant ist. Das Produkt wird als “unisex” gekennzeichnet und hat eine niedrigere Empfehlungspriorität als andere Produkte desselben Geschlechts.

Das Element type kann die folgenden Werte annehmen:

Elementwert (gender)	Beschreibung
`shoe`	Schuhe
`shirt`	Hemden, Blusen, Kleider
`tshirt`	T-Shirts
`underwear`	Unterwäsche
`trouser`	Hosen, Jeans, Shorts, Röcke, Bademode
`jacket`	Jacken, Mäntel, Pelzmäntel
`blazer`	Sakkos, Westen, Pullover
`sock`	Socken
`belt`	Gürtel
`hat`	Hüte
`glove`	Handschuhe

Beispiel:

<offer ...>
    ...
    <fashion>
        <gender>f</gender>
        <type>shoe</type>
    </fashion>
</offer>

Der Parameter type ist erforderlich, wenn der Parameter sizes verwendet wird. Sie können eine Liste verfügbarer Größen hinzufügen, indem Sie so viele size-Tags wie nötig innerhalb des Elements sizes hinzufügen (siehe Beispiel unten). Wenn Sie mehrere locations haben und die Verfügbarkeit der Produktgrößen je nach Standort unterschiedlich ist, fügen Sie ein location-Tag mit der Liste der verfügbaren Größen in jedes size-Element ein (siehe Beispiel unten).

Beschreibung	Beispiel
Europäische Größe	`e38`
Internationale Größe	`M`, `L`, `u30`
UK-Größe	`b6`
Höhe (für Kinderprodukte)	`h89-95`
Eine Größe passt allen	`null`

Beispiel:

<offer ...>
    ...
    <fashion>
        <gender>f</gender>
        <type>shoe</type>
        <feature>adult</type>
        <sizes>
            <size>e41</size>
            <size>e42</size>
            <size>e44</size>
            <size>e48</size>
        </sizes>
    </fashion>
</offer>
<offer ...>
    ...
    <fashion>
        <gender>m</gender>
        <type>jacket</type>
        <sizes>
            <size value="M">
              <location id="3"/>
            </size>
        </sizes>
    </fashion>
</offer>

Ein Produkt kann mehrere verfügbare Farben haben. Sie können ein bestimmtes Bild für eine Farbe festlegen, indem Sie ein picture-Attribut hinzufügen. Andernfalls wird das Hauptbild angezeigt.

Beispiel:

<offer ...>
    ...
    <fashion>
        <gender>f</gender>
        <type>shirt</type>
        <color>white</color>
        <color picture="https://example.com/products/shirts/395532-blue.jpg">blue</color>
    </fashion>
</offer>

Element: yml_catalog > shop > offers > offer > auto

Verwenden Sie das auto-Tag, wenn Sie Autoteile und -zubehör verkaufen. Der Algorithmus von Kameleoon ist darauf ausgelegt, einen potenziellen Käufer mit bestimmten Merkmalen, wie der Marke und dem Modell des Autos, automatisch zu erkennen. Er wird verwendet, um Teile und Zubehör in Empfehlungsblöcken anzuzeigen, die nur mit bestimmten Automarken und -modellen kompatibel sind. Das Element auto enthält eine Liste kompatibler Autos. Jede Automarke und jedes Modell wird durch ein separates compatibility-Element beschrieben.

Wenn das Produkt mit allen Autos kompatibel ist, müssen Sie keine compatibility-Elemente hinzufügen. Wenn das Produkt mit allen Automodellen einer Marke kompatibel ist, müssen Sie das Attribut model nicht hinzufügen.

Sie können die folgenden Attribute für das Element compatibility verwenden:

Attribut	Erforderlich	Beschreibung
`brand`	Ja	Automarke
`model`	Nein	Automodell

Wenn das Produkt nur mit einer Liste von Autos kompatibel ist, können Sie auch ein vds-Element für jedes kompatible Auto hinzufügen. Das vds enthält die Vehicle Identification Number (VIN), die als Fingerabdruck des Autos dient. Beispiel:

<offer ...>
    ...
    <auto>
        <compatibility brand="BMW" />
        <compatibility brand="Mini" model="Cooper S" />
        <compatibility brand="Mini" model="Cooper C" />
        <vds>BP8AN5</vds>
        <vds>BP8AN5</vds>
    </auto>
</offer>

Element: yml_catalog > shop > offers > offer > tags

Das Element tags enthält eine Liste von Tags, die dem Produkt zugeordnet sind. Dies ist nützlich zur Verbesserung der Suchmaschinen-Empfehlung von Kameleoon. Jeder Wert wird durch ein separates tag-Element beschrieben.

Element	Erforderlich	Beschreibung
`tag`	Ja	Tag-Wert

Nachfolgend finden Sie Beispiele für XML-Dateien, die Sie als Vorlage verwenden können:

XML-Produkt-Feed - Beispiel 1 (ohne locations-Elemente):

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2022-10-03 22:00">
	<shop>
		<categories>
			<category id="270821163172" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/adidas">Adidas</category>
			<category id="270821261476" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/asics">Asics</category>
			<category id="270821228708" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/converse">Converse</category>
			<category id="270821425316" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/drmartens">Dr Martens</category>
			<category id="270821490852" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/flex">Flex</category>
			<category id="2708211" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/trainers">Sneakers</category>
			<category id="2708" url="https://kameleoon-store.myshopify.com/collections/all">Shoes</category>
		</categories>
		<offers>
			<offer id="6737859641508" available="true" leftovers="lot">
				<url>https://kameleoon-store.myshopify.com/products/adidas-kids-stan-smith</url>
				<price>50.99</price>
				<oldprice>90</oldprice>
				<price_margin>45</price_margin>
				<categoryId>270821163172</categoryId>
				<categoryId>2708211</categoryId>
				<picture>https://cdn.shopify.com/s/files/1/0564/9180/2788/products/7883dc186e15bf29dad696e1e989e914_grande.jpg?v=1622707556</picture>
				<name>ADIDAS | KID'S STAN SMITH</name>
				<is_new>1</is_new>
				<rating>4</rating>
				<vendor>Adidas</vendor>
				<description>The Stan Smith owned the tennis court in the '70s. Today it runs the streets with the same clean, classic style. These kids' shoes preserve the iconic look of the original, made in leather with punched 3-Stripes, heel and tongue logos and lightweight step-in cushioning. </description>
				<stock_quantity>300</stock_quantity>
				<tags>
					<tag>Sneakers</tag>
					<tag>Lean low top sneakers</tag>
					<tag>Men sneakers</tag>
				</tags>
				<fashion>
					<type>shoe</type>
					<color>black</color>
					<sizes>
						<size>9</size>
					</sizes>
					<feature>child</feature>
				</fashion>
				<param name="Size" unit="EU">9</param>
				<param name="Color">white</param>
			</offer>
			<offer id="6737859641509" available="false">
			......
			</offer>	
		</offers>
	</shop>
</yml_catalog>

XML-Produkt-Feed - Beispiel 2 (mit locations-Elementen):

<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2022-10-03 22:00">
	<shop>
		<categories>
			<category id="270821163172" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/adidas">Adidas</category>
			<category id="270821261476" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/asics">Asics</category>
			<category id="270821228708" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/converse">Converse</category>
			<category id="270821425316" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/drmartens">Dr Martens</category>
			<category id="270821490852" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/flex">Flex</category>
			<category id="2708211" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/trainers">Sneakers</category>
			<category id="2708" url="https://kameleoon-store.myshopify.com/collections/all">Shoes</category>
		</categories>		
		<locations>
			<location id="1" type="city" name="New York" />
			<location id="2" type="city" name="Los Angeles" />
			<location id="145" parentId="1" type="store" name="New York City main store" />
		</locations>		
		<offers>
			<offer id="6737859641508" available="true" leftovers="lot">
				<url>https://kameleoon-store.myshopify.com/products/adidas-kids-stan-smith</url>
				<price>50.99</price>
				<oldprice>90</oldprice>
				<categoryId>270821163172</categoryId>
				<categoryId>2708211</categoryId>
				<picture>https://cdn.shopify.com/s/files/1/0564/9180/2788/products/7883dc186e15bf29dad696e1e989e914_grande.jpg?v=1622707556</picture>
				<name>ADIDAS | KID'S STAN SMITH</name>
				<is_new>1</is_new>
				<rating>4</rating>
				<vendor>Adidas</vendor>
				<description>The Stan Smith owned the tennis court in the '70s. Today it runs the streets with the same clean, classic style. These kids' shoes preserve the iconic look of the original, made in leather with punched 3-Stripes, heel and tongue logos and lightweight step-in cushioning. </description>
				<stock_quantity>300</stock_quantity>
				<tags>
					<tag>Sneakers</tag>
					<tag>Men</tag>
				</tags>
				<locations>
					<location id="145">
						<price>63</price>
						<oldprice>90</oldprice>
						<stock_quantity>90</stock_quantity>
					</location>
				</location>
				<customerRecommendations>67378596415,673785964150821,673785964150,673785964150811</customerRecommendations>
			</offer>
			<offer id="6737859641509" available="false">
				......
			</offer>	
		</offers>
	</shop>
</yml_catalog>

Schritt 2: Ihre Produkt-Feed-Datei mit Kameleoon synchronisieren

Standardmäßig synchronisiert sich der Kameleoon-Feed alle 24 Stunden mit Ihrer XML-Datei. Sie können diese Einstellung jedoch ändern, wenn Ihr Produktkatalog häufiger aktualisiert wird. Sie können Anpassungen in Store settings vornehmen.

Sie können den Import auch so planen, dass er zu einer bestimmten Stunde startet. Wenden Sie sich an Ihren Kameleoon Customer Success Manager, um diese Option zu aktivieren.

![](https://storage.googleapis.com/kameleoon-storage-documentation/user-manual/images/recommendations-and-merchandising/recommendations/import-your-product-catalog-feed/Screenshot-2024-07-01-at-1.28.50 PM.png)

Schritt 3: Besucherereignisse verfolgen

Zusätzlich zur Synchronisation Ihres XML-Produkt-Feeds müssen Sie Ereignisse implementieren, um Produktereignisse wie Produktansicht, Zu-Warenkorb-Hinzufügen und Transaktion zu verfolgen.

Produktansichten

Sie müssen die Methode trackProductView verwenden. Kameleoon.API.Products.trackProductView("ProductID/SKU/EAN"); Detaillierte Anweisungen lesen

trackAddToCart()

Sie müssen die Methode trackAddToCart() verwenden, wenn ein Produkt zum Warenkorb des Besuchers hinzugefügt wurde oder wenn der Besucher die Warenkorbseite aufruft. Kameleoon.API.Products.trackAddToCart("ProductID/SKU/EAN"); Detaillierte Anweisungen lesen

Transaktion

Kameleoon.API.Products.trackTransaction([
	{
	 "productID": "ProductID/SKU/EAN 1",
	 "quantity": 1
	}
]);

Unsere detaillierten Anweisungen lesen

Den Synchronisationsstatus Ihres Feeds validieren

Wenn Sie die Product API von Kameleoon verwenden, können Sie überprüfen, ob Ihre Implementierung erfolgreich war, indem Sie die Methode obtainProductData verwenden. Mit dieser Methode können Sie Ihre Implementierung einfach in Echtzeit testen und überprüfen, ob Kameleoon Ihre Produktattribute korrekt erfasst hat. Sie können Ihren Produktkatalog mit dem Menü Data feed visualisieren.

Sie können auch direkt über das Menü Imports log auf die Importprotokolle zugreifen, um Importprobleme zu beheben.

Sie können dann auf eine beliebige Zeile klicken, um auf das detaillierte Importprotokoll zuzugreifen.

​Ihren Produkt-Feed mit der Kameleoon Product API synchronisieren

​trackProductView()

​trackCategoryView()

​trackAddToCart()

​trackTransaction()

​Ihren Produkt-Feed mit einer XML-Datei synchronisieren

​Schritt 1: Ihren Produkt-Feed erstellen

​Element: yml_catalog

​Element: yml_catalog > shop

​Element: yml_catalog > shop > categories

​Element: yml_catalog > shop > locations

​Element: yml_catalog > shop > offers

​Element: yml_catalog > shop > offers > offer

​Element: yml_catalog > shop > offers > offer > locations

​Element: yml_catalog > shop > offers > offer > fashion

​Element: yml_catalog > shop > offers > offer > auto

​Element: yml_catalog > shop > offers > offer > tags

​Schritt 2: Ihre Produkt-Feed-Datei mit Kameleoon synchronisieren

​Schritt 3: Besucherereignisse verfolgen

​Produktansichten

​trackAddToCart()

​Transaktion

​Den Synchronisationsstatus Ihres Feeds validieren

Ihren Produkt-Feed mit der Kameleoon Product API synchronisieren

trackProductView()

trackCategoryView()

trackAddToCart()

trackTransaction()

Ihren Produkt-Feed mit einer XML-Datei synchronisieren

Schritt 1: Ihren Produkt-Feed erstellen

Element: yml_catalog

Element: yml_catalog > shop

Element: yml_catalog > shop > categories

Element: yml_catalog > shop > locations

Element: yml_catalog > shop > offers

Element: yml_catalog > shop > offers > offer

Element: yml_catalog > shop > offers > offer > locations

Element: yml_catalog > shop > offers > offer > fashion

Element: yml_catalog > shop > offers > offer > auto

Element: yml_catalog > shop > offers > offer > tags

Schritt 2: Ihre Produkt-Feed-Datei mit Kameleoon synchronisieren

Schritt 3: Besucherereignisse verfolgen

Produktansichten

trackAddToCart()

Transaktion

Den Synchronisationsstatus Ihres Feeds validieren