Een HTTP API streamingverbinding via de gebruikersinterface
Deze zelfstudie bevat stappen voor het maken van een streamingbronverbinding met de Sources werkruimte.
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 waarbinnen Experience Platform organiseert de gegevens van de klantenervaring.
- Basisbeginselen van de schemacompositie: Leer over de basisbouwstenen van schema's XDM, met inbegrip van zeer belangrijke principes en beste praktijken in schemacompositie.
- Zelfstudie Schema-editor: Leer hoe u aangepaste schema's maakt met de gebruikersinterface van de Schema-editor.
-
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 interface Platform de optie Sources van de linkernavigatie om tot Sources werkruimte. De Catalog in het scherm 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.
Onder de Streaming categorie, selecteert u HTTP API en selecteer vervolgens Add data.
De 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 de HTTP API-account waarmee u een nieuwe gegevensstroom wilt maken en selecteert u Next om verder te gaan.
Nieuwe account
Als u een nieuwe account maakt, selecteert u New account. 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.
Selecteer Connect to source en selecteer vervolgens Next om verder te gaan.
Gegevens selecteren
Nadat u de HTTP API-verbinding hebt gemaakt, Select data wordt weergegeven, zodat u een interface hebt voor het uploaden en voorvertonen van uw gegevens.
Selecteren Upload files om uw gegevens te uploaden. U kunt uw gegevens ook naar de Drag and drop files van de interface.
Als uw gegevens zijn geüpload, kunt u de rechterkant van de interface gebruiken om een voorvertoning van de bestandshiërarchie weer te geven. Selecteren Next om verder te gaan.
Gegevensvelden toewijzen aan een XDM-schema
De Mapping stap verschijnt, verstrekkend een interface 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
Als u een nieuwe gegevensset wilt maken, selecteert u New dataset. Voor de vorm die verschijnt, verstrek de naam, een facultatieve beschrijving, evenals het doelschema voor de dataset. Als u een Profile-enabled schema, kunt u kiezen als de dataset ook zou moeten zijn Profile-enabled.
Een bestaande gegevensset gebruiken
Als u een bestaande gegevensset wilt gebruiken, selecteert u Existing dataset. Selecteer in het formulier dat wordt weergegeven de gegevensset die u wilt gebruiken. Zodra u een dataset selecteert, kunt u kiezen als de dataset zou moeten zijn Profile-enabled.
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 UI-hulplijn voor gegevensvoorinstelling.
Als u een nieuw bronveld wilt toevoegen, selecteert u Add new mapping.
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 knop Select source field invoerbalk.
De Select attributes kunt u uw 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 verder 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.
De Map source field to target field het 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 verder te gaan.
Als alle bronvelden zijn toegewezen aan de juiste XDM-doelvelden, selecteert u Next
Gegevens
De Dataflow detail wordt weergegeven. Op deze pagina kunt u details voor de gemaakte gegevensstroom verstrekken door een naam en een facultatieve beschrijving te geven.
Nadat u de details voor de gegevensstroom hebt opgegeven, selecteert u Next.
Controleren
De 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: Hiermee geeft u de naam van de account, het bronplatform en de bronnaam weer.
- Assign dataset and map fields: Toont de doeldataset en het schema dat de dataset volgt.
Nadat u hebt bevestigd dat de details juist zijn, selecteert u Finish.
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
Door deze zelfstudie te volgen, hebt u een het stromen verbinding van HTTP gecreeerd, toelatend u om het het stromen eindpunt te gebruiken om tot een verscheidenheid van Data Ingestion API's. Voor instructies voor het maken van een streamingverbinding in de API leest u de een zelfstudie over streamingverbindingen maken.
Lees de zelfstudie voor meer informatie over het streamen van gegevens naar Platform. streaming tijdreeksgegevens of de zelfstudie streaming recordgegevens.