Skapa en Marketo Engage-källanslutning och ett dataflöde för anpassade aktivitetsdata i användargränssnittet

NOTE
I den här självstudiekursen beskrivs hur du konfigurerar och hämtar anpassade aktivitetsdata från Marketo till Experience Platform. Anvisningar om hur du hämtar standardaktivitetsdata finns i Marketo gränssnittsguiden.

Utöver standardaktiviteter kan du även använda källan Marketo för att hämta anpassade aktivitetsdata till Adobe Experience Platform. Det här dokumentet innehåller steg om hur du skapar en källanslutning och ett dataflöde för anpassade aktivitetsdata med hjälp av källan Marketo i användargränssnittet.

Komma igång

Den här självstudiekursen kräver en fungerande förståelse av följande komponenter i Adobe Experience Platform:

  • Verktyget för automatisk generering av B2B-namnutrymmen och scheman: Med verktyget för automatisk generering av B2B-namnutrymmen och scheman kan du använda Postman för att automatiskt generera värden för B2B-namnutrymmen och scheman. Du måste slutföra B2B-namnutrymmen och scheman först innan du skapar en Marketo-källanslutning och ett dataflöde.
  • Källor: Experience Platform tillåter data att hämtas från olika källor samtidigt som du kan strukturera, etikettera och förbättra inkommande data med hjälp av plattformstjänster.
  • Experience Data Model (XDM): Det standardiserade ramverk som Experience Platform använder för att ordna kundupplevelsedata.
  • Identitetsnamnutrymmen: Identitetsnamnutrymmen är en komponent i Identity Service som fungerar som indikatorer för det sammanhang som en identitet relateras till. En fullständigt kvalificerad identitet innehåller ett ID-värde och ett namnutrymme.
  • Real-Time Customer Profile: Tillhandahåller en enhetlig konsumentprofil i realtid baserad på aggregerade data från flera källor.
  • Sandlådor: Experience Platform tillhandahåller virtuella sandlådor som partitionerar en enda plattformsinstans till separata virtuella miljöer för att utveckla och utveckla program för digitala upplevelser.

Hämta din anpassade aktivitetsinformation

Det första steget för att hämta anpassade aktivitetsdata från Marketo till Experience Platform är att hämta API-namnet och visningsnamnet för den anpassade aktiviteten.

Logga in på ditt konto med gränssnittet Marketo. I den vänstra navigeringen, under Database Management, väljer du Anpassade aktiviteter för Marketo.

Gränssnittet uppdateras och visar dina anpassade aktiviteter, inklusive information om deras respektive visningsnamn och API-namn. Du kan också använda högerspåret för att välja och visa andra anpassade aktiviteter från ditt konto.

Gränssnittet för anpassade aktiviteter i Adobe Marketo Engage-gränssnittet.

Välj Fält i den översta rubriken om du vill visa fälten som är kopplade till din anpassade aktivitet. På den här sidan kan du visa namn, API-namn, beskrivningar och datatyper för fälten i din anpassade aktivitet. Information om enskilda fält kommer att användas i ett senare steg när du skapar ett schema.

Marketo sida med information om anpassade aktivitetsfält i användargränssnittet för Marketo Engage.

Ställ in fältgrupper för anpassade aktiviteter i B2B-aktivitetsschemat

Markera Browse på kontrollpanelen Schemas i användargränssnittet för Experience Platform och välj sedan B2B Activity i listan med scheman.

TIP
Använd sökfältet för att underlätta navigeringen i schemalistan.

Schemaarbetsytan i användargränssnittet i Experience Platform med B2B-aktivitetsschemat markerat.

Skapa en ny fältgrupp för anpassad aktivitet

Lägg sedan till en ny fältgrupp i schemat B2B Activity. Den här fältgruppen ska motsvara den anpassade aktivitet som du vill importera och ska använda den anpassade aktivitetens visningsnamn som du hämtade tidigare.

Om du vill lägga till en ny fältgrupp väljer du + Add bredvid panelen Field groups under Composition.

Schemastrukturen.

Fönstret Add field groups visas. Välj Create new field group och ange sedan samma visningsnamn för den anpassade aktiviteten som du hämtade i ett tidigare steg och ange en valfri beskrivning för den nya fältgruppen. När du är klar väljer du Add field groups.

Fönstret för etikettering och skapande av en ny fältgrupp.

När du har skapat din nya fältgrupp för anpassad aktivitet visas den i katalogen Field groups.

Schemastrukturen med en ny fältgrupp tillagd under fältgruppspanelen.

Lägg till ett nytt fält i schemastrukturen

Lägg sedan till ett nytt fält i schemat. Det nya fältet måste anges till type: object och kommer att innehålla de enskilda fälten för den anpassade aktiviteten.

Om du vill lägga till ett nytt fält väljer du plustecknet (+) bredvid schemanamnet. En post för Untitled Field | Type visas. Konfigurera sedan egenskaperna för fältet med panelen Field properties. Ange att fältnamnet ska vara den anpassade aktivitetens API-namn och ange visningsnamnet som den anpassade aktivitetens visningsnamn. Ange sedan typen object och tilldela fältgruppen till den anpassade aktivitetsfältgruppen som du skapade i föregående steg. När du är klar väljer du Apply.

Schemastrukturen med plustecknet () markerat så att ett nytt fält kan läggas till.

Det nya fältet visas i ditt schema.

Ett nytt fält har lagts till i schemat.

Lägg till delfält i objektfältet add-sub-fields-to-the-object-field

Det sista steget i att förbereda schemat är att lägga till enskilda fält i fältet som du skapade i föregående steg.

En grupp underfält har lagts till i ett fält i schemat.

Skapa ett dataflöde

När schemainställningarna är klara kan du nu skapa ett dataflöde för dina anpassade aktivitetsdata.

I plattformsgränssnittet väljer du Sources i det vänstra navigeringsfältet för att komma åt arbetsytan i Sources. På skärmen Catalog visas en mängd olika källor som du kan använda för att skapa ett konto.

Du kan välja lämplig kategori i katalogen till vänster på skärmen. Du kan också använda sökfältet till att hitta den källa du vill arbeta med.

Välj Marketo Engage under kategorin Adobe applications. Välj sedan Add data för att skapa ett nytt Marketo-dataflöde.

Källkatalogen i användargränssnittet i Experience Platform med Marketo Engage-källan markerad.

Markera data

Välj Activities i listan med Marketo datauppsättningar och välj sedan Next.

Det valda datasteget i källarbetsflödet med aktivitetsdatauppsättningen markerad.

Dataflödesdetaljer

Därefter anger du information för dataflödet, inklusive namn och beskrivningar för datauppsättningen och dataflödet, det schema som du kommer att använda och konfigurationer för Profile-inmatning, feldiagnostik och partiellt intag.

Detaljsteget för dataflödet.

Mappning

Mappningar för standardaktivitetsfält fylls i automatiskt, men anpassade aktivitetsfält måste mappas till motsvarande målfält manuellt.

Om du vill börja mappa dina anpassade aktivitetsfält väljer du New field type och sedan Add new field.

Mappningssteget med listrutan för att lägga till ett nytt fält.

Navigera genom källdatastrukturen och hitta det anpassade aktivitetsfältet som du vill importera. När du är klar väljer du Select.

TIP
För att undvika förvirring och hantera dubblettfältnamn läggs anpassade aktivitetsfält till som prefix med API-namnet.

Källdatastrukturen.

Om du vill lägga till ett målfält väljer du schemaikonen schemaikon och väljer sedan anpassade aktivitetsfält från målschemat.

Målschemastrukturen.

Upprepa stegen för att lägga till resten av dina anpassade aktivitetsmappningsfält. När du är klar väljer du Next.

Alla mappningar för käll- och måldata.

Granska

Steg Review visas, så att du kan granska det nya dataflödet innan det skapas. Informationen är grupperad i följande kategorier:

  • Connection: Visar källtypen, den relevanta sökvägen för den valda källentiteten och mängden kolumner i källentiteten.
  • Assign dataset & map fields: Visar vilka data som källdata hämtas till, inklusive det schema som datauppsättningen följer.

När du har granskat dataflödet väljer du Save & ingest och tillåt en tid innan dataflödet skapas.

Det sista granskningssteget som sammanfattar information om anslutnings-, datauppsättnings- och mappningsfält.

Lägg till anpassade aktiviteter i ett befintligt aktivitetsdataflöde add-to-existing-dataflows

Om du vill lägga till anpassade aktivitetsdata i ett befintligt dataflöde ändrar du mappningarna för ett befintligt aktivitetsdataflöde med anpassade aktivitetsdata som du vill importera. Detta gör att du kan importera anpassad aktivitet till samma befintliga aktivitetsdatauppsättning. Mer information om hur du uppdaterar mappningarna för ett befintligt dataflöde finns i guiden Uppdatera dataflöden i användargränssnittet.

Använd Query Service för att filtrera aktiviteter för anpassade aktiviteter query-service-filter

När dataflödet är klart kan du använda frågetjänsten för att filtrera aktiviteter efter anpassade aktivitetsdata.

När anpassade aktiviteter hämtas till Platform blir API-namnet för den anpassade aktiviteten automatiskt eventType. Använd eventType={API_NAME} för att filtrera efter anpassade aktivitetsdata.

SELECT * FROM with_custom_activities_ds_today WHERE eventType='aepCustomActivityDemo1'

Använd IN-satsen för att filtrera flera anpassade aktiviteter:

SELECT * FROM $datasetName WHERE eventType='{API_NAME}'
SELECT * FROM $datasetName WHERE eventType IN ('aepCustomActivityDemo1', 'aepCustomActivityDemo2')

Bilden nedan visar ett exempel på en SQL-sats i frågeredigeraren som filtrerar efter anpassade aktivitetsdata.

Plattformsgränssnitt som visar ett frågeexempel för anpassade aktiviteter.

Nästa steg

Genom att följa den här självstudiekursen har du konfigurerat ett plattformsschema för Marketo anpassade aktivitetsdata och skapat ett dataflöde för att överföra dessa data till plattformen. Allmän information om källan Marketo finns i Marketo källöversikten.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089