Facebook API Key, Application Secret… tajniki integracji z własną stroną
Praca z Facebookiem
Ten artykuł jest wstępem zarówno do artykułów o integracji strony WordPress z Facebookiem, jak i integracji każdej dowolnej strony WWW z Facebookiem.
Artykuł opisuje jak utworzyć i skonfigurować Aplikację oraz Stronę oficjalną
Aplikacja będzie tu używana wyłącznie do integracji strony opartej na WordPressie za pomocą wtyczki Simple Facebook Connect. Jeśli nie korzystasz z WordPressa lub nie chcesz posługiwać się wtyczką – nie twórz Aplikacji.
Strona oficjalna jest niezbędna. Czy tworzysz małą wlepkę na stronę, czy łączysz z Facebookiem cały system CMS – musisz posiadać na Facebooku Stronę o unikalnym adresie URL.
Niniejszy tekst nie tłumaczy i nie rozwija wielu pojęć. Skupiamy się tu na wprowadzeniu do integracji strony internetowej z serwisem Facebook.
Założeniem wyjściowym jest to, że posiadasz stronę internetową oraz jej odpowiednik na Facebooku w postaci Strony oficjalnej lub Strony społecznościowej. W kolejnym artykule skupimy się na integracji ze stroną opartą na WordPress, a ten tekst opisze kwestie ogólne i przygotowanie.
Najpierw musisz jednak posiadać zwykłe konto użytkownika Facebook.
Dobra praktyka: Nie zakładaj dla swojej witryny osobnego konta użytkownika – Strona oficjalna lub Społecznościowa oferują Ci lepsze i ciekawsze narzędzia administracyjne i promocyjne.
Ponieważ bardziej typowym wyborem będzie Strona oficjalna – dalej będziemy pisać tylko o niej.
Aplikacja czy Strona?
Chociaż chcesz zintegrować z własną witryną Stronę oficjalną, w wielu sytuacjach należy stworzyć Aplikację Facebook. Tylko dzięki Aplikacji zdobędziesz Klucz API i tzw. Application Secret – bez nich nie połączych się z Facebook API. Jest to potrzebne, jeśli chcesz integrować komentarze, publikację treści lub używać wtyczki do WordPressa Simple Facebook Connect.
Jeśli to, co zamierzasz robić nie wymaga podawania: Klucza API i tzw. Application Secret – nie twórz Aplikacji
Można stworzyć tylko Aplikację i promować ją zamiast Strony oficjalnej – z pozoru wyglądają podobnie. Jednak tylko Strona oferuje interesujące Cię funkcjonalności.
Niestety choć wydaje się to zagmatwane – niezbędne do integracji: Facebook API Key i Application Secret możesz uzyskać tylko zakładając Aplikację więc musisz ją założyć nawet jeżeli nie będziesz jej wykorzystywać do niczego więcej.
Podsumowując, aby rozpocząć integrację, musisz mieć:
- Konto użytkownika Facebook
- Aplikację Facebook
- Stronę oficjalną na Facebook
Dzięki nim uzyskasz:
- indywidualny klucz Facebook API
- Application Secret
- adres URL założonej przez Ciebie Strony oficjalnej.
Do dzieła!
Tworzenie i konfiguracja Aplikacji Facebook
Wejdź na stronę swoich Aplikacji pod adresem: http://www.facebook.com/developers/apps.php
Utwórz Aplikację o dowolnej nazwie, klikając w przycisk Set up new App. Strona utworzonej Aplikacji zawiera dane, których wymaga wtyczka Simple Facebook Connect (min. Klucz API, ID Aplikacji itd.), ale UWAGA: Aplikacja wymaga jeszcze poprawnego skonfigurowania!
Aplikacja utworzona. Aby zintegrować Facebook z konkretną stroną WWW, musisz wprowadzić następujące dane:
Zakładka: Informacje
Nazwa aplikacji – Aplikacja musi mieć nazwę. Ja wprowadzam adresy stron, które integruję, np. NazwaSerwisu.pl
Podstawowe informacje – dane takie jak Opis czy Logo nie są niezbędne, żeby połączenie z Facebookiem zadziałało. Jeśli nie tworzysz Aplikacji, tylko połączenie z Facebookiem – te dane, to kwestia estetyki. Uzupełnij je wg własnych potrzeb.
Informacje kontaktowe – do kontaktów z użytkownikami – wybierz opcję URL i wpisz adres w formacie: http://nazwaserwisu.pl/, do kontaktów z FB wpisz swój adres email,
Zakładka: Strona aplikacji
Tu znajdziesz unikalne ID Aplikacji i Aplication Secret
Adres (URL) strony – Podaj adres, pod którym znajdują się twoje pliki i treści odbierane przez FB. Adres musi kończyć się znakiem / np. http://nazwaserwisu.pl/
Domena strony – Wpisz główną domenę, np. nazwaserwisu.pl Bez http://, www., bez końcówki /. Umożliwi to obsługę subdomen.
Zakładka: Integracja z Facebookiem
Strona ramki – pozostaw puste. Jeśli tworzysz Aplikację ożesz utwórzyć tu unikalny adres URL swojej Aplikacji na FB, np. http://apps.facebook.com/nazwaserwisu (taki sam jak w Adres URL karty.
Adres ramki – (poprzednio: Canvas Callback URL) – WAŻNE! to tu zastępujesz ową Stronę ramki (w skrócie: stronę aplikacji) adresem własnej strony WWW. Podaj adres, pod którym znajdują się twoje pliki i treści odbierane przez FB. Adres musi kończyć się znakiem / np. http://nazwaserwisu.pl/
Adres URL zakładki – pozostaw puste. To adres, na który kierowani będą użytkownicy po kliknięciu w zakładkę Twojej aplikacji. Jeśli pole będzie puste, zostaną przekierowani pod adres, który wpisałeś w Adresie ramki.
Nazwa zakładki – nazwij krótko zakładkę/bookmark widoczną dla użytkowników, np. NazwaSerwisu
Adres URL karty – pozostaw puste. Domyślnie system uzupełni to adresem – adresem URL twojej strony.
Reszta ustawień to opcje, których możesz potrzebować, jeśli faktycznie chcesz tworzyć prawdziwą aplikację. Jeśli chcesz tylko zintegrować stronę WWW ze Stroną/Profilem FB, przejrzyj, ale nie zaprzątaj sobie nimi głowy.
OK, Aplikacja stworzona, inaczej mówiąć: masz Klucz API, a Facebook będzie wiedział, jak połączyć się z twoją stroną WWW.
Czas założyć Stronę FB – czyli nawiązać kontakt z użytkownikami tego serwisu-molocha.
Jak stworzyć Stronę oficjalną na Facebooku i uzyskać jej URL?
Jeśli stworzyłeś już Stronę oficjalną (jeśli nie – zrób to: zrób to teraz) potrzebujesz jej URL-u.
Bezpośredni adres na twoją Stronę (URL) powinien wyglądać tak:
http://www.facebook.com/pages/Nazwa-Strony/XXXXXXXXXXXX
Te „iksy” (tzn. numer, który reprezentują) to Twoje unikalne ID Strony. Poprawnie skopiowany adres URL powinien je zawierać.
Jeżeli jeteś zalogowany jako użytkownik – do swojej Strony najszybciej dostaniesz się klikając w prawym górnym rogu:
Konto > Zarządzanie stronami > Nazwa Strony
Oczywiste? W takim razie przepraszamy – nam ciągle nawigacja po Facebooku wydaje się nieintuicyjna :)
Integracje
Teraz zobacz, co możesz zrobić bez przeszkód i ograniczeń:
Dodać przycisk Lubię to na swojej stronie internetowej
Dodać wlepkę Like Box na swojej stronie
Zintegrować stronę działającą na silniku WordPress
Automatycznie publikować treści na stronie i na Facebooku
Zintegrować moduł komentarzy Facebook
Dodać przycisk Lubię to i wlepkę Like Box za pomocą wtyczki
Rozwiązania Facebooka bywają czasem wyjątkowo nieintuicyjne. Mamy nadzieję, że tematy konfiguracji Aplikacji i Strony oficjalnej udało się przedstawić wystarczająco przejrzyście, ale w razie problemów zapraszamy do zadawania pytań!