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

NOTE
I den här självstudiekursen beskrivs hur du konfigurerar och tar fram anpassad aktivitet data från Marketo till Experience Platform. För steg om hur du tar med standardaktivitet data, läsa Marketo Användargränssnittsguide.

Förutom standardverksamhetkan du också använda Marketo källa för anpassade aktivitetsdata till Adobe Experience Platform. Det här dokumentet innehåller steg för hur du skapar en källanslutning och ett dataflöde för anpassade aktivitetsdata med 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:

  • B2B-namnutrymmen och automatisk schemagenerering: Med B2B-namnutrymmen och automatisk schemagenerering kan du använda Postman för att automatiskt generera värden för B2B-namnutrymmen och scheman. Du måste fylla i B2B-namnutrymmen och scheman innan du skapar en Marketo källanslutning och dataflöde.
  • Källor: Experience Platform tillåter att data kan hämtas från olika källor samtidigt som du kan strukturera, märka 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 hör till. En fullständigt kvalificerad identitet innehåller ett ID-värde och ett namnutrymme.
  • Real-Time Customer Profile: Ger 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 i separata virtuella miljöer för att utveckla och utveckla program för digitala upplevelser.

Hämta din anpassade aktivitetsinformation

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

Logga in på ditt konto med Marketo gränssnitt. I vänster navigering, under Database Management, markera 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 Anpassade aktiviteter i Adobe Marketo Engage-gränssnittet.

Välj Fält i det övre huvudet för att 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

I Schemas kontrollpanel för användargränssnittet i Experience Platform väljer Browse och sedan B2B Activity från listan över 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 B2B Activity schema. 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.

Välj om du vill lägga till en ny fältgrupp + Add bredvid Field groups panel under Composition.

Schemastrukturen.

The Add field groups visas. Välj Create new field group och ange sedan samma visningsnamn för den anpassade aktivitet 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 Field groups katalog.

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 innehåller 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 Field properties -panelen. Ange att fältnamnet ska vara den anpassade aktivitetens API-namn och ange visningsnamnet som den anpassade aktivitetens visningsnamn. Ange sedan typen som 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 med underfält som 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.

Välj Sources från det vänstra navigeringsfältet för att komma åt Sources arbetsyta. The 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.

Under Adobe applications kategori, välj Marketo Engage. Välj sedan Add data för att skapa en ny 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 över Marketo datauppsättningar och sedan välja Next.

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

Dataflödesdetaljer

Nästa, ange information om 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 förtäring, 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 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älj sedan de anpassade aktivitetsfälten 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

The 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 vilken datauppsättning 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 så att dataflödet kan skapas.

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

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 filtrera aktiviteter för anpassade aktiviteter query-service-filter

När dataflödet är klart kan du använda Frågetjänst 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 dess 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 -sats 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 skapade ett dataflöde för att överföra dessa data till plattformen. Allmän information om Marketo källa, läs Marketo källöversikt.

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