Documentatie Experience Platform Handleiding voor bestemmingen

Ultimate

Amazon Kinesis verbinding

Laatst bijgewerkt: 4 april 2025

Onderwerpen:
Destinations

Gemaakt voor:

Beheerder
Gebruiker

Overzicht

IMPORTANT

Deze bestemming is beschikbaar slechts aan Adobe Real-Time Customer Data Platform Ultimateklanten.

Met de Kinesis Data Streams -service van Amazon Web Services kunt u grote stromen gegevensrecords in real-time verzamelen en verwerken.

U kunt een real-time uitgaande verbinding maken met uw Amazon Kinesis -opslag om gegevens vanuit Adobe Experience Platform te streamen.

Voor meer informatie over Amazon Kinesis, zie de documentatie van Amazon.
Om met Amazon Kinesis programmatically te verbinden, zie de Streaming bestemmingen API leerprogramma.
Zie de volgende secties als u verbinding wilt maken met Amazon Kinesis via de Experience Platform-gebruikersinterface.

Kinesis van Amazon in UI

Gebruiksscenario’s

Door het stromen bestemmingen zoals Amazon Kinesis te gebruiken, kunt u high-value segmenteringsgebeurtenissen en bijbehorende profielattributen in uw systemen van keus gemakkelijk invoeren.

Met een vooruitzicht downloadde u bijvoorbeeld een witboek dat hen kwalificeert tot een segment met een "hoge neiging om te converteren". Als u het publiek in kaart brengt dat het vooruitzicht naar het Amazon Kinesis -doel valt, ontvangt u deze gebeurtenis in Amazon Kinesis . Daar, kunt u een doe-het-zelf benadering gebruiken en bedrijfslogica bovenop de gebeurtenis beschrijven, aangezien u denkt het beste met uw systemen van bedrijfsIT zou werken.

Ondersteunde doelgroepen

In deze sectie wordt beschreven welke soorten publiek u naar dit doel kunt exporteren.

Oorsprong publiek	Ondersteund	Beschrijving
Segmentation Service	✓	Het publiek produceerde door de Dienst van de Segmentatie van Experience Platform 🔗.
Aangepaste uploads	✓	Het publiek ingevoerdein Experience Platform van Csv- dossiers.

Type en frequentie exporteren

Raadpleeg de onderstaande tabel voor informatie over het exporttype en de exportfrequentie van de bestemming.

Item	Type	Notities
Exporttype	Profile-based	U exporteert alle leden van een segment, samen met de gewenste schemavelden (bijvoorbeeld: e-mailadres, telefoonnummer, achternaam), zoals gekozen in het scherm van de uitgezochte profielkenmerken van het werkschema van de bestemmingsactivering.
Exportfrequentie	Streaming	Streaming doelen zijn "altijd aan" API-verbindingen. Zodra een profiel in Experience Platform wordt bijgewerkt dat op publieksevaluatie wordt gebaseerd, verzendt de schakelaar de update stroomafwaarts naar het bestemmingsplatform. Lees meer over het stromen bestemmingen.

IP adres lijst van gewenste personen

Experience Platform biedt een lijst met statische IP's die u kunt lijsten van gewenste personen voor de Amazon Kinesis -bestemming om aan de beveiligings- en compatibiliteitsvereisten van klanten te voldoen. Verwijs naar IP adreslijst van gewenste personen voor het stromen bestemmingenvoor de volledige lijst van IPs aan lijst van gewenste personen.

Vereiste Amazon Kinesis machtigingen

Experience Platform heeft machtigingen nodig voor de volgende handelingen om gegevens te kunnen verbinden en exporteren naar uw Amazon Kinesis -streams:

kinesis:ListStreams
kinesis:PutRecord
kinesis:PutRecords

Deze machtigingen worden gerangschikt via de Kinesis -console en worden gecontroleerd door Experience Platform nadat u uw Kinesis-bestemming hebt geconfigureerd in de Experience Platform-gebruikersinterface.

In het onderstaande voorbeeld worden de minimale toegangsrechten weergegeven die zijn vereist om gegevens te kunnen exporteren naar een Kinesis -doel.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kinesis:ListStreams",
                "kinesis:PutRecord",
                "kinesis:PutRecords"
            ],
            "Resource": [
                "arn:aws:kinesis:us-east-2:901341027596:stream/*"
            ]
        }
    ]
}

Eigenschap

Beschrijving

kinesis:ListStreams

Een handeling waarmee uw Amazon Kinesis-gegevensstromen worden vermeld.

kinesis:PutRecord

Een handeling die één gegevensrecord naar een Kinesis-gegevensstroom schrijft.

kinesis:PutRecords

Een actie die veelvoudige gegevensverslagen in een de gegevensstroom van Kinesis in één enkele vraag schrijft.

Voor meer informatie bij het controleren van toegang voor Kinesis gegevensstromen, lees het volgende Kinesis document.

Verbinden met de bestemming

IMPORTANT

Om met de bestemming te verbinden, hebt u View Destinations en Manage Destinations toegangsbeheertoestemmingennodig. Lees het overzicht van de toegangscontroleof contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.

Om met deze bestemming te verbinden, volg de stappen die in het leerprogramma van de bestemmingsconfiguratieworden beschreven. Wanneer u verbinding maakt met dit doel, moet u de volgende informatie opgeven:

Verificatiegegevens

Voer de onderstaande velden in en selecteer Connect to destination :

Beeld van het scherm UI die voltooide gebieden voor de de authentificatiedetails van Kinesis van Amazon tonen

Amazon Web Servicestoegangstoets en geheime sleutel : genereer in Amazon Web Services een access key - secret access key paar om Experience Platform toegang te verlenen tot uw Amazon Kinesis -account. Leer meer in de documentatie van Amazon Web Services.
Region: geef aan naar welk Amazon Web Services -gebied gegevens moeten worden gestreamd.

Doelgegevens invullen

Als u details voor de bestemming wilt configureren, vult u de vereiste en optionele velden hieronder in. Een sterretje naast een veld in de gebruikersinterface geeft aan dat het veld verplicht is.

Beeld van het scherm UI die voltooide gebieden voor de bestemmingsdetails van Amazon Kinesis tonen

Name: Geef een naam op voor uw verbinding met Amazon Kinesis
Description: geef een beschrijving op voor de verbinding met Amazon Kinesis .
Stream: geef de naam op van een bestaande gegevensstroom in uw Amazon Kinesis -account. Experience Platform exporteert gegevens naar deze stream.
Include Segment Names: in-/uitschakelen als u wilt dat bij het exporteren van de gegevens de namen worden opgenomen van het publiek dat u exporteert. Voor een voorbeeld van een gegevens die met deze geselecteerde optie uitvoeren, verwijs naar de Uitgevoerde gegevenssectie verder hieronder.
Include Segment Timestamps: Schakel deze optie in als u wilt dat bij het exporteren van de gegevens de UNIX-tijdstempel wordt gebruikt wanneer het publiek is gemaakt en bijgewerkt, en ook de UNIX-tijdstempel wanneer het publiek voor activering is toegewezen aan het doel. Voor een voorbeeld van een gegevens die met deze geselecteerde optie uitvoeren, verwijs naar de Uitgevoerde gegevenssectie verder hieronder.

Waarschuwingen inschakelen

U kunt alarm toelaten om berichten over de status van dataflow aan uw bestemming te ontvangen. Selecteer een waarschuwing in de lijst om u te abonneren op meldingen over de status van uw gegevensstroom. Voor meer informatie over alarm, zie de gids bij het intekenen aan bestemmingsalarm gebruikend UI.

Wanneer u klaar bent met het opgeven van details voor uw doelverbinding, selecteert u Next .

Soorten publiek naar dit doel activeren

IMPORTANT

Om gegevens te activeren, hebt u View Destinations, Activate Destinations, View Profiles, en View Segments toegangsbeheertoestemmingennodig. Lees het overzicht van de toegangscontroleof contacteer uw productbeheerder om de vereiste toestemmingen te verkrijgen.
de beleidsevaluatie van de toestemmingwordt momenteel niet gesteund in de uitvoer naar de bestemming van Amazon Kinesis. Meer informatie.

Zie publieksgegevens aan het stromen van profieluitvoer bestemmingenvoor instructies op het activeren van publiek aan deze bestemming activeren.

Exportgedrag profiel

Experience Platform optimaliseert het gedrag voor het exporteren van profielen naar uw Amazon Kinesis -doel, zodat alleen gegevens naar uw doel worden geëxporteerd wanneer relevante updates naar een profiel zijn opgetreden na een kwalificatie van het publiek of andere belangrijke gebeurtenissen. In de volgende situaties worden profielen naar uw doel geëxporteerd:

De profielupdate werd bepaald door een wijziging in het publiekslidmaatschap voor ten minste een van de doelgroepen. Het profiel is bijvoorbeeld gekwalificeerd voor een van de soorten publiek die aan de bestemming zijn toegewezen of heeft een van de soorten publiek afgesloten die aan de bestemming zijn toegewezen.
De profielupdate werd bepaald door een verandering in de identiteitskaart. Een profiel dat bijvoorbeeld al was gekwalificeerd voor een van de soorten publiek dat aan de bestemming is toegewezen, is toegevoegd aan een nieuwe identiteit in het kenmerk Naamplaatje.
De profielupdate is bepaald door een wijziging in kenmerken voor ten minste een van de kenmerken die aan de bestemming zijn toegewezen. Een van de kenmerken die in de toewijzingsstap aan het doel is toegewezen, wordt bijvoorbeeld aan een profiel toegevoegd.

In alle hierboven beschreven gevallen worden alleen de profielen waarin relevante updates zijn opgetreden, naar uw bestemming geëxporteerd. Bijvoorbeeld, als een publiek dat aan de bestemmingsstroom in kaart wordt gebracht honderd leden heeft, en vijf nieuwe profielen voor het segment kwalificeren, is de uitvoer naar uw bestemming incrementeel en omvat slechts de vijf nieuwe profielen.

Alle toegewezen kenmerken worden geëxporteerd voor een profiel, ongeacht de locatie van de wijzigingen. In het voorbeeld hierboven worden alle toegewezen kenmerken voor deze vijf nieuwe profielen geëxporteerd, zelfs als de kenmerken zelf niet zijn gewijzigd.

Wat bepaalt een gegevensexport en wat wordt opgenomen in de export?

Met betrekking tot het gegeven dat voor een bepaald profiel wordt uitgevoerd, is het belangrijk om de twee verschillende concepten te begrijpen wat een gegevensuitvoer aan uw Amazon Kinesis bestemming en bepaalt welke gegevens in de uitvoer inbegrepen zijn.

Wat bepaalt de doelexport

Wat is inbegrepen in de doelexport

Toegewezen kenmerken en doelgroepen fungeren als actiepunt voor het exporteren van een bestemming. Dit betekent dat als een toegewezen publiek de status wijzigt (van null in realized of van realized in exiting ) of dat toegewezen kenmerken worden bijgewerkt, een doelexport wordt uitgeschakeld.
Omdat identiteiten momenteel niet aan Amazon Kinesis bestemmingen kunnen worden in kaart gebracht, bepalen de veranderingen in om het even welke identiteit op een bepaald profiel ook bestemmingsuitvoer.
Een wijziging voor een kenmerk wordt gedefinieerd als een update voor het kenmerk, ongeacht of het dezelfde waarde heeft of niet. Dit houdt in dat een overschrijven van een kenmerk als een wijziging wordt beschouwd, zelfs als de waarde zelf niet is gewijzigd.

Het segmentMembership -object bevat het publiek dat is toegewezen in de activeringsgegevensstroom, waarvoor de status van het profiel is gewijzigd na een afsluitgebeurtenis voor kwalificatie of publiek. Merk op dat andere niet in kaart gebrachte publiek waarvoor het profiel dat voor wordt gekwalificeerd deel van de bestemmingsuitvoer kan uitmaken, als deze doelgroepen tot het zelfde fusiebeleidzoals het publiek behoren dat in activeringsdataflow in kaart wordt gebracht.
Alle identiteiten in het identityMap -object worden ook opgenomen (Experience Platform ondersteunt momenteel geen identiteitstoewijzing in het Amazon Kinesis -doel).
Alleen de toegewezen kenmerken worden opgenomen in de doelexport.

Neem bijvoorbeeld deze gegevensstroom naar een Amazon Kinesis -bestemming waar drie soorten publiek in de gegevensstroom zijn geselecteerd en vier kenmerken aan de bestemming worden toegewezen.

de bestemmingsdataflow van Amazon Kinesis

Een profieluitvoer naar de bestemming kan door een profiel worden bepaald dat voor of het weggaan van één van drie in kaart gebrachte segmenten in aanmerking komt. Nochtans, in de gegevensuitvoer, in het segmentMembership voorwerp (zie Uitgevoerde Gegevenssectie hieronder), zouden andere niet in kaart gebrachte toehoorders kunnen verschijnen, als dat bepaalde profiel een lid van hen is en als deze het zelfde fusiebeleid zoals het publiek delen dat de uitvoer teweegbracht. Als een profiel voor de Klant met de Auto's van DeLorean maar ook een lid van het Gecontroleerde "Terug naar de Toekomstige" film en de fictiefondsen van de Wetenschap publiek kwalificeert, dan zullen deze andere twee soorten publiek ook in het segmentMembership voorwerp van de gegevensuitvoer aanwezig zijn, alhoewel deze niet in dataflow worden in kaart gebracht, als deze delen fusiebeleid met de Klant met het segment van de AutoAuto's van DeLorean.

Vanuit het oogpunt van profielkenmerken bepalen wijzigingen in de vier bovenstaande kenmerken de doelexport en zijn alle vier toegewezen kenmerken in het profiel aanwezig in de gegevensexport.

Back-up van historische gegevens

Wanneer u een nieuw publiek aan een bestaande bestemming toevoegt, of wanneer u een nieuw doel creeert en een publiek in kaart brengt aan het, exporteert Experience Platform historische publiekskwalificatiegegevens naar de bestemming. Profielen die voor het publiek kwalificeerden alvorens het publiek aan de bestemming werd toegevoegd worden uitgevoerd naar de bestemming binnen ongeveer één uur.

Geëxporteerde gegevens

De geëxporteerde Experience Platform gegevens worden in JSON-indeling in uw Amazon Kinesis -doel geplaatst. Bijvoorbeeld, bevat de hieronder uitvoer een profiel dat voor een bepaald segment heeft gekwalificeerd, een lid van andere twee segmenten is, en een ander segment verliet. Het exporteren bevat ook de voornaam, achternaam, geboortedatum en het persoonlijke e-mailadres van het profielkenmerk. De identiteiten voor dit profiel zijn ECID en e-mail.

{
  "person": {
    "birthDate": "YYYY-MM-DD",
    "name": {
      "firstName": "John",
      "lastName": "Doe"
    }
  },
  "personalEmail": {
    "address": "john.doe@acme.com"
  },
  "segmentMembership": {
   "ups":{
      "7841ba61-23c1-4bb3-a495-00d3g5fe1e93":{
         "lastQualificationTime":"2022-01-11T21:24:39Z",
         "status":"exited"
      },
      "59bd2fkd-3c48-4b18-bf56-4f5c5e6967ae":{
         "lastQualificationTime":"2022-01-02T23:37:33Z",
         "status":"realized"
      },
      "947c1c46-008d-40b0-92ec-3af86eaf41c1":{
         "lastQualificationTime":"2021-08-25T23:37:33Z",
         "status":"realized"
      },
      "5114d758-ce71-43ba-b53e-e2a91d67b67f":{
         "lastQualificationTime":"2022-01-11T23:37:33Z",
         "status":"realized"
      }
   }
},
  "identityMap": {
    "ecid": [
      {
        "id": "14575006536349286404619648085736425115"
      },
      {
        "id": "66478888669296734530114754794777368480"
      }
    ],
    "email_lc_sha256": [
      {
        "id": "655332b5fa2aea4498bf7a290cff017cb4"
      },
      {
        "id": "66baf76ef9de8b42df8903f00e0e3dc0b7"
      }
    ]
  }
}

Hieronder vindt u meer voorbeelden van geëxporteerde gegevens, afhankelijk van de UI-instellingen die u hebt geselecteerd in de doelstroom voor verbinden voor de opties Include Segment Names en Include Segment Timestamps :

In het onderstaande voorbeeld voor het exporteren van gegevens worden publieksnamen opgenomen in de sectie segmentMembership

"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "realized",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
            "name": "First name equals John"
          }
        }
      }

Het onderstaande voorbeeld voor het exporteren van gegevens bevat tijdstempels voor het publiek in de sectie segmentMembership

"segmentMembership": {
        "ups": {
          "5b998cb9-9488-4ec3-8d95-fa8338ced490": {
            "lastQualificationTime": "2019-04-15T02:41:50+0000",
            "status": "realized",
            "createdAt": 1648553325000,
            "updatedAt": 1648553330000,
            "mappingCreatedAt": 1649856570000,
            "mappingUpdatedAt": 1649856570000,
          }
        }
      }

Beperkingen en beleid opnieuw proberen

In 95 percent van de tijd, probeert Experience Platform om een productietolerantie van minder dan 10 minuten voor met succes verzonden berichten met een tarief van minder dan 10.000 verzoeken per seconde voor elke dataflow aan een bestemming van HTTP aan te bieden.

In het geval van mislukte verzoeken aan uw bestemming van HTTP API, slaat Experience Platform de ontbroken verzoeken op en probeert tweemaal om de verzoeken naar uw eindpunt te verzenden.

recommendation-more-help