DokumentationExperience PlatformAnvändarhandbok för dataströmmar

Skapa och konfigurera datastreams

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Utvecklare

Det här dokumentet innehåller stegen för hur du konfigurerar datastream i användargränssnittet.

Åtkomst till arbetsytan Datastreams

Du kan skapa och hantera datastölar i användargränssnittet för datainsamling eller användargränssnittet för Experience Platform genom att välja Datastreams i den vänstra navigeringen.

Fliken Datastreams i användargränssnittet för datainsamling

Fliken Datastreams visar en lista över befintliga datastreams, inklusive deras egna namn, ID och senaste ändringsdatum. Om du vill visa information om det och konfigurera tjänster markerar du namnet på ett datastream.

Om du vill visa fler alternativ för en viss datastam väljer du ikonen "mer" (…). Välj Edit om du vill uppdatera den grundläggande konfigurationen för datastream. Om du vill ta bort datastream väljer du Delete.

Alternativ för att redigera eller ta bort ett befintligt datastream

Skapa ett datastream create

Om du vill skapa ett datastream börjar du med att välja New Datastream.

Välj nytt datastream

Arbetsflödet för att skapa en datastam visas med början i konfigurationssteget. Härifrån måste du ange ett namn och en valfri beskrivning för datastream.

Om du konfigurerar en datastream för användning i Experience Platform och även använder Web SDK, måste du även välja ett händelsebaserat XDM-schemasom representerar de data du planerar att använda vid inhämtning.

Grundkonfiguration för ett datastream

Konfigurera geopositionering och nätverkssökning geolocation-network-lookup

Med inställningarna för geopositionering och nätverkssökning kan du definiera detaljnivån för de geografiska data och nätverksdata som du vill samla in.

Expandera avsnittet Geolocation and network lookup för att konfigurera inställningarna som beskrivs nedan.

Konfigurationsskärmen för dataström med inställningarna för geopositionering och nätverkssökning markerade.

Inställning
Beskrivning
Geo Lookup

Aktiverar sökningar efter geopositionering för de valda alternativen baserat på besökarens IP-adress. Tillgängliga alternativ är:

  • Land: Fyller i xdm.placeContext.geo.countryCode
  • Postnummer: Fyller i xdm.placeContext.geo.postalCode
  • Region: Fyller i xdm.placeContext.geo.stateProvince
  • DMA: Fyller i xdm.placeContext.geo.dmaID
  • Ort: Fyller i xdm.placeContext.geo.city
  • Latitude: Fyller xdm.placeContext.geo._schema.latitude
  • Longitud: Fyller i xdm.placeContext.geo._schema.longitude

Om du väljer City, Latitude eller Longitude får du koordinater upp till två decimalpunkter, oavsett vilka andra alternativ som är markerade. Detta betraktas som granularitet på stadsnivå.

Om du inte väljer något alternativ inaktiveras sökningar efter geopositionering. Geolocation inträffar före IP Obfuscation, vilket betyder att den inte påverkas av inställningen IP Obfuscation.

Network Lookup

Aktiverar nätverkssökningar för de valda alternativen baserat på besökarens IP-adress. Tillgängliga alternativ är:

  • Bärare: Fyller i xdm.environment.carrier
  • Domän: Fyller i xdm.environment.domain
  • ISP: Fyller i xdm.environment.ISP

Om du aktiverar något av fälten ovan för datainsamling bör du kontrollera att du har angett arrayegenskapen context korrekt när du konfigurerar Web SDK.

Geolocation-sökfält använder context-matrissträngen "placeContext" medan nätverkssökningsfält använder context-matrissträngen "environment".

Kontrollera också att varje önskat XDM-fält finns i schemat. Om den inte gör det kan du lägga till fältgruppen Environment Details som tillhandahålls av Adobe i ditt schema.

Konfigurera enhetssökning geolocation-device-lookup

Med inställningarna för Device Lookup kan du välja enhetsspecifik information som du vill samla in.

Expandera avsnittet Device Lookup för att konfigurera inställningarna som beskrivs nedan.

Konfigurationsskärmen för dataström med inställningarna för enhetssökning markerade.

IMPORTANT
Inställningarna som visas i tabellen nedan utesluter varandra. Du kan inte välja både användaragentinformation och enhetssökningsdata samtidigt.
Inställning
Beskrivning
Keep user agent and client hints headers
Välj det här alternativet om du bara vill samla in den information som lagras i användaragentsträngen. Den här inställningen är markerad som standard. Fyller xdm.environment.browserDetails.userAgent
Use device lookup to collect the following information

Välj det här alternativet om du vill samla in en eller flera av följande enhetsspecifika information:

  • Device information:

    • Enhetstillverkare: Fyller i xdm.device.manufacturer
    • Enhetsmodell: Fyller i xdm.device.modelNumber
    • Marknadsnamn: Fyller i xdm.device.model

  • Hardware information:

    • Maskinvarutyp: Fyller i xdm.device.type
    • Visningshöjd: Fyller i xdm.device.screenHeight
    • Visningsbredd: Fyller i xdm.device.screenWidth
    • Visa färgdjup: Fyller i xdm.device.colorDepth

  • Browser information:

    • Webbläsarleverantör: Fyller i xdm.environment.browserDetails.vendor
    • Webbläsarnamn: Fyller i xdm.environment.browserDetails.name
    • Webbläsarversion: Fyller i xdm.environment.browserDetails.version

  • Operating system information:

    • OS-leverantör: Fyller i xdm.environment.operatingSystemVendor
    • OS-namn: Fyller i xdm.environment.operatingSystem
    • OS-version: Fyller i xdm.environment.operatingSystemVersion

Det går inte att samla in information om enhetssökning tillsammans med användaragent- och klienttips. Om du väljer att samla in enhetsinformation inaktiveras samlingen av användaragent- och klienttips och vice versa.

Do not collect any device information
Välj det här alternativet om du inte vill samla in någon information om enhetssökning. Inga tipsdata för enheter, maskinvara, webbläsare, operativsystem, användare eller klient samlas in.

Om du aktiverar något av fälten ovan för datainsamling bör du kontrollera att du har angett arrayegenskapen context korrekt när du konfigurerar Web SDK.

Enhet- och maskinvaruinformationen använder context-matrissträngen "device" medan webbläsar- och operativsystemsinformationen använder context-matrissträngen "environment".

Kontrollera också att varje önskat XDM-fält finns i schemat. Om den inte gör det kan du lägga till fältgruppen Environment Details som tillhandahålls av Adobe i ditt schema.

Konfigurera avancerade alternativ @advanced-options

Om du vill visa avancerade konfigurationsalternativ väljer du Advanced Options. Här kan du konfigurera ytterligare datastream-inställningar, som IP-förfalskning, cookies för första parts-ID med mera.

Avancerade konfigurationsalternativ

IMPORTANT
Du ansvarar för att se till att du har fått alla tillstånd, samtycke, klargöranden och tillstånd som krävs enligt tillämpliga lagar och bestämmelser för att samla in, bearbeta och överföra personuppgifter, inklusive exakt geolokaliseringsinformation.
Ditt val av IP-adressofuscation påverkar inte nivån på geopositioneringsinformation som härleds från IP-adressen och skickas till dina konfigurerade Adobe-lösningar. Geoplatssökningar måste begränsas eller inaktiveras separat.
Inställning
Beskrivning
IP Obfuscation

Anger vilken typ av IP-ofuscation som ska användas för datastream. All bearbetning som baseras på kundens IP-adress påverkas av IP-begränsningsinställningen. Detta inkluderar alla Experience Cloud-tjänster som tar emot data från ditt datastream.

Tillgängliga alternativ

  • None: Inaktiverar IP-förfalskning. Den fullständiga användarens IP-adress skickas via datastream.

  • Partial: För IPv4-adresser döljer den sista oktetten i användarens IP-adress. För IPv6-adresser döljer de sista 80 bitarna i adressen.

    Exempel:

    • IPv4: 1.2.3.4 -> 1.2.3.0
    • IPv6: 2001:0db8:1345:fd27:0000:ff00:0042:8329 -> 2001:0db8:1345:0000:0000:0000:0000:0000

  • Full: Komprimerar hela IP-adressen.

    Exempel:

    • IPv4: 1.2.3.4 -> 0.0.0.0
    • IPv6: 2001:0db8:1345:fd27:0000:ff00:0042:8329 -> 0:0:0:0:0:0:0:0

IP-försvårande effekter på andra Adobe-produkter:

  • Adobe Target: Datastream-nivån IP obfuscation tillämpas före IP obfuscation som har utförts i Adobe Target på alla IP-adresser som finns i begäran. Om till exempel alternativet IP obfuscation på datastream-nivå är inställt på Full och alternativet för Adobe Target IP-förfalskning är inställt på Last octet obfuscation, får Adobe Target en fullständigt osäker IP. Om alternativet IP obfuscation på datastream-nivå är inställt på Partial och Adobe Target IP-begränsningsalternativet är inställt på Full, får Adobe Target en delvis ofuskerad IP och tillämpar sedan den fullständiga osäkerheten på den. Adobe Target IP-förfalskning hanteras oberoende av datastream. Mer information finns i Adobe Target-dokumentationen om IP-förfalskning och geopositionering.
  • Audience Manager: Inställningen på datastream-nivå IP obfuscation tillämpas före IP obfuscation som utfördes i Audience Manager, på alla IP-adresser som finns i begäran. Alla sökningar efter geopositionering som gjorts av Audience Manager påverkas av alternativet IP obfuscation på datastream-nivå. En sökning efter geopositionering i Audience Manager, som baseras på en helt okomplicerad IP-adress, resulterar i ett okänt område och inga segment som baseras på resulterande geopositioneringsdata realiseras. Mer information finns i Audience Manager-dokumentationen om IP-obefuscation.
  • Adobe Analytics: Om IP-begränsningsinställningen på datastream-nivå är inställd på Full hanterar Adobe Analytics IP-adressen som tom. Detta påverkar alla Analytics-bearbetningar som är beroende av IP-adressen, till exempel sökningar efter geopositionering och IP-filtrering. För att Analytics ska kunna ta emot de obefuscerade eller delvis dolda IP-adresserna anger du IP-förfalskningsinställningen till Partial eller None. Delvis dolda och odolda IP-adresser kan döljas ytterligare i Analytics. Se Adobe Analytics dokumentation för mer information om hur du aktiverar IP-förfalskning i Analytics. Om IP-adressen är helt okomplicerad och sidträffen varken har ECID eller VisitorID, kommer Analytics att släppa träffen i stället för att generera ett reserv-ID som delvis baseras på IP-adressen.
First Party ID Cookie
När den här inställningen är aktiverad anger den att Edge Network ska referera till en angiven cookie när ett förstahandsenhets-ID identifieras, i stället för att det här värdet hittas i identitetskartan.

När du aktiverar den här inställningen måste du ange namnet på den cookie som ska lagra ID:t.
Third Party ID Sync
ID-synkroniseringar kan grupperas i behållare så att olika ID-synkroniseringar kan köras vid olika tidpunkter. När den här inställningen är aktiverad kan du ange vilken ID-synkroniseringsbehållare som ska köras för den här datastream-filen.
Third Party ID Sync Container ID
Det numeriska ID:t för behållaren som ska användas för synkronisering av ID från tredje part.
Container ID Overrides
I det här avsnittet kan du definiera ytterligare behållar-ID:n för synkronisering av tredjeparts-ID som du kan använda för att åsidosätta standardbehållar-ID:n.
Access Type

Definierar den autentiseringstyp som Edge Network accepterar för datastream.

  • Mixed Authentication: När det här alternativet är markerat accepterar Edge Network både autentiserade och oautentiserade begäranden. Välj det här alternativet när du tänker använda Web SDK eller Mobile SDK tillsammans med Server-API.
  • Authenticated Only: När det här alternativet är markerat accepterar Edge Network endast autentiserade begäranden. Välj det här alternativet när du bara vill använda Server-API:t och vill förhindra att oautentiserade begäranden behandlas av Edge Network.
Media Analytics
Möjliggör bearbetning av spårningsdata för direktuppspelning för integrering med Edge Network via Experience Platform SDK:er eller Media Edge API. Läs mer om Media Analytics i dokumentationen.

Om du konfigurerar datastream för Experience Platform följer du självstudiekursen Data Prep for Data Collection för att mappa dina data till ett plattformshändelseschema innan du återgår till den här guiden. Annars väljer du Save och fortsätter till nästa avsnitt.

Visa information om dataström view-details

När du har konfigurerat en ny datastam eller valt en befintlig som ska visas, visas informationssidan för den datastream. Här finns mer information om datastream, inklusive dess ID.

Informationssida för dataström.

På informationsskärmen i datastream kan du lägga till tjänster för att aktivera funktioner från de Adobe Experience Cloud-produkter du har tillgång till. Du kan också redigera datastreams grundläggande konfiguration, uppdatera dess mappningsregler, kopiera datastream eller ta bort den helt.

Lägga till tjänster i ett datastream add-services

Välj Add Service på informationssidan för ett datastream för att börja lägga till tillgängliga tjänster för det datastream.

Välj Lägg till tjänst för att fortsätta.

På nästa skärm använder du listrutemenyn för att välja en tjänst som ska konfigureras för det här dataflödet. Endast de tjänster som du har åtkomst till visas i den här listan.

Välj en tjänst i listan.

Välj önskad tjänst, fyll i de konfigurationsalternativ som visas och välj sedan Save för att lägga till tjänsten i dataströmmen. Alla tillagda tjänster visas i informationsvyn för datastream.

Tjänster har lagts till i en datastream

Underavsnitten nedan beskriver konfigurationsalternativen för varje tjänst.

NOTE
Varje tjänstkonfiguration innehåller en Enabled-växel som aktiveras automatiskt när tjänsten väljs. Om du vill inaktivera den valda tjänsten för den här datastreamen väljer du Enabled igen.

Adobe Analytics-inställningar analytics

Den här tjänsten kontrollerar om och hur data skickas till Adobe Analytics. Se Skicka data till Adobe Analytics.

Adobe Analytics datastream-inställningar.

Inställning
Beskrivning
Report Suite ID
(Obligatoriskt) ID:t för analysrapportsviten som du vill skicka data till. Detta ID finns i Adobe Analytics-gränssnittet under Admin > ReportSuites. Om flera rapportsviter anges kopieras data till varje rapportserie.
Visitor ID namespace
(Valfritt) Det namnutrymme som du vill använda för Adobe Analytics visitorID. När du skickar en händelse med ett värde angivet för det här namnutrymmet används den automatiskt som visitorID i Analytics.
Report Suite Overrides
I det här avsnittet kan du lägga till ytterligare ID:n för rapportsviten som du kan använda för att åsidosätta standarddessa.

Adobe Audience Manager-inställningar audience-manager

Den här tjänsten kontrollerar om och hur data skickas till Adobe Audience Manager. Allt som behövs för att skicka data till Audience Manager är att aktivera det här avsnittet. De andra inställningarna är valfria men rekommenderas.

Adobe-målgruppshantering för dataströmsinställningar.

Inställning
Beskrivning
Cookie Destinations Enabled
Tillåter SDK att dela segmentinformation via cookie-mål från Audience Manager.
URL Destinations Enabled
Tillåter SDK att dela segmentinformation via URL-mål från Audience Manager.

Adobe Experience Platform-inställningar aep

IMPORTANT
När du aktiverar en datastream för Platform bör du tänka på den plattformssandlåda som du använder just nu, så som den visas på den översta menyfliken i användargränssnittet.
Markerad sandlåda
Sandlådor är virtuella partitioner i Adobe Experience Platform som gör att du kan isolera data och implementeringar från andra i din organisation. När en datastream har skapats kan dess sandlåda inte ändras. Mer information om rollen för sandlådor i Experience Platform finns i dokumentationen för sandlådor.

Den här tjänsten kontrollerar om och hur data skickas till Adobe Experience Platform.

Adobe Experience Platform datastream-inställningar.

Inställning
Beskrivning
Event Dataset
(Obligatoriskt) Välj den plattformsdatauppsättning som kundhändelsedata ska direktuppspelas till. Det här schemat måste använda XDM ExperienceEvent-klassen. Om du vill lägga till fler datauppsättningar väljer du Add Event Dataset.
Profile Dataset
Välj den plattformsdatauppsättning som kundattributdata ska skickas till. Schemat måste använda XDM-klassen för enskild profil.
Offer Decisioning
Aktiverar Offer decisioning för Web SDK-implementeringar. Mer implementeringsinformation finns i guiden om att använda Offer decisioning med Web SDK.

Mer information om Offer decisioning finns i Adobe Journey Optimizer-dokumentationen.
Edge Segmentation
Aktiverar kantsegmentering för det här datastream. När Web SDK eller Edge Network Server-API:t skickar data via ett datastam med kantsegmentering aktiverat, skickas alla uppdaterade målgruppsmedlemskap för den aktuella profilen tillbaka som svar.

Du kan använda det här alternativet i kombination med Personalization Destinations för personalisering av samma sida och nästa sida genom kantmål eller Offer Decisioning.
Personalization Destinations
När du aktiverar det här alternativet efter att du har aktiverat kryssrutan Edge Segmentation kan datastream ansluta till personaliseringsmål, till exempel Anpassad Personalization.

Mer information om hur du konfigurerar anpassningsmål 🔗 finns i dokumentationen för destinationer. Anpassa destinationer.
Adobe Journey Optimizer
Aktiverar Adobe Journey Optimizer för den här datastream.

Om du aktiverar det här alternativet kan datastream returnera anpassat innehåll från webb- och appbaserade inkommande kampanjer i Adobe Journey Optimizer. Det här alternativet kräver att Edge Segmentation är aktivt. Om Edge Segmentation inte är markerat är det här alternativet nedtonat.

Adobe Target-inställningar target

Den här tjänsten kontrollerar om och hur data skickas till Adobe Target.

Adobe Target datastream-inställningar.

Inställning
Beskrivning
Property Token
Med Target kan kunderna styra behörigheter med hjälp av egenskaper. Mer information om egenskaper finns i handboken om konfigurering av företagsbehörigheter i Target -dokumentationen.

Egenskapstoken finns i Adobe Target-gränssnittet under Setup > Properties.
Target Environment ID
Med miljöer i Adobe Target kan du hantera implementeringen i alla utvecklingsfaser. Den här inställningen anger vilken miljö du tänker använda med den här datastream.

Det bästa sättet är att ange detta på olika sätt för var och en av dev -, stage - och prod -datastream-miljöerna för att hålla saker och ting enkla. Om du redan har definierat Adobe Target-miljöer kan du dock använda dessa.
Target Third Party ID namespace
Identitetsnamnrymden för mbox3rdPartyId som du vill använda för det här datastream. Mer information finns i guiden om implementering mbox3rdPartyId med Web SDK.
Property Token Overrides
I det här avsnittet kan du definiera ytterligare egenskapstoken som du kan använda för att åsidosätta standardegenskapstoken.

Inställningar för Event Forwarding

Den här tjänsten kontrollerar om och hur data skickas till vidarebefordran av händelser.

Avsnittet Vidarebefordra händelser på datastream-konfigurationsskärmen.

Inställning
Beskrivning
Launch Property
(Obligatoriskt) Den egenskap för vidarebefordran av händelser som du vill skicka data till.
Launch Environment
(Obligatoriskt) Miljön i den valda egenskapen som du vill skicka data till.
NOTE
Du kan välja Manually enter IDs om du vill skriva in egenskaps- och miljönamnen i stället för att använda listrutemenyerna.

Kopiera ett datastream copy

Du kan skapa en kopia av ett befintligt datastream och ändra informationen efter behov.

NOTE
Datastreams kan bara kopieras inom samma sandlåda. Du kan alltså inte kopiera en datastam från en sandlåda till en annan.

Välj ellipsen () på huvudsidan på arbetsytan Datastreams.) för datastream i fråga och välj sedan Copy.

Bild som visar alternativet Kopiera som väljs i datastreams listvy.

Du kan också välja Copy Datastream i informationsvyn för en given datastream.

Kopieringsalternativ väljs från datastream-informationsvyn.

En bekräftelsedialogruta visas där du uppmanas att ange ett unikt namn för den nya datastream som ska skapas, tillsammans med information om de konfigurationsalternativ som ska kopieras. Välj Copy när du är klar.

Bekräftelsedialogruta för kopiering av ett datastream.

Huvudsidan på arbetsytan Datastreams visas igen med den nya datastream som visas.

Nästa steg

I den här guiden beskrivs hur du hanterar datastölar i användargränssnittet för datainsamling. Mer information om hur du installerar och konfigurerar Web SDK efter att du har konfigurerat ett datastam finns i E2E-guiden för datainsamling.

recommendation-more-help
c4bd45d4-a044-4e32-94ad-5e2f71800fac