Een Marketo Engage bronverbinding en gegevensstroom voor gegevens met aangepaste activiteit in de gebruikersinterface
Naast standaardactiviteitenkunt u ook de opdracht Marketo bron om gegevens over aangepaste activiteiten naar Adobe Experience Platform te verzenden. In dit document worden de volgende stappen beschreven voor het maken van een bronverbinding en gegevensstroom voor aangepaste activiteitengegevens met de opdracht Marketo bron in de UI.
Aan de slag
Deze zelfstudie vereist een goed begrip van de volgende onderdelen van Adobe Experience Platform:
- B2B-naamruimten en hulpprogramma voor automatisch genereren van schema's: Het B2B-hulpprogramma voor naamruimten en automatisch genereren van schema maakt het mogelijk om Postman om automatisch waarden te genereren voor uw B2B-naamruimten en -schema's. U moet eerst uw B2B-naamruimten en -schema's voltooien voordat u een Marketo bronverbinding en gegevensstroom.
- Bronnen: Met Experience Platform kunnen gegevens uit verschillende bronnen worden ingepakt en kunt u inkomende gegevens structureren, labelen en verbeteren met behulp van de platformservices.
- Experience Data Model (XDM): Het gestandaardiseerde kader waardoor Experience Platform gegevens van de klantenervaring organiseert.
- Schema's maken en bewerken in de gebruikersinterface: Leer om schema's in UI tot stand te brengen en uit te geven.
- Identiteitsnaamruimten: Identiteitsnaamruimten zijn een component van Identity Service die dienen als indicatoren van de context 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.
- Sandboxen: Experience Platform biedt virtuele sandboxen die één platforminstantie in afzonderlijke virtuele omgevingen verdelen om toepassingen voor digitale ervaringen te ontwikkelen en te ontwikkelen.
Je aangepaste activiteitengegevens ophalen
De eerste stap om gegevens van de douaneactiviteit van te brengen Marketo aan Experience Platform moet de API-naam en de weergavenaam van uw aangepaste activiteit ophalen.
Meld u aan bij uw account met de Marketo interface. In de linkernavigatie, onder Database Management, selecteert u Aangepaste Marketo-activiteiten.
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.
Selecteren Velden in de bovenste koptekst om de velden weer te geven die zijn gekoppeld aan uw aangepaste activiteit. 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
In de Schemas het dashboard van Experience Platform UI, uitgezocht Browse en selecteer vervolgens B2B Activity in de lijst van schema's.
Nieuwe veldgroep maken voor aangepaste activiteit
Voeg vervolgens een nieuwe veldgroep toe aan de B2B Activity schema. 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 de Field groups paneel onder Composition.
De Add field groups wordt weergegeven. Selecteren Create new field group en geef vervolgens dezelfde weergavenaam voor de aangepaste activiteit op die u in een eerdere stap hebt opgehaald. Geef een optionele beschrijving voor de nieuwe veldgroep op. Selecteer Add field groups.
Als u een nieuwe veldgroep voor aangepaste activiteit hebt gemaakt, wordt deze weergegeven in het dialoogvenster Field groups catalogus.
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.
Als u een nieuw veld wilt toevoegen, selecteert u het plusteken (+) naast de naam van het schema. Een vermelding voor Untitled Field | Type wordt weergegeven. Configureer vervolgens eigenschappen van uw veld met de Field properties deelvenster. Stel de veldnaam in op de API-naam van uw aangepaste activiteit en stel de weergavenaam in op de weergavenaam van uw aangepaste activiteit. Stel vervolgens de tekst in als object en wijs de veldgroep toe aan de veldgroep met aangepaste activiteiten die u in de vorige stap hebt gemaakt. Selecteer Apply.
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 interface Platform de optie Sources van de linkernavigatiebalk voor toegang tot de 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 zoekbalk.
Onder de Adobe applications categorie, selecteert u Marketo Engage. Selecteer vervolgens Add data om een nieuwe Marketo dataflow.
Gegevens selecteren
Selecteren Activities van de lijst van Marketo datasets en selecteer vervolgens Next.
Gegevens
Volgende, Geef informatie voor uw gegevensstroom, met inbegrip van namen en beschrijvingen voor uw dataset en dataflow, het schema dat u zult gebruiken, en configuraties voor Profile inname, foutopsporing en gedeeltelijke inname.
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 vervolgens Add new field.
Navigeer door de brongegevensstructuur en zoek het veld voor aangepaste activiteit dat u wilt innemen. Selecteer Select.
Selecteer het schemapictogram om een doelveld toe te voegen
Herhaal de stappen om de rest van uw gebieden van de afbeelding van de douaneactiviteit toe te voegen. Selecteer Next.
Controleren
De Review wordt weergegeven, zodat u de nieuwe gegevensstroom kunt controleren voordat deze wordt gemaakt. De details worden gegroepeerd in de volgende categorieën:
- Connection: Hiermee geeft u 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.
Nadat u de gegevensstroom hebt gecontroleerd, selecteert u Save & ingest en laat enige tijd voor de gegevensstroom worden gecreeerd.
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. Lees voor meer informatie over het bijwerken van de toewijzingen van een bestaande gegevensstroom de handleiding op bijwerken, gegevensstromen in UI.
Gebruiken Query Service om activiteiten voor douaneactiviteiten te filtreren query-service-filter
Zodra uw gegevensstroom volledig is, kunt u gebruiken Query-service om activiteiten voor uw gegevens van de douaneactiviteit te filtreren.
Wanneer aangepaste activiteiten worden opgenomen in Platform, wordt de API-naam van de aangepaste activiteit automatisch gewijzigd in eventType. Gebruiken eventType={API_NAME} om te filteren op aangepaste activiteitsgegevens.
SELECT * FROM with_custom_activities_ds_today WHERE eventType='aepCustomActivityDemo1'
Gebruik de IN clausule om meerdere aangepaste activiteiten te filteren:
SELECT * FROM $datasetName WHERE eventType='{API_NAME}'
SELECT * FROM $datasetName WHERE eventType IN ('aepCustomActivityDemo1', 'aepCustomActivityDemo2')
In de onderstaande afbeelding ziet u een voorbeeld van een SQL-instructie in het dialoogvenster Query-editor dat filters voor de gegevens van de douaneactiviteit.
Volgende stappen
Aan de hand van deze zelfstudie hebt u een platformschema ingesteld voor Marketo gegevens van de douaneactiviteit en creeerde een gegevensstroom om die gegevens aan Platform te brengen. Voor algemene informatie over de Marketo bron, lees de Marketo bronoverzicht.