Marketing API

Call Ads

In diesem Leitfaden wird erläutert, wie du mithilfe der Marketing API von Meta Call Ads erstellen und veröffentlichen kannst.

Bevor du beginnst

Voraussetzungen für diesen Leitfaden:

Um erfolgreiche Aufrufe an alle Endpunkte zu tätigen, benötigst du Folgendes:

  • Einen Seiten-Zugriffsschlüssel, der von einer Person angefordert wurde, die auf der Seite die ADVERTIZE-Aufgabe ausführen kann.
  • Einer Person, die deine App nutzt, müssen die folgenden Berechtigungen gewährt werden:
    • ads_management
    • pages_manage_ads
    • pages_read_engagement
    • pages_show_list

Empfehlungen

Stelle sicher, dass du die Öffnungszeiten deines Unternehmens in den Einstellungen deiner Facebook-Seite angibst.

Wenn du einen API-Aufruf testest, kannst du den access_token-Parameter einbeziehen, der auf deinen Zugriffsschlüssel festgelegt ist. Wenn du jedoch sichere Aufrufe über deine App ausführst, verwende die Klasse des Zugriffsschlüssels.

Einschränkungen

  • Das Zielpublikum muss mindestens 18 Jahre alt sein
  • Die im Call-to-Action enthaltene Telefonnummer muss dem Land der Zielgruppe entsprechen

Schritt 1: Erstelle eine Kampagne

Um deine Werbekampagne zu erstellen, sendest du eine POST-Anfrage an den act_ad_account_id/campaigns-Endpunkt, wobei ad_account_id die ID für dein Meta-Werbekonto ist. Deine Anfrage muss Folgendes enthalten:

  • name
  • objective – festgelegt auf eines der folgenden unterstützten Ziele:
    • OUTCOME_AWARENESS
    • OUTCOME_ENGAGEMENT
    • OUTCOME_LEADS
    • OUTCOME_SALES
    • OUTCOME_TRAFFIC
  • special_ad_categories

Beispielanfrage

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie ad_account_id mit deinen Werten.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "name":"Call_ad_campaign_name",
           "objective":"OUTCOME_TRAFFIC",
           "special_ad_categories":["NONE"],
         }'

Bei Erfolg erhält deine App eine JSON-Antwort mit der ID deiner Kampagne.

{
  "id": "campaign_id"
}

Schritt 2: Anzeigengruppe erstellen

Um eine Anzeigengruppe zu erstellen, sendest du eine POST-Anfrage an den act_ad_account_id/adsets-Endpunkt, wobei ad_account_id die ID für dein Meta-Werbekonto ist. Deine Anfrage muss Folgendes enthalten:

  • bid_amount
  • billing_event festgelegt auf IMPRESSIONS
  • campaign_id
  • daily_budget
  • destination_type festgelegt auf PHONE_CALL
  • name
  • optimization_goal festgelegt auf QUALITY_CALL für Call Ads
  • targeting

Beispielanfrage

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie ad_account_id mit deinen Werten.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/adsets"
     -H "Content-Type: application/json" 
     -d '{
           "bid_amount":"Your_bid_amount",
           "billing_event":"IMPRESSIONS",
           "campaign_id":"Your_campaign_id",
           "daily_budget":"Your_daily_budget",
           "destination_type":"PHONE_CALL",
           "name:"Your_call_adset_name",
           "optimization_goal":"QUALITY_CALL",
           "targeting":{ 
             "geo_locations": { "countries":["US","CA"] },
             "device_platforms": ["mobile"],
             "publisher_platforms": ["facebook"] 
           } 
         }'

Bei Erfolg erhält deine App die folgende JSON-Antwort mit der Anzeigengruppen-ID.

{
  "id": "adset_id"
}

Schritt 3: Anzeigengestaltung erstellen

Die Anzeigengestaltung ermöglicht das Hinzufügen von Assets zu deinen Anzeigen. Es werden Carousel, Bild, Video und Anzeigengestaltungen, die nur Text enthalten, unterstützt.

Um eine Anzeigengestaltung zu erstellen, sendest du eine POST-Anfrage an den /act_ad_account_id/adcreatives-Endpunkt, wobei ad_account_id die ID für dein Meta-Werbekonto ist. Deine Anfrage muss Folgendes enthalten:

  • name
  • object_story_spec
  • object_story_spec mit einem link_data-Objekt, das den call_to_action definiert mit type festgelegt auf CALL_NOW und value als die Telefonnummer für dein Unternehmen

Beispielanfrage für Image Ads

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie page_access_token durch deine Werte.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/adcreatives"
     -H "Content-Type: application/json" 
     -d '{
           "name":"Your_call_image_ad_name",
           "object_story_spec":{
             "page_id": "your_page_id",
             "link_data": {
               "picture": "Your_image_URL", 
               "link": "Your_business_page_URL", 
               "call_to_action": {
                 "type":"CALL_NOW",
                 "value":{ "link":"tel:+Your_business_phone_number_with_country_code" }
               }   
             }
           }
         }'

Bei Erfolg erhält deine App die folgende JSON-Antwort mit der Anzeigengestaltungs-ID.

{
  "id": "ad_creative_id"
}

Schritt 4: Werbeanzeige erstellen

Um die Anzeige zu erstellen, musst du die Anzeigengestaltung der Anzeigengruppe zuordnen. Um die Anzeige zu erstellen, sendest du eine POST-Anfrage an den /act_ad_account_id/ads-Endpunkt, wobei ad_account_id die ID für dein Meta-Werbekonto ist. Deine Anfrage muss Folgendes enthalten:

Beispielanfrage für eine Anzeige mit Anzeigengestaltung

Für Lesbarkeit formatiert. Ersetze Werte in Fett- oder Kursivschrift wie ad_account_id mit deinen Werten.
curl -X POST "https://graph.facebook.com/v21.0/act_ad_account_id/ads"
     -H "Content-Type: application/json" 
     -d '{

           "adset_id": "Your_ad_set_id",
           "creative": { "creative_id": "Your_ad_creative_id" },
           "status": "PAUSED"
         }'

Bei Erfolg erhält deine App die folgende JSON-Antwort mit der Anzeigen-ID.

{
  "id": "ad_id"
}

Nächste Schritte

Sieh dir den Leitfaden für die ersten Schritte an, um zu erfahren, wie du deine Anzeige zum Review übermittelst.

Mehr dazu

Weitere Informationen über die Marketing API und weitere Optionen für Call Ads.

Hilfebereich für Unternehmen

Marketing API