Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
Ämnen:
Använd feeds för att importera entiteter till Adobe Target Recommendations. Enheter kan skickas med CSV-filer, Google produktsökningsformat och Adobe Analytics produktklassificeringar.
Med feeds kan du skicka entiteter eller förstärka dina mbox-data med information som antingen inte är tillgänglig på sidan eller som inte kan skickas direkt från sidan, t.ex. marginal, COGS osv.
Med feeds kan du skicka detaljerad objektinformation till Recommendations, t.ex. produkt-ID, kategori, namn, meddelande och andra attribut.
Du kan välja vilka kolumner från din Target produktklassificeringsfil eller Google produktsökningsfil som du vill skicka till Recommendations-servern.
Dessa datadelar för varje objekt kan sedan användas för att:
Visa värden i design
Definiera villkor för inkludering
Sortera objekt i olika samlingar
Tillämpa undantag för rekommendationer
Du kan skicka objektbeskrivningar till Target med hjälp av feeds eller mbox. Om data samlas in både av en entitetsfeed och en mbox, vinner den senaste informationen. Vanligtvis kommer de senaste data från en mbox, eftersom de visas oftare. I den sällsynta händelse att enhetsmatningsdata och mbox-data träffar samtidigt, används mbox-data.
Listan Feeds ( Recommendations > Feeds) innehåller information om alla feeds som du har skapat.
Sidan Feeds innehåller följande kolumner:
Namn: Namnet på den feed som angavs när den skapades. Om du vill redigera namnet på en feed måste du redigera själva feeden. När du sparar feeden med det nya namnet uppdateras feeden.
Schema: Visar uppdateringsschemat för feed: Daily, Weekly, Every 2 Weeks eller Never.
Objekt: Visar antalet objekt i feeden.
Senast uppdaterad: Visar datum och tid då feeden senast uppdaterades och namnet på den person som uppdaterade feeden. Om matningen Last Updated säger"undefined" kommer matningen från Recommendations Classic och kan inte ändras inifrån Target Premium Recommendations.
Klicka på informationsikonen för att visa ett kort som visar det senaste överföringsdatumet och feed-URL:en.
Klicka på ellipsikonen för att komma åt följande åtgärder: Deactivate, Edit, Copy och Delete.
IMPORTANT
Överförda entiteter och entitetsattribut upphör att gälla efter 61 dagar. Detta innebär:
Din feed bör köras minst en gång i månaden för att säkerställa att kataloginnehållet inte går ut.
När du tar bort ett objekt från din feed-fil tas det inte bort från katalogen. Om du vill ta bort objektet från katalogen tar du bort det manuellt via Target-gränssnittet eller API:t. Eller ändra artikelattributen (t.ex. lager) för att säkerställa att artikeln utesluts från övervägande.
Source
Enheter kan skickas med CSV-filer, Google produktsökningsformat och Adobe Analytics produktklassificeringar.
CSV section_65CC1148C7DD448FB213FDF499D35FCA
Du kan skapa en CSV-fil med det egna CSV-överföringsformatet Adobe. Filen innehåller visningsinformation om de reserverade och anpassade attributen för dina produkter. Om du vill överföra attribut som är specifika för implementeringen ersätter du CustomN i rubrikraden med namnet på det attribut som du vill använda. I exemplet nedan har entity.Custom1 ersatts med: entity.availability. Du kan sedan överföra filen till servern Recommendations gruppvis.
Att använda CSV-formatet har följande fördelar jämfört med Google Feed-formatet:
CSV-formatet kräver inte fältkopplingar.
CSV-formatet stöder attribut med flera värden (se exemplet nedan).
CSV-formatet har stöd för upp till 100 anpassade attribut. Om du behöver fler än 100 anpassade attribut kan du skapa en andra feed-fil med en annan uppsättning anpassade attribut angivna.
Använd metoden för massöverföring för att skicka visningsinformation om du inte har några kryssrutor på sidan, eller om du vill komplettera visningsinformationen med objekt som inte är tillgängliga på webbplatsen. Du kan till exempel skicka lagerinformation som inte är publicerad på din plats.
Alla data som överförs med CSV-filen, Google produktfeed eller Analytics Produktklassificeringsfeed skriver över det befintliga entitetsattributvärdet i databasen. Om du skickar prisinformation via mbox-begäranden och sedan skickar olika prisvärden i filen, skriver värdena i filen över de värden som angetts med mbox-begäran. Ett undantag till detta är entitetsattributet categoryId där kategorivärdena läggs till i stället för att skrivas över upp till gränsen på 250 tecken.
IMPORTANT
Omge inte värden med citattecken ( " ) i CSV-filen om de inte är avsiktliga. Om du omsluter värden med dubbla citattecken måste du undvika dem genom att omsluta dem med en annan uppsättning dubbla citattecken. Dubbla citattecken som inte escape-konverteras förhindrar att rekommendationsfeeden läses in korrekt.
Följande syntax är till exempel felaktig:
"Apples "Bananas" Grapes"",
Följande syntax är korrekt:
"Apples ""Bananas"" Grapes""",
NOTE
Du kan inte skriva över ett befintligt värde med ett tomt värde. Skriv över ett annat värde i stället. Vid ett försäljningspris är en gemensam lösning att antingen skicka in ett faktiskt"NULL" eller något annat meddelande. Du kan sedan skriva en mallregel för att exkludera objekt med det värdet.
Produkten är tillgänglig i administratörsgränssnittet cirka två timmar efter att enheten har överförts.
Följande är exempelkod för en CSV-fil:
## 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
Google produktsökningsfeed-typen använder Google-formatet. Detta skiljer sig från det egna CSV-överföringsformatet för Adobe.
Om du har en Google-produktfeed kan du använda den som importfil.
NOTE
Du behöver inte använda Google-data. Recommendations använder samma format som Google. Du kan använda den här metoden för att överföra data som du har och använda de tillgängliga schemafunktionerna. Du måste dock behålla Google fördefinierade attributnamn när du konfigurerar filen.
De flesta återförsäljare överför produkter till Google, så när en besökare använder Google produktsökning visas deras produkter. Recommendations följer Google-specifikationen exakt för entitetsfeeds. Entitetsfeeds kan skickas till Recommendations via .xml, .txt eller .tsv, och du kan använda de attribut som definieras av Google. Resultaten är sökbara på Google shoppingsidor.
NOTE
Metoden POST måste vara tillåten på den server som är värd för Google feed-innehåll.
Eftersom Recommendations användare redan har konfigurerat .xml- eller .txt-feeds för att skicka till Google via URL eller FTP, accepterar entitetsflödena produktdata och använder dem för att skapa rekommendationskatalogen. Ange var denna feed finns och rekommendationsservern hämtar data.
Om du använder Google produktsökning för överföring av enhetsfeed måste du ändå ha en produktsidesruta på sidan om du vill visa rekommendationer där eller spåra produktvyer för algoritmleverans baserat på vyer.
Google-feeds stöder inte flera värden för ett anpassat attribut.
Flödet körs när du sparar och aktiverar det. Den körs vid den tidpunkt då du sparar flödet, och därefter varje dag i en timme.
Följande är exempelkod för en XML-fil i Google Product Search feed:
Följande är exempelkod för en Google Product Search feed .tsv-fil:
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
Produktklassificeringen Analytics är den enda klassificeringen som är tillgänglig för rekommendationer. Mer information om den här klassificeringsfilen finns i Om klassificeringar i guiden Analyskomponenter. Det är möjligt att inte all information du behöver för rekommendationer finns tillgänglig i den aktuella implementeringen, så följ den här användarhandboken om du vill lägga till i klassificeringsfilen.
IMPORTANT
Innan du importerar entitetsdata till Recommendations med Analytics produktklassificeringar bör du vara medveten om att detta inte är den rekommenderade metoden.
Var uppmärksam på följande kavattar:
Uppdateringar av entitetsattribut medför en ytterligare fördröjning på upp till 24 timmar.
Target har bara stöd för Product Classifications. Produkt-SKU:n Analytics måste mappas till samma nivå som Recommendations entity.id. Anpassade Analytics-klassificeringar kan skapas med Adobe Consulting Services. Kontakta din kontoansvarige med frågor.
Skapa feed steps
Skapa en feed om du vill infoga information om dina produkter eller tjänster i Recommendations.
I målgränssnittet klickar du på Recommendations > Feeds > Create Feed.
Ange ett beskrivande namn för feeden.
Välj en Source Type.
CSV
Google Product Feed
Analytics Classifications
Mer information om flödestyperna CSV och Google Product Feed finns i Feeds - översikt. Du kan även hämta en CSV-guide för modellen så att du kan formatera flödet korrekt.
(Villkorligt) Om du valde CSV eller Google Product Feed anger du platsen där feeden kan nås.
FTP: Om du har valt FTP anger du FTP-serverinformationen, inloggningsuppgifterna, filnamnet och FTP-katalogen. Du kan använda FTP med SSL (FTPS) för säkrare överföringar.
FTP-serverinställningar som stöds:
FTP och FTPS måste anges till Passiv FTP.
För FTPS ska du konfigurera servern så att den accepterar explicita FTPS-anslutningar.
SFTP stöds inte.
Du kan ange en port som anslutningen ska initieras på manuellt (till exempel ftp://ftp.yoursite.com:2121). Om du inte anger någon port används FTP- eller FTPS-standardporten.
URL: Om du väljer URL anger du URL:en.
(Villkorligt) Om du valde Analytics Classifications väljer du rapportsviten i listrutan.
Klicka på pilen Next för att visa alternativen för Schedule.
Välj ett uppdateringsalternativ:
Daily
Weekly
Every 2 Weeks
Never: Schemalägg inte någon uppdatering. Välj det här alternativet om du inte vill att denna feed ska köras.
Ange den tid då du vill att din feed ska köras.
Det här alternativet baseras på den tidszon som används i webbläsaren. Om du vill använda en tid i en annan tidszon måste du beräkna den tiden enligt din tidszon.
Klicka på pilen Next för att visa Mapping-alternativen och ange sedan hur du vill mappa dina data till Target-definitioner.
(Valfritt) Om du vill att flödet ska tillhöra en miljö (värdgrupp) väljer du värdgruppen.
Som standard tillhör feeden alla värdgrupper. Detta garanterar att objekt i denna feed är tillgängliga i alla miljöer. Mer information finns i Värdar.
Klicka på Save.
När du har skapat eller redigerat en feed körs den omedelbart. Flödet uppdateras sedan enligt de parametrar som du anger. Det tar ett tag innan informationen är tillgänglig. Först måste feeden synkroniseras, sedan måste den bearbetas och indexeras innan den kan publiceras och göras tillgänglig. Aktuell status visas under Feed-status i listan Feeds. Du kan stänga Target innan processen är klar och processen fortsätter.
När indexering pågår visas produkter och flödeshuvuden innan enskilda värden har indexerats. På så sätt kan du söka efter och visa produkter så att du kan skapa samlingar, uteslutningar, designer och aktiviteter innan indexeringen har slutförts.
När det står"Slutfört" i status betyder det att filen hittades och att den tolkades korrekt. Informationen är inte tillgänglig för användning inom Recommendations förrän filen har indexerats, vilket kan ta en stund beroende på filens storlek. Om processen misslyckas betyder det att filen inte kunde hittas. Du använde till exempel en felaktig URL eller FTP-informationen var felaktig eller så var det ett tolkningsfel.
Feedstatus och indikatorer concept_E475986720D1400999868B3DFD14A7A0
Information om möjliga feedstatusar och deras indikatorer.
Feed-status status
Följande är möjliga statusvärden för en feed:
Status
Beskrivning
Syncing
Feed-inställningsinformation sparas i Target.
Sync Failed
Det gick inte att spara information om matningsinställningar i Target. Försök igen.
No Feed Run
Du har skapat en feed men den har inte schemalagts (frekvensen anges till Aldrig).
Schemalagd datum och tid
Feed har inte körts, men är schemalagd att köras vid angivet datum och angiven tid.
Waiting for Download
Target förbereder hämtning av feed-filen.
Downloading Feed File
Target hämtar feed-filen.
Importing Items
Target importerar objekt från feed-filen.
Feed importerades time
Target har importerat feed-filen till innehållsleveranssystemet. Ändringar av objektattribut har gjorts i innehållsleveranssystemet och kommer snart att återspeglas i levererade rekommendationer. Om du inte ser de förväntade ändringarna kan du försöka igen och uppdatera sidan med rekommendationer. Obs!
Om ändringar i ett objekts attribut leder till att ett objekt utesluts från rekommendationerna, återspeglas uteslutningen omedelbart. Om ett objekt nyligen har lagts till, eller om attributändringar resulterar i att ett objekt inte längre utesluts från rekommendationer, återspeglas det inte förrän nästa algoritmuppdatering, som sker inom 24 timmar.
När den här statusen visas kanske inte uppdateringarna visas i användargränssnittet för Catalog Search än. En separat status visas i Catalog Search som anger den senaste gången den sökbara katalogen uppdaterades.
Failed to Index
Indexåtgärden misslyckades. Försök igen.
Server Not Found
FTP- eller URL-platserna är ogiltiga eller går inte att nå på annat sätt.
Om du vill uppdatera en feed (till exempel om du vill ändra din flödeskonfiguration eller feed-fil) öppnar du den, gör önskade ändringar och klickar på Save.
IMPORTANT
Överförda enheter upphör att gälla efter 61 dagar. Det innebär att din feed-fil ska laddas upp minst var 60:e dag för att undvika avbrott i dina rekommendationer. Om ett objekt inte ingår i en feed-fil (eller någon annan metod för entitetsuppdatering) minst en gång var 60:e dag, är Target inte längre relevant och tar bort det från katalogen.
Indikatorer för matningsstatus section_3C8A236C5CB84C769A9E9E36B8BFABA4
Följande statusindikeringar för feed visas i kolumnen Status:
Statusindikator
Beskrivning
Grön statusindikator
När en feed har indexerats utan fel anger en grön statuspunkt att feeden är i ett lyckat läge.
Gul statusindikator
När ett feed- eller feed-index fördröjs med 25 % av matningsfrekvensen visas en gul statuspunkt. En gul punkt visas till exempel för en feed-uppsättning som körs dagligen om indexet inte har slutförts sex timmar efter den schemalagda tiden. Obs! När matningsstatusen är"Väntar på indexkö" är de nyligen uppdaterade värdena tillgängliga vid leverans och villkorsbearbetning.
Indikator för vit status
När en feed inte är schemalagd anger en vit statuspunkt att den inte har körts än.
Röd statusindikator
Om feeden inte kan överföra data till servern visas en röd statusindikator.
Titta på följande exempel:
Exempel 1:
Dag ett: dagliga foderprocesser klockan 9.00 PST.
Dag två: klockan är 23.30 och maten har inte gått sedan i går klockan 9.00.
Statusen bör vara gul eftersom indexet borde ha körts för cirka 6,5 timmar sedan. 6,5 timmar +24 är 127% av matningsfönstret.
3 februari: klockan är 10.00 och maten har inte gått på en månad, en dag och en timme sedan.
Statusen ska vara gul eftersom indexet ska ha körts för ungefär en dag och en timme sedan. Även om detta endast är (31+(1/25))/30 = 1,03 % av frekvensinställningen, överskred det maximala antalet endagsfördröjningar.
Utbildningsvideor
I följande videofilmer finns mer information om de begrepp som beskrivs i den här artikeln.
