Een HTTP API streamingverbinding maken met de gebruikersinterface
Deze zelfstudie bevat stappen voor het maken van een streamingbronverbinding met de werkruimte van Sources .
Aan de slag
Deze zelfstudie vereist een goed begrip van de volgende onderdelen van Adobe Experience Platform:
-
Experience Data Model (XDM) Systeem: Het gestandaardiseerde kader waardoor 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.
Een streamingverbinding maken
Selecteer in de gebruikersinterface van het platform de optie Sources in de linkernavigatie 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 Streaming de optie HTTP API en selecteer vervolgens Add data .
De pagina Connect HTTP API account wordt weergegeven. Op deze pagina kunt u nieuwe of bestaande referenties gebruiken.
Bestaande account
Als u een bestaande account wilt gebruiken, selecteert u het HTTP API-account waarmee u een nieuwe gegevensstroom wilt maken en selecteert u vervolgens Next om door te gaan.
Nieuwe account
Selecteer New account als u een nieuwe account maakt. Geef in het invoerformulier dat wordt weergegeven een accountnaam en een optionele beschrijving op. U zult ook de optie krijgen om de volgende configuratieeigenschappen te verstrekken:
- Authentication: This property determines whether or not the streaming connection requires authentication. Verificatie zorgt ervoor dat gegevens worden verzameld van vertrouwde bronnen. Als u met Persoonlijk Identificeerbare Informatie (PII) werkt, zou dit bezit moeten worden aangezet. Deze eigenschap is standaard uitgeschakeld.
- XDM compatible: Deze eigenschap geeft aan of deze streamingverbinding gebeurtenissen verzendt die compatibel zijn met XDM-schema's. Deze eigenschap is standaard uitgeschakeld.
Als u klaar bent, selecteert u Connect to source en selecteert u Next om door te gaan.
Gegevens selecteren
Nadat u de HTTP API-verbinding hebt gemaakt, wordt de stap Select data weergegeven en krijgt u een interface voor het uploaden en voorvertonen van uw gegevens.
Selecteer Upload files om uw gegevens te uploaden. U kunt uw gegevens ook naar het gedeelte Drag and drop files van de interface slepen.
Als uw gegevens zijn geüpload, kunt u de rechterkant van de interface gebruiken om een voorvertoning van de bestandshiërarchie weer te geven. Selecteer Next om door te gaan.
Gegevensvelden toewijzen aan een XDM-schema
De stap Mapping verschijnt, die een interface verstrekken om de brongegevens aan een dataset van het Platform in kaart te brengen.
De HTTP API -bron ondersteunt inname van JSON-bestanden. JSON-bestanden vereisen geen handmatige configuratie als deze zijn gemarkeerd als XDM-klap. Als niet, dan moet u de afbeelding uitdrukkelijk vormen.
Kies een dataset voor binnenkomende gegevens waarin moeten worden opgenomen. U kunt een bestaande gegevensset gebruiken of een nieuwe gegevensset maken.
Een nieuwe gegevensset maken
Selecteer New dataset als u een nieuwe gegevensset wilt maken. Voor de vorm die verschijnt, verstrek de naam, een facultatieve beschrijving, evenals het doelschema voor de dataset. Als u een Profile -schema selecteert, kunt u kiezen of de dataset ook Profile -enabled zou moeten zijn.
Een bestaande gegevensset gebruiken
Selecteer Existing dataset als u een bestaande gegevensset wilt gebruiken. Selecteer in het formulier dat wordt weergegeven de gegevensset die u wilt gebruiken. Nadat u een gegevensset hebt geselecteerd, kunt u kiezen of de gegevensset Profile moet zijn ingeschakeld.
Standaardvelden toewijzen
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 Add new mapping als u een nieuw bronveld wilt toevoegen.
Er wordt een nieuw bronveld en een nieuwe koppeling naar een doelveld weergegeven. Als u een nieuw bronveld wilt toevoegen, selecteert u het pijlpictogram naast de invoerbalk van Select source field .
In het deelvenster Select attributes kunt u de bestandshiërarchie verkennen en een specifiek bronveld selecteren om toe te wijzen aan een doel-XDM-veld. Als u het bronveld hebt geselecteerd dat u wilt toewijzen, selecteert u Select om door te gaan.
Als er een bronveld is geselecteerd, kunt u nu het juiste doel-XDM-veld identificeren waarnaar u de hyperlink wilt koppelen. Selecteer het schemapictogram onder de sectie van het doelgebied.
Het Map source field to target field venster verschijnt, die u van een interface voorzien om het schema van uw doeldataset te onderzoeken. Selecteer het doelveld dat overeenkomt met het bronveld en selecteer vervolgens Select om door te gaan.
Als alle bronvelden zijn toegewezen aan de juiste XDM-doelvelden, selecteert u Next
Gegevens
De stap Dataflow detail wordt weergegeven. Op deze pagina kunt u details voor de gemaakte gegevensstroom verstrekken door een naam en een facultatieve beschrijving te geven.
Selecteer Next nadat u details voor de gegevensstroom hebt opgegeven.
Controleren
De stap Review wordt weergegeven, zodat u de details van de gegevensstroom kunt bekijken voordat deze wordt gemaakt. De details zijn groep binnen de volgende categorieën:
- Connection: geeft de accountnaam, het bronplatform en de bronnaam weer.
- Assign dataset and map fields: toont de doeldataset en het schema dat de dataset volgt.
Selecteer Finish nadat u hebt bevestigd dat de details juist zijn.
URL voor streamingeindpunt ophalen
Als de verbinding is gemaakt, wordt de pagina met brondetails weergegeven. Deze pagina bevat details van de zojuist gemaakte verbinding, waaronder eerder uitgevoerde dataflows, ID en URL van het streamingeindpunt.
Volgende stappen
Aan de hand van deze zelfstudie hebt u een streaming HTTP-verbinding gemaakt, waarmee u het streaming eindpunt kunt gebruiken voor toegang tot diverse Data Ingestion API's. Voor instructies om een het stromen verbinding in API tot stand te brengen, te lezen gelieve creërend een het stromen verbindingsleerprogramma.
Leren hoe te om gegevens aan Platform te stromen, te lezen gelieve of het leerprogramma op het stromen tijdreeksgegevensof het leerprogramma op het stromen verslaggegevens.