Handleiding voor het oplossen van problemen bij het streamen

In dit document worden antwoorden gegeven op veelgestelde vragen over het streamen van opname op Adobe Experience Platform. Voor vragen en problemen met betrekking tot andere Platform services, inclusief services die overal worden aangetroffen Platform API's, raadpleeg de Handleiding voor het oplossen van problemen met Experience Platforms.

Adobe Experience Platform Data Ingestion biedt RESTful-API's die u kunt gebruiken om gegevens in te voeren Experience Platform. De opgenomen gegevens worden gebruikt om individuele klantenprofielen in bijna real time bij te werken, toestaand u om gepersonaliseerde, relevante ervaringen over veelvoudige kanalen te leveren. Lees de Overzicht van gegevensinname voor meer informatie over de dienst en de verschillende innamemethoden. Voor stappen over het gebruik van streaming opname-API's leest u de overzicht van het opnemen van streaming.

Veelgestelde vragen

Hieronder volgt een lijst met antwoorden op veelgestelde vragen over streaming opname.

Hoe weet ik dat de lading die ik verzend correct geformatteerd is?

Data Ingestion hefboomwerkingen Experience Data Model (XDM) schema's om het formaat van inkomende gegevens te bevestigen. Het verzenden van gegevens die niet in overeenstemming zijn met de structuur van een vooraf gedefinieerd XDM-schema zal ertoe leiden dat de invoer mislukt. Voor meer informatie over XDM en het gebruik ervan in Experience Platform, zie de XDM System, overzicht.

Streaming opname ondersteunt twee validatiemodi: synchroon en asynchroon. Elke validatiemethode verwerkt mislukte gegevens anders.

Synchrone validatie moet worden gebruikt tijdens uw ontwikkelingsproces. Records die niet kunnen worden gevalideerd, worden verwijderd en er wordt een foutbericht geretourneerd met betrekking tot de vraag waarom deze zijn mislukt (bijvoorbeeld: "Ongeldige XDM Message Format").

Asynchrone validatie worden gebruikt bij de productie. Eventuele beschadigde gegevens die geen validatie doorstaan, worden verzonden naar de Data Lake als een mislukt batchbestand, waar het later kan worden opgehaald voor verdere analyse.

Raadpleeg voor meer informatie over synchrone en asynchrone validatie de overzicht van streamingvalidatie. Raadpleeg de handleiding voor informatie over hoe u batches die niet zijn gevalideerd kunt bekijken. ophalen van mislukte batches.

Kan ik een aanvraaglading bevestigen alvorens het te verzenden naar Platform?

De lading van het verzoek kan slechts worden geëvalueerd nadat zij zijn verzonden naar Platform. Bij het uitvoeren van synchrone validatie retourneert een geldige payload gevulde JSON-objecten terwijl een ongeldige payload foutberichten retourneert. Tijdens asynchrone bevestiging, ontdekt de dienst en verzendt om het even welke misvormde gegevens naar Data Lake waar het later voor analyse kan worden opgehaald. Zie de overzicht van streamingvalidatie voor meer informatie .

Wat gebeurt er als synchrone validatie wordt aangevraagd voor een rand die deze niet ondersteunt?

Wanneer synchrone validatie niet wordt ondersteund voor de aangevraagde locatie, wordt een 501-foutreactie geretourneerd. Zie de overzicht van streamingvalidatie voor meer informatie over synchrone validatie.

Hoe kan ik ervoor zorgen dat gegevens alleen worden verzameld van vertrouwde bronnen?

Experience Platform ondersteunt beveiligde gegevensverzameling. Wanneer de voor authentiek verklaarde gegevensinzameling wordt toegelaten, moeten de cliënten een Token van het Web JSON (JWT) en hun organisatie-identiteitskaart als verzoekkopballen verzenden. Voor meer informatie over hoe te om voor authentiek verklaarde gegevens te verzenden naar Platform, raadpleeg de handleiding op geverifieerde gegevensverzameling.

Wat is de latentie voor het stromen gegevens aan Real-Time Customer Profile?

Gestroomde gebeurtenissen worden over het algemeen weerspiegeld in Real-Time Customer Profile in minder dan 60 seconden. De daadwerkelijke latentie kan door gegevensvolume, berichtgrootte, en bandbreedtebeperkingen variëren.

Kan ik meerdere berichten opnemen in dezelfde API-aanvraag?

U kunt veelvoudige berichten binnen één enkele verzoeklading groeperen en hen stromen aan Platform. Als de gegevens correct worden gebruikt, is het groeperen van meerdere berichten binnen één aanvraag een uitstekende manier om uw gegevensbewerkingen te optimaliseren. Lees de zelfstudie op het verzenden van veelvoudige berichten in een verzoek voor meer informatie .

Hoe weet ik of de gegevens die ik verstuur, worden ontvangen?

Alle gegevens waarnaar wordt verzonden Platform (met succes of anders) wordt opgeslagen als partijdossiers alvorens in datasets wordt voortgeduurd. De verwerkingsstatus van batches wordt weergegeven in de gegevensset waarnaar ze zijn verzonden.

U kunt verifiëren of de gegevens met succes zijn opgenomen door datasetactiviteit te controleren gebruikend Gebruikersinterface Experience Platform. Klikken Datasets in de linkernavigatie om een lijst van datasets te tonen. Selecteer de dataset u aan van de getoonde lijst stroomt om zijn te openen Dataset activity pagina, met daarin alle batches die tijdens een geselecteerde tijdsperiode zijn verzonden. Voor meer informatie over het gebruik Experience Platform om gegevensstromen te controleren, zie de gids op streaming gegevensstromen controleren.

Als uw gegevens niet zijn ingevoerd en u wilt deze herstellen van Platform, kunt u de mislukte batches ophalen door hun id's naar de Data Access API. Zie de handleiding op ophalen van mislukte batches voor meer informatie .

Waarom zijn mijn streaminggegevens niet beschikbaar in het Data Lake?

Er zijn diverse redenen waarom het niet mogelijk is dat de ingestie van de partij de Data Lake, zoals ongeldige opmaak, ontbrekende gegevens of systeemfouten. Om te bepalen waarom de batch is mislukt, moet u de batch ophalen met de Data Ingestion Service API en bekijk de details. Zie de handleiding voor gedetailleerde stappen voor het ophalen van een mislukte batch ophalen van mislukte batches.

Hoe parseer ik de reactie die voor het API verzoek is teruggekeerd?

U kunt een reactie parseren door eerst de antwoordcode van de server te controleren om te bepalen of uw verzoek werd goedgekeurd. Als een geslaagde antwoordcode wordt geretourneerd, kunt u vervolgens de responses matrixobject om de status van de ingangstaak te bepalen.

Een geslaagde API-aanvraag voor één bericht retourneert statuscode 200. Een geslaagde (of gedeeltelijk succesvolle) API-aanvraag voor berichten in batches retourneert statuscode 207.

De volgende JSON is een voorbeeld van een reactieobject voor een API-aanvraag met twee berichten: één succesvol en één mislukt. Berichten die succesvol streamen retourneren een xactionId eigenschap. Berichten die er niet in slagen om een stream te retourneren statusCode eigenschap en een reactie message met meer informatie.

{
    "inletId": "9b0cb233972f3b0092992284c7353f5eead496218e8441a79b25e9421ea127f5",
    "batchId": "1565638336649:1750:244",
    "receivedTimeMs": 1565638336705,
    "responses": [
        {
            "xactionId": "1565650704337:2124:92:3"
        },
        {
            "statusCode": 400,
            "message": "inletId: [9b0cb233972f3b0092992284c7353f5eead496218e8441a
                79b25e9421ea127f5]
                imsOrgId: [{ORG_ID}]
                Message has unknown xdm format"
        }
    ]
}

Waarom worden mijn verzonden berichten niet ontvangen door Real-Time Customer Profile?

Indien Real-Time Customer Profile Hiermee wordt een bericht afgewezen. Dit is vooral te wijten aan onjuiste identiteitsgegevens. Dit kan het resultaat zijn van het opgeven van een ongeldige waarde of naamruimte voor een identiteit.

Er zijn twee typen naamruimten: standaard en aangepast. Wanneer u aangepaste naamruimten gebruikt, moet u ervoor zorgen dat de naamruimte is geregistreerd binnen Identity Service. Zie de Overzicht van naamruimte in identiteit voor meer informatie over het gebruik van standaard- en aangepaste naamruimten.

U kunt de Experience Platform UI om meer informatie te zien over waarom een bericht ontbrak het opnemen. Klikken Monitoring in de linkernavigatie, dan bekijk Streaming end-to-end om berichtenbatches te bekijken die tijdens een geselecteerde tijdsperiode zijn gestreamd.