Een Marketo Engage bronverbinding en gegevensstroom maken voor aangepaste activiteitsgegevens in de gebruikersinterface
Naast standaardactiviteiten, kunt u de Marketo bron ook gebruiken om gegevens van douaneactiviteiten aan Adobe Experience Platform te brengen. Dit document bevat stappen voor het maken van een bronverbinding en gegevensstroom voor aangepaste activiteitengegevens met behulp van de Marketo -bron in de gebruikersinterface.
Aan de slag
Deze zelfstudie vereist een goed begrip van de volgende onderdelen van Adobe Experience Platform:
- B2B namespaces en schema auto-generatienut: Het B2B namespaces en schema auto-generatienut staat u toe om Postman te gebruiken om waarden voor uw B2B namespaces en schema's auto-produceren. U moet eerst de B2B-naamruimten en -schema's voltooien voordat u een Marketo -bronverbinding en -gegevensstroom maakt.
- Bronnen: Experience Platform staat gegevens toe om van diverse bronnen worden opgenomen terwijl het voorzien van u van de capaciteit om, inkomende gegevens te structureren te etiketteren en te verbeteren gebruikend de diensten van het Platform.
- Model van de Gegevens van de Ervaring (XDM): Het gestandaardiseerde kader waardoor het Experience Platform gegevens van de klantenervaring organiseert.
- creeer en geef schema's in UIuit: Leer hoe te om schema's in UI tot stand te brengen en uit te geven.
- Identiteitsnaamruimten: Identiteitsnaamruimten zijn een component van Identity Service die als indicatoren van de context dienen waarop een identiteit betrekking heeft. Een volledig gekwalificeerde identiteit omvat een waarde van identiteitskaart en een namespace.
- Real-Time Customer Profile: biedt een uniform, real-time consumentenprofiel dat is gebaseerd op geaggregeerde gegevens van meerdere bronnen.
- Sandboxes: Experience Platform verstrekt virtuele zandbakken die één enkele instantie van het Platform in afzonderlijke virtuele milieu's verdelen helpen digitale ervaringstoepassingen ontwikkelen en ontwikkelen.
Je aangepaste activiteitengegevens ophalen
De eerste stap om aangepaste activiteitsgegevens van Marketo naar het Experience Platform te brengen, is het ophalen van de API-naam en de weergavenaam van uw aangepaste activiteit.
Meld u aan bij uw account met de interface Marketo. In de linkernavigatie, onder Database Management, selecteer de Activiteiten van de Douane van Marketo.
De interface wordt bijgewerkt met een weergave van uw aangepaste activiteiten, inclusief informatie over de respectievelijke weergavenamen en API-namen. U kunt ook de Right-rail gebruiken om andere aangepaste activiteiten van uw account te selecteren en weer te geven.
Selecteer Gebieden van de hoogste kopbal om de gebieden te bekijken verbonden aan uw douaneactiviteit. Op deze pagina kunt u de namen, API-namen, beschrijvingen en gegevenstypen van de velden in uw aangepaste activiteit weergeven. Details betreffende afzonderlijke velden worden in een latere stap gebruikt wanneer u een schema maakt.
Veldgroepen instellen voor aangepaste activiteiten in het B2B-activiteitenschema
Selecteer in het Schemas dashboard van de gebruikersinterface van het Experience Platform de optie Browse en selecteer vervolgens B2B Activity in de lijst met schema's.
Nieuwe veldgroep maken voor aangepaste activiteit
Voeg vervolgens een nieuwe veldgroep toe aan het schema B2B Activity . Deze veldgroep moet overeenkomen met de aangepaste activiteit die u wilt invoeren en moet de weergavenaam van de aangepaste activiteit gebruiken die u eerder hebt opgehaald.
Als u een nieuwe veldgroep wilt toevoegen, selecteert u + Add naast het deelvenster Field groups onder Composition .
Het venster Add field groups wordt weergegeven. Selecteer Create new field group en geef dezelfde weergavenaam voor de aangepaste activiteit op die u eerder hebt opgehaald. Geef een optionele beschrijving voor de nieuwe veldgroep op. Selecteer Add field groups als u klaar bent.
Nadat u een nieuwe veldgroep voor aangepaste activiteiten hebt gemaakt, wordt deze weergegeven in de catalogus van Field groups .
Een nieuw veld toevoegen aan de schemastructuur
Voeg vervolgens een nieuw veld toe aan uw schema. Dit nieuwe veld moet worden ingesteld op type: object en bevat de afzonderlijke velden van de aangepaste activiteit.
Om een nieuw gebied toe te voegen, selecteer het plusteken (+) naast de schemanaam. Er wordt een vermelding voor Untitled Field | Type weergegeven. Configureer vervolgens eigenschappen van het veld met behulp van het deelvenster Field properties . Stel de veldnaam in op de API-naam van uw aangepaste activiteit en stel de weergavenaam in op de weergavenaam van uw aangepaste activiteit. Vervolgens stelt u het type in als object en wijst u de veldgroep toe aan de veldgroep met aangepaste activiteit die u in de vorige stap hebt gemaakt. Selecteer Apply als u klaar bent.
Het nieuwe veld wordt in uw schema weergegeven.
Subvelden toevoegen aan het objectveld add-sub-fields-to-the-object-field
De laatste stap bij het voorbereiden van uw schema is het toevoegen van individuele gebieden binnen het gebied dat u in de vorige stap creeerde.
Een gegevensstroom maken
Als de schema-instelling is voltooid, kunt u nu doorgaan met het maken van een gegevensstroom voor uw aangepaste activiteitengegevens.
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 zoekbalk.
Selecteer onder de categorie Adobe applications de optie Marketo Engage . Selecteer vervolgens Add data om een nieuwe Marketo dataflow te maken.
Gegevens selecteren
Selecteer Activities in de lijst met Marketo gegevenssets en selecteer vervolgens Next .
Gegevens
Daarna, verstrekt informatie voor uw dataflow, met inbegrip van namen en beschrijvingen voor uw dataset en dataflow, het schema dat u, en configuraties voor Profile opname, foutendiagnostiek, en gedeeltelijke opname zult gebruiken.
Toewijzing
Toewijzingen voor velden met standaardactiviteit worden automatisch ingevuld, maar aangepaste velden voor activiteit moeten handmatig worden toegewezen aan de desbetreffende doelvelden.
Selecteer New field type en selecteer Add new field om uw aangepaste activiteitsvelden toe te wijzen.
Navigeer door de brongegevensstructuur en zoek het veld voor aangepaste activiteit dat u wilt innemen. Selecteer Select als u klaar bent.
Om een doelgebied toe te voegen, selecteer het schemapictogram
Herhaal de stappen om de rest van uw gebieden van de afbeelding van de douaneactiviteit toe te voegen. Selecteer Next als u klaar bent.
Controleren
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 de gekozen bronentiteit en de hoeveelheid kolommen in die bronentiteit weer.
- Assign dataset & map fields: Toont welke dataset de brongegevens worden opgenomen in, met inbegrip van het schema dat de dataset volgt aan.
Nadat u de gegevensstroom hebt gereviseerd, selecteert u Save & ingest en laat u enige tijd over om de gegevensstroom te maken.
Aangepaste activiteiten toevoegen aan een bestaande activiteitengegevensstroom add-to-existing-dataflows
Om de gegevens van de douaneactiviteit aan een bestaande gegevensstroom toe te voegen, wijzig de afbeeldingen van een bestaande activiteitendataflow met de gegevens van de douaneactiviteit die u wilt opnemen. Dit staat u toe om douaneactiviteit in de zelfde bestaande activiteitendataset in te voeren. Voor meer informatie over hoe te om de afbeeldingen van een bestaande dataflow bij te werken, lees de gids op het bijwerken dataflows in UI.
Gebruik Query Service om activiteiten voor aangepaste activiteiten te filteren query-service-filter
Zodra uw dataflow volledig is, kunt u Dienst van de Vraaggebruiken om activiteiten voor uw gegevens van de douaneactiviteit te filtreren.
Wanneer aangepaste activiteiten in Platform worden opgenomen, wordt de API-naam van de aangepaste activiteit automatisch de eventType ervan. Gebruik eventType={API_NAME} om te filteren voor aangepaste activiteitsgegevens.
SELECT * FROM with_custom_activities_ds_today WHERE eventType='aepCustomActivityDemo1'
Gebruik de component IN om meerdere aangepaste activiteiten te filteren:
SELECT * FROM $datasetName WHERE eventType='{API_NAME}'
SELECT * FROM $datasetName WHERE eventType IN ('aepCustomActivityDemo1', 'aepCustomActivityDemo2')
Het beeld toont hieronder een voorbeeld SQL verklaring in de Redacteur van de Vraagdie filters voor de gegevens van de douaneactiviteit.
Volgende stappen
Aan de hand van deze zelfstudie hebt u een platformschema voor Marketo aangepaste activiteitengegevens ingesteld en een gegevensstroom gemaakt om die gegevens over te brengen naar Platform. Voor algemene informatie over de Marketo bron, lees het Marketo bronoverzicht.