Az Apsis One integrációval mindenki, aki regisztrál, profilként jön létre vagy frissül az Apsis One-ban, az Ön által kiválasztott szekcióban, és fel is iratkoztatható valamelyik Apsis One-feliratkozására.
Amire szüksége lesz
- Egy Apsis One-fiók, valamint egy felhasználó, aki kezelheti az API-kulcsokat (általában egy adminisztrátor).
- Tudnia kell, hogy Apsis One-fiókja az Europe vagy az Asia régióban van-e. A legtöbb fiók Európában található.
1. lépés: API-kulcs létrehozása az Apsis One-ban
- Az Apsis One-ban nyissa meg az Account settings menüt, és lépjen az API keys részre (az integrációk alatt).
- Hozzon létre egy új API-kulcsot. Adjon neki könnyen felismerhető nevet, például „Scratcher”.
- Adjon a kulcsnak hozzáférést ahhoz a szekcióhoz vagy szekciókhoz, amelyekbe a Scratcher profilokat küldjön, az alább felsorolt jogosultságokkal.
- Mentsen, majd másolja ki a Client ID és a Client secret értékét. A titkos kulcs csak egyszer jelenik meg.
Az Apsisnak saját, lépésenkénti útmutatója is van ehhez. Ez a Scratcher telepítési párbeszédablakában, a Setup guide részben érhető el („To install the integration, follow the guide here”).
A kulcshoz szükséges jogosultságok
A Scratcher a kulcsot a következőkre használja:
- a szekciók, valamint az azokban lévő attribútumok, feliratkozások (hozzájárulási témák) és események olvasása, hogy ezeket kiválaszthassa a kampányban;
- profilok létrehozása és attribútumaik frissítése;
- hozzájárulások (feliratkozások) hozzáadása a profilokhoz;
- események hozzáadása a profilokhoz.
A kulcsnak tehát olvasási hozzáférés kell a szekciókhoz, valamint írási hozzáférés a profilokhoz, hozzájárulásokhoz és eseményekhez a használt szekciókban. Írási hozzáférés nélkül a küldések az Apsis One saját hibaüzenetével meghiúsulnak.
2. lépés: Az Apsis One összekapcsolása a Scratcherrel
- A Scratcherben lépjen a Beállítások > Integrációk menübe, és kattintson az Apsis One elemre.
- Válassza ki az API-régiót: Europe vagy Asia.
- Illessze be a Client ID és a Client secret értékét.
- Kattintson az Integráció telepítése gombra. A Scratcher bejelentkezik az Apsis One-ba, hogy ellenőrizze az adatokat.
3. lépés: Bekapcsolás egy kampányban
- A Szerkesztőben lépjen a Kapcsolódás > Integrációk > Apsis One részre, és kattintson az Aktiválás gombra.
- Ha több Apsis One-fiókot is összekapcsolt, válassza ki a megfelelőt a Fiók kiválasztása alatt.
- Az Apsis-szekció alatt válassza ki a szekciót (Szekció kiválasztása).
- A Mezőmegfeleltetések alatt minden mezőhöz kattintson a Mezőmegfeleltetés hozzáadása gombra, és párosítsa a Scratcher-mezőt az Apsis One-attribútummal a Célmező részben. A lista a kiválasztott szekció attribútumait mutatja, a saját attribútumait is beleértve.
- A Feliratkozások (hozzájárulások) alatt válassza ki, melyik feliratkozásra iratkozzanak fel a résztvevők, vagy válassza a Nincs lehetőséget. „Válassza ki azt a feliratkozást, amelyre a résztvevőt fel kell iratkoztatni.”
- A Szűrés hozzájárulások szerint (opcionális) alatt válassza ki a marketinghozzájárulási jelölőnégyzetet, hogy csak azok kerüljenek továbbításra, akik bejelölték.
- Kattintson a Mentés, majd a Teszt gombra egy tesztprofil elküldéséhez.
Mezőmegfeleltetés
- Az e-mail-címet mindig elküldjük, és ez azonosítja a profilt. Ezt nem kell megfeleltetnie.
- Telefonszámoknál a Formátum beállítással küldheti a számot abban a formában, ahogyan az attribútum elvárja.
- Az igen/nem attribútumok true vagy false értéket kapnak, ezért egy hozzájárulás Elfogadva mezőjét igen/nem attribútumhoz rendelje.
Hozzájárulás
Ha kiválaszt egy feliratkozást, minden résztvevő „Subscribed via” indoklással és a kampány nevével, valamint „Scratcher” forrással iratkozik fel rá. Ha a résztvevő már feliratkozott, semmi sem változik. Használja a Szűrés hozzájárulások szerint beállítást, hogy csak azok iratkozzanak fel, akik bejelölték a marketing-jelölőnégyzetet.
Ha a szekcióban szerepel az Apsis One hozzájárulási űrlap eseménye, a Scratcher a regisztrációt eseményként is rögzíti a profilon, a kampány címével együtt.
Mit és mikor küldünk
Az új regisztrációk egy-két percen belül továbbításra kerülnek. Az integráció aktiválásakor a kampány meglévő leadjeit is elküldjük. Ha valaki ismét részt vesz, a profilja frissül. Minden küldést ellenőrizhet a Beállítások > Integrációk > Kézbesítési állapot részben; itt az is látható, hogy a profil új volt-e, vagy már létezett. Lásd: A kézbesítési állapot ellenőrzése és a leadek újraküldése.
Hibaelhárítás
- „All or some of the fields are invalid...” üzenet telepítéskor: ellenőrizze a régiót, és másolja ki újra a Client ID-t és a titkos kulcsot.
- A küldések az Apsis One hozzáférési hibájával meghiúsulnak: a kulcs nem fér hozzá a szekcióhoz, vagy hiányoznak az írási jogosultságai. Szerkessze a kulcsot az Apsis One-ban.
- A Feliratkozások (hozzájárulások) lista üres: a szekcióban még nincs feliratkozás. Hozzon létre egyet az Apsis One-ban, majd nyissa meg újra az integrációt.