Video- und Carousel Ads

Du kannst Video- und Carousel Ads auf Facebook ganz einfach mit der API erstellen, messen und optimieren. Mehr dazu erfährst du unter Facebook for Business, Carousel Ads. Die unterstützten Videoformate für Werbeanzeigen findest du im Hilfebereich für Werbetreibende, Videos.

Video Ads

Gehe wie folgt vor, um eine Video Ad im Ziel VIDEO_VIEWS zu erstellen und das Gebot für Reichweite zu optimieren:

• Schritt 1: Anzeigengestaltungen angeben
• Schritt 2: Werbekampagne erstellen
• Schritt 3: Anzeigengruppe erstellen
• Schritt 4: Werbeanzeige erstellen

Schritt 1: Anzeigengestaltungen angeben

Erstelle ein Video Ad mit einer bestehenden Video-ID und einem auf Facebook hochgeladenen Video.

Voraussetzungen:

• Die Berechtigungen pages_read_engagement und ads_management
• ein Video, das auf den Endpunkt act_{ad-account-id}/advideos hochgeladen wurde

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Slideshow

Verwende Slideshows, wenn du Markenkampagnen für traditionelle Mobiltelefone in Schwellenländern erweitern oder starten oder wenn du ein einfaches Video erstellen möchtest (du brauchst mindestens 3 Bilder). Lade Bilder in ein Videoelement hoch. Zum Beispiel:

curl \
  -F 'slideshow_spec={ 
  "images_urls": [ 
  "<IMAGE_URL_1>", 
  "<IMAGE_URL_2>", 
  "<IMAGE_URL_3>" 
  ], 
  "duration_ms": 2000, 
  "transition_ms": 200 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph-video.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/advideos
 
  Open In Graph API Explorer

Mehr dazu erfährst du unter Best Practices für Videowerbeanzeigen und Referenz: Ad Videos.

Schritt 2: Werbekampagne erstellen

Setze das Ziel auf VIDEO_VIEWS:

curl -X POST \
  -F 'name="Video Views campaign"' \
  -F 'objective="OUTCOME_ENGAGEMENT"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns
  
Open In Graph API Explorer

Mehr dazu erfährst du unter Referenz: Kampagne,AdObjectives in PHP und AdObjectives in Python.

Schritt 3: Anzeigengruppe erstellen

Wenn du die niedrigsten Kosten pro Aufruf erreichen möchtest, solltest du das Kampagnenziel „Videoaufrufe“ mit den optimization_goal=THRUPLAY einer Anzeigengruppe kombinieren. Du kannst bidding_event auf IMPRESSIONS oder THRUPLAY setzen, um pro Impression oder Videoaufruf zu bezahlen. Mehr dazu erfährst du unter CPV-Gebote.

curl \
  -F 'name=A CPV Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2024-05-06T04:45:29+0000' \
  -F 'end_time=2024-06-06T04:45:29+0000' \
  -F 'billing_event=THRUPLAY' \
  -F 'optimization_goal=THRUPLAY' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
  "device_platforms": ["mobile"], 
  "geo_locations": {"countries":["US"]}, 
  "publisher_platforms": ["facebook"] 
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets


  Open In Graph API Explorer

Die Kosten pro Aufruf für Anzeigengruppen mit optimization_goal=THRUPLAY sind im Vergleich zu CPVs aus der Buchungsart „Reichweite und Frequenz“ mit Optimierung für Videoaufrufe geringer. Das Enddatum muss in der Zukunft liegen. Mehr dazu erfährst du unter Referenz: Anzeigengruppe.

Schritt 4: Werbeanzeige erstellen

Verwende die Anzeigengruppe und die Anzeigengestaltung, die du eingerichtet hast:

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
  "creative_id": "<CREATIVE_ID>"
  }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

Wenn das Kampagnenziel VIDEO_VIEWS lautet, erhält die Werbeanzeige standardmäßig die richtige Tracking-Spezifikation, die definiert, welche Handlungen für eine Werbeanzeige verfolgt werden. Beispiel für Videoaufrufe:

{'action.type':'video_view','post':'POST_ID','post.wall':'PAGE_ID'}
    

Mehr dazu erfährst du unter Werbeanzeigenmanager: Meine Kampagnen und Referenz: Werbeanzeige.

Beispiel für Markenbekanntheit

Im Blog zur Markenbekanntheit erhältst du Informationen zum Erstellen einer Video Ad für Markenbekanntheit.

Beispiel für Reichweite und Frequenz

Verwende das Kampagnenziel „Videoaufrufe“ mit Reichweite und Frequenz, um mehr Menschen mit einem Video zu erreichen. Du musst eine Vorhersage erstellen, reservieren und deiner Anzeigengruppe zuweisen.

Führe die Schritte in Erstellung von Videoaufrufen aus, wende aber „Reichweite und Frequenz“ auf deine Anzeigengruppe an. Gib diese zusätzlichen Parameter an:

-F "rf_prediction_id=<RESERVATION_ID>" \

Video für Direct Response

Lies dir die Informationen unter Videowerbung im Carousel-Format durch, wenn du nicht nur die Bekanntheit, sondern auch Interaktionen steigern möchtest.

• Sprich Personen an, die ein Video angesehen haben. So kannst du Bekanntheit, Affinität und Erwägung steigern. Siehe Remarketing.
• Steigere die Interaktion mit Marke und Produkten. Füge einen Call to Action hinzu, damit Besucher zu einer bestimmten Seite deiner Webseite geleitet werden. Siehe Call to Action.

Remarketing

Über das Remarketing mit Video Ads können Werbetreibende bestimmte Custom Audiences aus organischen oder bezahlten Videos auf Facebook und Instagram ansprechen. Anhand dieses Features kannst du nicht nur die Bekanntheit steigern, sondern auch tiefer gehende Funnel-Ziele wie Affinität und Erwägung. Mehr dazu erfährst du unter Forschung: Kreative Kombinationen, die funktionieren.

Du benötigst Werbekundenberechtigung für die Seite, die ein Video enthält, um eine Zielgruppe für dieses Video zu erstellen.

Lege subtype=ENGAGEMENT für die Zielgruppe fest. Verfasse dann Regeln für die gewünschte Zielgruppe. Jede Regel hat eine object_id wie eine Video-ID und einen event_name. Der event_name ist einer der Folgenden:

• video_watched: Wie oft dein Video mindestens insgesamt 3 Sekunden oder fast komplett angesehen wurde, je nachdem, was zuerst eintritt.
• video_completed: Wie oft dein Video bis zu 95 % der Länge angesehen wurde, einschließlich Aufrufe, bei denen das Video bis zu diesem Punkt übersprungen wurde.
• video_view_10s: Wie oft dein Video mindestens insgesamt 10 Sekunden oder fast komplett angesehen wurde, je nachdem, was zuerst eintritt.
• video_view_15s: Wie oft dein Video mindestens insgesamt 15 Sekunden oder fast komplett angesehen wurde, je nachdem, was zuerst eintritt.
• video_view_25_percent: Wie oft dein Video bis zu 25 % der Länge angesehen wurde, einschließlich Aufrufe, bei denen das Video bis zu diesem Punkt übersprungen wurde.
• video_view_50_percent: Wie oft dein Video bis zu 50 % der Länge angesehen wurde, einschließlich Aufrufe, bei denen das Video bis zu diesem Punkt übersprungen wurde.
• video_view_75_percent: Wie oft dein Video bis zu 75 % der Länge angesehen wurde, einschließlich Aufrufe, bei denen das Video bis zu diesem Punkt übersprungen wurde.

Du kannst Videos kombinieren, um eine Zielgruppe basierend auf verschiedenen Videos und Handlungen zu erstellen. Eine Zielgruppe könnte beispielsweise Aufrufe von 3 Sekunden von Video A und vollständige Aufrufe von Videos B und C enthalten.

So erstellst du eine Zielgruppe aus den vergangenen 14 Tagen mit Videoaufrufen von mehr als 3 Sekunden von Video 1 und vollständigen Videoaufrufen von Video 2. Die Zielgruppe bietet außerdem automatische Ausfüllung für Betrachter vor der Zielgruppenerstellung mit prefill=true.

curl \
  -F 'name=Video Ads Engagement Audience' \
  -F 'subtype=ENGAGEMENT' \
  -F 'description=Users who watched my video' \
  -F 'prefill=1' \
  -F 'rule=[ 
  {"object_id":"%video_id_1","event_name":"video_watched"}, 
  {"object_id":"%video_id_2","event_name":"video_completed"} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences
  
Open In Graph API Explorer

Backfill unterstützt für Videoaufrufe nach dem 16. Oktober 2015.

Call-to-Action

Videos mit Call to Action (CTA) fordern Betrachter auf, mehr Infos anzuzeigen und eine bestimmte Seite auf einer Webseite zu besuchen. Verbessere die Performance, wenn dein primäres Ziel die Steigerung von Videoaufrufen oder Markenbekanntheit ist und dein sekundäres Ziel die Steigerung von Offsite-Klicks. Für Letzteres solltest du eine Video Link Ad verwenden. So werden CTAs angezeigt:

• Auf Mobilgeräten und Desktops erscheinen sie als Teil des Beitrags. Wenn das Video angehalten wird, erscheint der CTA neben der Option zum Fortsetzen.
• Wenn jemand auf einem Mobilgerät auf ein Video klickt, um es im Vollbildmodus anzusehen, erscheint ein schwebender CTA als Video-Overlay.
• Beiträge mit Links zu externen Videos enthalten keine CTAs.

Du kannst Videos mit CTAs nur mit den folgenden Kampagnenzielen verwenden:

• PAGE_LIKES
• LEAD_GENERATION
• LOCAL_AWARENESS
• LINK_CLICKS
• CONVERSIONS
• APP_INSTALLS
• VIDEO_VIEWS
• BRAND_AWARENESS
• Interaktion mit der mobilen App

Mehr dazu erfährst du unter Videoerweiterung auf zusätzliche Ziele. So erstellst du eine Video Ad mit dem Call to Action GET_DIRECTIONS:

curl \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": { 
  "call_to_action": { 
  "type": "GET_DIRECTIONS", 
  "value": { 
  "link": "fbgeo:\/\/37.48327, -122.15033, \"1601 Willow Rd Menlo Park CA\"" 
  } 
  }, 
  "image_url": "<THUMBNAIL_URL>", 
  "link_description": "Come check out our new store in Menlo Park!", 
  "video_id": "<VIDEO_ID>" 
  } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
   https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Videokennzahlen

Insights zu Videobeiträgen, Organisch

Erfahre mehr über die Performance deiner Videos auf Facebook und treffe fundierte Entscheidungen zum Video-Content. Derzeit bieten wir nur Kennzahlen an, wenn jemand damit beginnt, Videos anzusehen. Diese Zahlen umfassen Videoaufrufe, einmalige Videoaufrufe, die durchschnittliche Dauer des Videoaufrufs und die Zielgruppenbindung. Finde heraus, an welcher Stelle Betrachter deine Videos abbrechen und welche Teile besonders gut ankommen.

Video Ad-Insights, Bezahlt

Verwende die Ad Insights API. Die Antwort enthält verschiedene Videokennzahlen.

Videoart

Rufe Video Ad-Statistiken gruppiert nach Videoart ab wie Autoplay, Click-to-Play. Nimm action_video_type in action_breakdowns auf. Die erwarteten Werte für action_video_type lauten total, click_to_play und auto_play.

Wir testen die action_video_type-Option momentan in einer eingeschränkten Version. Um Kunden mit der Aufschlüsselung zu identifizieren, prüfe CAN_USE_VIDEO_METRICS_BREAKDOWN für das Werbekonto.

curl -G \
  -d 'action_breakdowns=action_video_type' \
  -d 'date_preset=last_30_days' \
  -d 'fields=actions,video_avg_pct_watched_actions,video_complete_watched_actions' \
  -d 'access_token= <ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
   
Open In Graph API Explorer

Die Antwort enthält Objekte mit action_type als video_view sowie mit dem Schlüssel action_video_type:

{
  "data": [
    {
      "actions": [
        ...
        {
          "action_type": "video_play", 
          "value": 9898
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 921129
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 915971
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 5158
        }
      ], 
      "video_avg_pct_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 60.59
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 60.47
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 80.63
        }
      ], 
      "video_complete_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 156372
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 154015
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 2357
        }
      ], 
      "date_start": "2014-12-26", 
      "date_stop": "2015-03-25"
    }
  ], 
  "paging": {
    "cursors": {
      "before": "MA==", 
      "after": "MA=="
    }
  }
}

Mehr dazu erfährst du unter Ad Insights API

Carousel Ads

Lasse deiner Kreativität im Feed freien Lauf und leite Besucher zur Conversion zu deiner Webseite oder deinen mobilen App um. Du erstellst eine Carousel Ad auf zwei Arten:

• Erstelle eine Werbeanzeige und einen unveröffentlichten Seitenbeitrag in einem Aufruf: Ad Creative API.
• Erstelle einen unveröffentlichten Seitenbeitrag und dann eine Anzeigengestaltung mit dem Beitrag (nicht für Video-Karussell verfügbar).

Carousel Ads werden für Facebook Stories nicht unterstützt.

Inline erstellen

Erstelle einen Carousel Ad-Seitenbeitrag beim Erstellen einer Anzeigengestaltung. Gib den Inhalt des Seitenbeitrags in object_story_spec an. Dadurch wird ein unveröffentlichter Seitenbeitrag aus adcreatives erstellt. Siehe Gestaltung der Werbeanzeige. Zum Beispiel:

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "child_attachments": [ 
        { 
          "description": "$8.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product1", 
          "name": "Product 1", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$9.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product2", 
          "name": "Product 2", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$10.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product3", 
          "name": "Product 3" 
        } 
      ], 
      "link": "<URL>" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Die Antwort ist eine Anzeigengestaltungs-ID:

{"id":"<CREATIVE_ID>"}

Erst Beitrag und dann Werbeanzeige erstellen

Erstelle einen unveröffentlichten Seitenbeitrag. child_attachments ist ein Array mit Linkobjekten. In jedem Linkobjekt sind picture, name und description optional. Du kannst diese Beiträge nur mit einem Seiten-Zugriffsschlüssel im Namen der Seite posten.

curl -X GET \
  -d 'message="Browse our latest products"' \
  -d 'published=0' \
  -d 'child_attachments=[
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 1",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 2",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 3",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 4",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       }
     ]' \
  -d 'caption="WWW.EXAMPLE.COM"' \
  -d 'link="http://www.example.com/products"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/posts
  
Open In Graph API Explorer

Stelle dann eine Anzeigengestaltung mit dem unveröffentlichten Seitenbeitrag bereit. Verwende die id für die object_story_id in deiner Anzeigengestaltung.

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Video Carousel Ad erstellen

Video Carousel Ads können einen „caption“-Wert im untergeordneten Anhang aufweisen, um die Anzeige-URL auf dem Endbildschirm anzupassen:

"child_attachments": [
 {
   "link": "https://www.facebookmarketingdevelopers.com/",
   "name": "Facebook Marketing Developers",
   "description": "Facebook Marketing Developers",
   "call_to_action": {
     "type": "APPLY_NOW",
     "value": {
      "link_title": "Facebook Marketing Developers"
     }
   },
   "video_id": "123",
   "caption": "mycustomlinkcaption.com"
  },
]

Um Details zum untergeordneten Anhang abzurufen, verwende die ID und rufe Graph API, Video, Referenz auf.

Mobile App Ad erstellen

Einschränkungen:

• Carousel Mobile App Ads unterstützen nur eine App
• Es sind mindestens 3 Bilder erforderlich und nicht 2 wie bei anderen Anzeigen als App Ad Carousel Ads
• Carousel Mobile App Ads müssen einen Call to Action aufweisen
• Die Endkarte, die in der Regel das Profilbild der Seite anzeigt, erscheint bei Carousel Mobile App Ads nicht. Beachte, dass du denselben App Store-Link in jedem child_attachment angeben solltest. Du musst den Link in call_to_action:{'value':{'link':... }}} nicht erneut angeben.

So erstellst du beispielsweise eine Carousel Ad für mobile App-Installationen:

\

curl -X POST \
  -F 'name="Carousel app ad"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "message": "My message",
         "link": "http://www.example.com/appstoreurl",
         "caption": "WWW.ITUNES.COM",
         "name": "The link name",
         "description": "The link description",
         "child_attachments": [
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           }
         ],
         "multi_share_optimized": true
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Du kannst deinen Beitrag nur über die Facebook-Seite veröffentlichen, die mit der mobilen App verknüpft ist. Außerdem musst du einen Seiten-Zugriffsschlüssel verwenden.

curl \
  -F 'message=My description' \
  -F 'link=<APP_STORE_URL>' \
  -F 'caption=WWW.ITUNES.COM' \
  -F 'child_attachments=[ 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    } 
  ]' \
  -F 'multi_share_optimized=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<PAGE_ID>/feed

Erstelle die AdCreative mit der id aus der Antwort:

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Feldspezifikation

Diese Carousel Ad auf iOS zeigt, wie die beschriebenen Felder genutzt werden.

Anzeigenstatistiken pro Produkt

Gruppiere Handlungen für Carousel Ads nach den einzelnen Produkten mit actions_breakdown=['action_carousel_card_id', 'action_carousel_card_name']. Jeder child_attachment hat eine eigene Karten-ID. action_carousel_card_id und action_carousel_card_name sind nur für Carousel Ads vorgesehen.

Rufe die folgenden Statistiken pro Karte ab:

• website_ctr: verfügbar bei Angabe von fields=['website_ctr']
• app_install, app_use, apps.uses, credit_spent, mobile_app_install, tab_view, link_click, mobile_app_install, app_custom_event.*, offsite_conversion.*: verfügbar bei Angabe von fields=['actions']. Andere Handlungen sind bei der Aufschlüsselung von Karten nicht verfügbar.

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_id"]' \
  -d 'level=ad' \
  -d 'date_preset=last_30_days' \
  -d 'time_increment=all_days' \
  -d 'breakdowns=placement' \
  --data-urlencode 'filtering=[ 
    { 
      "field": "action_type", 
      "operator": "IN", 
      "value": ["link_click"] 
    } 
  ]' \
  -d 'fields=impressions,inline_link_clicks,actions,website_ctr' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

Antwort:

{
...
   "website_ctr": [
      {
         "action_carousel_card_id": "1",
         "action_type": "link_click",
         "value": 51.401869158878
      },
      {
         "action_carousel_card_id": "2",
         "action_type": "link_click",
         "value": 50.980392156863
      }
   ],
   "placement": "mobile_feed",
   "date_start": "2015-05-25",
   "date_stop": "2015-05-28"
}

Du kannst auch cost_per_action_type anfragen, um eine Aufschlüsselung der Kosten nach Handlungsart abzurufen:

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_name"]' \
  -d 'level=ad' \
  -d 'breakdowns=placement' \
  -d 'fields=impressions,campaign_name,cost_per_action_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

Beispielantwort:

{
   "data": [
      {
         "impressions": "1862555",
         "campaign_name": "My Campaign",
         "cost_per_action_type": [
            {
               "action_carousel_card_name": "My Carousel Card 1",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.093347346315861
            },
            {
               "action_carousel_card_name": "My Carousel Card 2",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.38324089579301
            },
            ...
         ],
      }
   ]
}

Platzierungen

Wenn du nur right_hand_column als Platzierung auswählst, kannst du lediglich das Format „Einzelnes Video“ oder das Carousel-Format in deiner Anzeigengruppe verwenden. Das Videoformat wird nicht unterstützt, wenn nur die right_hand_column-Platzierung gewählt wird. Mehr dazu erfährst du unter Erweiterte Optionen für Targeting und Platzierung.

Erstelle zum Beispiel eine Anzeigengruppe mit right_hand_column als einzige Platzierung:

curl \
  -F 'name=RHS only Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2017-11-21T15:41:36+0000' \
  -F 'end_time=2017-11-28T15:41:36+0000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
    "device_platforms": ["mobile"], 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook"] ,
    "facebook_positions": ["right_hand_column"] ,  
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets
  
Open In Graph API Explorer

Gib eine Anzeigengestaltung mit einem Video an:

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Du kannst auch ein Canvas-Anzeigenformat für die Anzeigengestaltung angeben:

curl \
  -F 'image_hash=<IMAGE_HASH>' \
  -F 'object_story_spec={ 
    "link_data": { 
      "call_to_action": {"type":"LEARN_MORE"}, 
      "image_hash": "<IMAGE_HASH>", 
      "link": "CANVAS_LINK", 
      "name": "Creative message" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Versuche, eine Werbeanzeige mit der Anzeigengruppe und der Anzeigengestaltung zu erstellen:

curl \
  -F 'name=My Ad' \
  -F 'adset_id=<AD_SET_ID>' \
  -F 'creative={"creative_id":"<CREATIVE_ID>"}' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

Falls du einen Fehlercode erhältst, solltest du eine unterstützte Werbeanzeige bereitstellen oder dein Targeting ändern.

Siehe auch

• Leitfaden zum Hochladen von Videos auf Facebook
• Carousel für Mobile App Ads
• Graph API-Referenz für Seiten-Feed
• Unveröffentlichte Seitenbeiträge
• Anzeigengestaltung
• Instagram Carousel Ads