Med integrationen för Apsis One skapas eller uppdateras alla som registrerar sig som en profil i Apsis One, i den sektion du väljer, och de kan anmälas till en av dina prenumerationer i Apsis One.
Det här behöver du
- Ett Apsis One-konto och en användare som kan hantera API-nycklar (oftast en administratör).
- Att du vet om ditt Apsis One-konto ligger i regionen Europa eller Asien. De flesta konton ligger i Europa.
Steg 1: Skapa en API-nyckel i Apsis One
- Öppna Account settings i Apsis One och gå till API keys (under integrationer).
- Klicka för att skapa en ny API-nyckel. Ge den ett namn som du känner igen, till exempel "Scratcher".
- Ge nyckeln åtkomst till den eller de sektioner som Scratcher ska skicka profiler till, med behörigheterna nedan.
- Spara och kopiera Client ID och Client secret. Din secret visas bara en gång.
Apsis har en egen steg-för-steg-guide för det här. Den är länkad från Installationsguide i installationsdialogen i Scratcher ("Följ guiden här för att installera integrationen").
Behörigheter som nyckeln behöver
Scratcher använder nyckeln för att:
- läsa dina sektioner och deras attribut, prenumerationer (samtyckesämnen) och händelser, så att du kan välja dem i kampanjen;
- skapa profiler och uppdatera deras attribut;
- lägga till samtycken (opt-ins) på profiler;
- lägga till händelser på profiler.
Nyckeln behöver alltså läsåtkomst till sektioner och skrivåtkomst till profiler, samtycken och händelser i de sektioner du använder. Utan skrivåtkomst misslyckas leveranserna med Apsis Ones eget felmeddelande.
Steg 2: Anslut Apsis One till Scratcher
- Gå till Inställningar > Integrationer i Scratcher och klicka på Apsis One.
- Välj API-region: Europa eller Asien.
- Klistra in Klient-ID och Klienthemlighet.
- Klicka på Installera integration. Scratcher loggar in i Apsis One för att kontrollera uppgifterna.
Steg 3: Slå på den i en kampanj
- I redigeraren går du till Anslut > Integrationer > Apsis One och klickar på Aktivera.
- Om du har anslutit mer än ett Apsis One-konto väljer du det under Välj konto.
- Under Apsis-sektion väljer du sektionen (Välj en sektion).
- Under Fältmappningar klickar du på Lägg till fältmappning för varje fält och matchar Scratcher-fält med attributet i Apsis One under Målfält. Listan visar attributen i den sektion du valde, även dina egna.
- Under Prenumerationer (samtycken) väljer du den prenumeration som personerna ska anmälas till, eller Ingen. "Välj den prenumeration som deltagaren ska anmälas till."
- Under Filtrera på samtycken (valfritt) väljer du din kryssruta för marknadsföringssamtycke, så att bara personer som har kryssat i den skickas.
- Klicka på Spara och sedan på Testa för att skicka en testprofil.
Fältmappning
- E-postadressen skickas alltid och används för att identifiera profilen. Du behöver inte mappa den.
- För telefonnummer använder du inställningen Format för att skicka numret så som ditt attribut förväntar sig.
- Ja/nej-attribut får true eller false, så mappa ett samtyckes fält Accepterad till ett ja/nej-attribut.
Samtycke
Om du väljer en prenumeration anmäls varje person till den med orsaken "Subscribed via" och kampanjens namn, och källan "Scratcher". Om personen redan är anmäld ändras ingenting. Använd Filtrera på samtycken så att bara personer som har kryssat i din kryssruta för marknadsföring anmäls.
Om din sektion har Apsis Ones händelse för samtyckesformulär registrerar Scratcher också registreringen som en händelse på profilen, med kampanjens adress.
Vad som skickas och när
Nya registreringar skickas inom en minut eller två. När du aktiverar integrationen skickas även kampanjens befintliga leads. När någon deltar igen uppdateras deras profil. Kontrollera varje leverans under Inställningar > Integrationer > Leveransstatus; där ser du också om profilen var ny eller redan fanns. Läs mer i Kontrollera leveransstatus och skicka leads igen.
Felsökning
- "Några eller alla fält är ogiltiga …" vid installationen: kontrollera regionen och kopiera klient-ID och klienthemlighet igen.
- Leveranser misslyckas med ett åtkomstfel från Apsis One: nyckeln har inte åtkomst till sektionen eller saknar skrivbehörighet. Redigera nyckeln i Apsis One.
- Prenumerationer (samtycken) är tom: sektionen har inga prenumerationer än. Skapa en i Apsis One och öppna integrationen igen.