Om datafiler och datakällor för kundattribut

Senaste uppdatering: 2022-09-23
  • Skapat för:
  • Experienced
    Admin

Datafilskrav och flera datakällor för överföring av kundattribut till Experience Cloud.

Du behöver åtkomst till CRM eller liknande data från ditt företag. De data du överför till Experience Cloud måste vara .csv -fil. Om du överför via FTP eller sFTP överför du även en .fin -fil.

Kundattribut är utformat för att hantera några filer per dag. För att minska problemet med att ha många små filer som försenar bearbetningen dirigeras filer som skickas inom 30 minuter från en tidigare batch från samma organisation till en kö med lägre prioritet.

Tillåtna filtyper och namnkrav

Filtyp Beskrivning

.csv

En fil med kommaavgränsade värden (t.ex. en som skapats i Excel). Den här filen innehåller kundattributsdata.

Namngivningskrav: Kontrollera att filnamnstilläggen inte innehåller blanksteg.

.fin

(Obligatoriskt) .fin filen talar om för systemet att du har överfört alla data. Namnet på .fin filen måste matcha namnet på .csv -fil.

Adobe rekommenderar att du skapar en tom textfil med en .fin tillägg. En tom fil sparar utrymme och laddningstid.

Obs! Byta namn på en .fin filen tillåts inte efter att den har överförts. The .fin filen måste överföras separat och kan inte ha bytt namn, tidigare överförd fil.

När du har överfört .fin i kundattributens FTP hämtar systemet data snabbt (inom en minut). Detta skiljer sig från andra Adobe FTP-baserade system, som hämtar in data mindre ofta (ungefär en gång i timmen).

The .fin filen behövs inte när du använder metoden för att dra och släppa uppladdning.

.gz eller .zip

.gz (gzip) eller .zip - för komprimerade filer. A .zip filen får inte innehålla mer än en fil i arkivet.

Namngivningskrav: Namnet på .zip eller .gz ska matcha namnet på .csv . Om .csv filen är crm_small.csv , .zip filen ska vara crm_small.csv.zip .

FIN-filen måste matcha CSV-filen.

Krav för attributdatafiler

Exempel på CSV

CSV-filen måste ha följande format:

Krav för attributdatafiler

Samma fil som visas i en textredigerare:

Krav för attributdatafiler

Riktlinjer

Objekt Beskrivning

Dra och släppa

Dra och släpp-filen bör vara mindre än 100 MB.

The .fin filen behövs inte när du använder metoden för att dra och släppa uppladdning.

Kund-ID, kolumn

Den första kolumnen måste vara ett unikt kund-ID. Det ID som används ska motsvara det ID som skickas till Experience Cloud ID-tjänsten.

För Analytics lagras ID:t i en propp eller eVar.

För Target anger du värdet setCustomerID. (Se Analytics & Adobe Target - synkronisera kund-ID )

Detta kund-ID är den unika identifierare som CRM använder för varje person i din databas. De återstående kolumnerna är attribut som kommer från CRM. Du väljer hur många attribut du vill överföra.

Ett läsbart namn rekommenderas för kolumnrubrikerna, men det behövs inte. När du validerar schemat efter överföring kan du mappa egna namn till överförda rader och kolumner.

Om Kund-ID

Ett företag använder vanligtvis ett kund-ID från ett CRM-system. Detta ID anges med setCustomerIDs ringa när en person loggar in. Detta ID används också som nyckel i CRM-filen som överförs till Experience Cloud. An Alias-ID är ett eget namn för ett datalager i Audience Manager, där aliasdata lagras. Systemet skickar alias till detta datalager (via setCustomerID:n). CRM-filen används på data i det datalagret.

För setCustomerIDs information, se Kund-ID och autentiseringstillstånd .

Efterföljande rubriker och kolumner

Efterföljande rubriker ska representera namnet på varje attribut.

Dessa kolumner ska innehålla kundattribut som kommer från CRM.

Attributgränser

Du kan överföra hundratals .csv kolumner till tjänsten Customer Attribute i Experience Cloud. När du konfigurerar prenumerationer och väljer attribut gäller dock följande begränsningar beroende på vilka program du äger:

  • Analytics Standard: 3 totalt
  • Analytics Premium: 200 per rapportserie
  • Adobe Target Standard: 5
  • Adobe Target Premium: 200

Radbegränsningar

Det finns ingen känd gräns för antalet rader.

Kolumngränser

Av praktiska skäl bör du begränsa antalet kolumner till ca 200.

Teckengränser

När du skapar en Analytics-prenumeration trunkeras fältlängderna för de överförda filerna till 255.

FTP-riktlinjer och storleksbegränsningar

  • Maximal filstorlek för FTP är 4 GB för varje överföring.
  • Minsta filstorleksgräns för 10 MB för varje överföring.
  • Du kan överföra en fil var halvtimme.
  • Du borde släppa din .csv (och .fin ) i FTP-platsens rotmapp.

Viktigt: Det totala tillåtna utrymmet för FTP-kontot är 40 GB. Det är ditt ansvar att ta bort bearbetade filer.

Filkrav

Varje attributkälla ska innehålla samma antal kommaavgränsade fält.

Fält som innehåller en radbrytning, dubbla citattecken eller kommatecken måste citeras.

Dubbelcitattecken i ett fält måste föregås av ett omvänt snedstreck (\).

Tomma kolumner lagras som null .

Flera filer

När du överför kundattributdata, och om du har flera filer som du vill överföra i snabb följd, och särskilt om filerna är stora, bör du kontrollera att den föregående filen har bearbetats innan du överför nästa fil. Du kan övervaka detta genom att kontrollera när föregående fil har flyttats till den bearbetade eller misslyckade mappen i din Customer Attributes FTP-konto.

Att dela upp en stor fil i mindre filer och skicka in dem i snabb följd kan i själva verket göra bearbetningen långsammare, såvida du inte kan säkerställa att varje fil bearbetas innan du skickar in nästa.

Teckenkodning

För Japan är UTF-8 obligatoriskt.

Historiska data

Kundattribut är knutna till den underliggande besökarprofilen i Analytics. Som sådan Customer Attributes är kopplade till besökaren under hela besökarprofilens livstid i Analytics. Den här profilen innehåller beteenden som inträffade innan kunden loggade in för första gången.

Om du använder metoden för bakåtfyllnad i Data warehouse är data knutna till en post_visid_high/low som är baserad på analys-ID (AID). Om du använder Experience Cloud ID-tjänsten är data knutna till en post_visid_high/low som är baserad på Experience Cloud ID (MID).

Observera att metoden Data warehouse backfill inte längre är tillgänglig från och med oktober 2022.

Dataflöden

Kundattribut är inte tillgängliga i dataflöden.

Använda flera datakällor

När du skapar, ändrar eller tar bort kundattributskällor är det en fördröjning på ungefär en timme innan ID:n börjar synkronisera med den nya datakällan.

Alias-ID för varje kundattributkälla måste vara unikt. Om du har flera datakällor som använder samma ID kan de konfigureras på följande sätt:

I VisitorAPI.js eller verktyget Experience Cloud ID i dynamisk tagghantering:

Ange två kund-ID som motsvarar rätt datakällor:

Visitor.setCustomerIDs({
     "ds_id1":"123456",
     "ds_id2":"123456"
});

(Se Kund-ID och autentiseringstillstånd för mer information.)

I Experience Cloud > People > Customer Attributes:

Skapa två kundattribut med unika alias-ID:n som motsvarar kundens ID:n ovan. Med den här metoden kan samma referens-ID skickas till flera källor för kundattribut.

På denna sida