DocumentatieExperience PlatformHandleiding voor gegevensstromen

Gegevensstromen maken en configureren

Last update: Thu May 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • Ontwikkelaar

In dit document worden de stappen beschreven voor het configureren van een datastream in de gebruikersinterface.

Toegang krijgen tot de Datastreams werkruimte

U kunt gegevensstromen in de UI van de Inzameling van Gegevens of UI van het Experience Platform tot stand brengen en beheren door te selecteren Datastreams in de linkernavigatie.

Gegevensstromen tabblad in de gebruikersinterface voor gegevensverzameling

De Datastreams wordt een lijst weergegeven met bestaande gegevensstromen, inclusief de vriendelijke naam, id en datum die als laatste is gewijzigd. Naar Bekijk zijn details en vorm de dienstenselecteert u de naam van een gegevensstroom.

Als u meer opties voor een bepaalde gegevensstroom wilt weergeven, selecteert u het pictogram Meer (…). Als u het dialoogvenster basisconfiguratie voor de gegevensstroom selecteert u Edit. Als u de gegevensstroom wilt verwijderen, selecteert u Delete.

Opties voor het bewerken of verwijderen van een bestaande gegevensstroom

Een gegevensstroom maken create

Als u een gegevensstroom wilt maken, selecteert u New Datastream.

Nieuwe gegevensstroom selecteren

De workflow voor het maken van de gegevensstroom wordt weergegeven, te beginnen bij de configuratiestap. Van hier, moet u een naam en een facultatieve beschrijving voor de gegevensstroom verstrekken.

Als u een gegevensstroom voor gebruik in Experience Platform vormt en u ook SDK van het Web gebruikt, moet u ook selecteren op gebeurtenissen gebaseerd XDM-schema (Experience Data Model) om de gegevens te vertegenwoordigen u bij het opnemen bent.

Basisconfiguratie voor een gegevensstroom

Geolocatie en netwerkopzoekhandeling configureren geolocation-network-lookup

De montages van de geolocatie en van de netwerkraadpleging helpen u het niveau van granulariteit van de geografische en netwerk-vlakke gegevens bepalen die u wilt verzamelen.

Breid uit Geolocation and network lookup om de hieronder beschreven instellingen te configureren.

Het configuratiescherm van de gegevensstroom met de geolocatie en de montages van de netwerkraadpleging benadrukt.

Instelling
Beschrijving
Geo Lookup

Hiermee schakelt u geolocatiezoekopdrachten voor de geselecteerde opties in op basis van het IP-adres van de bezoeker. Beschikbare opties zijn:

  • Land: Populaten xdm.placeContext.geo.countryCode
  • Postcode: Populaten xdm.placeContext.geo.postalCode
  • Staat/provincie: Populaten xdm.placeContext.geo.stateProvince
  • DMA: Populaten xdm.placeContext.geo.dmaID
  • Plaats: Populaten xdm.placeContext.geo.city
  • Breedte: Populaten xdm.placeContext.geo._schema.latitude
  • Lengtegraad: Populaten xdm.placeContext.geo._schema.longitude

Selecteren City, Latitude, of Longitude biedt coördinaten tot twee decimale punten, ongeacht welke andere opties zijn geselecteerd. Dit wordt beschouwd als granulariteit op stadsniveau.

Als u geen optie selecteert, worden geolocatieopzoekingen uitgeschakeld. Geolocatie gebeurt voor IP Obfuscation, hetgeen betekent dat de IP Obfuscation instellen.

Network Lookup

Laat netwerkraadplegingen voor de geselecteerde opties toe die op het IP van de bezoeker adres worden gebaseerd. Beschikbare opties zijn:

  • Vervoerder: Populaten xdm.environment.carrier
  • Domein: Populaten xdm.environment.domain
  • ISP: Populaten xdm.environment.ISP

Als u een van de bovenstaande velden inschakelt voor gegevensverzameling, moet u ervoor zorgen dat u de context arraybezit wanneer het vormen van het Web SDK.

De opzoekvelden van Geolocatie gebruiken de context arraytekenreeks "placeContext", terwijl de gebieden van de netwerkraadpleging gebruiken context arraytekenreeks "environment".

Zorg er ook voor dat elk gewenst XDM-veld in uw schema voorkomt. Als dit niet het geval is, kunt u de meegeleverde Adobe toevoegen Environment Details veldgroep aan uw schema.

Opzoeken van apparaat configureren geolocation-device-lookup

De Device Lookup Met instellingen kunt u apparaatspecifieke informatie selecteren die u wilt verzamelen.

Breid uit Device Lookup om de hieronder beschreven instellingen te configureren.

Het configuratiescherm van de gegevensstroom met de benadrukte montages van de apparatenraadpleging.

IMPORTANT
De instellingen in de onderstaande tabel sluiten elkaar uit. U kunt niet beide gebruikersagent-gegevens selecteren en de opzoekgegevens van het apparaat tegelijkertijd.
Instelling
Beschrijving
Keep user agent and client hints headers
Selecteer deze optie als u alleen de gegevens wilt verzamelen die in de userAgent-tekenreeks zijn opgeslagen. Deze instelling is standaard geselecteerd. Populaten xdm.environment.browserDetails.userAgent
Use device lookup to collect the following information

Selecteer deze optie als u een of meer van de volgende apparaatspecifieke informatie wilt verzamelen:

  • Device informatie:

    • Apparaatfabrikant: Populaten xdm.device.manufacturer
    • Apparaatmodel: Populaten xdm.device.modelNumber
    • Marketingnaam: Populaten xdm.device.model

  • Hardware informatie:

    • Type hardware: Populaten xdm.device.type
    • Weergavehoogte: Populaten xdm.device.screenHeight
    • Weergavebreedte: Populaten xdm.device.screenWidth
    • Kleurdiepte weergeven: Populaten xdm.device.colorDepth

  • Browser informatie:

    • Browserleverancier: Populaten xdm.environment.browserDetails.vendor
    • Browsernaam: Populaten xdm.environment.browserDetails.name
    • Browserversie: Populaten xdm.environment.browserDetails.version

  • Operating system informatie:

    • OS-leverancier: Populaten xdm.environment.operatingSystemVendor
    • Naam besturingssysteem: Populaten xdm.environment.operatingSystem
    • Versie besturingssysteem: Populaten xdm.environment.operatingSystemVersion

Opzoekgegevens van het apparaat kunnen niet samen met de gebruikersagent en de clienthints worden verzameld. Als u ervoor kiest apparaatinformatie te verzamelen, wordt de verzameling van gebruikersagent- en clienthints uitgeschakeld en andersom.

Do not collect any device information
Selecteer deze optie als u geen informatie over het zoeken van apparaten wilt verzamelen. Er worden geen apparaat-, hardware-, browser-, besturingssysteem-, gebruikersagent- of clientgegevens verzameld.

Als u een van de bovenstaande velden inschakelt voor gegevensverzameling, moet u ervoor zorgen dat u de context arraybezit wanneer het vormen van het Web SDK.

Apparaat- en hardwaregegevens gebruiken de context arraytekenreeks "device", terwijl de browser en besturingssysteeminformatie de context arraytekenreeks "environment".

Zorg er ook voor dat elk gewenst XDM-veld in uw schema voorkomt. Als dit niet het geval is, kunt u de meegeleverde Adobe toevoegen Environment Details veldgroep aan uw schema.

Geavanceerde opties configureren @advanced-options

Selecteer Advanced Options. Hier, kunt u extra gegevensstroommontages, zoals IP obfuscation, de koekjes van eerste identiteitskaart van de Partij, en meer vormen.

Geavanceerde configuratieopties

IMPORTANT
U bent ervoor verantwoordelijk dat u alle benodigde machtigingen, toestemmingen, toestemmingen, toestemmingen, en toestemming hebt verkregen die krachtens de toepasselijke wetten en verordeningen vereist zijn voor het verzamelen, verwerken en verzenden van persoonlijke gegevens, met inbegrip van nauwkeurige geolocatiegegevens.
Uw IP selectie van de adresverwarring beïnvloedt niet het niveau van geolocatieinformatie die uit het IP adres wordt afgeleid en naar uw gevormde oplossingen van de Adobe wordt verzonden. Geolocation lookups moeten worden beperkt of afzonderlijk worden uitgeschakeld.
Instelling
Beschrijving
IP Obfuscation

Geeft het type IP-verduistering aan dat op de gegevensstroom moet worden toegepast. Om het even welke verwerking die op klantIP wordt gebaseerd wordt beïnvloed door IP het obfuseren plaatsen. Dit omvat alle diensten van het Experience Cloud die gegevens van uw gegevensstroom ontvangen.

Beschikbare opties:

  • None: Schakelt IP-verduistering uit. Het volledige gebruikersIP adres wordt verzonden via de datastream.

  • Partial: Voor IPv4 adressen, verduistert het laatste octet van het gebruikersIP adres. Voor IPv6 adressen, verduistert de laatste 80 beetjes van het adres.

    Voorbeelden:

    • 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: Verduistert het volledige IP adres.

    Voorbeelden:

    • 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

Het effect van IP-verduistering op andere Adobe producten:

  • Adobe Target: Het gegevensstroomniveau IP obfuscation wordt toegepast vóór de IP obfuscation uitgevoerd in Adobe Target, aan alle IP adressen aanwezig op het verzoek. Bijvoorbeeld wanneer het gegevensstroomniveau IP obfuscation optie is ingesteld op Full en de optie van de Verduistering van Adobe Target IP wordt geplaatst aan Last octet obfuscation Adobe Target ontvangt een volledig verduisterde IP. Indien het gegevensstroomniveau IP obfuscation optie is ingesteld op Partial en de optie van de Verduistering van Adobe Target IP wordt geplaatst aan Full Adobe Target ontvangt een gedeeltelijk verduisterde IP en past daarop de volledige verduistering toe. De verwarring van Adobe Target IP wordt beheerd onafhankelijk van datastream één. Zie de Adobe Target documentatie op IP obfuscatie en geolocatie voor meer informatie .
  • Audience Manager: Het gegevensstroomniveau IP obfuscation instelling wordt toegepast vóór de instelling IP obfuscation uitgevoerd in Audience Manager, aan alle IP adressen huidig in het verzoek. Elke opzoekhandeling van de geolocatie door de Audience Manager wordt beïnvloed door het niveau van de gegevensstroom IP obfuscation -optie. Een opzoekhandeling naar een geolocatie in de Audience Manager, gebaseerd op een volledig verduisterde IP, resulteert in een onbekend gebied en alle segmenten op basis van de resulterende geolocatiegegevens worden niet uitgevoerd. Zie de documentatie van de Audience Manager op IP obfuscatie voor meer informatie .
  • Adobe Analytics: Als IP-verduistering op gegevensstroomniveau wordt ingesteld op Full, behandelt Adobe Analytics het IP-adres als leeg. Dit beïnvloedt om het even welke verwerking van Analytics die van IP adres, zoals geolocation raadplegingen en IP het filtreren afhangt. Voor Analytics om de onverduisterde of gedeeltelijk verduisterde IP adressen te ontvangen, plaats het IP verduisteren plaatsen aan Partial of None. Gedeeltelijk verduisterde en onverduisterde IP adressen kunnen verder worden verduisterd binnen Analytics. Zie de Adobe Analytics documentatie voor details op hoe te om IP verwarring in Analytics toe te laten. Als het IP adres volledig verduisterd is en de paginaconte geen heeft ECID noch VisitorIDEn dan laat Analytics de hit vallen in plaats van een Fallback-id, die gedeeltelijk op het IP-adres is gebaseerd.
First Party ID Cookie
Als deze instelling is ingeschakeld, geeft de Edge Network de opdracht naar een opgegeven cookie te verwijzen wanneer een gebruiker een apparaat-id van eerste partijin plaats van deze waarde op te zoeken in het identiteitsoverzicht.

Als u deze instelling inschakelt, moet u de naam opgeven van het cookie dat de id moet opslaan.
Third Party ID Sync
De syncs van identiteitskaart kunnen in containers worden gegroepeerd om verschillende syncs van identiteitskaart toe te laten om op verschillende tijden worden in werking gesteld. Als deze instelling is ingeschakeld, kunt u opgeven welke container met id-syncs wordt uitgevoerd voor deze gegevensstroom.
Third Party ID Sync Container ID
De numerieke id van de container die wordt gebruikt voor synchronisatie van externe id's.
Container ID Overrides
In deze sectie kunt u aanvullende id's van de synchronisatiecontainer van derden definiëren waarmee u de standaard id's kunt overschrijven.
Access Type

Bepaalt het authentificatietype dat de Edge Network voor de gegevensstroom goedkeurt.

  • Mixed Authentication: Als deze optie is ingeschakeld, accepteert de Edge Network zowel geverifieerde als niet-geverifieerde aanvragen. Selecteer deze optie als u de SDK van het Web wilt gebruiken of Mobile SDK, samen met de Server-API.
  • Authenticated Only: Als deze optie is ingeschakeld, accepteert de Edge Network alleen geverifieerde aanvragen. Selecteer deze optie als u alleen de server-API wilt gebruiken en niet-geverifieerde aanvragen door de Edge Network moeten worden verwerkt.
Media Analytics
Maakt verwerking van streaming tracking-gegevens voor Edge Network-integratie via Experience Platform SDK's of Media Edge-API. Meer informatie over Media Analytics van de documentatie.

Als u vanaf hier uw gegevensstroom configureert voor Experience Platform, volgt u de zelfstudie Gegevensvoorvoegsel voor gegevensverzameling om uw gegevens toe te wijzen aan een de gebeurtenisschema van het Platform alvorens aan deze gids terug te keren. Anders selecteert u Save en ga verder met de volgende sectie.

Gegevens gegevensstroom weergeven view-details

Nadat u een nieuwe gegevensstroom hebt geconfigureerd of een bestaande gegevensstroom hebt geselecteerd, wordt de detailpagina voor die gegevensstroom weergegeven. Hier vindt u meer informatie over de gegevensstroom, inclusief de bijbehorende id.

Detailpagina DataStream.

Vanuit het scherm met gegevensstroomdetails kunt u toevoegen, services om functies in te schakelen van de Adobe Experience Cloud-producten waartoe u toegang hebt. U kunt de gegevensstroom ook uitgeven basisconfiguratie, werkt de toewijzingsregels, de gegevensstroom kopiëren, of deze volledig verwijderen.

Services toevoegen aan een gegevensstroom add-services

Selecteer op de detailpagina van een gegevensstroom de optie Add Service om de beschikbare services voor die gegevensstroom toe te voegen.

Selecteer Service toevoegen om door te gaan.

Voor het volgende scherm, gebruik dropdown menu om de dienst te selecteren voor deze gegevensstroom te vormen. Alleen de services waartoe u toegang hebt, worden in deze lijst weergegeven.

Selecteer een service in de lijst.

Selecteer de gewenste service, vul de configuratieopties in die worden weergegeven en selecteer Save om de dienst aan de datastream toe te voegen. Alle toegevoegde diensten verschijnen in de detailmening voor de gegevensstroom.

Services die aan een gegevensstroom zijn toegevoegd

In de onderstaande subsecties worden de configuratieopties voor elke service beschreven.

NOTE
Elke de dienstconfiguratie bevat Enabled schakelt die automatisch wordt geactiveerd wanneer de service wordt geselecteerd. Als u de geselecteerde service voor deze gegevensstroom wilt uitschakelen, selecteert u de Enabled weer schakelen.

Adobe Analytics-instellingen analytics

Deze service bepaalt of en hoe gegevens naar Adobe Analytics worden verzonden. Zie Gegevens verzenden naar Adobe Analytics.

Adobe Analytics-gegevensstroominstellingen.

Instelling
Beschrijving
Report Suite ID
(Vereist) De id van de Analytics-rapportsuite waarnaar u gegevens wilt verzenden. Deze id is te vinden in de gebruikersinterface van Adobe Analytics onder Admin > ReportSuites. Als de veelvoudige rapportreeksen worden gespecificeerd, dan worden de gegevens gekopieerd aan elke rapportreeks.
Visitor ID namespace
(Optioneel) De naamruimte die u wilt gebruiken voor de Adobe Analytics bezoekerID. Wanneer u een gebeurtenis verzendt met een waarde die voor deze naamruimte is opgegeven, wordt deze automatisch gebruikt als de visitorID in Analytics.
Report Suite Overrides
In deze sectie, kunt u extra rapportreeks IDs toevoegen die u kunt gebruiken om het gebrek met voeten te treden.

Adobe Audience Manager-instellingen audience-manager

Deze service bepaalt of en hoe gegevens naar Adobe Audience Manager worden verzonden. Alles wat nodig is om gegevens naar de Audience Manager te verzenden, moet deze sectie inschakelen. De andere instellingen zijn optioneel, maar worden wel aangemoedigd.

Adobe publiek beheert gegevensstroominstellingen.

Instelling
Beschrijving
Cookie Destinations Enabled
Staat SDK toe om segmentinformatie via te delen koekjesbestemmingen van Audience Manager.
URL Destinations Enabled
Staat SDK toe om segmentinformatie via te delen URL-doelen van Audience Manager.

Adobe Experience Platform-instellingen aep

IMPORTANT
Wanneer het toelaten van een gegevensstroom voor Platform, neem nota van de zandbak van het Platform die u momenteel gebruikt, zoals getoond in het hoogste lint van UI.
Geselecteerde sandbox
Sandboxen zijn virtuele partities in Adobe Experience Platform waarmee u uw gegevens en implementaties kunt isoleren van die in uw organisatie. Wanneer een gegevensstroom is gemaakt, kan de sandbox niet meer worden gewijzigd. Zie voor meer informatie over de rol van sandboxen in het Experience Platform de klasse sandboxdocumentatie.

Deze service bepaalt of en hoe gegevens naar Adobe Experience Platform worden verzonden.

Adobe Experience Platform-gegevensstroominstellingen.

Instelling
Beschrijving
Event Dataset
(Vereist) Selecteer de dataset van het Platform dat de gegevens van de klantengebeurtenis zullen worden gestroomd aan. Dit schema moet de XDM ExperienceEvent, klasse. Als u aanvullende gegevenssets wilt toevoegen, selecteert u Add Event Dataset.
Profile Dataset
Selecteer de dataset van het Platform dat de gegevens van de klantenattributen zullen worden verzonden naar. Dit schema moet de Afzonderlijke XDM-profielklasse.
Offer Decisioning
Laat Offer decisioning voor de implementaties van SDK van het Web toe. Zie de handleiding op het gebruiken van Offer decisioning met Web SDK voor meer details over de implementatie.

Raadpleeg voor meer informatie over de mogelijkheden van Offer decisioning de Adobe Journey Optimizer-documentatie.
Edge Segmentation
Inschakelen randsegmentatie voor deze gegevensstroom. Wanneer de Web SDK of Edge Network Server-API verzendt gegevens door een gegevensstroom met toegelaten randsegmentatie, om het even welke bijgewerkte publiekslidmaatschappen voor het profiel in kwestie worden teruggestuurd in de reactie.

U kunt deze optie in combinatie met Personalization Destinations voor personalisatie van dezelfde pagina en van volgende pagina, gebruiks gevallen door Edge-doelen of Offer Decisioning.
Personalization Destinations
Wanneer u deze optie inschakelt nadat u het Edge Segmentation checkbox, staat deze optie de datastream toe om met verpersoonlijkingsbestemmingen, zoals te verbinden Aangepaste personalisatie.

Raadpleeg de documentatie bij bestemmingen voor specifieke stappen over het vormen verpersoonlijkingsbestemmingen.
Adobe Journey Optimizer
Inschakelen Adobe Journey Optimizer voor deze gegevensstroom.

Als u deze optie inschakelt, kan de gegevensstroom gepersonaliseerde inhoud van binnenkomende webcampagnes en op apps gebaseerde campagnes retourneren in Adobe Journey Optimizer. Deze optie is vereist Edge Segmentation om actief te zijn. Indien Edge Segmentation is uitgeschakeld, wordt deze optie grijs weergegeven.

Adobe Target-instellingen target

Deze service bepaalt of en hoe gegevens naar Adobe Target worden verzonden.

Adobe Target-gegevensstroominstellingen.

Instelling
Beschrijving
Property Token
Target staat klanten toe om toestemmingen te controleren door eigenschappen te gebruiken. Zie de handleiding voor meer informatie over eigenschappen configureren van bedrijfsmachtigingen in de Target documentatie.

Het eigenschapstoken vindt u in de gebruikersinterface van Adobe Target onder Setup > Properties.
Target Environment ID
Milieu in Adobe Target helpen u bij het beheren van uw implementatie in alle ontwikkelingsstadia. Deze instelling geeft aan welke omgeving u wilt gebruiken voor deze gegevensstroom.

De beste manier is om dit voor elk van uw dev, stage, en prod gegevensstroomomgevingen om dingen eenvoudig te houden. Als u echter al Adobe Target-omgevingen hebt gedefinieerd, kunt u deze gebruiken.
Target Third Party ID namespace
De naamruimte voor de identiteit van de mbox3rdPartyId wilt gebruiken voor deze gegevensstroom. Zie de handleiding op uitvoeren mbox3rdPartyId met de Web SDK voor meer informatie .
Property Token Overrides
In deze sectie kunt u aanvullende eigenschapstokens definiëren die u kunt gebruiken om de standaardtokens te overschrijven.

Event Forwarding instellingen

Deze service bepaalt of en hoe gegevens worden verzonden naar gebeurtenis doorsturen.

Het door:sturen van de gebeurtenis sectie van het de configuratiescherm van de gegevensstroom.

Instelling
Beschrijving
Launch Property
(Vereist) De gebeurtenis die bezit door:sturen dat u gegevens naar wilt verzenden.
Launch Environment
(Vereist) De omgeving binnen de geselecteerde eigenschap waarnaar u gegevens wilt verzenden.
NOTE
U kunt Manually enter IDs om in de bezit en omgevingsnamen in plaats van het gebruiken van dropdown menu's te typen.

Een gegevensstroom kopiëren copy

U kunt een kopie van een bestaande gegevensstroom maken en de details ervan desgewenst wijzigen.

NOTE
Gegevensstromen kunnen alleen worden gekopieerd binnen dezelfde map sandbox. Met andere woorden, u kunt geen gegevensstroom van één zandbak aan een andere kopiëren.

Vanaf de hoofdpagina in het dialoogvenster Datastreams werkruimte, selecteert u de ellips (…) voor de gegevensstroom in kwestie, dan selecteren Copy.

Afbeelding die de optie Kopiëren weergeeft die wordt geselecteerd in de lijstweergave van de gegevensstroom.

U kunt ook Copy Datastream in de detailweergave van een bepaalde gegevensstroom.

De optie Kopiëren die wordt geselecteerd in de weergave met gegevensstroomdetails.

Er wordt een bevestigingsdialoogvenster weergegeven waarin u wordt gevraagd een unieke naam op te geven voor de nieuwe gegevensstroom die moet worden gemaakt, en waarin u informatie kunt vinden over de configuratieopties waarover u de gegevens wilt kopiëren. Indien klaar, selecteert u Copy.

Bevestigingsdialoogvenster voor het kopiëren van een gegevensstroom.

De hoofdpagina van de Datastreams wordt de werkruimte opnieuw weergegeven met de nieuwe gegevensstroom die wordt weergegeven.

Volgende stappen

Deze gids behandelde hoe te om gegevensstromen in de Inzameling van Gegevens UI te beheren. Voor meer informatie over om SDK van het Web na vestiging een gegevensstroom te installeren en te vormen, verwijs naar E2E-handleiding voor gegevensverzameling.

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