Gegevensstromen maken en configureren

Laatst bijgewerkt: 21 februari 2025

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 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

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

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.

InstellingBeschrijving
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:

  • Mobiele Drager: Bevolkt xdm.environment.carrier
  • Domein: Populates xdm.environment.domain
  • ISP: Populates xdm.environment.ISP
  • Type van Verbinding: Bevolkt xdm.environment.connectionType

Als u een van de bovenstaande velden inschakelt voor gegevensverzameling, moet u de array-eigenschap context correct instellen wanneer u de Web SDK configureert.

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 Adobe verschafte Environment Details veldgroep toevoegen aan uw schema.

Opzoeken van apparaat configureren

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.
InstellingBeschrijving
Keep user agent and client hints headersSelecteer 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 informationSelecteer 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 de array-eigenschap context correct instellen wanneer u de Web SDK configureert.

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 Adobe verschafte Environment Details veldgroep toevoegen aan uw schema.

Geavanceerde opties configureren

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 Adobe wordt verzonden. Geolocation lookups moeten worden beperkt of afzonderlijk worden uitgeschakeld.
InstellingBeschrijving
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 geldt ook voor alle Experience Cloud-services 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

Invloed 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 Audience Manager wordt beïnvloed door de optie op gegevensstroomniveau IP obfuscation . Een opzoekhandeling naar een geolocatie in 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 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 CookieWanneer toegelaten, vertelt dit het plaatsen Edge Network om naar een gespecificeerd koekje te verwijzen wanneer het omhoog a eerste-partijapparaat identiteitskaartkijkt, 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 SyncDe 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 IDDe numerieke id van de container die wordt gebruikt voor synchronisatie van externe id's.
Container ID OverridesIn deze sectie kunt u aanvullende id's van de synchronisatiecontainer van derden definiëren waarmee u de standaard id's kunt overschrijven.
Access Type

Definieert het verificatietype dat de Edge Network accepteert voor de gegevensstroom.

  • Mixed Authentication: Als deze optie is geselecteerd, 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 geselecteerd, 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 AnalyticsLaat verwerking van het stromen volgen gegevens voor de integratie van 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

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

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

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

de gegevensstroommontages van Adobe Analytics.

InstellingBeschrijving
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 OverridesIn deze sectie, kunt u extra rapportreeks IDs toevoegen die u kunt gebruiken om het gebrek met voeten te treden.

Adobe Audience Manager-instellingen

Deze service bepaalt of en hoe gegevens naar Adobe Audience Manager worden verzonden. U kunt deze sectie alleen inschakelen als u gegevens naar Audience Manager wilt verzenden. De andere instellingen zijn optioneel, maar worden wel aangemoedigd.

de Audience van Adobe beheert gegevensstroommontages.

InstellingBeschrijving
Cookie Destinations EnabledStaat SDK toe om segmentinformatie via koekjesbestemmingenvan Audience Manager te delen.
URL Destinations EnabledStaat SDK toe om segmentinformatie via te delen bestemmingen URLvan Audience Manager.

Adobe Experience Platform-instellingen

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.

InstellingBeschrijving
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 DatasetSelecteer 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 DecisioningHiermee schakelt u Offer Decisioning for Web SDK-implementaties in. Zie de gids op gebruikend Offer Decisioning met het Web SDKvoor meer implementatiedetails.

voor meer informatie over de mogelijkheden van Offer Decisioning, verwijs naar de documentatie van Adobe Journey Optimizer.
Edge SegmentationLaat randsegmentatievoor deze gegevensstroom toe. Wanneer het Web SDKof de Server API van 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 DestinationsWanneer 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 OptimizerLaat 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

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

de gegevensstroommontages van Adobe Target.

InstellingBeschrijving
Property TokenTarget 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 IDMilieu'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 namespaceDe naamruimte voor de identiteit van de mbox3rdPartyId die u voor deze gegevensstroom wilt gebruiken. Als u een Customer Attributes integratie met Adobe Target gebruikt of thirdPartyId gebruikt om profielen via Profiles API van Adobe Targetbij te werken of tot stand te brengen, moet u een namespacewaarde van uw keus verstrekken. U moet deze naamruimte gebruiken in de IdentityMap -sectie van uw XDM-schema om de customerID of thirdPartyId te verzenden die worden gebruikt in het uploaden van het bestand met klantkenmerken of in de API-aanroepen voor het bijwerken van het profiel. Zie de gids bij het uitvoeren mbox3rdPartyId met het Web SDKvoor meer informatie.
Property Token OverridesIn 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.

InstellingBeschrijving
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

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.