Unternehmensfeatures konfigurieren

Erfahre mehr über die verfügbaren Optionen zum Aktivieren und Konfigurieren von Unternehmensfeatures für die Facebook Business Extension.

Konfigurationsoptionen

Verwende eine dieser verfügbaren Optione, um Unternehmensfeatures für den Nutzer zu aktivieren und zu konfigurieren:

Unterstützte Features

Facebook Business Extension bietet viele Features, die du für dein Unternehmen aktivieren kannst.

Die folgenden Features sind nach der Branche gruppiert, für die sie am besten geeignet sind:

Standard-Features

Features speziell für TERMINE

Keine zusätzliche Implementierung erforderlich

Zusätzliche Implementierung erforderlich

<div class="fb-customerchat"
            page_id="<PAGE_ID>">
        </div>

Anfängliche Feature-Einrichtung über Unternehmens-Login

Du kannst eine beliebige Anzahl von Features für dein Unternehmen konfigurieren, indem du diese in der Eigenschaft business_config angibst. Diese wird über den Parameter extras sowohl an den Unternehmens-Login als auch den App Store übergeben. Hier solltest du alle Features angeben, die du für dein Unternehmen aktivieren möchtest, sobald die FBE-Installation abgeschlossen ist.

business_config ist ein JSON-Objekt, das untergeordnete Felder enthält, um zu beschreiben, wie verschiedene Features konfiguriert werden. Erfahre mehr über die untergeordneten Felder, die angegeben werden müssen, und business_config. Wenn du z. B. nur den CTA auf der Facebook-Seite und im Instagram-Profil des Unternehmens konfigurieren möchtest, würde dein business_config-Objekt folgendermaßen aussehen:

{
  "business": {
    "name": "Foo Business"
  },
  "page_cta": {
    "enabled": true,
    "cta_button_text": "Book Now",
    "cta_button_url": "https://partner-site.com/foo-business",
    "below_button_text": "Powered by FBE Partner"
  },
  "ig_cta": {
    "enabled": true,
    "cta_button_text": "Book Now",
    "cta_button_url": "https://partner-site.com/foo-business"
  },
}

FBE-Feature-Management-Ansicht

Damit deine Unternehmen Features weiter (über die Konfiguration, die du für sie in business_config bei der Installation festgelegt hast, hinausgehend) konfigurieren können, kannst du Unternehmen über deine Plattform zu unserer FBE-Management-Ansicht weiterleiten.

Du kannst einen Einstiegspunkt hinzufügen, um die FBE-Management-Ansicht zu starten, indem du eine der folgenden Methoden (JavaScript-SDK oder URL) hinzufügst. Beide Beispiele zeigen einen Button, der angeklickt wird und das Fenster mit dem FBE-Management-Modus öffnen würde. Wir empfehlen, den FBE-Launch-Button erst einzublenden, nachdem ein*e Kund*in die FBE-Einrichtung abgeschlossen hat. Achte darauf, die fbe_external_business_id für external_business_id zu übergeben.

Du kannst den ausgewählten Tab für die FBE-Management-Ansicht angeben, indem du den optionalen Parameter tab mit dem Namen des gewünschten Tabs übergibst. Du kannst dafür zum Beispiel „Home“ oder „Commerce“ festlegen. Dieser Parameter kann im Javascript SDK oder mit der URL-Methode verwendet werden.

Facebook JavaScript-SDK

<script>
  function launchFBEManagementView() {
    FB.ui({
      display: 'popup',
      method: 'facebook_business_extension',
      external_business_id: '<fbe_external_business_id>',
      tab: '<selected_tab_name>', // optional
      }, function(response){
        // implement
      });
  }
</script>

<a href="javascript:void(0);"> <button onclick="launchFBEManagementView()">Launch Management View<button></a>;

URL-Methode

<a href="https://www.facebook.com/facebook_business_extension?app_id=<app_id>&external_business_id=<fbe_external_business_id>&tab=<selected_tab_name>"><button>Launch Management View</button></a>

FBE Feature Configuration API

Um die Features eines Unternehmens nach der anfänglichen Installation deinerseits zu konfigurieren und zu aktualisieren, kannst du die FBE Feature Configuration API verwenden.

Für die nicht anpassbaren Features werden nur eine Feature-Instanz-ID und die Kennzeichnung „Aktiviert“ angezeigt. Nur die anpassbaren Funktionen können mit einer POST-Anfrage aktualisiert werden.

Die Feature Configuration API unterscheidet sich von der FBE Installation API, da sie zusätzliche Feature-Informationen bereitstellt, die über die verknüpften Assets hinausgehen und auch den Status „Aktiviert“ sowie bestimmte Feature-Anpassungen umfassen. Nachdem du die FBE Installation API aufgerufen hast, verwende die Feature Configuration API, wenn weitere Informationen über den Status „Aktiviert“ oder die Konfiguration des Features erforderlich sind.

Über die folgenden API-Endpunkte kannst du Features für ein bestimmtes Unternehmen, das FBE installiert hat, auf deiner Plattform aktivieren, deaktivieren und konfigurieren. Der access_token, der für diese Endpunkte verwendet wird, ist derjenige, der über Unternehmens-Login oder den Webhook an dich zurückgegeben wird.

Lesen

Du kannst den aktuellen Feature-Konfigurationsstatus jedes Unternehmens lesen, indem du die folgende Anfrage stellst:

CURL -X GET 'https://graph.facebook.com/<API_VERSION>/fbe_business/?fbe_external_business_id=<fbe_external_business_id>&access_token=<access_token>'

Antwort

Siehe business_config-Objekt.

Aktualisieren

Um alle Features zu aktualisieren, stelle die folgende POST-Anfrage:

CURL -i -X POST \ 
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config={business_config object}' \
  -F 'access_token=<access_token>' \

  "https://graph.facebook.com/<API_VERSION>/fbe_business"

Antwort

Ein Beispiel für eine Antwort.

    {
  "page_cta": {
     "feature_instance_id": id1,
     "enabled": true,
     "cta_button_text": "Book Now",
     "cta_button_url": "https://partner-site.com/foo-business1",
     "below_button_text": "Powered by FBE Partner"
  },
  "page_ctas": [
    {
        "feature_instance_id": id1,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business1",
        "below_button_text": "Powered by FBE Partner"
    },
    {
        "feature_instance_id": id2,
        "enabled": true,
        "cta_button_text": "Book Now",
        "cta_button_url": "https://partner-site.com/foo-business2",
        "below_button_text": "Powered by FBE Partner"
    }
  ],
  "ig_ctas": [{...}, {...}],
  “ads”: [
    {
      "feature_instance_id": id3,
      “enabled”: true,
    },
    {
      "feature_instance_id": id4,
      “enabled”: true,
    },
  ],
  ...
}

Den Call-to-Action-Button auf der Seite des*der Endnutzer*in aktivieren und konfigurieren und eine POST-Anfrage stellen:

CURL -i -X POST \ 
  -F 'fbe_external_business_id=<fbe_external_business_id>' \
  -F 'business_config= {
       "business":{
       "name":"example_business"
        },
        "page_cta":{
          "enabled":true,
          "cta_button_text":"Buy Now",
          "cta_button_url":"https://examplebusiness.com",
          "below_button_text":"Powered by a partner"
        }
      }' \
  -F 'access_token=<access_token>' \
  "https://graph.facebook.com/<API_VERSION>/fbe_business"

Mehr dazu

Katalog

Nächste Schritte

Pixel-Events auslösen