Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
Themen:
Verwenden Sie Feeds, um Entitäten in Adobe Target Recommendations zu importieren. Entitäten können mit CSV-Dateien, dem Google Product Search-Feed-Format und Adobe Analytics Produktklassifizierungen gesendet werden.
Mit Feeds können Sie Entitäten übergeben oder Ihre Mbox-Daten mit Informationen ergänzen, die entweder nicht auf der Seite verfügbar sind oder nicht sicher von der Seite gesendet werden können, z. B. Marge, COGS usw.
Mit Feeds können Sie detaillierte Elementinformationen an Recommendations übergeben, z. B. Produkt-ID, Kategorie, Name, Nachricht und andere Attribute.
Sie können auswählen, welche Spalten aus Ihrer Target -Produktklassifizierungsdatei oder Google-Produktsuchdatei Sie an den Recommendations -Server senden möchten.
Diese Datenelemente zu den einzelnen Elementen können dann zu folgenden Zwecken verwendet werden:
Werte in Entwürfen anzeigen
Definieren von Kriterieneinschlussregeln
Sortieren von Elementen in verschiedene Sammlungen
Ausschlüsse auf Empfehlungen anwenden
Elementbeschreibungen können mithilfe von Feeds oder Mboxes an Target übergeben werden. Wenn Daten von einem Entitäts-Feed und einer Mbox erfasst werden, haben die aktuellen Daten Priorität. In der Regel stammen die aktuellen Daten von einer mbox, da sie häufiger angezeigt wird. Für den seltenen Fall, dass die Entitäts-Feed-Daten und die Mbox-Daten gleich aktuell sind, werden die Mbox-Daten verwendet.
Die Liste Feeds ( Recommendations > Feeds) enthält Informationen zu allen Feeds, die Sie erstellt haben.
Die Seite Feeds enthält die folgenden Spalten:
Name: Der Name des beim Erstellen angegebenen Feeds. Um den Namen eines Feeds zu bearbeiten, müssen Sie den Feed bearbeiten. Wenn Sie den Feed mit dem neuen Namen speichern, wird der Feed aktualisiert.
Zeitplan: Zeigt den Aktualisierungszeitplan für den Feed an: Daily, Weekly, Every 2 Weeks oder Never.
Artikel: Zeigt die Anzahl der Artikel im Feed an.
Zuletzt aktualisiert: Zeigt das Datum und die Uhrzeit der letzten Aktualisierung des Feeds sowie den Namen der Person an, die den Feed aktualisiert hat. Wenn der Last Updated -Feed "nicht definiert"lautet, kommt der Feed von Recommendations Classic und kann nicht innerhalb von Target Premium Recommendations geändert werden.
Klicken Sie auf das Informationssymbol, um eine Karte mit dem Datum des letzten Uploads und der URL des Feeds anzuzeigen.
Klicken Sie auf das Auslassungssymbol, um auf die folgenden Aktionen zuzugreifen: Deactivate, Edit, Copy und Delete.
IMPORTANT
Hochgeladene Entitäten und Entitätsattribute laufen nach 61 Tagen ab. Das bedeutet:
Ihr Feed sollte mindestens einmal monatlich ausgeführt werden, um sicherzustellen, dass Ihre Kataloginhalte nicht ablaufen.
Wenn Sie ein Element aus Ihrer Feed-Datei entfernen, wird dieses Element nicht aus Ihrem Katalog entfernt. Um das Element aus dem Katalog zu entfernen, löschen Sie es manuell über die Target -Benutzeroberfläche oder -API. Oder ändern Sie die Elementattribute (z. B. das Inventar), um sicherzustellen, dass das Element von der Berücksichtigung ausgeschlossen wird.
Source-Typen
Entitäten können mit CSV-Dateien, dem Google Product Search-Feed-Format und Adobe Analytics Produktklassifizierungen gesendet werden.
CSV section_65CC1148C7DD448FB213FDF499D35FCA
Sie können eine CSV-Datei im proprietären CSV-Upload-Format Adobe erstellen. Die Datei enthält Anzeigeinformationen über die reservierten und benutzerspezifischen Attribute für Ihre Produkte. Ersetzen Sie zum Hochladen von für Ihre Implementierung spezifischen Attributen CustomN in der Kopfzeile durch den Namen des gewünschten Attributs. Im folgenden Beispiel wurde entity.Custom1 ersetzt durch: entity.availability. Sie können die Datei anschließend per Massenvorgang auf den Recommendations-Server hochladen.
Die Verwendung des CSV-Formats bietet die folgenden Vorteile im Vergleich zum Google-Feed-Format:
Das .csv-Format erfordert keine Feldzuordnungen.
Das .csv-Format unterstützt Attribute mit mehreren Werten (siehe Beispiel unten).
Das .csv-Format unterstützt bis zu 100 benutzerdefinierte Attribute. Wenn Sie mehr als 100 benutzerspezifische Attribute benötigen, können Sie eine zweite Feed-Datei erstellen, in dem ein anderer Satz an benutzerspezifischen Attributen angegeben wird.
Verwenden Sie die Massen-Upload-Methode, um Anzeigeinformationen zu senden, wenn Ihre Seite keine Mboxes enthält oder wenn Sie Ihre Anzeigeinformationen mit Artikeln ergänzen möchten, die nicht auf Ihrer Site verfügbar sind. So können Sie z. B. Lagerbestandsinformationen versenden, die auf der Site nicht zur Verfügung stehen.
Alle Daten, die mit der CSV-Datei, dem Google-Produkt-Feed oder dem Analytics Produkt-Classification-Feed hochgeladen wurden, überschreiben den vorhandenen Entitätsattributwert in der Datenbank. Wenn Sie Preisinformationen über Mbox-Anfragen und anschließend andere Preiswerte in einer Datei senden, überschreiben die Werte in der Datei die mittels Mbox-Anfrage festgelegten Werte. Eine Ausnahme bildet das Entitätsattribut categoryId, für das Kategoriewerte bis zu einer Längenbeschränkung von 250 Zeichen angehängt statt überschrieben werden.
IMPORTANT
Verwenden Sie in Ihrer CSV-Datei keine Werte in doppelten Anführungszeichen ("), sofern dies nicht beabsichtigt ist. Wenn Sie Werte in doppelten Anführungszeichen setzen, müssen Sie sie mit Escape-Zeichen versehen, indem Sie sie in einen anderen Satz doppelter Anführungszeichen einschließen. Doppelte Anführungszeichen ohne Escape-Zeichen verhindern das ordnungsgemäße Laden des Recommendations-Feeds.
Die folgende Syntax ist falsch:
"Apples "Bananas" Grapes"",
Die folgenden Syntax ist richtig:
"Apples ""Bananas"" Grapes""",
NOTE
Sie können einen vorhandenen Wert nicht mit einem leeren Wert überschreiben. Übergeben Sie einen anderen Wert an seiner Stelle, um ihn zu überschreiben. Im Falle eines Verkaufspreises besteht eine gängige Lösung darin, entweder einen tatsächlichen "NULL"-Wert oder eine andere Meldung zu übermitteln. Sie können dann eine Vorlagenregel verfassen, um Artikel mit diesem Wert auszuschließen.
Das Produkt ist auf der Admin-Oberfläche ungefähr zwei Stunden nach dem erfolgreichen Upload seiner Entität verfügbar.
Im Folgenden finden Sie einen Beispielcode für eine CSV-Datei:
## RECSRecommendations Upload File
## RECS''## RECS'' indicates a Recommendations pre-process header. Please do not remove these lines.
## RECS
## RECSUse this file to upload product display information to Recommendations. Each product has its own row. Each line must contain 19 values and if not all are filled a space should be left.
## RECSThe last 100 columns (entity.custom1 - entity.custom100) are custom. The name 'customN' can be replaced with a custom name such as 'onSale' or 'brand'.
## RECSIf the products already exist in Recommendations then changes uploaded here will override the data in Recommendations. Any new attributes entered here will be added to the product''s entry in Recommendations.
## RECSentity.id,entity.name,entity.categoryId,entity.message,entity.thumbnailUrl,entity.value,entity.pageUrl,entity.inventory,entity.margin,entity.last_updated_by,entity.multi_english,entity.availability,entity.tax_country,entity.tax_region,entity.tax_rate,entity.product_type,entity.item_group_id,entity.color,entity.size,entity.brand,entity.gtin
na3456,RipCurl Watch with Titanium Dial,Watches & Sport,Cutting edge titanium with round case,https://example.com/s7/na3456_Viewer,425,https://example.com/shop/en-us/na3456_RipCurl,24,0.25,csv,"[""New"",""Web"",""Sales"",""[1,2,34,5]""]",in stock,US,CA,9.25,Shop by Category > Watches,dz1,Titanium,44mm,RipCurl,"075380 01050 5"
na3457,RipCurl Watch with Black Dial,Watches & Sport,Cutting edge matte black with round case,https://example.com/s7/na3457_Viewer,275,https://example.com/shop/en-us/na3457_RipCurl,24,0.27,csv,"[""New"",""Web"",""Sales"",""[1,2,34,5]""]",in stock,US,CA,9.25,Shop by Category > Watches,dz1,Black,44mm,RipCurl,"075340 01060 7"
Google section_8EFA98B5BC064140B3F74534AA93AFFF
Der Feed-Typ Google-Produktsuche verwendet das Google-Format. Dies unterscheidet sich vom proprietären CSV-Upload-Format Adobe.
Wenn Sie über einen vorhandenen Google-Produkt-Feed verfügen, können Sie diesen als Ihre Importdatei verwenden.
NOTE
Es müssen nicht Google-Daten verwendet werden. Recommendations verwendet dasselbe Format wie Google. Sie können mit dieser Methode alle Ihre Daten hochladen und dabei die verfügbaren Planungsfunktionen nutzen. Dennoch müssen Sie die von Google festgelegten und vordefinierten Attributnamen verwenden, wenn Sie die Datei einrichten.
Die meisten Einzelhändler laden Produkte in Google hoch. Wenn ein Besucher also die Google-Produktsuche verwendet, werden seine Produkte angezeigt. Recommendations berücksichtigt für Entitäts-Feeds exakt die Spezifikationen von Google. Entitäts-Feeds können an Recommendations über .xml, .txt oder .tsv gesendet werden und die von Google🔗 definierten Attribute verwenden. Die Ergebnisse können auf den Google-Shopping-Seiten durchsucht werden.
NOTE
Die POST-Methode muss auf dem Server zugelassen sein, der den Google-Feed-Inhalt hostet.
Da Recommendations -Benutzer bereits .xml- oder .txt-Feeds konfigurieren, um sie per URL oder FTP an Google zu senden, akzeptieren Entitäts-Feeds diese Produktdaten und erstellen mit ihnen den Empfehlungskatalog. Geben Sie an, wo sich dieser Feed befindet, und der Recommendations-server ruft die Daten ab.
Wenn Sie die Google-Produktsuche für den Entitäts-Feed-Upload verwenden, müssen Sie weiterhin eine Produktseiten-Mbox auf der Seite haben, wenn Sie dort Empfehlungen anzeigen oder Produktansichten für die Algorithmusbereitstellung basierend auf Ansichten verfolgen möchten.
Google Feeds unterstützen nicht mehrere Werte für ein benutzerdefiniertes Attribut.
Der Feed wird zu dem Zeitpunkt ausgeführt, zu dem Sie ihn speichern und aktivieren. Er wird zu dem Zeitpunkt ausgeführt, zu dem Sie den Feed speichern, und dann täglich eine Stunde später.
Nachfolgend finden Sie einen Beispielcode für eine Feed-XML-Datei für die Google-Produktsuche:
Nachfolgend finden Sie einen Beispielcode für eine Feed-TSV-Datei für die Google-Produktsuche:
id title description link price condition availability image_link tax shipping_weight shipping google_product_category product_type item_group_id color size gender age_group pattern brand gtin mpn
na3454 RipCurl Watch with Titanium Dial Cutting edge titanium with round case https://example.com/shop/en-us/na3454_RipCurl 425 new in stock https://example.com/s7/na3452_Viewer US:CA:9.25:y 1.5 oz US:::0.00 USD Watches & Sport Shop by Category > Watches dz1 Black 44mm male adult Solid RipCurl 075380 01050 5 DZ1437
na3455 RipCurl Watch with Black Dial Cutting edge matte black with round case https://example.com/shop/en-us/na3455_RipCurl 275 new in stock https://example.com/s7/na3452_Viewer US:CA:9.25:y 1.5 oz US:::0.00 USD Watches & Sport Shop by Category > Watches dz1 Black 44mm male adult Solid RipCurl 075340 01060 7 DZ1446
Die Analytics Produkt-Classification ist die einzige für Empfehlungen verfügbare Classification. Weitere Informationen zu dieser Klassifizierungsdatei finden Sie unter Über Klassifizierungen im Leitfaden Analytics-Komponenten . Es ist möglich, dass nicht alle für Empfehlungen benötigten Informationen in Ihrer aktuellen Implementierung verfügbar sind. Befolgen Sie dieses Benutzerhandbuch, wenn Sie es zu Ihrer Classification-Datei hinzufügen möchten.
IMPORTANT
Beachten Sie vor dem Import von Entitätsdaten in Recommendations mithilfe von Analytics -Produktklassifizierungen, dass dies nicht die bevorzugte Methode ist.
Beachten Sie die folgenden Einschränkungen:
Aktualisierungen an den Entitätsattributen umfassen eine zusätzliche Verzögerung von bis zu 24 Stunden.
Target unterstützt nur Product Classifications. Die Produkt-SKU Analytics muss derselben Ebene wie die Recommendations entity.id zugeordnet sein. Benutzerdefinierte Analytics Klassifizierungen können mit Adobe Consulting Services erstellt werden. Wenden Sie sich bei Fragen an Ihren Kundenbetreuer.
Feed erstellen steps
Erstellen Sie einen Feed, um Informationen über Ihre Produkte oder Services in Recommendations einzufügen.
Klicken Sie in der Target-Oberfläche auf Recommendations > Feeds > Create Feed.
Geben Sie einen beschreibenden Namen für Ihren Feed an.
(Bedingt) Wenn Sie CSV oder Google Product Feed ausgewählt haben, geben Sie den Speicherort an, an dem auf den Feed zugegriffen werden kann.
FTP: Wenn Sie „FTP“ ausgewählt haben, geben Sie die FTP-Serverdaten, die Anmeldedaten, den Dateinamen und das FTP-Verzeichnis an. Sie können FTP mit SSL (FTPS) für sicherere Uploads verwenden.
Unterstützte FTP-Servereinstellungen:
FTP und FTPS müssen für die Verwendung von passivem FTP eingestellt sein.
Für FTPS konfigurieren Sie den Server so, dass er explizite FTPS-Verbindungen akzeptiert.
SFTP wird nicht unterstützt.
Sie können manuell einen Port angeben, an dem die Verbindung initiiert werden soll (z. B. ftp://ftp.yoursite.com:2121). Wenn Sie keinen Port angeben, wird der standardmäßige FTP- oder FTPS-Port verwendet.
URL: Wenn Sie URL auswählen, geben Sie die URL an.
(Bedingt) Wenn Sie Analytics Classifications ausgewählt haben, wählen Sie die Report Suite aus der Dropdownliste aus.
Klicken Sie auf den Pfeil Next , um die Optionen Schedule anzuzeigen.
Wählen Sie eine Aktualisierungsoption aus:
Daily
Weekly
Every 2 Weeks
Never: Planen Sie keine Aktualisierung. Wählen Sie diese Option aus, wenn Sie nicht möchten, dass dieser Feed ausgeführt wird.
Geben Sie die Zeit an, zu der Ihr Feed ausgeführt werden soll.
Diese Option basiert auf der Zeitzone, die in Ihrem Browser verwendet wird. Wenn Sie einen Zeitpunkt in einer anderen Zeitzone verwenden möchten, müssen Sie diesen Zeitpunkt anhand Ihrer Zeitzone berechnen.
Klicken Sie auf den Pfeil Next , um die Optionen Mapping anzuzeigen, und geben Sie an, wie Sie Ihre Daten Target -Definitionen zuordnen möchten.
(Optional) Wenn der Feed einer Umgebung (Hostgruppe) zugeordnet werden soll, wählen Sie die Hostgruppe aus.
Standardmäßig gehört der Feed zu allen Hostgruppen. So wird sichergestellt, dass Artikel in diesem Feed in jeder Umgebung verfügbar sind. Weitere Informationen finden Sie unter Hosts.
Klicken Sie auf Save.
Nachdem Sie einen Feed erstellt oder bearbeitet haben, wird er sofort ausgeführt. Der Feed wird dann entsprechend den von Ihnen festgelegten Parametern aktualisiert. Es dauert ein wenig, bis die Informationen verfügbar sind. Zunächst muss der Feed synchronisiert, dann bearbeitet und anschließend indexiert werden, bevor er veröffentlicht und verfügbar gemacht werden kann. Der aktuelle Status wird unter Feed-Status in der Liste „Feeds“ angezeigt. Sie können Target schließen, bevor der Prozess abgeschlossen ist, und der Prozess wird weiter ausgeführt.
Während der Indexierung erscheinen Produkte und Feed-Header vor der Indexierung von individuellen Werten. Auf diese Weise können Sie Produkte durchsuchen und anzeigen, sodass Sie Sammlungen, Ausschlüsse, Designs und Aktivitäten erstellen können, bevor die Indizierung abgeschlossen ist.
Wenn als Status „Erfolg“ gemeldet wird, bedeutet dies, dass die Datei gefunden und korrekt analysiert wurde. Bis zum Abschluss der Indexierung, die abhängig von der Größe Ihrer Datei einige Zeit in Anspruch nehmen kann, steht die Information nicht zur Verwendung in Recommendations zur Verfügung. Wenn der Prozess fehlschlägt, bedeutet dies, dass die Datei nicht gefunden wurde. Sie haben beispielsweise eine falsche URL verwendet oder Ihre FTP-Informationen waren falsch oder es ist ein Parsing-Fehler aufgetreten.
Feedstatus-Optionen und -Indikatoren concept_E475986720D1400999868B3DFD14A7A0
Informationen über die möglichen Feedstatus-Optionen und deren Indikatoren.
Feedstatus-Optionen status
Folgende Statusoptionen stehen für Feeds zur Verfügung:
Status
Beschreibung
Syncing
Die Einrichtungsinformationen des Feeds werden in Target gespeichert.
Sync Failed
Die Einrichtungsinformationen des Feeds konnten nicht in Target gespeichert werden. Erneut versuchen.
No Feed Run
Sie haben einen Feed erstellt, aber nicht geplant (die Häufigkeit ist auf "Nie"eingestellt).
Geplant am Tag und Uhrzeit
Der Feed wurde nicht ausgeführt, jedoch für eine bestimmte Uhrzeit an einem bestimmten Tag geplant.
Waiting for Download
Target bereitet den Download der Feed-Datei vor.
Downloading Feed File
Target lädt die Feed-Datei herunter.
Importing Items
Target importiert Elemente aus der Feed-Datei.
Feed erfolgreich importiert um Zeit
Target hat die Feed-Datei in sein Inhaltsbereitstellungssystem importiert. Änderungen an Artikelattributen wurden im Inhaltsbereitstellungssystem vorgenommen und werden in Kürze in den bereitgestellten Empfehlungen übernommen. Wenn die erwarteten Änderungen nicht angezeigt werden, versuchen Sie es erneut und aktualisieren Sie die Seite mit den Empfehlungen. Hinweise:
Wenn Änderungen an den Attributen eines Artikels dazu führen, dass ein Artikel aus Empfehlungen ausgeschlossen wird, wird der Ausschluss sofort übernommen. Wenn ein Element neu hinzugefügt wird oder Änderungen an Attributen dazu führen, dass ein Element nicht mehr aus Empfehlungen ausgeschlossen wird, wird es erst beim nächsten Algorithmus-Update angezeigt, das innerhalb von 24 Stunden erfolgt.
Wenn dieser Status angezeigt wird, werden die Aktualisierungen möglicherweise noch nicht in der Benutzeroberfläche von Catalog Search angezeigt. Unter Catalog Search wird ein separater Status angezeigt, der angibt, wann der durchsuchbare Katalog zuletzt aktualisiert wurde.
Failed to Index
Die Index-Operation ist fehlgeschlagen. Erneut versuchen.
Server Not Found
FTP- oder URL-Speicherorte sind ungültig oder nicht erreichbar.
Um einen Feed zu aktualisieren (z. B. um Änderungen an Ihrer Feed-Konfiguration oder Feed-Datei vorzunehmen), öffnen Sie den Feed, nehmen Sie die gewünschten Änderungen vor und klicken Sie auf Save.
IMPORTANT
Hochgeladene Entitäten laufen nach 61 Tagen ab. Das bedeutet, dass Ihre Feed-Datei mindestens alle 60 Tage hochgeladen werden sollte, um eine Unterbrechung Ihrer Empfehlungsaktivitäten zu vermeiden. Wenn ein Element nicht mindestens alle 60 Tage in einer Feed-Datei (oder einer anderen Methode zur Aktualisierung der Entität) enthalten ist, zeigt Target an, dass das Element nicht mehr relevant ist, und entfernt es aus dem Katalog.
Die folgenden Feedstatus-Indikatoren werden in der Spalte Status angezeigt:
Statusindikator
Beschreibung
Grüner Statusindikator
Wenn die Indexierung eines Feeds erfolgreich abgeschlossen wurde, zeigt ein grüner Statuspunkt an, dass der Feed einen erfolgreichen Status hat.
Gelber Statusindikator
Wenn ein Feed oder Feed-Index um 25 % der Feed-Frequenz verzögert wird, wird ein gelber Punkt für den Status angezeigt. Beispielsweise wird für einen Feed, der täglich ausgeführt wird, ein gelber Punkt angezeigt, wenn der Index sechs Stunden nach der geplanten Zeit nicht abgeschlossen wurde. Hinweis: Sobald der Feed-Status "Warten auf Indexwarteschlange"lautet, sind die neu aktualisierten Werte in der Bereitstellung und Kriterienverarbeitung verfügbar.
Weißer Statusindikator
Wenn ein Feed nicht geplant ist, gibt ein weißer Punkt für den Status an, dass der Feed noch nicht ausgeführt wurde.
Roter Statusindikator
Wenn der Feed keine Daten auf den Server hochladen kann, wird eine rote Statusanzeige angezeigt.
Sehen Sie sich folgende Beispiele an:
Beispiel 1:
Tag 1: Der tägliche Feed wird um 9:00 Uhr PST verarbeitet.
Tag zwei: Es ist 15:30 Uhr und der Feed wurde seit gestern um 9:00 Uhr nicht ausgeführt
Der Status ist gelb, da der Index vor rund 6,5 Stunden erstellt werden sollte. 6,5 Stunden + 24 ergibt 127 % des Feed-Zeitfensters.
Beispiel 2:
1. Januar: Monatlicher Feed wird um 9:00 Uhr PST verarbeitet.
3. Februar: Es ist 10:00 Uhr und der Feed wurde einen Monat, einen Tag und eine Stunde lang nicht ausgeführt.
Der Status ist gelb, da der Index vor rund einem Tag und einer Stunde hätte ausgeführt werden müssen. Auch wenn dies nur (31 + (1 / 25)) / 30 = 1,03 % der Häufigkeitseinstellung ergibt, wurde der Höchstwert von einem Tag für die Verzögerung überschritten.
Schulungsvideos
In den folgenden Videos erhalten Sie weitere Informationen zu den in diesem Artikel behandelten Konzepten.
