[Beta]{class="badge informative"}

Een Customer.io bronverbinding en gegevensstroom maken in de gebruikersinterface

NOTE
De bron Customer.io is in bèta. Gelieve te lezen het overzicht van bronnenvoor meer informatie bij het gebruiken van bèta-geëtiketteerde bronnen.

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:

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.

voegt gegevensstap van het bronwerkschema toe.

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.

de voorproefstap van het bronwerkschema.

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.

dataflow-detail stap van het bronwerkschema.

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.

Doelveld
Beschrijving
object_type
Het objecten type, verwijs naar de Customer.io gebeurtenissendocumentatie voor de gesteunde types.
id
De id van het object.
email
Het e-mailadres dat aan het object is gekoppeld.
event_id
De unieke id van de gebeurtenis.
cio_id
De Customer.io -id voor de gebeurtenis.
metric
Het gebeurtenistype. Voor meer informatie, verwijs naar de Customer.io gebeurtenissendocumentatie voor gesteunde types.
timestamp
De tijdstempel wanneer de gebeurtenis heeft plaatsgevonden.
IMPORTANT
Wijs 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.

de afbeeldingsstap van het bronwerkschema.

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.

de overzichtsstap van het bronwerkschema.

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 .

het stromen eindpunt in dataflow activiteit.

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.

Het gebruikersinterface Customer.io die het WebHaak eindpuntgebied toont

TIP
U kunt zich abonneren op verschillende gebeurtenissen voor uw rapporterende webhaak. Het bericht van elke gebeurtenis wordt aan Platform getypt wanneer aan de triggercriteria voor een Customer.io -actiegebeurtenis wordt voldaan. Voor meer informatie over de verschillende gebeurtenissen, gelieve te verwijzen naar de Customer.io gebeurtenisdocumentatie.

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

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