Forbind Apsis One

Med integrationen til Apsis One bliver alle, der tilmelder sig, oprettet eller opdateret som profil i Apsis One i den sektion, du vælger, og de kan blive tilmeldt et af dine abonnementer i Apsis One.

Det skal du bruge

• En Apsis One-konto og en bruger, der kan administrere API-nøgler (som regel en administrator).
• At vide, om din Apsis One-konto ligger i regionen Europa eller Asien. De fleste konti ligger i Europa.

Trin 1: Opret en API-nøgle i Apsis One

1. Åbn Account settings i Apsis One, og gå til API keys (under integrationer).
2. Klik for at oprette en ny API-nøgle. Giv den et navn, du kan genkende, fx "Scratcher".
3. Giv nøglen adgang til den eller de sektioner, Scratcher skal sende profiler til, med rettighederne nedenfor.
4. Gem, og kopiér Client ID og Client secret. Dit secret bliver kun vist én gang.

Apsis har sin egen trin for trin-guide til det. Den er linket fra Opsætningsguide i installationsdialogen i Scratcher ("To install the integration, follow the guide here").

Rettigheder, nøglen skal have

Scratcher bruger nøglen til at:

• læse dine sektioner og attributterne, abonnementerne (consent topics) og hændelserne i dem, så du kan vælge dem i kampagnen;
• oprette profiler og opdatere deres attributter;
• tilføje samtykker (opt-ins) til profiler;
• tilføje hændelser til profiler.

Nøglen skal altså have læseadgang til sektioner og skriveadgang til profiler, samtykker og hændelser i de sektioner, du bruger. Uden skriveadgang mislykkes leveringerne med Apsis Ones egen fejlmeddelelse.

Trin 2: Forbind Apsis One med Scratcher

1. Gå til Indstillinger > Integrationer i Scratcher, og klik på Apsis One.
2. Vælg API-region: Europa eller Asien.
3. Indsæt Client ID og Client secret.
4. Klik på Installér integration. Scratcher logger ind i Apsis One for at tjekke oplysningerne.

Trin 3: Slå det til i en kampagne

1. Gå til Forbind > Integrationer > Apsis One i editoren, og klik på Aktivér.
2. Har du forbundet mere end én Apsis One-konto, vælger du den under Vælg konto.
3. Under Apsis-sektion vælger du sektionen (Vælg en sektion).
4. Under Felttilknytninger klikker du på Tilføj felttilknytning for hvert felt og matcher Scratcher-felt med attributten i Apsis One i Destinationsfelt. Listen viser attributterne i den sektion, du har valgt, også dine egne.
5. Under Abonnementer (samtykker) vælger du det abonnement, folk skal tilmeldes, eller Ingen. "Vælg et abonnement, som deltageren skal tilmeldes."
6. Under Filtrér efter samtykker (valgfrit) vælger du dit afkrydsningsfelt til samtykke til markedsføring, så kun dem, der har sat flueben, bliver sendt.
7. Klik på Gem og derefter på Test for at sende en testprofil.

Felttilknytning

• E-mailadressen bliver altid sendt og bruges til at genkende profilen. Du behøver ikke at tilknytte den.
• Til telefonnumre bruger du indstillingen Format for at sende nummeret, som din attribut forventer det.
• Ja/nej-attributter får true eller false, så tilknyt et samtykkes Accepteret-felt til en ja/nej-attribut.

Samtykke

Vælger du et abonnement, bliver hver person tilmeldt det med begrundelsen "Subscribed via" og kampagnens navn og kilden "Scratcher". Er personen allerede tilmeldt, ændrer det ingenting. Brug Filtrér efter samtykker, så kun dem, der har sat flueben i dit afkrydsningsfelt til markedsføring, bliver tilmeldt.

Har din sektion Apsis Ones hændelse for samtykkeformularer (consent form), registrerer Scratcher også tilmeldingen som en hændelse på profilen med kampagnens adresse.

Hvad bliver sendt, og hvornår

Nye tilmeldinger bliver sendt inden for et minut eller to. Når du aktiverer integrationen, bliver kampagnens eksisterende leads også sendt. Når nogen deltager igen, bliver deres profil opdateret. Tjek hver levering under Indstillinger > Integrationer > Leveringsstatus; her kan du også se, om profilen var ny eller allerede fandtes. Se Tjek leveringsstatus, og send leads igen.

Fejlfinding

• "Nogle eller alle felterne er ugyldige ..." ved installationen: tjek regionen, og kopiér client ID og secret igen.
• Leveringer mislykkes med en adgangsfejl fra Apsis One: nøglen har ikke adgang til sektionen eller mangler skriverettigheder. Redigér nøglen i Apsis One.
• Abonnementer (samtykker) er tom: sektionen har endnu ingen abonnementer. Opret et i Apsis One, og åbn integrationen igen.