Gegevensbestand en gegevensbronnen voor Customer Attributes

Gegevensbestandsvereisten en meerdere gegevensbronnen voor het uploaden van Customer Attributes naar het Experience Cloud.

U hebt toegang tot CRM of vergelijkbare gegevens van uw onderneming nodig. De gegevens die u uploadt naar Experience Cloud, moeten een .csv -bestand zijn. Als u uploadt via FTP of sFTP, uploadt u ook een .fin bestand.

Customer Attributes is ontworpen om enkele bestanden per dag af te handelen. Om de kwestie te verlichten van het hebben van vele kleine dossiers vertragend verwerking, worden de dossiers die binnen 30 minuten van een vorige partij van de zelfde organisatie worden verzonden verpletterd aan een laag-prioritaire rij.

Toegestane bestandstypen en vereisten voor naamgeving section_6F64FA02ACCC4215B0862CB6A1821FBF

Bestandstype
Beschrijving
.csv

Een bestand met door komma's gescheiden waarden (bijvoorbeeld een bestand dat in Excel is gemaakt). Dit bestand bevat de kenmerkgegevens van de klant.

het Noemen vereisten: zorg ervoor dat de dossiernaamuitbreidingen geen witte ruimten bevatten.

.fin

(Vereist) Het bestand .fin geeft aan dat u klaar bent met het uploaden van gegevens. De naam van het bestand .fin moet overeenkomen met de naam van het bestand .csv .

Adobe raadt u aan een leeg tekstbestand met de extensie .fin te maken. Een leeg bestand bespaart ruimte en uploadt tijd.

Opmerking: de naam van een .fin -bestand mag niet worden gewijzigd nadat het is geüpload. Het .fin -bestand moet afzonderlijk worden geüpload en kan geen hernoemd, eerder geüpload bestand zijn.

Nadat u het .fin -bestand in de FTP met klantkenmerken hebt geüpload, haalt het systeem snel gegevens op (binnen één minuut). Dit verschilt van andere op FTP gebaseerde systemen van de Adobe, die gegevens minder vaak (ongeveer één keer per uur) oppakken.

Het bestand .fin is niet vereist wanneer u de uploadmethode voor slepen en neerzetten gebruikt.

.gz of .zip

.gz (gzip) of .zip - voor gecomprimeerde bestanden. Een .zip -bestand mag niet meer dan één bestand in het archief bevatten.

het Noemen vereisten: de naam van .zip of .gz zou de naam van .csv moeten aanpassen. Als het .csv -bestand bijvoorbeeld crm_small.csv is, moet het ZIP-bestand .zip crm_small.csv.zip zijn.

Het .fin- dossier moet .csv aanpassen.

Vereisten voor de kenmerkgegevensbestanden section_169FBF5B7BBA47CE825B7A330CF3FE98

Voorbeeld CSV

Het CSV-bestand moet de volgende indeling hebben:

Vereisten voor de dossiers van attributengegevens

Hetzelfde bestand wordt weergegeven in een teksteditor:

Vereisten voor de dossiers van attributengegevens

Richtlijnen

Item
Beschrijving
Slepen en neerzetten

Het bestand voor slepen en neerzetten moet kleiner zijn dan 100 MB.

Het bestand .fin is niet vereist wanneer u de uploadmethode voor slepen en neerzetten gebruikt.

Kolom Klant-id

De eerste kolom moet een unieke klant-id zijn. Gebruikte identiteitskaart zou aan identiteitskaart moeten beantwoorden die aan de Dienst van identiteitskaart van het Experience Cloud wordt overgegaan.

Voor Analytics wordt de id opgeslagen in een proxy of eVar.

Voor Target, de waarde setCustomerID.

Deze klant-id is de unieke id die uw CRM gebruikt voor elke persoon in uw database. De resterende kolommen zijn attributen die uit uw CRM komen. U kiest hoeveel kenmerken u wilt uploaden.

U kunt goed leesbare namen aanbevelen voor de kolomkoppen, maar deze zijn niet vereist. Wanneer u het schema na het uploaden valideert, kunt u vriendelijke namen toewijzen aan de geüploade rijen en kolommen.

Ongeveer Klant IDs

Een onderneming gebruikt doorgaans een klant-id van een CRM-systeem. Deze id wordt ingesteld met de aanroep setCustomerIDs wanneer een persoon zich aanmeldt. Deze id wordt ook gebruikt als de sleutel in het CRM-bestand dat naar het Experience Cloud is geüpload. Een alias-idis een vriendelijke naam voor een gegevensopslag in Audience Manager, waar de aliasgegevens worden opgeslagen. Het systeem verzendt aliassen naar deze gegevensopslag (via setCustomerIDs). Het CRM-bestand wordt toegepast op de gegevens in die gegevensopslag.

Zie Klantid's en verificatiestatusvoor setCustomerIDs -informatie.

Volgende koppen en kolommen

De volgende kopballen zouden de naam van elk attribuut moeten vertegenwoordigen.

Deze kolommen zouden de Attributen van de Klant moeten bevatten die uit CRM komen.

Kenmerklimieten

U kunt honderden .csv kolommen uploaden naar de dienst van Attributen van de Klant in Experience Cloud. Wanneer u echter abonnementen configureert en kenmerken selecteert, gelden de volgende limieten, afhankelijk van de toepassingen die u hebt:

  • Norm van Analytics : 3 totaal
  • Premie van Analytics : 200 per rapportreeks
  • Adobe Target Norm: 5
  • Premium van Adobe Target: 200
Rijlimieten
Er is geen limiet voor het aantal rijen bekend.
Kolomlimieten
Voor de uitvoerbaarheid beperkt u het aantal kolommen tot ongeveer 200.
Tekenbeperkingen
Als u een abonnement op Analytics maakt, wordt de veldlengte voor de geüploade bestanden afgebroken tot 255.
FTP-richtlijnen en groottebeperkingen
  • Maximale bestandsgrootte voor FTP is 4 GB voor elke upload.
  • Minimale bestandsgroottelimiet voor 10 MB voor elke upload.
  • U kunt elk half uur één bestand uploaden.
  • Plaats het .csv -bestand (en het .fin -bestand) in de hoofdmap van de FTP-site.

Belangrijk: de totale hoeveelheid ruimte die voor de FTP-account is toegestaan, is 40 GB. Het is uw verantwoordelijkheid om verwerkte bestanden te verwijderen.

Bestandsvereisten

Elke kenmerkbron moet hetzelfde aantal door komma's gescheiden velden bevatten.

Velden met een regeleinde, een dubbel aanhalingsteken of komma moeten worden opgegeven.

Dubbele aanhalingstekens in een veld moeten worden voorkomen met een backslash (\).

Lege kolommen worden opgeslagen als null .

Meerdere bestanden

Wanneer u kenmerkgegevens van de klant uploadt en u meerdere bestanden hebt die u snel na elkaar wilt uploaden, en vooral als de bestanden groot zijn, moet u controleren of het vorige bestand is verwerkt voordat u het volgende bestand uploadt. U kunt dit controleren door te controleren wanneer het vorige bestand naar de verwerkte of mislukte map in uw Customer Attributes FTP-account is verplaatst.

Wanneer u een groot bestand in kleinere bestanden splitst en snel na elkaar verzendt, kan dit de verwerking vertragen, tenzij u ervoor kunt zorgen dat elk bestand wordt verwerkt voordat het volgende bestand wordt verzonden.

Tekencodering
Voor Japan is UTF-8 verplicht.
Historische gegevens

Klantkenmerken zijn gekoppeld aan het onderliggende bezoekersprofiel in Analytics . Customer Attributes wordt daarom gedurende de gehele levensduur van dat bezoekersprofiel gekoppeld aan de bezoeker in Analytics . Dit profiel bevat gedrag dat is opgetreden voordat de klant zich voor het eerst heeft aangemeld.

Als u de backfill methode van de Data Warehouse gebruikt, zijn de gegevens gebonden aan post_visid_high/low die op analytics ID (HULP) gebaseerd is. Als u de Dienst van identiteitskaart van het Experience Cloud gebruikt, zijn de gegevens gebonden aan post_visid_high/low die op Experience Cloud identiteitskaart (MID) gebaseerd is.

De backfill-methode voor Data Warehouse is vanaf oktober 2022 niet meer beschikbaar.

Gegevensfeeds
Klantkenmerken zijn niet beschikbaar in gegevensfeeds.

Meerdere gegevensbronnen gebruiken section_76DEB6001C614F4DB8BCC3E5D05088CB

Wanneer het creëren van, het wijzigen van, of het schrappen van de bronnen van de Attributen van de Klant, is er een vertraging rond één uur alvorens IDs met de nieuwe gegevensbron begint te synchroniseren.

De alias-id voor elke kenmerkbron van de klant moet uniek zijn. Als u meerdere gegevensbronnen hebt die dezelfde id gebruiken, kunnen deze als volgt worden ingesteld:

in VisitorAPI.js of het hulpmiddel van identiteitskaart van het Experience Cloud in dynamisch markeringsbeheer:

Stel twee klant-id's in die overeenkomen met de juiste gegevensbronnen:

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

(Zie Identiteitskaart van de Klant en de Staten van de Authentificatievoor meer informatie.)

In de lus Experience Cloud > People > Customer Attributes :

Maak twee bronnen voor klantkenmerken met behulp van unieke alias-id's die overeenkomen met de bovenstaande klant-id's. Met deze methode kan dezelfde referentie-id naar meerdere bronnen van kenmerk van klant worden verzonden.

recommendation-more-help
872fc4ed-f5f7-4b59-a6f8-4ddabe5aac1f