Documentatie Experience Platform Gids voor Source Connectors

Beta

Een Merkury Enterprise Identity Resolution bronverbinding en gegevensstroom maken in de gebruikersinterface

Laatst bijgewerkt: 8 augustus 2024

Onderwerpen:

Gemaakt voor:

Ontwikkelaar

NOTE

De bron Merkury Enterprise Identity Resolution is in bèta. Gelieve te lezen het overzicht van bronnenvoor meer informatie bij het gebruiken van bèta-geëtiketteerde bronnen.

Deze zelfstudie bevat stappen voor het maken van een Merkury Enterprise Identity Resolution bronverbinding en gegevensstroom via de Adobe Experience Platform-gebruikersinterface.

Aan de slag

Deze zelfstudie vereist een goed begrip van de volgende onderdelen van het Experience Platform:

Experience Data Model (XDM) Systeem: Het gestandaardiseerde kader waardoor het Experience Platform gegevens van de klantenervaring organiseert.
- Grondbeginselen van schemacompositie: Leer over de basisbouwstenen van schema's XDM, met inbegrip van zeer belangrijke principes en beste praktijken in schemacompositie.
- het leerprogramma van de Redacteur van het Schema: Leer hoe te om douaneschema's tot stand te brengen gebruikend de Redacteur UI van het Schema.
Real-Time Customer Profile: biedt een uniform, real-time consumentenprofiel dat is gebaseerd op geaggregeerde gegevens van meerdere bronnen.

Vereiste referenties verzamelen

Om tot uw emmer op Experience Platform toegang te hebben, moet u geldige waarden voor de volgende geloofsbrieven verstrekken:

Credentials	Beschrijving
Toegangstoets	De toegangs belangrijkste identiteitskaart voor uw emmer. U kunt deze waarde ophalen van uw Merkury -team.
Geheime sleutel	De geheime sleutel-id voor uw emmer. U kunt deze waarde ophalen van uw Merkury -team.
Naam van emmertje	Dit is uw Merkury bucket waar de dossiers zullen worden gedeeld. U kunt deze waarde ophalen van uw Merkury -team.

Voor meer informatie over opstelling voor Merkury en andere eerste vereisten, lees het Merkury bronoverzicht.

Maak verbinding met uw Merkury-account

Selecteer in de gebruikersinterface van het platform Sources in de linkernavigatiebalk voor toegang tot de werkruimte van Sources . In het scherm Catalog worden diverse bronnen weergegeven waarmee u een account kunt maken.

U kunt de juiste categorie selecteren in de catalogus aan de linkerkant van het scherm. U kunt ook de specifieke bron vinden waarmee u wilt werken met de zoekoptie.

Selecteer onder de categorie Data partners de optie Merkury en selecteer vervolgens Set up .

de broncatalogus met de geselecteerde bron van de Merkury.

De pagina Connect to Merkury wordt weergegeven. Op deze pagina kunt u nieuwe of bestaande referenties gebruiken.

Een nieuwe account maken

Selecteer New account als u nieuwe referenties gebruikt. Geef in het invoerformulier dat wordt weergegeven een naam, een optionele beschrijving en uw Merkury -gegevens op. Als u klaar bent, selecteert u Connect to source en laat u de nieuwe verbinding enige tijd tot stand brengen.

de nieuwe rekeningsinterface voor Merkury.

Een bestaande account gebruiken

Als u een bestaande account wilt gebruiken, selecteert u Existing account en vervolgens de Merkury -account die u wilt gebruiken. Selecteer Next om door te gaan.

de bestaande rekeningsinterface voor Merkury.

Gesteunde dossierformaten

U kunt de volgende bestandsindelingen invoeren met de Merkury -bron:

DSV (Delimiter-separated-separated values, gescheiden waarden): elke waarde van één teken kan worden gebruikt als scheidingsteken voor gegevensbestanden met DSV-indeling.
JavaScript Object Notation (JSON): gegevensbestanden met JSON-indeling moeten XDM-compatibel zijn.
Apache Parquet: gegevensbestanden met Parketindeling moeten XDM-compatibel zijn.
Gecomprimeerde bestanden: JSON- en gescheiden bestanden kunnen worden gecomprimeerd als: bzip2, gzip, deflate, zipDeflate, tarGzip en tar .

Gegevens toevoegen

Nadat u uw Merkury -account hebt gemaakt, wordt de stap Add data weergegeven. Deze stap bevat een interface waarmee u de bestandshiërarchie van Merkury kunt verkennen en de map of het specifieke bestand kunt selecteren die u naar het Experience Platform wilt verzenden.

Het linkergedeelte van de interface is een directorybrowser waarin de bestandshiërarchie van Merkury wordt weergegeven.
In het rechtergedeelte van de interface kunt u maximaal 100 rijen gegevens uit een compatibele map of bestand voorvertonen.

het dossier en de omslagfolder van het bronwerkschema waar u de gegevens kunt selecteren die u wilt opnemen.

Selecteer de hoofdmap voor toegang tot de mappenhiërarchie. Van hieruit kunt u één map selecteren om alle bestanden in de map recursief in te voeren. Wanneer u een volledige map opgeeft, moet u ervoor zorgen dat alle bestanden in die map dezelfde gegevensindeling en hetzelfde schema hebben.

Nadat u een map hebt geselecteerd, wordt de juiste interface bijgewerkt met een voorvertoning van de inhoud en structuur van het eerste bestand in de geselecteerde map.

de gegevens die voor opname en de interface van de dossiervoorproef worden geselecteerd.

Tijdens deze stap kunt u verschillende configuraties aan uw gegevens toevoegen voordat u verdergaat. Selecteer eerst Data format en selecteer vervolgens de juiste gegevensindeling voor het bestand in het vervolgkeuzemenu dat wordt weergegeven.

In de volgende tabel worden de juiste gegevensindelingen voor de ondersteunde bestandstypen weergegeven:

Bestandstype	Gegevensindeling
CSV	Delimited
JSON	JSON
Parquet	XDM Parquet

Een kolomscheidingsteken selecteren

Selecteren om stappen weer te geven voor het instellen van een scheidingsteken

Nadat u de gegevensindeling hebt geconfigureerd, kunt u een kolomscheidingsteken instellen bij het invoegen van gescheiden bestanden. Selecteer de optie Delimiter en selecteer vervolgens een scheidingsteken in het vervolgkeuzemenu. Het menu toont de vaakst gebruikte opties voor afbakeningen, met inbegrip van een komma (,), een lusje (\t), en een pijp (|).

Als u liever een aangepast scheidingsteken gebruikt, selecteert u Custom en voert u in de pop-upinvoerbalk een scheidingsteken voor één teken in.

Gecomprimeerde bestanden samenvoegen

Selecteren om stappen weer te geven voor het opnemen van gecomprimeerde bestanden

U kunt ook gecomprimeerde JSON- of gescheiden bestanden opnemen door het compressietype ervan op te geven.

Selecteer in de stap Select data een gecomprimeerd bestand voor inname en selecteer vervolgens het juiste bestandstype en of het al dan niet compatibel is met XDM. Selecteer vervolgens Compression type en selecteer het juiste gecomprimeerde bestandstype voor de brongegevens.

Als u een specifiek bestand wilt overbrengen naar Platform, selecteert u een map en selecteert u vervolgens het bestand dat u wilt opnemen. Tijdens deze stap kunt u ook een voorbeeld van de bestandsinhoud van andere bestanden in een bepaalde map bekijken met het voorvertoningspictogram naast een bestandsnaam.

Selecteer Next als u klaar bent.

Gegevens over gegevensstroom opgeven

Met de pagina Dataflow detail kunt u selecteren of u een bestaande gegevensset of een nieuwe gegevensset wilt gebruiken. Tijdens dit proces kunt u ook de gegevens configureren die u in het profiel wilt opnemen en instellingen als Error diagnostics , Partial ingestion en Alerts inschakelen.

Een bestaande gegevensset gebruiken

Selecteer Existing dataset als u gegevens in een bestaande gegevensset wilt opnemen. U kunt of een bestaande dataset terugwinnen gebruikend de Advanced search optie of door door de lijst van bestaande datasets in het dropdown menu te scrollen. Zodra u een dataset hebt geselecteerd, verstrek een naam en een beschrijving voor uw gegevensstroom.

de bestaande datasetinterface.

Een nieuwe gegevensset gebruiken

Om in een nieuwe dataset in te gaan, selecteer New dataset en verstrek dan een naam van de outputdataset en een facultatieve beschrijving. Selecteer vervolgens het schema dat u wilt toewijzen met de optie Advanced search of door door de lijst met bestaande schema's in het vervolgkeuzemenu te bladeren. Nadat u een schema hebt geselecteerd, geeft u een naam en een beschrijving voor de gegevensstroom op.

de nieuwe datasetinterface.

Profiel- en foutdiagnostiek inschakelen

Selecteer om stappen weer te geven om foutdiagnose en profielopname in te schakelen

Selecteer vervolgens de schakeloptie Profile dataset om uw gegevensset in te schakelen voor realtime klantprofiel. Hierdoor kunt u een holistische weergave maken van de kenmerken en het gedrag van een entiteit. De gegevens van alle profiel-toegelaten datasets zullen in Profiel worden omvat en de veranderingen worden toegepast wanneer u sparen uw gegevensstroom.

In Error diagnostics kunnen gedetailleerde foutberichten worden gegenereerd voor onjuiste records in de gegevensstroom, terwijl u in Partial ingestion gegevens met fouten kunt invoeren tot een bepaalde drempel die u handmatig definieert. Zie het gedeeltelijke overzicht van partijingestievoor meer informatie.

Waarschuwingen inschakelen

Selecteren om stappen weer te geven voor het inschakelen van waarschuwingen

U kunt waarschuwingen inschakelen om meldingen te ontvangen over de status van uw gegevensstroom. Selecteer een waarschuwing in de lijst om u te abonneren op meldingen over de status van uw gegevensstroom. Voor meer informatie over alarm, zie de gids bij het intekenen aan bronalarm gebruikend UI.

Wanneer u klaar bent met het opgeven van details voor de gegevensstroom, selecteert u Next .

Gegevensvelden toewijzen aan een XDM-schema

De stap Mapping verschijnt, die u van een interface voorziet om de brongebieden van uw bronschema aan hun aangewezen doelXDM gebieden in het doelschema in kaart te brengen.

Platform biedt intelligente aanbevelingen voor automatisch toegewezen velden op basis van het doelschema of de gegevensset die u hebt geselecteerd. U kunt toewijzingsregels handmatig aanpassen aan uw gebruiksgevallen. Op basis van uw behoeften kunt u ervoor kiezen om velden rechtstreeks toe te wijzen of gegevens prep-functies te gebruiken om brongegevens om berekende of berekende waarden af te leiden. Voor uitvoerige stappen bij het gebruiken van de kaartperinterface en berekende gebieden, zie de gids UI van de Prep van Gegevens.

Selecteer Next wanneer de brongegevens correct zijn toegewezen.

de afbeeldingsinterface.

Planninguitvoering

De stap Scheduling verschijnt, die u toestaat om een innameprogramma te vormen om de geselecteerde brongegevens automatisch in te nemen gebruikend de gevormde afbeeldingen. De planning wordt standaard ingesteld op Once . Als u de innamefrequentie wilt aanpassen, selecteert u Frequency en vervolgens een optie in het vervolgkeuzemenu.

TIP

Interval en backfill zijn niet zichtbaar tijdens een eenmalige opname.

de het plannen interface

Als u de innamefrequentie instelt op Minute , Hour , Day of Week , moet u een interval instellen om een bepaald tijdkader tussen elke inname te maken. Als de innamefrequentie bijvoorbeeld is ingesteld op Day en als het interval is ingesteld op 15 , worden gegevens elke 15 dagen opgenomen.

Tijdens deze stap, kunt u backfill ook toelaten en een kolom voor de stijgende opname van gegevens bepalen. Backfill wordt gebruikt om historische gegevens in te voeren, terwijl in de kolom die u voor incrementele inname definieert, nieuwe gegevens kunnen worden onderscheiden van bestaande gegevens.

Zie de lijst hieronder voor meer informatie over het plannen van configuraties.

Configuratie plannen

Beschrijving

Frequentie

Vorm frequentie om erop te wijzen hoe vaak dataflow zou moeten lopen. U kunt de frequentie instellen op:

Eenmaal: Plaats uw frequentie aan once om eenmalig te creëren. Configuraties voor interval en backfill zijn niet beschikbaar wanneer u een eenmalige gegevensstroom maakt. Standaard wordt de planningsfrequentie ingesteld op één keer.
Minuut: Plaats uw frequentie aan minute om uw gegevensstroom te plannen om gegevens op een per-minieme basis in te voeren.
Uur: Plaats uw frequentie aan hour om uw gegevensstroom te plannen om gegevens op een per-uurbasis in te voeren.
Dag: Plaats uw frequentie aan day om uw gegevensstroom te plannen om gegevens op een per-dagbasis in te voeren.
Week: Plaats uw frequentie aan week om uw gegevensstroom te plannen om gegevens op een per-weekbasis in te voeren.

Interval

Zodra u een frequentie selecteert, kunt u het interval dat dan vormen om het tijdkader tussen elke opname te vestigen. Bijvoorbeeld, als u uw frequentie aan dag plaatst en het interval aan 15 vormt, dan zal uw dataflow om de 15 dagen lopen. U kunt het interval niet instellen op nul. De minimaal toegestane intervalwaarde voor elke frequentie is als volgt:

Eenmaal: n/a
Minuut: 15
Uur: 1
Dag: 1
Week: 1

Begintijd

Het tijdstempel voor de geprojecteerde run, weergegeven in UTC-tijdzone.

Achtergrond

Met Backfill wordt bepaald welke gegevens in eerste instantie worden ingevoerd. Als backfill is ingeschakeld, worden alle huidige bestanden in het opgegeven pad tijdens de eerste geplande inname opgenomen. Als terugvullen is uitgeschakeld, worden alleen de bestanden opgenomen die tussen de eerste opname en de begintijd worden geladen. Bestanden die vóór de begintijd zijn geladen, worden niet opgenomen.

NOTE

Voor batch-opname, selecteert elke volgende dataflow dossiers die van uw bron worden opgenomen die op hun worden gebaseerd laatste gewijzigde timestamp. Dit betekent dat de batch-gegevens uitgezocht bestanden van de bron zijn die nieuw zijn of zijn gewijzigd sinds de laatste flowuitvoering. Bovendien moet u ervoor zorgen dat er voldoende tijd is tussen het uploaden van een bestand en een geplande doorloop, omdat bestanden die niet volledig naar uw account voor cloudopslag zijn geüpload voordat de geplande doorlooptijd wordt uitgevoerd, niet kunnen worden opgehaald voor opname.

Selecteer Next wanneer u klaar bent met het configureren van uw innameschema.

Controleer uw gegevensstroom

De stap Review wordt weergegeven, zodat u de nieuwe gegevensstroom kunt bekijken voordat deze wordt gemaakt. De details worden gegroepeerd in de volgende categorieën:

Connection: geeft het brontype, het relevante pad van het gekozen bronbestand en de hoeveelheid kolommen in dat bronbestand weer.
Assign dataset & map fields: Toont welke dataset de brongegevens worden opgenomen in, met inbegrip van het schema dat de dataset volgt aan.
Scheduling: geeft de actieve periode, frequentie en interval van het innameschema weer.

Nadat u de gegevensstroom hebt gereviseerd, klikt u op Finish en laat u enige tijd over tot de gegevensstroom.

De overzichtspagina.

Volgende stappen

Aan de hand van deze zelfstudie hebt u een gegevensstroom gemaakt om batchgegevens van uw Merkury -bron naar het Experience Platform te verzenden. Voor extra bronnen raadpleegt u de documentatie die hieronder wordt beschreven.

Uw gegevensstroom controleren

Zodra uw gegevensstroom is gecreeerd, kunt u de gegevens controleren die door het worden opgenomen om informatie over innamesnelheden, succes, en fouten te bekijken. Voor meer informatie over hoe te om dataflow te controleren, bezoek het leerprogramma op controlerekeningen en dataflows in UI.

Uw gegevensstroom bijwerken

Om configuraties voor uw dataflows bij te werken die, afbeelding, en algemene informatie plannen, bezoek het leerprogramma op bijwerken brondataflows in UI.

Uw gegevensstroom verwijderen

U kunt gegevensstromen verwijderen die niet meer nodig zijn of die onjuist zijn gemaakt met de functie Delete die beschikbaar is in de Dataflows -werkruimte. Voor meer informatie over hoe te om dataflows te schrappen, bezoek het leerprogramma bij het schrappen van dataflows in UI.