S integrací Apsis One se každý, kdo se zaregistruje, vytvoří nebo aktualizuje jako profil v Apsis One, v sekci, kterou zvolíte, a může být přihlášen k odběru jednoho z vašich odběrů v Apsis One.
Co budete potřebovat
- Účet Apsis One a uživatele, který může spravovat API klíče (obvykle administrátor).
- Vědět, zda je váš účet Apsis One v regionu Europe, nebo Asia. Většina účtů je v Evropě.
Krok 1: Vytvořte API klíč v Apsis One
- V Apsis One otevřete Account settings a přejděte do API keys (pod integracemi).
- Klikněte na vytvoření nového API klíče. Dejte mu název, který poznáte, například „Scratcher“.
- Dejte klíči přístup k sekci nebo sekcím, do kterých má Scratcher posílat profily, s oprávněními níže.
- Uložte a zkopírujte Client ID a Client secret. Secret se zobrazí jen jednou.
Apsis k tomu má vlastní návod krok za krokem. Odkaz na něj najdete v Průvodce nastavením v instalačním dialogu ve Scratcheru („To install the integration, follow the guide here“).
Oprávnění, která klíč potřebuje
Scratcher klíč používá k tomu, aby:
- četl vaše sekce a v nich atributy, odběry (consent topics) a události, abyste je mohli vybrat v kampani;
- vytvářel profily a aktualizoval jejich atributy;
- přidával k profilům souhlasy (opt-iny);
- přidával k profilům události.
Klíč tedy potřebuje přístup pro čtení k sekcím a přístup pro zápis k profilům, souhlasům a událostem v sekcích, které používáte. Bez přístupu pro zápis doručení selžou s vlastní chybovou zprávou Apsis One.
Krok 2: Připojte Apsis One ke Scratcheru
- Ve Scratcheru přejděte do Nastavení > Integrace a klikněte na Apsis One.
- Zvolte Region API: Evropa nebo Asie.
- Vložte ID klienta a Tajný klíč klienta.
- Klikněte na Nainstalovat integraci. Scratcher se přihlásí do Apsis One, aby údaje ověřil.
Krok 3: Zapněte ho v kampani
- V editoru přejděte do Připojit > Integrace > Apsis One a klikněte na Aktivovat.
- Pokud máte připojený více než jeden účet Apsis One, vyberte ho v Vybrat účet.
- V části Sekce Apsis vyberte sekci (Vyberte sekci).
- V části Mapování polí klikněte u každého pole na Přidat mapování pole a přiřaďte Pole Scratcheru k atributu Apsis One v Cílové pole. Seznam ukazuje atributy zvolené sekce, včetně vašich vlastních.
- V části Odběry (souhlasy) vyberte odběr, ke kterému se mají lidé přihlásit, nebo Žádné. „Vyberte předplatné, k jehož odběru má být účastník přihlášen.“
- V části Filtrovat podle souhlasů (volitelné) vyberte své zaškrtávací políčko se souhlasem s marketingem, aby se posílali jen lidé, kteří ho zaškrtli.
- Klikněte na Uložit a pak na Otestovat, čímž pošlete testovací profil.
Mapování polí
- E-mailová adresa se posílá vždy a slouží k identifikaci profilu. Mapovat ji nemusíte.
- U telefonních čísel použijte nastavení Formát, aby se číslo posílalo tak, jak ho váš atribut očekává.
- Atributy typu ano/ne dostávají true nebo false, proto pole Přijato u souhlasu mapujte na atribut typu ano/ne.
Souhlas
Pokud zvolíte odběr, každý člověk se k němu přihlásí s důvodem „Subscribed via“ a názvem kampaně a se zdrojem „Scratcher“. Pokud už je člověk přihlášený, nic se nezmění. Použijte Filtrovat podle souhlasů (volitelné), aby se přihlásili jen lidé, kteří zaškrtli vaše políčko se souhlasem s marketingem.
Pokud má vaše sekce událost formuláře souhlasu Apsis One, Scratcher zaznamená registraci také jako událost na profilu, s adresou kampaně.
Co se posílá a kdy
Nové registrace se odešlou do minuty nebo dvou. Když integraci aktivujete, odešlou se i stávající leady kampaně. Když se někdo zúčastní znovu, jeho profil se aktualizuje. Každé doručení zkontrolujete v Nastavení > Integrace > Stav doručení; uvidíte tam i to, zda byl profil nový, nebo už existoval. Viz Kontrola stavu doručení a opětovné odeslání leadů.
Řešení problémů
- „Některá nebo všechna pole jsou neplatná...“ při instalaci: zkontrolujte region a znovu zkopírujte ID klienta a secret.
- Doručení selžou s chybou přístupu z Apsis One: klíč nemá přístup k sekci, nebo mu chybí oprávnění k zápisu. Upravte klíč v Apsis One.
- Odběry (souhlasy) jsou prázdné: sekce zatím nemá žádné odběry. Vytvořte odběr v Apsis One a integraci otevřete znovu.