Gegevensbestand en gegevensbronnen voor Customer Attributes
Gegevensbestandsvereisten en meerdere gegevensbronnen voor het uploaden van klantkenmerkgegevens naar 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
.csv.fin.fin -bestand geeft aan het systeem door 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. Nota: het anders noemen van een .fin dossier wordt niet toegestaan nadat het wordt geupload. Het .fin -bestand moet afzonderlijk worden geüpload en kan geen hernoemd, eerder geüpload bestand zijn. Nadat u het .fin -bestand in de attributen FTP van de klant hebt geüpload, haalt het systeem snel gegevens op (binnen één minuut). Dit verschilt van andere op FTP gebaseerde Adobe-systemen, die gegevens minder vaak (ongeveer één keer per uur) ophalen. 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. Naamgevingsvereisten: de naam van het bestand .zip of .gz moet overeenkomen met de naam van het bestand .csv . Als uw .csv -bestand bijvoorbeeld crm_small.csv is, moet het .zip -bestand crm_small.csv.zip zijn. Het bestand .fin moet overeenkomen met het bestand .csv .Vereisten voor de kenmerkgegevensbestanden section_169FBF5B7BBA47CE825B7A330CF3FE98
Voorbeeld CSV
Het CSV-bestand moet de volgende indeling hebben:
Hetzelfde bestand wordt weergegeven in een teksteditor:
Richtlijnen
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.
De eerste kolom moet een unieke klant-id zijn. De gebruikte id moet overeenkomen met de id die wordt doorgegeven aan de Experience Cloud-id-service.
Voor Analytics wordt de id opgeslagen in een prop of eVar.
Voor Doel, de setcustomerID waarde.
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 Experience Cloud wordt 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 Customer ID's en verificatiestatussen voor informatie over setcustomerID's.
De volgende kopballen zouden de naam van elk attribuut moeten vertegenwoordigen.
Deze kolommen zouden klantenattributen moeten bevatten die uit CRM komen.
U kunt honderden kolommen .csv uploaden naar de klantenkenmerkservice 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
- 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.
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 .
Als u kenmerkgegevens van klanten 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.
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 Data Warehouse backfill methode gebruikt, zijn de gegevens gekoppeld aan een post_visid_high/low die is gebaseerd op de Analytics ID (AID). Als u de Experience Cloud ID Service gebruikt, zijn de gegevens gekoppeld aan een post_visid_high/low die is gebaseerd op Experience Cloud ID (MID).
De Data Warehouse backfill-methode is vanaf oktober 2022 niet meer beschikbaar.
Meerdere gegevensbronnen gebruiken multiple
Wanneer het creëren van, het wijzigen van, of het schrappen van de bronnen van de klantenattributen, is er een vertraging rond één uur alvorens IDs met de nieuwe gegevensbron begint te synchroniseren.
Alias ID voor elke bron van klantkenmerken 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 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 klant IDs en de Staten van de Authentificatievoor meer informatie.)
In Experience Cloud > Customer Attributes :
Maak twee bronnen voor klantkenmerken met behulp van unieke alias-id's die overeenkomen met de bovenstaande id's van de klant. Met deze methode kan dezelfde referentie-id naar meerdere bronnen voor klantkenmerken worden verzonden.