Playable Ads für mobile Apps

Playable Ads sind interaktive Anzeigen, die Werbetreibenden ermöglichen, Nutzern eine kurze Vorschau der App zu zeigen, bevor diese entscheiden, ob sie die App herunterladen möchten. Playable Ads verfügen über ein Lead-In Video oder ein einführendes Video mit der Nachricht Zum Ausprobieren tippen. Wenn ein Nutzer auf das Video tippt, wird er zu einer Vollbild-Demo des Spiels weitergeleitet, mit der er interagieren kann. Die Anzeige kann während der Demo oder im Anschluss daran einen Call to Action anzeigen.

Playable Ads sind verfügbar für:

Einschränkungen

  • Lead-In Videos werden für Platzierungen bei Audience Network nicht angezeigt.
  • Für Platzierungen bei Instagram werden nur Lead-In Videos angezeigt.
  • Playable Ads sind nur mit dem Ziel „App-Installationen“ verfügbar.

Lade eine Playable Ad über den Werbeanzeigenmanager hoch statt über die API.

Spezifikationen

Sieh dir den Artikel zu Playable Ads im Hilfebereich an, um mehr über die Spezifikationen für Lead-In Videos und HTML- sowie Zip-Dateien zu erfahren.

Playable Ad mit der API erstellen

Anforderungen

Du benötigst Folgendes:

Schritt 1: Anzeigengruppe erstellen

Sende eine POST-Anfrage an den /act_AD_ACCOUNT_ID/adsets-Endpunkt, um eine Anzeigengruppe zu erstellen.

Du kannst für deine Anzeige mehrere Videos hochladen und festlegen, welches Video für welche Platzierung verwendet wird, wenn du über mehrere Platzierungen verfügst. Das folgende Beispiel zeigt mehrere Platzierungen mit publisher_platforms, facebook_positions und audience_network_positions.

Für Lesbarkeit formatiert.
curl -X POST "https://graph.facebook.com/act_AD_ACCOUNT_ID/adsets
  ?name=AD_SET_NAME
  &access_token=ACCESS_TOKEN
  &bid_amount=2
  &billing_event=IMPRESSIONS
  &campaign_id=AD_CAMPAIGN_ID
  &daily_budget=1000
  &optimization_goal=APP_INSTALLS
  &promoted_object={  
    'application_id':'APP_ID',
    'object_store_url':'APP_STORE_URL'
    }
  &targeting={
    'device_platforms': ['mobile'],
    'geo_locations': {countries:['US']},
    'publisher_platforms': ['facebook','audience_network'],
    'facebook_positions': ['feed'],
    'audience_network_positions': ['rewarded_video','classic'],
    'user_os': ['ANDROID']
    }"

Bei Erfolg wird eine Anzeigengruppen-ID für die Playable Ad zurückgegeben.

Schritt 2: HTML- oder Zip-Datei in dein Werbekonto hochladen

Sende eine POST-Anfrage an den /act_AD_ACCOUNT_ID/adplayables-Endpunkt, um eine Playable Ad-Datei hochzuladen. Verwende den source-Parameter für eine HTML-Datei oder den source_zip-Parameter für eine Zip-Datei.

Für Lesbarkeit formatiert.
curl -X POST "https://graph.facebook.com/act_{your-ad-account}/adplayables
  ?name={your-playable-ad-name}
  &source=@{your-source-location}  
  &access_token={your-system-access-token}"

Bei Erfolg wird eine Playable Asset-ID zurückgegeben.

Schritt 3: Lead-In Video-Datei in ein Werbekonto hochladen

Sende eine POST-Anfrage an den /act_AD_ACCOUNT_ID/advideos-Endpunkt, um ein Lead-In Video hochzuladen. Verwende den source-Parameter für eine HTML-Datei oder den source_zip-Parameter für eine Zip-Datei.

Für Lesbarkeit formatiert.
curl -X POST "https://graph-video.facebook.com/act_AD_ACCOUNT_ID/advideos
  ?source=@SOURCE_LOCATION
  &access_token=AD_ACCOUNT_ID"

Bei Erfolg wird eine Lead-In Video-ID zurückgegeben.

Schritt 4: Inhalt der Werbeanzeige erstellen

Sende eine POST-Anfrage an den /act_AD_ACCOUNT_ID/adcreatives-Endpunkt, um den Inhalt der Werbeanzeige zu erstellen.

Für Lesbarkeit formatiert.
curl -X POST "https://graph.facebook.com/act_AD_ACCOUNT_ID/adcreatives
  ?name=PLAYABLE_AD_CREATIVE_NAME
  &access_token=ACCESS_TOKEN
  &playable_asset_id=PLAYABLE_ASSET_ID
  &object_story_spec={
    'page_id': 'PAGE_ID',
    'video_data': {
      'call_to_action': {
        'type':'INSTALL_MOBILE_APP',
        'value':{
          'application':'APP_ID',
          'link':'LINK_URL'
        }
      },
      'image_url': 'THUMBNAIL_URL',
      'link_description': 'CTA_MESSAGE',
      'video_id': 'LEAD_IN_VIDEO_ID'
    }
  }"

Bei Erfolg wird eine Werbeanzeigen-ID zurückgegeben.

Schritt 5: Werbeanzeige erstellen

Sende eine POST-Anfrage an den /act_AD_ACCOUNT_ID/ads-Endpunkt.

Für Lesbarkeit formatiert.
curl -X POST "https://graph.facebook.com/act_AD_ACCOUNT_ID/ads
  ?name=PLAYABLE_AD_NAME
  &access_token=ACCESS_TOKEN
  &adset_id=PLAYABLE_AD_SET_ID
  &creative={'creative_id':'PLAYABLE_AD_CREATIVE_ID'}
  &status=PAUSED"
  

Sobald das Testen deiner Anzeige abgeschlossen ist, ändere den status zu ACTIVE.

iPads werden für das Testen von Playable Ads nicht unterstützt. Verwende für das Testen auf iOS-Geräten ein Mobilgerät.

Problembehebung

Wenn du Playable Assets hochlädst, während du eine Playable Ad erstellst, erscheint möglicherweise eine Fehlermeldung mit dem Hinweis, dass dein Playable Asset ungültig ist.

Nachfolgend findest du typische Fehler, die dir angezeigt werden können und Tipps, wie du sie beheben kannst.

FehlerMögliche Behebung

Ungültige App-ID

Diese Fehlermeldung erscheint, wenn der App-Bereich nicht ausgewählt wurde oder keine Berechtigung hat, eine Anzeige für diese App zu erstellen. Wähle den App-Bereich aus und stelle sicher, dass du über die entsprechenden Berechtigungen zum Erstellen der Anzeige für diese App verfügst.

CTA-Klick Function Call fehlt

Der Playable Code verwendet nicht die JavaScript-Funktion FbPlayableAd.onCTAClick() für den Call to Action. Verwende diese Funktion in deinem CTA-Code.

Zu viele SubAssets in hochgeladenem Bundle

Deine Zip-Datei enthält mehr als 100 Dateien. Verwende weniger als 100 Dateien.

Upload zu groß

Deine Zip-Datei ist größer als 5 MB. Verringere die Größe deiner Zip-Datei auf weniger als 5 MB.

Hochgeladene Datei ist zu groß

Deine einzelne HTML-Datei ist größer als 2 MB oder die index.html-Datei ist größer als 2 MB. Verringere die Größe der Datei.

Hochgeladene Datei enthält Weiterleitung zu externem Link

Mindestens ein Asset enthält einen JavaScript-Weiterleitungscode. Entferne den Code.

Nicht unterstützte HTML-Datei für Playable Ad

Diese Fehlermeldung erscheint, wenn der Virenscan fehlgeschlagen ist.

Nicht unterstütztes Ziel für Playable Ads

Du hast ein Ziel ausgewählt, das nicht unterstützt wird. Für Playable Ads wird nur das Ziel App-Installationen unterstützt. Wähle das Ziel App-Installationen im Werbeanzeigenmanager aus, bevor du deine Anzeige erstellst.

Nicht unterstützte Platzierung für Playable Ads

Du hast eine Platzierung ausgewählt, die von Playable Ads nicht unterstützt wird.