DocumentatieExperience PlatformHandleiding voor gegevensstromen

Gegevensstromen maken en configureren

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

Gemaakt voor:

  • Ontwikkelaar

Dit document behandelt de stappen voor het vormen a datastreamin UI.

De werkruimte van Datastreams openen

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

de stromen van Gegevens lusje in de Inzameling UI van Gegevens

Op het tabblad Datastreams wordt een lijst weergegeven met bestaande gegevensstromen, inclusief de vriendelijke naam, id en datum die als laatste is gewijzigd. Om zijn details te bekijken en de dienstente vormen, selecteer de naam van een gegevensstroom.

Om meer opties voor een bepaalde gegevensstroom te openbaren, selecteer het "meer"pictogram (…). Om de basisconfiguratievoor de gegevensstroom bij te werken, selecteer Edit. Selecteer Delete als u de gegevensstroom wilt verwijderen.

Opties om een bestaande gegevensstroom uit te geven of te schrappen

Een gegevensstroom maken create

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

Uitgezochte Nieuwe DataStream

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 het Web SDK gebruikt, moet u ook een op gebeurtenis-gebaseerde schema van de Gegevens van de Ervaring (XDM)selecteren om de gegevens te vertegenwoordigen u bij het opnemen van plan bent.

Basisconfiguratie voor een datastream

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.

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

het configuratiescherm van DataStream met de benadrukte montages van de geolocatie en van de netwerkraadpleging.

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: Populates xdm.placeContext.geo.postalCode
  • Staat/Provincie: Populaten xdm.placeContext.geo.stateProvince
  • DMA: Populates xdm.placeContext.geo.dmaID
  • Stad: Populates xdm.placeContext.geo.city
  • Breedte: Bevolkt xdm.placeContext.geo._schema.latitude
  • Lengte: Bevolkt xdm.placeContext.geo._schema.longitude

Als u City , Latitude of Longitude selecteert, krijgt u coördinaten tot twee decimale punten, ongeacht welke andere opties zijn geselecteerd. Dit wordt beschouwd als stad-vlakke granulariteit.

het selecteren van geen optie maakt geolocatieraadplegingen onbruikbaar. Geolocatie vindt plaats vóór IP Obfuscation . Dit houdt in dat dit niet wordt beïnvloed door de instelling IP Obfuscation .

Network Lookup

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

  • Drager: Populates xdm.environment.carrier
  • Domein: Populates xdm.environment.domain
  • ISP: Populates xdm.environment.ISP

Als u om het even welke gebieden hierboven voor gegevensinzameling toelaat, zorg ervoor dat u correct het context seriebezit plaatst wanneer het vormen van het Web SDK.

Geolocatie-opzoekvelden gebruiken de context arraytekenreeks "placeContext" , terwijl netwerkopzoekvelden de context arraytekenreeks "environment" gebruiken.

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

Opzoeken van apparaat configureren geolocation-device-lookup

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

Vouw de sectie Device Lookup uit om de hieronder beschreven instellingen te configureren.

{het configuratiescherm van 0} DataStream met de benadrukte montages van de apparatenraadpleging.

IMPORTANT
De instellingen in de onderstaande tabel sluiten elkaar uit. U kunt niet zowel gebruikersagent informatie als apparaat raadplegingsgegevens tezelfdertijd selecteren.
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:

    • de fabrikant van het Apparaat: Bevolkt xdm.device.manufacturer
    • model van het Apparaat: Bevolkt xdm.device.modelNumber
    • Marketing naam: Populates xdm.device.model

  • Hardware -informatie:

    • Type van Hardware: Bevolkt xdm.device.type
    • de hoogte van de Vertoning: Bevolkt xdm.device.screenHeight
    • de breedte van de Vertoning: Bevolkt xdm.device.screenWidth
    • de kleurdiepte van de Vertoning: Bevolkt xdm.device.colorDepth

  • Browser -informatie:

    • Browser verkoper: Bevolkt xdm.environment.browserDetails.vendor
    • Browser naam: Bevolkt xdm.environment.browserDetails.name
    • Browser versie: Populates xdm.environment.browserDetails.version

  • Operating system -informatie:

    • OS verkoper: Bevolkt xdm.environment.operatingSystemVendor
    • OS naam: Bevolkt xdm.environment.operatingSystem
    • OS versie: Populates 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 om het even welke gebieden hierboven voor gegevensinzameling toelaat, zorg ervoor dat u correct het context seriebezit plaatst wanneer het vormen van het Web SDK.

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

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

Geavanceerde opties configureren @advanced-options

Selecteer Advanced Options om geavanceerde configuratieopties weer te geven. 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 wordt het laatste octet van het IP-adres van de gebruiker verborgen. 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 datastream-niveau IP obfuscation wordt toegepast vóór IP obfuscation uitgevoerd in Adobe Target, op alle IP adressen aanwezig op het verzoek. Als de optie op gegevensstroomniveau IP obfuscation bijvoorbeeld is ingesteld op Full en de optie Adobe Target IP-verduistering is ingesteld op Last octet obfuscation , ontvangt Adobe Target een volledig verduisterde IP. Als de gegevensstroom-vlakke IP obfuscation optie aan Partial wordt geplaatst en de optie van de Verduistering van Adobe Target IP wordt geplaatst aan Full, ontvangt Adobe Target gedeeltelijk verduisterde IP, en past dan de volledige verduistering op het toe. De verwarring van Adobe Target IP wordt beheerd onafhankelijk van datastream één. Zie de documentatie van Adobe Target op IP verduisteringen geolocationvoor meer details.
  • Audience Manager: Het datastream-niveau IP obfuscation plaatsen wordt toegepast vóór IP obfuscation uitgevoerd in Audience Manager, op alle IP adressen aanwezig in het verzoek. Elke opzoekhandeling van de geolocatie door de Audience Manager wordt beïnvloed door de optie op gegevensstroomniveau IP obfuscation . 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 verduisteringvoor meer details.
  • Adobe Analytics: Als het gegevensbestand-vlakke IP obfuscation plaatsen aan Full wordt geplaatst, 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 Adobe Analytics documentatievoor details op hoe te om IP verwarring in Analytics toe te laten. Als het IP adres volledig verduisterd is en de paginacrek noch ECID noch VisitorID heeft, dan laat Analytics de slag vallen eerder dan het produceren van identiteitskaart van de a Fallback, die gedeeltelijk op het IP adres gebaseerd is.
First Party ID Cookie
Wanneer toegelaten, vertelt dit het plaatsen de Edge Network om naar een gespecificeerd koekje te verwijzen wanneer het kijken omhoog a eerste-partijapparaat identiteitskaart, eerder dan het kijken omhoog deze waarde in de Kaart van de Identiteit.

wanneer het toelaten van dit het plaatsen, moet u de naam van het koekje verstrekken dat identiteitskaart zou moeten 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 wanneer u van plan bent om het Web SDK of Mobiele SDK, samen met Server APIte gebruiken.
  • 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
Laat verwerking van het stromen volgende gegevens voor de integratie van de Edge Network via Experience Platform SDKs of Media Edge APItoe. Leer over Analytics van Media van de documentatie.

Van hier, als u uw gegevensstroom voor Experience Platform vormt, volg het leerprogramma op Prep van Gegevens voor de Inzameling van Gegevensom uw gegevens aan een de gebeurtenisschema van het Platform in kaart te brengen alvorens aan deze gids terug te keren. Anders selecteert u Save en gaat u verder naar 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.

de detailspagina van DataStream.

Van het scherm van gegevensstroomdetails, kunt u de dienstentoevoegen om mogelijkheden van de producten van Adobe Experience Cloud toe te laten u toegang tot hebt. U kunt de 0} basisconfiguratie van de gegevensstroom 🔗 ook uitgeven, zijn kaartregelsbijwerken, exemplaar de datastream, of het volledig schrappen.

Services toevoegen aan een gegevensstroom add-services

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

Uitgezocht voeg de Dienst toe om verder 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 de dienst van de lijst.

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

de Diensten die aan een datastream worden toegevoegd

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

NOTE
Elke serviceconfiguratie bevat een schakeloptie Enabled die automatisch wordt geactiveerd wanneer de service wordt geselecteerd. Als u de geselecteerde service voor deze gegevensstroom wilt uitschakelen, selecteert u de Enabled -schakeloptie opnieuw.

Adobe Analytics-instellingen analytics

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

de gegevensstroommontages van Adobe Analytics.

Instelling
Beschrijving
Report Suite ID
(Vereist) identiteitskaart van de het rapportreeks van Analytics die u gegevens naar wilt verzenden. U vindt deze id 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
(Facultatief) namespace u voor Adobe Analytics bezoekorIDwilt gebruiken. Wanneer u een gebeurtenis verzendt met een waarde die voor deze naamruimte is opgegeven, wordt deze automatisch gebruikt als 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.

het Publiek van de Adobe beheert gegevensstroommontages.

Instelling
Beschrijving
Cookie Destinations Enabled
Staat SDK toe om segmentinformatie via koekjesbestemmingenvan Audience Manager te delen.
URL Destinations Enabled
Staat SDK toe om segmentinformatie via te delen bestemmingen URLvan 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 zandbak
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. Voor meer details over de rol van zandbakken in Experience Platform, zie de zandbakdocumentatie.

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

de gegevensstroommontages van Adobe Experience Platform.

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 klasse XDM ExperienceEventgebruiken. Selecteer Add Event Dataset als u aanvullende gegevenssets wilt toevoegen.
Profile Dataset
Selecteer de dataset van het Platform dat de gegevens van de klantenattributen zullen worden verzonden naar. Dit schema moet de individuele klasse van het Profiel XDMgebruiken.
Offer Decisioning
Laat Offer decisioning voor de implementaties van SDK van het Web toe. Zie de gids op gebruikend Offer decisioning met Web SDKvoor meer implementatiedetails.

voor meer informatie over de mogelijkheden van de Offer decisioning, verwijs naar de documentatie van Adobe Journey Optimizer.
Edge Segmentation
Laat randsegmentatievoor deze gegevensstroom toe. Wanneer SDK van het Webof de Server API van de Edge Networkgegevens door een gegevensstroom met toegelaten randsegmentatie verzendt, worden om het even welke bijgewerkte publiekslidmaatschappen voor het profiel in kwestie teruggestuurd in de reactie.

u kunt deze optie in combinatie met Personalization Destinations voor zelfde-pagina en volgende-pagina het gebruiksgevallen van het verpersoonlijkingsgebruik door randbestemmingenof Offer Decisioning gebruiken.
Personalization Destinations
Wanneer het toelaten van dit na het toelaten van Edge Segmentation checkbox, staat deze optie de datastream toe om met verpersoonlijkingsbestemmingen, zoals Douane Personalizationte verbinden.

verwijs naar de bestemmingsdocumentatie voor specifieke stappen op vormend verpersoonlijkingsbestemmingen.
Adobe Journey Optimizer
Laat Adobe Journey Optimizervoor deze gegevensstroom toe.

Als u deze optie inschakelt, kan de gegevensstroom gepersonaliseerde inhoud van binnenkomende campagnes via het web en op apps gebaseerde campagnes retourneren in Adobe Journey Optimizer . Deze optie is alleen actief in Edge Segmentation . Als Edge Segmentation niet is ingeschakeld, wordt deze optie grijs weergegeven.

Adobe Target-instellingen target

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

de gegevensstroommontages van Adobe Target.

Instelling
Beschrijving
Property Token
Target staat klanten toe om toestemmingen te controleren door eigenschappen te gebruiken. Voor meer informatie over eigenschappen, zie de gids over het vormen ondernemingstoestemmingenin de Target documentatie.

Het bezitstoken kan in Adobe Target UI onder Setup worden gevonden > Properties.
Target Environment ID
Milieu's in Adobe Targethelpen u uw implementatie door alle stadia van ontwikkeling beheren. Deze instelling geeft aan welke omgeving u wilt gebruiken voor deze gegevensstroom.

beste praktijken moeten dit voor elk van uw dev, stage, en prod gegevensstroommilieu's verschillend plaatsen 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 die u voor deze gegevensstroom wilt gebruiken. Zie de gids bij uitvoerend mbox3rdPartyId met het Web SDKvoor 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 dienst controleert of en hoe het gegeven wordt verzonden naar gebeurtenis door:sturen.

Gebeurtenis door:sturen sectie van het scherm van de gegevensstroomconfiguratie.

Instelling
Beschrijving
Launch Property
(Vereist) de gebeurtenis die bezit door:sturen dat u gegevens naar wilt verzenden.
Launch Environment
(Vereist) het milieu binnen het geselecteerde bezit dat u gegevens naar wilt verzenden.
NOTE
U kunt Manually enter IDs selecteren om de naam van de eigenschap en omgeving in te voeren in plaats van de vervolgkeuzemenu's te gebruiken.

Een gegevensstroom kopiëren copy

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

NOTE
De stromen van gegevens kunnen slechts binnen de zelfde zandbakworden gekopieerd. Met andere woorden, u kunt geen gegevensstroom van één zandbak aan een andere kopiëren.

Van de belangrijkste pagina in de Datastreams werkruimte, selecteer de ellips (… ) voor de gegevensstroom in kwestie, dan uitgezocht Copy.

Beeld dat de optie van het Exemplaar toont die van de datastream lijstmening wordt geselecteerd.

U kunt ook Copy Datastream selecteren in de weergave Details van een bepaalde gegevensstroom.

optie die van het Exemplaar van de mening van gegevensstroomdetails wordt geselecteerd.

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. Selecteer Copy als u klaar bent.

de dialoog van de Bevestiging voor het kopiëren van een gegevensstroom.

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

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 te installeren en te vormen een gegevensstroom, verwijs naar de gids van de Inzameling E2E van Gegevens van de Gegevens.

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