Gegevens voorbereiden voor gebruik in Intelligent Services

Als u in Intelligent Services inzichten wilt detecteren uit de gegevens van uw marketinggebeurtenissen, moeten de gegevens semantisch worden verrijkt en onderhouden in een standaardstructuur. Intelligent Services hefboomwerking Experience Data Model (XDM) schema's om dit te bereiken. Specifiek, moeten alle datasets die in Intelligent Services worden gebruikt met het schema van XDM van Consumer ExperienceEvent (CEE) in overeenstemming zijn of de schakelaar van Adobe Analytics gebruiken. Daarnaast ondersteunt de AI van de Klant de Adobe Audience Manager-aansluiting.

Dit document verstrekt algemene begeleiding bij het in kaart brengen van uw gegevens van marketinggebeurtenissen van veelvoudige kanalen aan het CEE schema, schetsend informatie over belangrijke gebieden binnen het schema om u te helpen bepalen hoe te om uw gegevens aan zijn structuur effectief in kaart te brengen. Als u bij het gebruiken van de gegevens van Adobe Analytics van plan bent, te bekijken gelieve de sectie voor de gegevensvoorbereiding van Adobe Analytics. Als u bij het gebruiken van de gegevens van Adobe Audience Manager (Klant AI slechts) van plan bent, te bekijken gelieve de sectie voor de gegevensvoorbereiding van de Manager van het publiek van de Adobe.

Gegevensvereisten

Intelligent Services vereist verschillende hoeveelheden historische gegevens, afhankelijk van het doel dat u maakt. Ongeacht, moeten de gegevens u voor allen Intelligent Services voorbereidingen treft zowel positieve als negatieve klantenreizen/gebeurtenissen omvatten. Het hebben van zowel negatieve als positieve gebeurtenissen verbetert modelprecisie en nauwkeurigheid.

Als u bijvoorbeeld de AI van de Klant gebruikt om de neiging te voorspellen om een product te kopen, heeft het model voor AI van de Klant zowel voorbeelden van succesvolle aankoopwegen als voorbeelden van mislukte wegen nodig. Dit komt omdat de AI van de Klant tijdens modeltraining probeert te begrijpen welke gebeurtenissen en reizen tot een aankoop leiden. Dit omvat ook de acties die zijn ondernomen door klanten die geen goederen hebben gekocht, zoals een persoon die zijn reis heeft gestopt bij het toevoegen van een artikel aan de wagen. Deze klanten kunnen echter op vergelijkbare wijze te werk gaan. Klantenservice kan echter inzichten verschaffen en de belangrijkste verschillen en factoren die tot een hogere prioriteitsscore leiden, opruimen. Op dezelfde manier vereist Attribution AI zowel soorten gebeurtenissen als reizen om metriek zoals touchpoint doeltreffendheid, hoogste omzettingswegen, en onderverdelingen door touchpoint positie te tonen.

Voor meer voorbeelden en informatie over historische gegevensvereisten, bezoek de AI van de Klantof sectie van de Attribution AIhistorische gegevensvereisten in de input/outputdocumentatie.

Richtlijnen voor het koppelen van gegevens

U wordt aangeraden de gebeurtenissen van een gebruiker zo veel mogelijk aan te sluiten op een gemeenschappelijke id. U hebt bijvoorbeeld gebruikersgegevens met "id1" voor 10 gebeurtenissen. Later heeft dezelfde gebruiker de cookie-id verwijderd en wordt deze als "id2" opgenomen bij de volgende 20 gebeurtenissen. Als u weet dat id1 en id2 aan de zelfde gebruiker beantwoorden, is de beste praktijk om alle 30 gebeurtenissen met gemeenschappelijke identiteitskaart te hechten.

Als dit niet mogelijk is, moet u elke set gebeurtenissen als een andere gebruiker behandelen wanneer u uw modelinvoergegevens maakt. Dit zorgt voor de beste resultaten tijdens modeltraining en scoring.

Overzicht van workflow

Het voorbereidingsproces is afhankelijk van het feit of uw gegevens in Adobe Experience Platform of extern worden opgeslagen. Deze sectie vat de noodzakelijke stappen samen u, gegeven één van beide scenario's moet nemen.

Externe gegevensvoorbereiding

Als uw gegevens buiten Experience Platform worden opgeslagen, moet u uw gegevens aan de vereiste en relevante gebieden in het schema van a Consumer ExperienceEvent in kaart brengen. Dit schema kan worden aangevuld met aangepaste veldgroepen om uw klantgegevens beter vast te leggen. Zodra in kaart gebracht, kunt u een dataset tot stand brengen gebruikend uw schema van Consumer ExperienceEvent en neemt uw gegevens aan Platformin. De CEE dataset kan dan worden geselecteerd wanneer het vormen van Intelligent Service.

Afhankelijk van de Intelligent Service die u wilt gebruiken, zijn mogelijk verschillende velden vereist. Houd er rekening mee dat u het beste gegevens aan een veld kunt toevoegen als u over de beschikbare gegevens beschikt. Om meer over de vereiste gebieden te leren, bezoek de Attribution AIof gids van de Klant AIgegevensvereisten.

Adobe Analytics-gegevensvoorbereiding analytics-data

AI en Attribution AI ondersteunen Adobe Analytics-gegevens. Om de gegevens van Adobe Analytics te gebruiken, volg de stappen die in de documentatie worden geschetst aan opstelling een bron van Analytics schakelaar.

Zodra de bronschakelaar uw gegevens in Experience Platform stroomt, kunt u Adobe Analytics als gegevensbron selecteren die door een dataset tijdens uw instantieconfiguratie wordt gevolgd. Alle vereiste groepen van schemagebieden en individuele gebieden worden automatisch gecreeerd tijdens de verbindingsopstelling. U te hoeven niet om (Extraheren, Transformeren, Lading) de datasets in het formaat te ETL.

Als u de gegevens die door de Adobe Analytics-bronconnector naar Adobe Experience Platform worden geleid, vergelijkt met Adobe Analytics-gegevens, kunnen er verschillen optreden. De Analytics Source-connector kan rijen neerzetten tijdens de transformatie naar een XDM-schema (Experience Data Model). Er kunnen meerdere redenen zijn waarom de hele rij ongeschikt is voor transformatie, zoals ontbrekende tijdstempels, ontbrekende ID's, ongeldige id's of id's van grote personen, ongeldige analytische waarden en meer.

Voor meer informatie en voorbeelden, bezoek de documentatie voor het vergelijken van gegevens van Adobe Analytics en van de Customer Journey Analytics. Dit artikel is ontworpen om u te helpen voor die verschillen diagnostiseren en op te lossen zodat u en uw team Adobe Experience Platform-gegevens voor Intelligente services kunnen gebruiken zonder dat dit wordt belemmerd door zorgen over gegevensintegriteit.

In de Diensten van de Vraag van Adobe Experience Platform, stel de volgende Totale Verslagen tussen begin en eind timestamp door channel.typeAtSource vraag in werking om de telling door marketing kanalen te vinden.

       Count(_id) AS Records
FROM  df_hotel
WHERE timestamp>=from_utc_timestamp('2021-05-15','UTC')
        AND timestamp<from_utc_timestamp('2022-01-10','UTC')
        AND timestamp IS NOT NULL
        AND enduserids._experience.aaid.id IS NOT NULL
GROUP BY channel.typeAtSource

Adobe Audience Manager-gegevensvoorbereiding (alleen voor AI van klant) AAM-data

Adobe Audience Manager-gegevens worden native door de klant ondersteund. Om de gegevens van de Audience Manager te gebruiken, volg de stappen die in de documentatie worden geschetst aan opstelling een Audience Manager bronschakelaar.

Zodra de bronschakelaar uw gegevens in Experience Platform stroomt, kunt u Adobe Audience Manager als gegevensbron selecteren die door een dataset tijdens uw configuratie van AI van de Klant wordt gevolgd. Alle groepen van schemagebieden en individuele gebieden worden automatisch gecreeerd tijdens de verbindingsopstelling. U te hoeven niet om (Extraheren, Transformeren, Lading) de datasets in het formaat te ETL.

Experience Platform gegevensvoorbereiding

Voer de onderstaande stappen uit als uw gegevens al zijn opgeslagen in Platform en niet via de Adobe Analytics- of Adobe Audience Manager-bronconnectors (alleen Customer AI) worden gestreamd. Het wordt nog geadviseerd u het CEE schema begrijpt.

Het CEE-schema cee-schema

Het schema Consumer ExperienceEvent beschrijft het gedrag van een individu aangezien het betrekking heeft op digitale marketing gebeurtenissen (web of mobiel) evenals online of off-line handelsactiviteit. Het gebruik van dit schema is vereist voor Intelligent Services vanwege de semantisch duidelijk gedefinieerde velden (kolommen). Hierbij worden onbekende namen vermeden die de gegevens anders minder duidelijk zouden maken.

Het CEE-schema legt, net als alle XDM ExperienceEvent-schema's, de op tijdreeksen gebaseerde status van het systeem vast wanneer een gebeurtenis (of set gebeurtenissen) plaatsvond, inclusief het tijdstip en de identiteit van het betreffende onderwerp. De gebeurtenissen van de ervaring zijn feitenverslagen van wat voorkwam, en zo zijn zij onveranderlijk en vertegenwoordigen wat gebeurde zonder samenvoeging of interpretatie.

Intelligent Services gebruikt verscheidene zeer belangrijke gebieden binnen dit schema om inzichten van uw gegevens van marketinggebeurtenissen te produceren, die allen op het wortelniveau kunnen worden gevonden en worden uitgebreid om hun vereiste subfields te tonen.

Net als alle XDM-schema's is de veldgroep van het CEE-schema uitbreidbaar. Met andere woorden, er kunnen extra velden worden toegevoegd aan de CEE-veldgroep en indien nodig kunnen verschillende variaties in meerdere schema's worden opgenomen.

Een volledig voorbeeld van de gebiedsgroep kan in de openbare bewaarplaats worden gevonden XDM. Bovendien kunt u het volgende JSON- dossiervoor een voorbeeld van bekijken en kopiëren hoe de gegevens kunnen worden gestructureerd om aan het CEE schema te voldoen. Verwijs naar beide voorbeelden aangezien u over de belangrijkste gebieden leert die in de sectie worden geschetst hieronder, om te bepalen hoe u uw eigen gegevens aan het schema kunt in kaart brengen.

Hoofdvelden

Er zijn verschillende sleutelvelden in de CEE-veldgroep die moeten worden gebruikt om Intelligent Services nuttige inzichten te laten genereren. In deze sectie worden het gebruiksgeval en de verwachte gegevens voor deze velden beschreven en vindt u koppelingen naar de documentatie bij naslagwerken voor meer voorbeelden.

Verplichte velden

Terwijl het gebruik van alle zeer belangrijke gebieden sterk wordt geadviseerd, zijn er twee gebieden die ​ ​worden vereist opdat Intelligent Services werken:

Primaire identiteit identity

Een van de velden in uw schema moet zijn ingesteld als primair identiteitsveld. Dit betekent dat Intelligent Services elke instantie van tijdreeksgegevens kan koppelen aan een individuele persoon.

U moet bepalen welk veld het beste kan worden gebruikt als primaire identiteit op basis van de bron en de aard van uw gegevens. Een identiteitsgebied moet een identiteit namespace omvatten die op het type van identiteitsgegevens wijst het gebied als waarde verwacht. Enkele geldige naamruimtewaarden zijn:

Als u niet zeker bent welk gebied u als primaire identiteit zou moeten gebruiken, contacteer de Diensten van Adobe Consulting om de beste oplossing te bepalen. Als er geen primaire identiteit is ingesteld, gebruikt de toepassing Intelligente service het volgende standaardgedrag:

Als u een primaire identiteit wilt instellen, navigeert u naar het schema op het tabblad Schemas en selecteert u de hyperlink voor de schemanaam om het schema Schema Editor te openen.

Navigeer vervolgens naar het veld dat u als primaire identiteit wilt gebruiken en selecteer het. Het menu Field properties wordt geopend voor dat veld.

Blader in het menu Field properties omlaag totdat u het selectievakje Identity hebt gevonden. Nadat u het selectievakje hebt ingeschakeld, wordt de optie voor het instellen van de geselecteerde identiteit weergegeven als de Primary identity . Selecteer dit vak ook.

Vervolgens moet u een Identity namespace opgeven uit de lijst met vooraf gedefinieerde naamruimten in het vervolgkeuzemenu. In dit voorbeeld wordt de ECID-naamruimte geselecteerd omdat een Adobe Audience Manager-id mcid.id wordt gebruikt. Selecteer Apply om de updates te bevestigen en selecteer vervolgens Save in de rechterbovenhoek om de wijzigingen in het schema op te slaan.

xdm:tijdstempel timestamp

Dit veld vertegenwoordigt de datum waarop de gebeurtenis heeft plaatsgevonden. Deze waarde moet worden opgegeven als een tekenreeks, volgens de ISO 8601-standaard.

xdm:kanaal channel

Dit gebied vertegenwoordigt het marketing kanaal met betrekking tot ExperienceEvent. Het veld bevat informatie over het kanaaltype, het mediatype en het locatietype.

schema van het Voorbeeld

{
  "@id": "https://ns.adobe.com/xdm/channels/facebook-feed",
  "@type": "https://ns.adobe.com/xdm/channel-types/social",
  "xdm:mediaType": "earned",
  "xdm:mediaAction": "clicks"
}

Voor volledige informatie betreffende elk van de vereiste subfields voor xdm:channel, gelieve te verwijzen naar het schema van het ervaringskanaalspecificatie. Voor sommige voorbeeldafbeeldingen, zie de lijst hieronder.

Voorbeeldkanaaltoewijzingen example-channels

In de volgende tabel staan enkele voorbeelden van marketingkanalen die zijn toegewezen aan het schema xdm:channel :

Aanbevolen velden

De overige belangrijke velden worden in deze sectie beschreven. Hoewel deze velden niet noodzakelijkerwijs vereist zijn voor Intelligent Services , wordt u ten zeerste aangeraden zoveel mogelijk velden te gebruiken om rijkere inzichten te verkrijgen.

xdm:productListItems

Dit veld is een array van items die producten vertegenwoordigen die door een klant zijn geselecteerd, waaronder de SKU, naam, prijs en hoeveelheid van het product.

schema van het Voorbeeld

[
  {
    "xdm:SKU": "1002352692",
    "xdm:name": "24-Watt 8-Light Chrome Integrated LED Bath Light",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 159.45
  },
  {
    "xdm:SKU": "3398033623",
    "xdm:name": "16ft RGB LED Strips",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 79.99
  }
]

Voor volledige informatie betreffende elk van vereiste subfields voor xdm:productListItems, gelieve te verwijzen naar het schema van handelsdetailsspecificatie.

xdm:handel

Dit veld bevat handelspecifieke informatie over de ExperienceEvent, waaronder het inkoopordernummer en betalingsgegevens.

schema van het Voorbeeld

{
    "xdm:order": {
      "xdm:purchaseID": "a8g784hjq1mnp3",
      "xdm:purchaseOrderNumber": "123456",
      "xdm:payments": [
        {
          "xdm:transactionID": "transactid-a111",
          "xdm:paymentAmount": 59,
          "xdm:paymentType": "credit_card",
          "xdm:currencyCode": "USD"
        },
        {
          "xdm:transactionId": "transactid-a222",
          "xdm:paymentAmount": 100,
          "xdm:paymentType": "gift_card",
          "xdm:currencyCode": "USD"
        }
      ],
      "xdm:currencyCode": "USD",
      "xdm:priceTotal": 159
    },
    "xdm:purchases": {
      "xdm:value": 1
    }
  }

Voor volledige informatie betreffende elk van vereiste subfields voor xdm:commerce, gelieve te verwijzen naar het schema van handelsdetailsspecificatie.

xdm:web

In dit veld worden de webdetails weergegeven die betrekking hebben op de ExperienceEvent, zoals de interactie, paginagegevens en de referentie.

schema van het Voorbeeld

{
  "xdm:webPageDetails": {
    "xdm:siteSection": "Shopping Cart",
    "xdm:server": "example.com",
    "xdm:name": "Purchase Confirmation",
    "xdm:URL": "https://www.example.com/orderConf",
    "xdm:errorPage": false,
    "xdm:homePage": false,
    "xdm:pageViews": {
      "xdm:value": 1
    }
  },
  "xdm:webReferrer": {
    "xdm:URL": "https://www.example.com/checkout",
    "xdm:referrerType": "internal"
  }
}

Voor volledige informatie betreffende elk van de vereiste subfields voor xdm:productListItems, gelieve te verwijzen naar het ExperienceEvent Web details schemaspecificatie.

xdm:marketing

Dit veld bevat informatie over marketingactiviteiten die actief zijn met het aanraakpunt.

schema van het Voorbeeld

{
  "xdm:trackingCode": "marketingcampaign111",
  "xdm:campaignGroup": "50%_DISCOUNT",
  "xdm:campaignName": "50%_DISCOUNT_USA"
}

Voor volledige informatie betreffende elk van vereiste subfields voor xdm:productListItems, gelieve te verwijzen naar marketing sechmaspecificatie.

Gegevens toewijzen en opnemen mapping

Nadat u hebt bepaald of de gegevens van uw marketinggebeurtenissen kunnen worden toegewezen aan het CEE-schema, kunt u nu bepalen in welke gegevens u de gegevens wilt opnemen in Intelligent Services . Alle historische gegevens die in Intelligent Services worden gebruikt, moeten binnen het minimale tijdvenster van vier maanden aan gegevens vallen, plus het aantal dagen dat als terugzoekperiode wordt bedoeld.

Nadat u het gegevensbereik hebt bepaald dat u wilt verzenden, neemt u contact op met Adobe Consulting Services om uw gegevens toe te wijzen aan het schema en deze in te voeren in de service.

Als u een Adobe Experience Platform -abonnement hebt en de gegevens zelf wilt toewijzen en invoeren, volgt u de stappen in de onderstaande sectie.

Adobe Experience Platform gebruiken

In deze sectie wordt de workflow beschreven voor het toewijzen en invoeren van gegevens in Experience Platforms voor gebruik in Intelligent Services , inclusief koppelingen naar zelfstudies voor gedetailleerde stappen.

Een CEE-schema en gegevensset maken

Wanneer u klaar bent om uw gegevens voor opname voor te bereiden, moet de eerste stap een nieuw XDM schema tot stand brengen dat de CEE gebiedsgroep aanwendt. De volgende zelfstudies lopen door het proces om een nieuw schema in UI of API tot stand te brengen:

Nadat u de CEE-veldgroep aan het schema hebt toegevoegd, kunt u desgewenst andere veldgroepen toevoegen voor extra velden in uw gegevens.

Zodra u het schema hebt gecreeerd en bewaard, kunt u een nieuwe dataset tot stand brengen die op dat schema wordt gebaseerd. De volgende zelfstudies lopen door het proces om een nieuwe dataset in UI of API tot stand te brengen:

Nadat de dataset wordt gecreeerd, kunt u het in Platform UI binnen de Datasets werkruimte vinden.

Identiteitsvelden toevoegen aan de gegevensset

Als u gegevens van Adobe Audience Manager, Adobe Analytics, of een andere externe bron inbrengt, dan hebt u de optie om een schemagebied als identiteitsgebied te plaatsen. Om een schemagebied als identiteitsgebied te plaatsen, bekijk de sectie bij het plaatsen van identiteitsgebieden binnen het leerprogramma UIof API leerprogrammavoor het creëren van een schema.

Als u gegevens van een lokaal Csv- dossier opneemt, kunt u vooruit aan de volgende sectie op afbeelding overslaan en gegevens opnemen.

Gegevens toewijzen en opnemen ingest

Na het creëren van een CEE schema en dataset, kunt u beginnen uw gegevenslijsten aan het schema in kaart te brengen en die gegevens in Platform in te voeren. Zie het leerprogramma op in kaart brengen een Csv- dossier aan een XDM- schemavoor stappen op hoe te om dit in UI uit te voeren. U kunt het volgende steekproefJSON- dossiergebruiken om het innameproces te testen alvorens uw eigen gegevens te gebruiken.

Zodra een dataset is bevolkt, kan de zelfde dataset worden gebruikt om extra gegevensdossiers in te voeren.

Als uw gegevens in een gesteunde derdetoepassing worden opgeslagen, kunt u ook verkiezen om a bronschakelaartot stand te brengen om uw marketing gebeurtenisgegevens in Platform in real time in te nemen.

Volgende stappen next-steps

Dit document bevat algemene richtlijnen voor het voorbereiden van gegevens voor gebruik in Intelligent Services . Neem contact op met Adobe Consulting Support als je aanvullende consultancy nodig hebt op basis van je gebruikscase.

Zodra u met succes een dataset met uw gegevens van de klantenervaring hebt bevolkt, kunt u Intelligent Services gebruiken om inzichten te produceren. Raadpleeg de volgende documenten om aan de slag te gaan: