Last update: Wed Feb 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
Onderwerpen:
Gebruik feeds om entiteiten in te voeren in Adobe Target Recommendations . Entiteiten kunnen worden verzonden met gebruik van CSV-bestanden, de Google Product Search feed-indeling en Adobe Analytics -productclassificaties.
Overzicht van feeds
Het voer laat u Entiteitenovergaan of uw brievenbusgegevens met informatie uitbreiden die of niet beschikbaar op de pagina is of onveilig om rechtstreeks van de pagina te verzenden. Bijvoorbeeld marge, kostprijs van verkochte goederen (COGS) enzovoort.
Met feeds kunt u ook gedetailleerde itemgegevens doorgeven in Recommendations , zoals product-id, categorie, naam, bericht en andere kenmerken.
U kunt selecteren welke kolommen u naar de Target product classifications file of Google Product Search bestand wilt verzenden naar de Recommendations server.
Deze gegevens over elk item kunnen vervolgens worden gebruikt om:
Waarden weergeven in ontwerpen
Criteria voor inclusie definiëren
Items in verschillende verzamelingen sorteren
Uitzonderingen op aanbevelingen toepassen
U kunt itembeschrijvingen doorgeven aan Target met feeds of selectievakjes. Als Target gegevens verzamelt met zowel een eenheidfeed als een box, worden de meest recente gegevens gewint. Meestal komen de meest recente gegevens uit een box, omdat deze vaker worden weergegeven. In het zeldzame geval dat de entiteit gegevens invoert en tegelijkertijd de gegevens van de doos raken, worden de mbox gegevens gebruikt.
De Feeds -lijst ( Recommendations > Feeds ) bevat informatie over alle feeds die u hebt gemaakt.
De pagina Feeds bevat de volgende kolommen:
Naam: De naam van het voer tijdens verwezenlijking wordt gespecificeerd die. Als u de naam van een feed wilt bewerken, moet u de feed zelf bewerken. Wanneer u de feed onder de nieuwe naam opslaat, wordt de feed vernieuwd.
Programma: Toont het updateschema voor het voer: Daily, Weekly, Every 2 Weeks, of Never.
Laatste Bijgewerkt: Toont de datum en de tijd toen het voer en de naam van de persoon laatst werd bijgewerkt die het voer bijwerkte.
Klik het Customize Table pictogram (
aan om kolommen te selecteren of te schrappen die u wilt tonen.
Klik het Information pictogram (
) om een kaart te tonen die de laatste uploaddatum en URL van het voer toont.
Klik het More Actions pictogram (
) om tot de volgende acties toegang te hebben: Deactivate, Edit, Copy, en Delete.
IMPORTANT
Geüploade entiteiten en entiteitskenmerken verlopen na 61 dagen. Dit betekent:
Uw feed moet ten minste maandelijks worden uitgevoerd om ervoor te zorgen dat de inhoud van de catalogus niet verloopt.
Als u een item uit het voederbestand verwijdert, wordt dat item niet uit de catalogus verwijderd. Als u het item uit de catalogus wilt verwijderen, verwijdert u het handmatig via de gebruikersinterface of API van Target . Of wijzig de itemkenmerken (zoals voorraad) om ervoor te zorgen dat het item niet in aanmerking wordt genomen.
Source-typen
Entiteiten kunnen worden verzonden met gebruik van CSV-bestanden, de Google Product Search feed-indeling en Adobe Analytics -productclassificaties.
CSV
U kunt een .csv-bestand maken met de gedeponeerde CSV-uploadindeling van Adobe . Het bestand bevat weergaveinformatie over de gereserveerde en aangepaste kenmerken voor uw producten. Als u kenmerken wilt uploaden die specifiek zijn voor uw implementatie, vervangt u CustomN in de koptekstrij door de naam van het kenmerk dat u wilt gebruiken. In het onderstaande voorbeeld is entity.Custom1 vervangen door: entity.availability . Vervolgens kunt u het bestand in bulk uploaden naar de Recommendations -server.
Het gebruik van de .csv-indeling heeft de volgende voordelen ten opzichte van de Google feed-indeling:
Voor de .csv-indeling zijn geen veldtoewijzingen vereist.
De .csv-indeling ondersteunt kenmerken met meerdere waarden (zie het onderstaande voorbeeld).
De .csv-indeling ondersteunt maximaal 100 aangepaste kenmerken. Als u meer dan 100 aangepaste kenmerken nodig hebt, kunt u een tweede feed-bestand maken met een andere set opgegeven aangepaste kenmerken.
Gebruik de methode voor het bulkuploaden om weergavegegevens te verzenden als u geen vakken op uw pagina hebt of als u uw weergavegegevens wilt aanvullen met items die niet op uw site beschikbaar zijn. Stel bijvoorbeeld dat u inventarisgegevens wilt verzenden die mogelijk niet op uw site worden gepubliceerd.
Alle gegevens die zijn geüpload met het CSV-bestand, de Google Product Feed of de Analytics Product Classification Feed, overschrijven de bestaande entiteitskenmerkwaarde in de database. Als u prijsinformatie via mbox-aanvragen verzendt en vervolgens andere prijswaarden in het bestand verzendt, overschrijven de waarden in het bestand de waarden die met de mbox-aanvraag zijn ingesteld. Een uitzondering hierop is het kenmerk entiteit van categoryId , waarbij de categoriewaarden worden toegevoegd in plaats van te worden overschreven tot de limiet van 250 tekens.
IMPORTANT
Plaats geen waarden tussen dubbele aanhalingstekens ( " ) in het CSV-bestand, tenzij deze opzettelijk zijn. Als u waarden tussen dubbele aanhalingstekens plaatst, moet u deze weglaten door ze in een andere set dubbele aanhalingstekens in te sluiten. Dubbele aanhalingstekens die niet worden genegeerd, verhinderen dat de aanbevolen feed correct wordt geladen.
De volgende syntaxis is bijvoorbeeld onjuist:
"Apples "Bananas" Grapes"",
De volgende syntaxis is correct:
"Apples ""Bananas"" Grapes""",
NOTE
U kunt een bestaande waarde niet overschrijven met een lege waarde. Geef een andere waarde in de plaats ervan door om de bestaande waarde te overschrijven. In het geval van een verkoopprijs is het een gemeenschappelijke oplossing om een werkelijk "NULL" of een ander bericht door te geven. Vervolgens kunt u een sjabloonregel schrijven om items met die waarde uit te sluiten.
Het product is ongeveer twee uur na het uploaden van de entiteit beschikbaar in de beheerinterface.
Hier volgt een voorbeeldcode voor een CSV-bestand:
## 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
Het feed-type Google Product Search gebruikt de Google -indeling. Dit is anders dan de gedeponeerde CSV-uploadindeling van Adobe .
Als u een bestaande Google Product Feed hebt, kunt u die gebruiken als uw importbestand.
NOTE
Het is niet vereist om Google -gegevens te gebruiken. Recommendations gebruikt dezelfde indeling als Google . U kunt deze methode gebruiken om alle gegevens te uploaden die u hebt en de beschikbare planningsfuncties te gebruiken. U moet echter de vooraf gedefinieerde Google kenmerknamen behouden wanneer u het bestand instelt.
De meeste detailhandelaren uploaden producten naar Google, dus wanneer een bezoeker de Google -zoekopdracht gebruikt, worden hun producten weergegeven. Recommendations volgt de Google -specificatie exact voor entiteitsfeeds. De voer van de entiteit kan naar Recommendations via .xml, .txt, of .tsv worden verzonden, en kan de attributen gebruiken die door Googleworden bepaald. De resultaten zijn doorzoekbaar op Google het winkelen pagina's.
NOTE
De methode POST moet zijn toegestaan op de server die de Google feed-inhoud host.
Omdat Recommendations -gebruikers al .xml- of .txt-feeds configureren voor verzending naar Google via URL of FTP, worden deze productgegevens door entiteitsfeeds geaccepteerd en gebruikt om de catalogus met aanbevelingen te maken. Geef op waar die feed bestaat en de aanbevelingen-server de gegevens ophaalt.
Als u Google Product Search gebruikt voor het uploaden van de entiteitvoer, moet u nog een productpaginamarbox op de pagina hebben als u daar aanbevelingen wilt tonen of productmeningen voor algoritmelevering volgen die op meningen wordt gebaseerd.
Google feeds bieden geen ondersteuning voor meerdere waarden voor een aangepast kenmerk.
De feed wordt uitgevoerd op het moment dat u de feed opslaat en activeert. Het wordt uitgevoerd op het moment dat u de feed opslaat, en vervolgens elke dag en uur later.
Hier volgt een voorbeeldcode voor een XML-bestand met Google Product Search feed:
Hieronder volgt een voorbeeldcode voor een Google Product Search feed.tsv-bestand:
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
Analytics Productclassificaties
De Adobe Analytics productclassificatie is de enige classificatie die beschikbaar is voor aanbevelingen. Voor meer informatie over dit classificatiedossier, zie Ongeveer classificatiesin de gids van de Componenten van Analytics. Het is mogelijk dat niet alle informatie u voor aanbevelingen nodig hebt in uw huidige implementatie beschikbaar is, zo volg deze gebruikershandleiding als u aan uw classificatiedossier wilt toevoegen.
IMPORTANT
Voordat u entiteitsgegevens importeert naar Recommendations met Analytics -productclassificaties, moet u er rekening mee houden dat dit niet de voorkeursmethode is.
Let op het volgende:
Updates van entiteitskenmerken hebben een extra vertraging van maximaal 24 uur.
Target biedt alleen ondersteuning voor Product Classifications . De SKU van het Analytics product moet aan het zelfde niveau in kaart brengen zoals Recommendations entity.id. Aangepaste Analytics classificaties kunnen worden ontwikkeld met Adobe Consulting Services . Neem contact op met uw accountmanager voor vragen.
Feed maken
Maak een feed om informatie over uw producten of services in te voegen in Recommendations .
Klik in de interface van Target op Recommendations > Feeds > Create Feed .
Geef een beschrijvende naam op voor uw feed.
Selecteer een Source Type .
CSV
Google Product Feed
Analytics Classifications
Voor informatie over de CSV en Google Product Feed voedertypes, zie Overzicht van het Beeld. U kunt ook een modelCSV gidsdownloaden om u te helpen de voer correct formatteren.
(Voorwaardelijk) Als u CSV of Google Product Feed hebt geselecteerd, geeft u de locatie op waar de feed kan worden geopend.
FTP: Als u FTP selecteerde, verstrek de de serverinformatie van FTP, de login geloofsbrieven, filename, en de folder van FTP. U kunt FTP met SSL (FTPS) gebruiken voor veiliger uploads.
Ondersteunde FTP-serverinstellingen:
FTP en FTPS moeten zijn ingesteld op het gebruik van Passieve FTP.
Voor FTPS configureert u de server zodanig dat deze expliciete FTPS-verbindingen accepteert.
SFTP wordt niet ondersteund.
U kunt handmatig een poort opgeven waarop de verbinding moet worden gestart (bijvoorbeeld ftp://ftp.yoursite.com:2121 ). Als u geen poort opgeeft, wordt de standaard-FTP- of FTPS-poort gebruikt.
URL: Als u URL selecteert, specificeer URL.
(Voorwaardelijk) Als u Analytics Classifications hebt geselecteerd, kiest u de rapportsuite in de vervolgkeuzelijst.
Klik op de pijl Next om de opties van Schedule weer te geven.
Selecteer een updateoptie:
Daily
Weekly
Every 2 Weeks
Never: plant geen update. Kies deze optie als u deze feed niet wilt uitvoeren.
Geef de tijd op waarop de feed moet worden uitgevoerd.
Deze optie is gebaseerd op de tijdzone die in uw browser wordt gebruikt. Als u een tijd in een verschillende tijdzone wilt gebruiken, moet u die tijd volgens uw tijdzone berekenen.
Klik op de pijl Next om de Mapping -opties weer te geven en geef vervolgens op hoe u de gegevens wilt toewijzen aan Target -definities.
(Optioneel) Als u wilt dat de feed tot een omgeving (hostgroep) behoort, selecteert u de hostgroep.
De feed behoort standaard tot alle hostgroepen. Dit zorgt ervoor dat de punten in dit voer in om het even welke milieu beschikbaar zijn. Voor meer informatie, zie Gastheren.
Klik op Save.
Nadat u een feed hebt gemaakt of bewerkt, wordt de feed direct uitgevoerd. De feed wordt dan bijgewerkt volgens de parameters die u instelt. Het duurt enige tijd voordat de informatie beschikbaar is. Eerst moet de feed gesynchroniseerd worden, vervolgens moet deze worden verwerkt en geïndexeerd voordat deze kan worden gepubliceerd en beschikbaar gesteld. De huidige status verschijnt onder Status van het Gegevenin de Feeds lijst. U kunt Target sluiten voordat het proces is voltooid en het proces wordt voortgezet.
Terwijl het indexeren lopend is, verschijnen de producten en de voederkopballen alvorens de individuele waarden zijn geïndexeerd. Dit laat u zoeken en producten zien zodat kunt u inzamelingen, uitsluitingen, ontwerpen, en activiteiten tot stand brengen alvorens het indexeren is voltooid.
Wanneer in Status de tekst ''Voltooid'' wordt weergegeven, betekent dit dat het bestand is gevonden en correct is geparseerd. De informatie is niet beschikbaar voor gebruik binnen Recommendations totdat het bestand is geïndexeerd. Dit kan enige tijd in beslag nemen, afhankelijk van de grootte van het bestand. Als het proces mislukt, is het bestand niet gevonden. U hebt bijvoorbeeld een onjuiste URL gebruikt of de FTP-gegevens zijn onjuist of er is een parseringsfout opgetreden.
Voederstatussen en indicatoren
Informatie over de mogelijke voederstatussen en hun indicatoren.
Voederstatussen
De volgende statussen zijn mogelijk voor een diervoeder:
Status
Beschrijving
Syncing
Gegevens over de instellingen van feed worden opgeslagen in Target .
Sync Failed
Gegevens over instellingen van feed kunnen niet worden opgeslagen in Target . Probeer het opnieuw.
No Feed Run
U hebt een feed gemaakt, maar deze is niet gepland (de frequentie is ingesteld op Nooit).
Gepland bij datum en tijd
De feed is niet uitgevoerd, maar moet op de opgegeven datum en tijd worden uitgevoerd.
Waiting for Download
Target bereidt zich voor op het downloaden van het feed-bestand.
Downloading Feed File
Target downloadt het feed-bestand.
Importing Items
Target importeert items uit het feed-bestand.
Het voer met succes in tijd werd ingevoerd
Target heeft het feed-bestand geïmporteerd in het systeem voor de levering van inhoud. Wijzigingen in objectkenmerken zijn aangebracht in het systeem voor de levering van inhoud en zullen binnenkort worden weergegeven in de geleverde aanbevelingen. Als u de verwachte wijzigingen niet ziet, probeert u het opnieuw en vernieuwt u de pagina met aanbevelingen. Nota's:
Als wijzigingen in de kenmerken van een item ertoe leiden dat een item wordt uitgesloten van aanbevelingen, wordt de uitsluiting onmiddellijk weerspiegeld. Als een punt onlangs wordt toegevoegd, of de veranderingen in attributen in een punt resulteren dat niet meer van aanbevelingen wordt uitgesloten, wordt het niet weerspiegeld tot de volgende algoritmeupdate, die binnen 24 uren voorkomt.
Wanneer deze status wordt weergegeven, worden updates mogelijk nog niet weergegeven in de gebruikersinterface van Catalog Search . In Catalog Search wordt een aparte status weergegeven die de laatste keer aangeeft dat de doorzoekbare catalogus is bijgewerkt.
Failed to Index
De indexbewerking is mislukt. Probeer het opnieuw.
Server Not Found
FTP- of URL-locaties zijn ongeldig of anderszins onbereikbaar.
Als u een feed wilt bijwerken (bijvoorbeeld om wijzigingen aan te brengen in de configuratie of het feed-bestand), opent u de feed, brengt u de gewenste wijzigingen aan en klikt u op Save .
IMPORTANT
Geüploade entiteiten verlopen na 61 dagen. Dit betekent dat uw voederdossier minstens om de 60 dagen moet worden geupload om een verstoring van uw aanbevelingen activiteiten te vermijden. Als een item niet ten minste om de 60 dagen in een feed-bestand (of een andere methode voor het bijwerken van entiteiten) wordt opgenomen, leidt Target tot de conclusie dat het item niet langer relevant is en wordt het uit de catalogus verwijderd.
Indicatoren voor de voederstatus
De volgende statusindicatoren voor de feed worden weergegeven in de kolom Status :
Status-indicator
Beschrijving
Groene statusindicator
Wanneer een feed de indexering heeft voltooid, geeft een groene statuspunt aan dat de feed is geslaagd.
Gele statusindicator
Als een diervoeder- of voederindex wordt vertraagd met 25% van de voederfrequentie, wordt een gele statuspunt weergegeven. Bijvoorbeeld, toont een gele punt voor een voer dat wordt geplaatst om dagelijks te lopen als de index zes uur na de geplande tijd niet heeft voltooid. Opmerking: als de status van de feed 'Waiting for Index Queue' is, zijn de nieuwe bijgewerkte waarden beschikbaar in de levering en verwerking van criteria.
Wit statussymbool
Als een feed niet is gepland, geeft een witte statuspunt aan dat de feed nog niet is gestart.
Indicator voor rode status
Als de feed er niet in slaagt gegevens naar de server te uploaden, wordt een rode statusindicator weergegeven.
Neem de volgende voorbeelden:
Voorbeeld 1:
Dag één: dagelijkse voederprocessen om 9.00 uur PST.
Dag twee: het is 15:30 en het voer is sinds gisteren om 9:00 uur niet meer.
De status moet geel zijn omdat de index ongeveer 6,5 uur geleden had moeten worden uitgevoerd. 6,5 uur +24 is 127% van het voedervenster.
Voorbeeld 2:
1 januari: maandelijkse voederprocessen om 9.00 uur PST.
3 februari: om 10.00 uur en de feed is een maand, een dag en een uur geleden niet gestart.
De status moet geel zijn omdat de index ongeveer een dag en een uur geleden had moeten lopen. Hoewel dit slechts is (31+(1/25))/30 = 1,03% van de frequentie-instelling, overschrijdt het het maximum van één dag vertraging.
Trainingsvideo's
De volgende video's bevatten meer informatie over de concepten die in dit artikel worden besproken.