Een Marketo Engage bronverbinding en gegevensstroom in de gebruikersinterface

IMPORTANT
Voordat u een Marketo Engage bronverbinding en een gegevensstroom, moet u eerst ervoor zorgen dat u hebt aan uw organisatie-id voor Adobe toegewezen in Marketo. Bovendien moet u ervoor zorgen dat u hebt voltooid automatisch vullen van uw Marketo B2B-naamruimten en -schema's voordat u een bronverbinding en een gegevensstroom maakt.

Deze zelfstudie bevat stappen voor het maken van een Marketo Engage (hierna "Marketo") bronaansluiting in de gebruikersinterface om B2B-gegevens naar Adobe Experience Platform te brengen.

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.
  • 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.

Vereiste referenties verzamelen

Voor toegang tot uw Marketo account op Experience Platform, moet u de volgende waarden opgeven:

Credentials
Beschrijving
munchkinId
De Munchkin-id is de unieke id voor een specifieke Marketo -instantie.
clientId
De unieke client-id van uw Marketo -instantie.
clientSecret
Het unieke clientgeheim van uw Marketo -instantie.

Voor meer informatie over het verkrijgen van deze waarden raadpleegt u de Marketo verificatiehandleiding.

Nadat u de vereiste gegevens hebt verzameld, kunt u de stappen in de volgende sectie volgen.

Verbind uw Marketo account

Selecteer in de interface Platform de optie Sources van de linkernavigatie om tot Sources werkruimte. 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 Adoben categorie, selecteert u Marketo Engage en selecteer vervolgens Add data.

TIP
De bronnen in de broncatalogus geven de Set up als een bepaalde bron nog geen geverifieerde account heeft. Als er eenmaal een geverifieerd account is, wordt deze optie gewijzigd in Add data.

De broncatalogus met het geselecteerde Marketo Engage.

De Connect Marketo Engage account wordt weergegeven. Op deze pagina kunt u een nieuw account gebruiken of een bestaand account openen.

Een nieuwe account maken

Als u een nieuwe account wilt maken, selecteert u New account en geef een naam, een optionele beschrijving en uw referenties op.

Selecteer Connect to source en laat dan wat tijd voor de nieuwe verbinding tot stand brengen.

De nieuwe accountinterface voor het verifiëren van een nieuwe Marketo-account.

Een bestaande account gebruiken

Als u een bestaande account wilt gebruiken, selecteert u Existing account en selecteer vervolgens de account die u wilt gebruiken in de bestaande accountcatalogus.

Selecteren Next om verder te gaan.

De bestaande accountinterface waarin u een bestaande Marketo-account kunt selecteren.

Een gegevensset selecteren

Nadat u uw Marketo account, biedt de volgende stap een interface om te verkennen Marketo datasets.

De linkerhelft van de interface is een directorybrowser, die de 10 weergeeft Marketo datasets. Een volledig functionerende Marketo bronverbinding vereist de opname van de negen verschillende datasets. Als u ook de Marketo account-based marketing (ABM) eigenschap, dan moet u ook een tiende gegevensstroom creëren om op te nemen Named Accounts dataset.

NOTE
Voor beknoptheid wordt de volgende zelfstudie gebruikt Opportunities als voorbeeld, maar de hieronder beschreven stappen zijn van toepassing op om het even welke 10 Marketo datasets.

Selecteer de dataset die u wilt opnemen. Dit werkt de interface bij om een voorproef van uw dataset te tonen. Selecteer Next.

De voorvertoningsinterface

Gegevensset en gegevens over gegevensstroom opgeven provide-dataset-and-dataflow-details

Daarna, moet u informatie over uw dataset en uw gegevensstroom verstrekken.

Gegevens over gegevensset dataset-details

Een dataset is een opslag en beheersconstructie voor een inzameling van gegevens, typisch een lijst, die een schema (kolommen) en gebieden (rijen) bevat. De gegevens die met succes in Experience Platform worden opgenomen worden opgeslagen binnen het gegevensmeer als datasets. Tijdens deze stap, kunt u een nieuwe dataset tot stand brengen of een bestaande dataset gebruiken.

Een nieuwe gegevensset gebruiken

Als u een nieuwe gegevensset wilt gebruiken, selecteert u New dataset en geef vervolgens een naam en een optionele beschrijving voor uw gegevensset op. U moet ook een schema van het Model van de Gegevens van de Ervaring (XDM) selecteren dat uw dataset volgt aan.

De nieuwe interface van de datasetselectie.

Een bestaande gegevensset gebruiken

Als u al een bestaande dataset hebt, selecteert u Existing dataset en gebruikt vervolgens de Advanced search optie om een venster van alle datasets in uw organisatie, met inbegrip van hun respectieve details, zoals te bekijken of zij voor opname aan het Profiel van de Klant in real time of niet worden toegelaten.

De bestaande interface voor de selectie van gegevenssets.

Dataflow-configuraties dataflow-configurations

IMPORTANT
De Marketo de bron gebruikt batch-opname om alle historische records in te voeren en gebruikt streaming opname voor realtime updates. Hierdoor kan de bron doorgaan met streamen terwijl onjuiste records worden ingeslikt. De optie Partial ingestion schakelen en vervolgens instellen Error threshold % maximaal gebruiken om te voorkomen dat de gegevensstroom mislukt.

Als uw dataset voor het Profiel van de Klant in real time wordt toegelaten, dan tijdens deze stap, kunt u van een knevel voorzien Profile dataset om uw gegevens in te schakelen voor profielopname. U kunt deze stap ook gebruiken om Error diagnostics en Partial ingestion.

  • Error diagnostics: Select Error diagnostics om de bron op te dragen om foutendiagnostiek te veroorzaken die u wanneer het controleren van uw datasetactiviteit en dataflow status kunt later van verwijzingen voorzien.
  • Partial ingestion: Gedeeltelijke batch ingestie is de capaciteit om gegevens in te voeren die fouten, tot een bepaalde configureerbare drempel bevatten. Met deze functie kunt u al uw nauwkeurige gegevens in het Experience Platform opnemen, terwijl al uw onjuiste gegevens afzonderlijk worden opgeslagen met informatie over waarom deze niet geldig zijn.

Tijdens deze stap kunt u Sample dataflow het beperken van de inname van gegevens en het vermijden van extra kosten die gepaard gaan met het inslikken van alle historische gegevens, met inbegrip van persoonlijke identiteiten.

recommendation-more-help

Snelle handleiding voor het gebruik van voorbeeldgegevens

Gegevensstroom van voorbeeld is een configuratie die u voor uw Marketo gegevensstroom om uw innamesnelheid te beperken en dan de eigenschappen van het Experience Platform uit te proberen zonder het moeten grote hoeveelheden gegevens innemen.

  • Schakel voorbeeldgegevensstroom in om historische gegevens te beperken door maximaal 100 k (van de grootste record-id) records op te nemen of tot de laatste 10 dagen van activiteit tijdens de back-uptaak.
  • Wanneer het gebruiken van de configuratie van de steekproefgegevens voor alle B2B entiteiten, moet u in overweging nemen dat het mogelijk is dat sommige verwante verslagen kunnen ontbreken omdat de volledige geschiedenis van de brongegevens niet wordt opgenomen.

De sectie met gegevensstroomconfiguraties van de pagina met gegevensstroomdetails.

Bovendien, als u gegevens van de bedrijvendataset opneemt, kunt u toelaten Exclude unclaimed accounts om niet-geclaimde accounts uit te sluiten van inname.

Wanneer personen een formulier invullen, Marketo leidt tot een fantoomrekeningsverslag dat op de Naam van het Bedrijf wordt gebaseerd dat geen andere gegevens bevat. Voor nieuwe gegevensstromen, wordt de knevel om niet geclaimde rekeningen uit te sluiten toegelaten door gebrek. Voor bestaande gegevensstromen, kunt u de eigenschap toelaten of onbruikbaar maken, met veranderingen die op nieuw opgenomen gegevens en niet bestaande gegevens van toepassing zijn.

Niet-geclaimde accounts uitsluiten

Uw kaart toewijzen Marketo Gegevenssetbronvelden naar doel-XDM-velden

De Mapping de stap 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.

Elk Marketo dataset heeft zijn eigen specifieke toewijzingsregels om te volgen. Zie het volgende voor meer informatie over hoe u kunt toewijzen Marketo datasets voor XDM:

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 kaartinterface, zie UI-hulplijn voor gegevensvoorinstelling.

De toewijzingsinterface voor Marketo-gegevens.

Als uw toewijzingssets gereed zijn, selecteert u Next en kan de nieuwe gegevensstroom enkele ogenblikken maken.

Controleer uw gegevensstroom

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.

De overzichtspagina waar u details van uw gegevensstroom kunt bevestigen alvorens in te gaan.

Uw gegevensstroom controleren

Zodra uw gegevensstroom is gecreeerd, kunt u de gegevens controleren die door het worden opgenomen om informatie over innamepercentages, succes, en fouten te zien. Voor meer informatie over hoe te om dataflows te controleren, zie het leerprogramma op gegevens controleren in de gebruikersinterface.

Uw kenmerken verwijderen

Aangepaste kenmerken in gegevenssets kunnen niet retroactief worden verborgen of verwijderd. Als u een douaneattribuut van een bestaande dataset wilt verbergen of verwijderen, dan moet u een nieuwe dataset zonder dit douaneattribuut, een nieuw schema XDM tot stand brengen, en een nieuwe dataflow voor de nieuwe dataset vormen die u creeert. U moet de originele dataflow ook onbruikbaar maken of schrappen die uit de dataset met de douanekenmerken bestaat u wilt verbergen of verwijderen.

Uw gegevensstroom verwijderen

U kunt gegevensstromen schrappen die niet meer noodzakelijk of verkeerd gecreeerd gebruikend zijn Delete functie beschikbaar in de Dataflows werkruimte. Raadpleeg de zelfstudie voor meer informatie over het verwijderen van gegevensstromen gegevens verwijderen in de gebruikersinterface.

Volgende stappen

Door deze zelfstudie te volgen, hebt u een gegevensstroom gemaakt om B2B-gegevens van uw Marketo Engage bron naar Experience Platform.

Bijlage appendix

De volgende secties bevatten aanvullende richtlijnen die u kunt volgen bij het gebruik van de Marketo bron.

Foutberichten in de gebruikersinterface error-messages

De volgende foutberichten worden weergegeven in de gebruikersinterface wanneer Platform problemen detecteert met uw installatie:

Munchkin ID is niet toegewezen aan de desbetreffende organisatie

Verificatie wordt geweigerd als uw Munchkin ID wordt niet toegewezen aan de organisatie van het Platform die u gebruikt. Vorm de afbeelding tussen uw Munchkin ID en uw organisatie die Marketo interface.

Een foutbericht met de mededeling dat de Marketo-instantie niet correct is toegewezen aan de Adobe organisatie.

Primaire identiteit ontbreekt

Een dataflow kan niet worden opgeslagen en opgenomen als een primaire identiteit ontbreekt. Zorg ervoor dat er bestaat een primaire identiteit binnen uw XDM-schema, voordat u probeert een gegevensstroom te configureren.

Een foutbericht waarin wordt aangegeven dat de primaire identiteit ontbreekt in het XDM-schema.

337b99bb-92fb-42ae-b6b7-c7042161d089