[Beta]{class="badge informative"}
Een Customer.io bronverbinding en gegevensstroom maken in de gebruikersinterface
Deze zelfstudie bevat stappen voor het maken van een Customer.io bronverbinding en gegevensstroom via de Adobe Experience Platform-gebruikersinterface.
Aan de slag getting-started
Deze zelfstudie vereist een goed begrip van de volgende onderdelen van het Experience Platform:
-
Experience Data Model (XDM) Systeem: Het gestandaardiseerde kader waardoor Experience Platform gegevens van de klantenervaring organiseert.
- Grondbeginselen van schemacompositie: Leer over de basisbouwstenen van schema's XDM, met inbegrip van zeer belangrijke principes en beste praktijken in schemacompositie.
- het leerprogramma van de Redacteur van het Schema: Leer hoe te om douaneschema's tot stand te brengen gebruikend de Redacteur UI van het Schema.
-
Real-Time Customer Profile: biedt een uniform, real-time consumentenprofiel dat is gebaseerd op geaggregeerde gegevens van meerdere bronnen.
Vereisten prerequisites
In de volgende sectie vindt u informatie over voorwaarden die moeten worden voltooid voordat u een Customer.io bronverbinding kunt maken.
Voorbeeld-JSON om het bronschema voor Customer.io te definiëren prerequisites-json-schema
Voordat u een Customer.io -bronverbinding maakt, moet u een bronschema opgeven. U kunt de onderstaande JSON gebruiken.
{
"event_id": "01E4C4CT6YDC7Y5M7FE1GWWPQJ",
"object_type": "customer",
"metric": "subscribed",
"timestamp": 1613063089,
"data": {
"customer_id": "42",
"email_address": "test@example.com",
"identifiers": {
"id": "42",
"email": "test@example.com",
"cio_id": "d9c106000001"
}
}
}
Een platformschema maken voor Customer.io create-platform-schema
U moet ook ervoor zorgen dat u een schema van het Platform voor uw bron creeert te gebruiken. Zie het leerprogramma op creërend een schema van het Platformvoor uitvoerige stappen op hoe te om een schema tot stand te brengen.
{het schermschot van het platform UI die een voorbeeldschema voor Customer.io toont
Sluit uw Customer.io -account aan connect-account
Selecteer in de gebruikersinterface van het platform Sources in de linkernavigatie voor toegang tot de werkruimte van Sources en bekijk een catalogus met bronnen die beschikbaar zijn in het Experience Platform.
Gebruik het menu Categories om bronnen op categorie te filteren. U kunt ook een bronnaam invoeren in de zoekbalk om een specifieke bron uit de catalogus te zoeken.
Ga naar de categorie Marketing automation om de Customer.io bronkaart te zien. Selecteer eerst Add data .
{het schermschot van het platform UI voor catalogus met kaart Customer.io
Gegevens selecteren select-data
De stap Select data wordt weergegeven en biedt een interface waarmee u de gegevens kunt selecteren die u naar Platform wilt verzenden.
- Het linkergedeelte van de interface is een browser waarmee u de beschikbare gegevensstromen binnen uw account kunt bekijken.
- In het rechtergedeelte van de interface kunt u maximaal 100 rijen gegevens uit een JSON-bestand voorvertonen.
Selecteer Upload files om een JSON-bestand van uw lokale systeem te uploaden. U kunt ook het JSON-bestand dat u wilt uploaden naar het deelvenster Drag and drop files slepen.
Nadat het bestand is geüpload, wordt de voorbeeldinterface bijgewerkt en wordt een voorvertoning weergegeven van het schema dat u hebt geüpload. Met de voorvertoningsinterface kunt u de inhoud en structuur van een bestand controleren. U kunt het hulpprogramma Search field ook gebruiken om toegang te krijgen tot specifieke items binnen uw schema.
Selecteer Next als u klaar bent.
Gegevens dataflow-detail
De Dataflow detailstap verschijnt, die u van opties voorzien om een bestaande dataset te gebruiken of een nieuwe dataset voor uw dataflow te vestigen, evenals een kans om een naam en een beschrijving voor uw dataflow te verstrekken. Tijdens deze stap kunt u ook instellingen configureren voor het opnemen van profielen, foutdiagnose, gedeeltelijke inname en waarschuwingen.
Selecteer Next als u klaar bent.
Toewijzing mapping
De stap Mapping verschijnt, die u van een interface voorziet om de brongebieden van uw bronschema aan hun aangewezen doelXDM gebieden in het doelschema in kaart te brengen.
Platform biedt intelligente aanbevelingen voor automatisch toegewezen velden op basis van het doelschema of de gegevensset die u hebt geselecteerd. U kunt toewijzingsregels handmatig aanpassen aan uw gebruiksgevallen. Op basis van uw behoeften kunt u ervoor kiezen om velden rechtstreeks toe te wijzen of gegevens prep-functies te gebruiken om brongegevens om berekende of berekende waarden af te leiden. Voor uitvoerige stappen bij het gebruiken van de kaartperinterface en berekende gebieden, zie de gids UI van de Prep van Gegevens.
Alle onderstaande toewijzingen zijn verplicht en moeten worden ingesteld voordat u naar het Review -werkgebied gaat.
object_type
id
email
event_id
cio_id
metric
timestamp
cio_id
niet toe bij het uitvoeren van Customer.io webhaak in de test mode
omdat er geen gekoppelde velden worden verzonden vanuit Customer.io .Selecteer Next wanneer de brongegevens correct zijn toegewezen.
Controleren review
De stap Review wordt weergegeven, zodat u de nieuwe gegevensstroom kunt bekijken voordat deze wordt gemaakt. De details worden gegroepeerd in de volgende categorieën:
- Connection: geeft het brontype, het relevante pad van het gekozen bronbestand en de hoeveelheid kolommen in dat bronbestand weer.
- Assign dataset & map fields: Toont welke dataset de brongegevens worden opgenomen in, met inbegrip van het schema dat de dataset volgt aan.
Nadat u de gegevensstroom hebt gereviseerd, selecteert u Finish en laat u enige tijd over om de gegevensstroom te maken.
Uw URL voor het streamingeindpunt ophalen get-streaming-endpoint
Wanneer uw streaminggegevens zijn gemaakt, kunt u nu de URL van het streamingeindpunt ophalen. Dit eindpunt zal worden gebruikt om aan uw webhaak in te tekenen, toestaand uw het stromen bron om met Experience Platform te communiceren.
Als u de URL wilt maken die wordt gebruikt om de webhaak op Customer.io te configureren, moet u het volgende ophalen:
- Dataflow ID
- Streaming endpoint
Als u de gegevens Dataflow ID en Streaming endpoint wilt ophalen, gaat u naar de Dataflow activity pagina van de gegevensstroom die u net hebt gemaakt en kopieert u de gegevens onder aan het deelvenster Properties .
Wanneer u het streamingeindpunt en de dataflow-id hebt opgehaald, maakt u een URL op basis van het volgende patroon: {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}
. Een geconstrueerde URL voor een webhaak ziet er bijvoorbeeld als volgt uit: https://dcs.adobedc.net/collection/febc116d22ba0ea2868e9c93b199375302afb8a589617700991bb8f3f0341ad7?x-adobe-flow-id=439b3fc4-3042-4a3a-b5e0-a494898d3fb0
Rapportwebhaak instellen in Customer.io set-up-webhook
Als de URL van uw webhaak is gemaakt, kunt u nu de rapportwebhaak instellen via de gebruikersinterface van Customer.io . Voor stappen bij vestiging die webhooks melden, te lezen gelieve de Customer.io gidsbij vestiging webhooks.
In het Customer.io gebruikersinterface, input uw webhaak URLop het WEBHOOK ENDPOINT gebied.
toont
Volgende stappen next-steps
Aan de hand van deze zelfstudie hebt u een streaminggegevensstroom geconfigureerd om uw Customer.io -gegevens naar het Experience Platform te brengen. Om de gegevens te controleren die worden opgenomen, verwijs naar de gids bij controle die dataflows gebruikend Platform UIstromen.
Aanvullende bronnen additional-resources
De onderstaande secties bevatten aanvullende bronnen waarnaar u kunt verwijzen wanneer u de Customer.io -bron gebruikt.
Guardrails guardrails
Voor informatie over gidsen, gelieve te verwijzen naar de Customer.io onderbrekingen en mislukkingspagina.
Validatie validation
Voer de onderstaande stappen uit om te controleren of u de bron juist hebt ingesteld en of Customer.io -berichten worden ingevoerd:
- U kunt de pagina Customer.io Activity Logs controleren om de gebeurtenissen te identificeren die door Customer.io worden vastgelegd.
{het schermschot van 0} Customer.io die activiteitenlogboeken tonen
- Selecteer in de interface Platform de optie View Dataflows naast het kaartmenu Customer.io in de catalogus met bronnen. Selecteer vervolgens Preview dataset om de gegevens te verifiëren die zijn ingevoerd voor de gebeurtenissen die u in Customer.io hebt geselecteerd.
{het schermschot van het platform UI die ingebedde gebeurtenissen tonen