[Beta]{class="badge informative"}

Testa och skicka källan

NOTE
Självbetjäning Källströmning SDK är en betaversion. Läs källöversikten om du vill ha mer information om hur du använder betatecknade källor.

De sista stegen för att integrera din nya källa till Adobe Experience Platform med självbetjäningskällor (Streaming SDK) är att testa och skicka den nya källan. När du har slutfört anslutningsspecifikationen och uppdaterat specifikationen för direktuppspelningsflödet kan du börja testa källans funktionalitet antingen via API:t eller gränssnittet. När det är klart kan du sedan skicka in din nya källfil genom att kontakta Adobe.

Följande dokument innehåller steg om hur du testar och felsöker källan med Flow Service API.

Komma igång

Testa källan med API:t

Om du vill testa källan med API:t måste du köra verifieringssamlingen och miljön 🔗 för Postman-källor med självbetjäning, samtidigt som du anger lämpliga miljövariabler som hör till källan.

Om du vill börja testa måste du först konfigurera samlingen och miljön på Postman. Ange sedan det ID för anslutningsspecifikationen som du vill testa.

NOTE
Alla exempelvariabler nedan är platshållarvärden som du måste uppdatera, förutom för flowSpecificationId och targetConnectionSpecId, som är fasta värden.
Parameter
Beskrivning
Exempel
x-api-key
En unik identifierare som används för att autentisera anrop till Experience Platform API:er. I självstudiekursen om autentisering och åtkomst av Experience Platform API:er finns mer information om hur du hämtar din x-api-key.
c8d9a2f5c1e03789bd22e8efdd1bdc1b
x-gw-ims-org-id
En företagsenhet som kan äga eller licensiera produkter och tjänster och ge åtkomst till sina medlemmar. Se självstudiekursen Konfigurera utvecklarkonsolen och Postman för instruktioner om hur du hämtar din x-gw-ims-org-id-information.
ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
authorizationToken
Den auktoriseringstoken som krävs för att slutföra anrop till Experience Platform API:er. I självstudiekursen om autentisering och åtkomst av Experience Platform API:er finns mer information om hur du hämtar din authorizationToken.
Bearer authorizationToken
schemaId
För att källdata ska kunna användas i Experience Platform måste ett målschema skapas för att strukturera källdata efter dina behov. Detaljerade steg om hur du skapar ett mål-XDM-schema finns i självstudiekursen Skapa ett schema med API:t.
https://ns.adobe.com/{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
schemaVersion
Den unika version som motsvarar ditt schema.
application/vnd.adobe.xed-full-notext+json; version=1
schemaAltId
meta:altId som returneras tillsammans med schemaId när ett nytt schema skapas.
_{TENANT_ID}.schemas.0ef4ce0d390f0809fad490802f53d30b
dataSetId
Detaljerade steg om hur du skapar en måldatauppsättning finns i självstudiekursen Skapa en datauppsättning med API:t.
5f3c3cedb2805c194ff0b69a
mappings
Mappningsuppsättningar kan användas för att definiera hur data i ett källschema mappas till data i ett målschema. Detaljerade anvisningar om hur du skapar en mappning finns i självstudiekursen om hur du skapar en mappningsuppsättning med API:t.
[{"destinationXdmPath":"person.name.firstName","sourceAttribute":"email.email_id","identity":false,"version":0},{"destinationXdmPath":"person.name.lastName","sourceAttribute":"email.activity.action","identity":false,"version":0}]
mappingId
Det unika ID som motsvarar din mappningsuppsättning.
bf5286a9c1ad4266baca76ba3adc9366
connectionSpecId
Anslutningsspecifikations-ID som motsvarar källan. Detta är det ID som du genererade efter att du har skapat en ny anslutningsspecifikation.
2e8580db-6489-4726-96de-e33f5f60295f
flowSpecificationId
Flödesspecifikation-ID för GenericStreamingAEP. Det här är ett fast värde.
e77fde5a-22a8-11ed-861d-0242ac120002
targetConnectionSpecId
Målanslutnings-ID för den datasjön där inmatade data landar. Det här är ett fast värde.
c604ff05-7f1a-43c0-8e18-33bf874cb11c
verifyWatTimeInSecond
Det angivna tidsintervallet som ska följas när en flödeskörning slutförs.
40
startTime
Starttiden för dataflödet. Starttiden måste formateras i unix-tid.
1597784298

När du har angett alla dina miljövariabler kan du börja köra samlingen med gränssnittet Postman. I gränssnittet Postman markerar du ellipserna () bredvid Sources SSSs Verification Collection och väljer sedan Kör samlingen.

runner

Gränssnittet Runner visas så att du kan konfigurera körningsordningen för dataflödet. Välj Kör SSS-verifieringssamling för att köra samlingen.

NOTE
Du kan inaktivera Ta bort flöde från checklistan för körningsordning om du föredrar att använda kontrollpanelen för källövervakning i Experience Platform-gränssnittet. När du är klar med testningen måste du dock se till att testflödena tas bort.

run-collection

Testa källan med användargränssnittet

Om du vill testa källan i användargränssnittet går du till källkatalogen i organisationens sandlåda i Experience Platform-användargränssnittet. Här ser du att din nya källa visas under kategorin Direktuppspelning.

När din nya källa nu är tillgänglig i din sandlåda måste du följa arbetsflödet för källor för att testa funktionerna. Börja genom att välja Set up.

Källkatalogen som visar den nya direktuppspelningskällan.

Add data-steget visas. Om du vill testa att källan kan direktuppspela data använder du den vänstra sidan av gränssnittet för att överföra ett exempel på JSON-data. När data har överförts uppdateras den högra sidan av gränssnittet till en förhandsgranskning av datahierarkin. Välj Next om du vill fortsätta.

Stegen för att lägga till data i källarbetsflödet där du kan överföra och förhandsgranska dina data innan de hämtas.

På sidan Dataflow detail kan du välja om du vill använda en befintlig datauppsättning eller en ny datauppsättning. Under den här processen kan du även konfigurera dina data så att de hämtas till profilen och aktivera inställningar som Error diagnostics och Partial ingestion.

Om du vill testa väljer du New dataset och anger ett namn på utdatauppsättningen. Under det här steget kan du även ange en valfri beskrivning för att lägga till ytterligare information till datauppsättningen. Välj sedan ett schema att mappa till med alternativet Advanced search eller genom att bläddra igenom listan med befintliga scheman i listrutan. När du har valt ett schema anger du ett namn och en beskrivning för dataflödet.

När du är klar väljer du Next.

Dataflödets detaljsteg i källarbetsflödet.

Steg Mapping visas, och du får ett gränssnitt för att mappa källfälten från källschemat till rätt mål-XDM-fält i målschemat.

Experience Platform ger intelligenta rekommendationer för automatiskt mappade fält baserat på det målschema eller den datamängd som du har valt. Du kan justera mappningsreglerna manuellt så att de passar dina användningsfall. Beroende på dina behov kan du välja att mappa fält direkt eller använda förinställningsfunktioner för data för att omvandla källdata för att härleda beräknade eller beräknade värden. Mer information om hur du använder mappningsgränssnittet och beräkningsfälten finns i Användargränssnittshandboken för dataförinställningar

När källdata har mappats väljer du Next.

Mappningssteget för källarbetsflödet.

Steg Review visas, så att du kan granska det nya dataflödet innan det skapas. Informationen är grupperad i följande kategorier:

  • Connection: Visar ditt kontonamn, typ av källa och annan information som är specifik för den strömmande molnlagringskällan som du använder.
  • Assign dataset and map fields: Visar måldatauppsättningen och målschemat som du använder för dataflödet.

När du har granskat dataflödet väljer du Finish och tillåt en tid innan dataflödet skapas.

Granskningssteget för källarbetsflödet.

Slutligen måste du hämta dataflödets slutpunkt för direktuppspelning. Den här slutpunkten kommer att användas för att prenumerera på din webkrok så att strömningskällan kan kommunicera med Experience Platform. Om du vill hämta strömningsslutpunkten går du till sidan Dataflow activity i det dataflöde som du just skapade och kopierar slutpunkten längst ned på panelen Properties.

Slutpunkten för direktuppspelning i dataflödesaktivitet.

Skicka din källa

När källan är klar med hela arbetsflödet kan du kontakta Adobe och skicka in din källfil för integrering mellan andra Experience Platform-organisationer.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089