[Beta]{class="badge informative"}

Skapa en Customer.io-källanslutning och ett dataflöde i användargränssnittet

NOTE
Källan Customer.io är i betaversion. Läs källöversikten om du vill ha mer information om hur du använder betatecknade källor.

I den här självstudiekursen beskrivs hur du skapar en Customer.io-källanslutning och ett dataflöde med Adobe Experience Platform-användargränssnittet.

Komma igång getting-started

Den här självstudiekursen kräver en fungerande förståelse av följande komponenter i Experience Platform:

Förhandskrav prerequisites

Följande avsnitt innehåller information om krav som måste slutföras innan du kan skapa en Customer.io-källanslutning.

Exempel-JSON för att definiera källschemat för Customer.io prerequisites-json-schema

Innan du skapar en Customer.io-källanslutning måste du ange ett källschema. Du kan använda JSON nedan.

{
  "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"
    }
  }
}

Skapa ett plattformsschema för Customer.io create-platform-schema

Du måste också se till att du skapar ett plattformsschema som kan användas för källan. I självstudiekursen Skapa ett plattformsschema finns mer information om hur du skapar ett schema.

Skärmbild för plattformsgränssnitt som visar ett exempelschema för Customer.io

Anslut ditt Customer.io-konto connect-account

I plattformsgränssnittet väljer du Sources i den vänstra navigeringen för att komma åt arbetsytan i Sources och visa en katalog med tillgängliga källor i Experience Platform.

Använd menyn Categories för att filtrera källor efter kategori. Du kan också ange ett källnamn i sökfältet för att hitta en viss källa från katalogen.

Gå till kategorin Marketing automation om du vill se källkortet Customer.io. Börja genom att välja Add data.

Skärmbild för plattformsgränssnitt för katalog med Customer.io-kortet

Markera data select-data

Select data-steget visas med ett gränssnitt där du kan välja vilka data du vill hämta till plattformen.

  • Den vänstra delen av gränssnittet är en webbläsare som gör att du kan visa tillgängliga dataströmmar på ditt konto;
  • Med den högra delen av gränssnittet kan du förhandsgranska upp till 100 rader data från en JSON-fil.

Välj Upload files om du vill överföra en JSON-fil från det lokala systemet. Du kan också dra och släppa den JSON-fil som du vill överföra till panelen Drag and drop files.

Stegen för att lägga till data i källarbetsflödet.

När filen har överförts uppdateras förhandsvisningsgränssnittet för att visa en förhandsgranskning av schemat som du har överfört. I förhandsvisningsgränssnittet kan du inspektera innehållet och strukturen i en fil. Du kan också använda verktyget Search field för att komma åt specifika objekt från schemat.

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

Förhandsgranskningssteget för källarbetsflödet.

Dataflödesdetaljer dataflow-detail

Dataflödesdetaljsteget visas. Här finns alternativ för att använda en befintlig datauppsättning eller skapa en ny datauppsättning för dataflödet, samt en möjlighet att ange ett namn och en beskrivning för dataflödet. Under det här steget kan du även konfigurera inställningar för profilinmatning, feldiagnostik, partiell inmatning och aviseringar.

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

Dataflödesdetaljsteget i källarbetsflödet.

Mappning mapping

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.

Plattformen ger intelligenta rekommendationer för automatiskt mappade fält baserat på det målschema eller den datamängd du 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.

Alla mappningar som anges nedan är obligatoriska och bör konfigureras innan du fortsätter till Review-steget.

Målfält
Beskrivning
object_type
Objekttypen finns i Customer.io events -dokumentationen för de typer som stöds.
id
Objektets identifierare.
email
E-postadressen som är associerad med objektet.
event_id
Händelsens unika identifierare.
cio_id
Identifieraren Customer.io för händelsen.
metric
Händelsetypen. Mer information finns i dokumentationen för Customer.io events om vilka typer som stöds.
timestamp
Tidsstämpeln när händelsen inträffade.
IMPORTANT
Mappa inte cio_id när Customer.io-webkrok körs i test mode eftersom inga associerade fält skickas från Customer.io.

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

Mappningssteget för källarbetsflödet.

Granska review

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

  • Connection: Visar källtypen, den relevanta sökvägen för den valda källfilen och mängden kolumner i källfilen.
  • Assign dataset & map fields: Visar vilka data som källdata hämtas till, inklusive det schema som datauppsättningen följer.

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.

Hämta din URL för direktuppspelningsslutpunkt get-streaming-endpoint

När du har skapat ett dataflöde för direktuppspelning kan du nu hämta URL:en för din slutpunkt för direktuppspelning. Den här slutpunkten används för att prenumerera på din webkrok, vilket gör att strömningskällan kan kommunicera med Experience Platform.

För att kunna skapa den URL som används för att konfigurera webkroken på Customer.io måste du hämta följande:

  • Dataflow ID
  • Streaming endpoint

Om du vill hämta Dataflow ID och Streaming endpoint går du till sidan Dataflow activity i det dataflöde som du just skapade och kopierar informationen längst ned på panelen Properties.

Slutpunkten för direktuppspelning i dataflödesaktivitet.

När du har hämtat ditt ID för direktuppspelningsslutpunkt och dataflöde ska du skapa en URL som baseras på följande mönster: {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}. En webbkrok-URL kan till exempel se ut så här: https://dcs.adobedc.net/collection/febc116d22ba0ea2868e9c93b199375302afb8a589617700991bb8f3f0341ad7?x-adobe-flow-id=439b3fc4-3042-4a3a-b5e0-a494898d3fb0

Konfigurera webkrok för rapportering i Customer.io set-up-webhook

När webkrok-URL:en har skapats kan du nu konfigurera din rapportwebkrok med användargränssnittet Customer.io. Anvisningar om hur du konfigurerar webbhooks för rapportering finns i Customer.io guiden om hur du konfigurerar webbhooks.

I användargränssnittet för Customer.io anger du din webkrok-URL i fältet WEBHOOK ENDPOINT.

Användargränssnittet Customer.io som visar webkrok-slutpunktsfältet

TIP
Du kan prenumerera på en mängd olika händelser för din rapportwebkrok. Varje händelsemeddelande hämtas till plattformen när ett Customer.io-utlösarvillkor för en åtgärdshändelse uppfylls. Mer information om de olika händelserna finns i Customer.io händelsedokumentationen.

Nästa steg next-steps

Genom att följa den här självstudiekursen har du konfigurerat ett dataflöde för direktuppspelning så att dina Customer.io-data kommer till Experience Platform. Om du vill övervaka data som importeras läser du i guiden Övervaka direktuppspelade dataflöden med hjälp av plattformsgränssnittet.

Ytterligare resurser additional-resources

Avsnitten nedan innehåller ytterligare resurser som du kan referera till när du använder källan Customer.io.

Guardrails guardrails

Mer information om skyddsutkast finns på sidan Customer.io Timeout and errors.

Validering validation

Följ stegen nedan för att verifiera att du har konfigurerat källan och att Customer.io meddelanden importeras korrekt:

  • Du kan kontrollera sidan Customer.io Activity Logs för att identifiera de händelser som spelas in av Customer.io.

Kund.io Skärmbild av användargränssnittet som visar aktivitetsloggar

  • I plattformsgränssnittet väljer du View Dataflows bredvid kortmenyn Customer.io i källkatalogen. Välj sedan Preview dataset för att verifiera data som har importerats för händelser som du har valt i Customer.io.

Skärmbild för plattformsgränssnitt som visar kapslade händelser

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