Teilen im Messenger für iOS und Android

Wenn du mit dem Facebook-SDK für iOS oder Android ab Version 4.29.0 entwickelst, kannst du Nutzer*innen ermöglichen, Links und Medien aus deinen Apps im Messenger zu teilen. Wenn Nutzer*innen Inhalte im Messenger teilen, kannst du deine Chat-Erweiterungen über den Attributionslink aktivieren. Deine Chat-Erweiterungen werden im Bereich Mehr im Interface für das Teilen angezeigt.

In den folgenden Abschnitten findest du weitere Informationen:

• Teilungsarten
• Verknüpfen von App- und Seiten-IDs
• Registrieren von Domains
• iOS
• Android

Unter Teilen im Messenger für das Web findest du Informationen zur Implementierung einer Teilen-Funktion im Messenger für das Web.

Teilungsarten

Das Facebook-SDK bietet die folgenden Teilungsarten:

• Teilen eines Links (wie das bestehende Teilen eines Links, aber mit Zuordnung durch eine pageID)
• Foto (ohne Zuordnung)

In der folgenden Tabelle findest du alle Teilungsarten, die beim Teilen im Messenger unterstützt werden, sowie Informationen, ob eine Seiten- oder App-ID erforderlich ist.

Verknüpfen von App- und Seiten-IDs

Entwickler*innen können im Teilen-Vorgang eine Seiten-ID angeben. Wenn der*die Nutzer*in dann Content aus einer App über das Teilen-SDK im Messenger teilt, wird der Content der Seite zugeordnet. Seitenadministrator*innen können kontrollieren, welche Apps für ihre Seiten eine Teilen-Zuordnung verwenden dürfen, um falsche Zuordnungen zu verhindern. Um einer App die Teilen-Zuordnung zu gestatten, verknüpft der*die Administrator*in die App-ID mit der Seiten-ID.

So verknüpfst du eine App-ID mit einer Seiten-ID:

1. Rufe die Einstellungen der Seite auf.
2. Klicke auf den Abschnitt Messenger-Plattform.
3. Gehe unter Allgemeine Einstellungen zum Abschnitt Eine App verknüpfen.
4. Gib die App-ID ein und klicke auf den Button Verknüpfen.
5. Wenn diese App noch NICHT in der Tabelle Abonnierte Apps aufgeführt war, wird sie in der Tabelle mit der Rolle „Teilen-Zuordnung“ aufgeführt. Wenn die App bereits in der Tabelle aufgeführt war, wird ihr die neue Rolle „Teilen-Attribution“ hinzugefügt.

Seitenadministrator*innen können die Berechtigung einer App, die Teilen-Attribution zu verwenden, auch wieder entziehen.

So entfernst du die Rolle „Teilen-Attribution“ für eine App:

1. Klicke in der Tabelle Abonnierte Apps auf das Menü in der Spalte „Rolle“ für die App.
2. Klicke auf „Teilen-Attribution“, um die Rolle zu deaktivieren.
3. Wenn „Teilen-Attribution“ die einzige Rolle der App war, wird die Zeile der App aus der Tabelle entfernt. Ansonsten bleibt die Zeile bestehen, aber die Rolle „Teilen-Attribution“ wird abgewählt.

Registrieren von Domains

Wenn du im Teilen-SDK einen URL-Button verwendest und die Messenger-Erweiterung für deine URL beim Öffnen im Messenger aktivieren möchtest, musst du die URL-Domain registrieren, damit der Teilungsvorgang korrekt funktioniert.

So registrierst du eine Domain:

1. Rufe die Seite auf.
2. Gehe zu Settings > Advance Messaging (Einstellungen > Erweitertes Messaging).
3. Füge die Domain zum Feld Domains auf der Whitelist hinzu.

Weitere Informationen findest du unter SDK für Messenger-Erweiterungen – Erforderliches Domain-Whitelisting.

iOS

Voraussetzungen

Bevor du Teilen im Messenger zu deiner App hinzufügst, musst du die folgenden Schritte durchführen:

• Füge das Facebook-SDK für iOS deiner mobilen Entwicklungsumgebung hinzu.
• Konfiguriere deine Facebook-App-ID und verknüpfe sie über das Messenger-Plattform-Tool mit deiner Seiten-ID.
• Füge deine App-ID, den Anzeigenamen und einen für Menschen lesbaren Grund für den Fotozugriff zur .plist-Datei deiner App hinzu.
• Verknüpfe das FBSDKShareKit.framework mit deinem Projekt.

Weitere Informationen findest du unter Erste Schritte mit dem Facebook-SDK für iOS.

Stelle außerdem sicher, dass deine App canShow oder validate in der MessageDialog-Instanz aufruft, um zu bestimmen, ob auf dem Gerät des*der Nutzer*in eine kompatible Messenger-Version installiert ist.

Einschränkungen

Die Zitat-Eigenschaft wird nicht unterstützt.

Beispiel für das Teilen von Links

guard let url = URL(string: "https://newsroom.fb.com/") else {
    preconditionFailure("URL is invalid")
}

let content = ShareLinkContent()
content.contentURL = url

let dialog = MessageDialog(content: content, delegate: self)

do {
    try dialog.validate()
} catch {
    print(error)
}

dialog.show()

Beispiel für das Teilen von Fotos

// Assumes your assets contain an image named "puppy"
guard let image = UIImage(named: "puppy") else {
    return
}

let photo = SharePhoto(image: image, userGenerated: true)
let content = SharePhotoContent()
        content.photos = [photo]

let dialog = MessageDialog(content: content, delegate: self)

// Recommended to validate before trying to display the dialog
do {
    try dialog.validate()
} catch {
    print(error)
}

dialog.show()

Beispiel für das Teilen von Videos

// Assuming you have a URL for a PHAsset
let video = ShareVideo(videoURL: assetURL)
let content = ShareVideoContent()
content.video = video

let dialog = MessageDialog(content: content, delegate: self)

// Recommended to validate before trying to display the dialog
do {
    try dialog.validate()
} catch {
    print(error)
}

dialog.show()

Android

Voraussetzungen

Folge den Anweisungen in Teilen unter Android, die unten zusammengefasst sind:

• Damit du das Teilen-SDK in deinem Projekt verwenden kannst, richte in Maven eine Abhängigkeit ein oder lade es herunter.
• Abrufen einer Facebook-App-ID, die ordnungsgemäß konfiguriert und mit deiner Android-App verknüpft ist.
• Konfiguriere deine Facebook-App-ID und verknüpfe sie über das Messenger-Plattform-Tool mit deiner Seiten-ID.
• Generiere einen Android-Key-Hash und füge ihn zu deinem Entwicklerprofil hinzu.
• Füge eine Facebook-Aktivität hinzu und füge sie in deine AndroidManifest.xml ein.

Stelle außerdem sicher, dass deine App MessageDialog.canshow({template}) aufruft, um zu bestimmen, ob auf dem Gerät des*der Nutzer*in eine kompatible Messenger-Version installiert ist.

Verwandtes Thema

Teilen im Messenger für das Web