MetaのマーケティングAPIからの電話発信広告

このガイドでは、MetaのマーケティングAPIを使用して電話発信広告を作成し公開する方法について説明します。

広告の作成の概要

広告を作成して公開するには以下を行います。

  1. 広告キャンペーンを作成する
  2. 広告を広告キャンペーンにリンクする広告セットを作成する
  3. 電話発信広告の広告クリエイティブを作成する
  4. 広告クリエイティブを広告セットにリンクして広告を作成する
  5. FacebookとInstagramに広告を公開する

開始する前に

このガイドは、以下を前提としています。

このガイドのエンドポイントのどれについても、その呼び出しが成功するためには以下が必要です。

  • ページでADVERTIZEタスクを実行できる人がリクエストしたページアクセストークン
  • アプリを使っている人に以下のアクセス許可が付与されていなければなりません。
    • ads_management
    • pages_manage_ads
    • pages_read_engagement
    • pages_show_list

推奨事項

Facebookページ設定でビジネスの営業時間を必ず設定してください

API呼び出しをテストする場合は、自分のアクセストークンに設定したaccess_tokenパラメーターを含めることができます。ただし、アプリから安全な呼び出しを行う場合は、アクセストークンクラスを使用してください。

制限

  • ターゲットオーディエンスは18歳以上である必要があります
  • コールトゥーアクションに含まれる電話番号はターゲットオーディエンスと同じ国である必要があります

ステップ1. キャンペーンを作成する

広告キャンペーンを作成するには、POSTリクエストをact_ad_account_id/campaignsエンドポイントに送信します。このad_account_idは、Meta広告アカウントのIDです。リクエストには以下を含める必要があります。

  • name
  • objective – 次のサポートされているオブジェクトのいずれかに設定します。
    • OUTCOME_AWARENESS
    • OUTCOME_ENGAGEMENT
    • OUTCOME_LEADS
    • OUTCOME_SALES
    • OUTCOME_TRAFFIC
  • special_ad_categories

リクエストの例

読みやすくするためにフォーマットしています。ad_account_idのように、太字でイタリックになっている値は、実際の値に置き換えてください。
curl -X POST "https://graph.facebook.com/v19.0/act_ad_account_id/campaigns" \
     -H "Content-Type: application/json" \
     -d '{
           "name":"Call_ad_campaign_name",
           "objective":"OUTCOME_TRAFFIC",
           "special_ad_categories":["NONE"],
         }'

成功すると、アプリはキャンペーンのIDを含むJSONの応答を受け取ります。

{
  "id": "campaign_id"
}

ステップ2. 広告セットを作成する

広告セットを作成するには、act_ad_account_id/adsetsエンドポイントに対してPOSTリクエストを送信します。このエンドポイントにあるad_account_idは、Meta広告アカウントのIDです。リクエストには以下を含める必要があります。

  • bid_amount
  • IMPRESSIONSに設定したbilling_event
  • campaign_id
  • daily_budget
  • PHONE_CALLに設定したdestination_type
  • name
  • 電話発信広告用にQUALITY_CALLに設定したoptimization_goal
  • targeting

リクエストの例

読みやすくするためにフォーマットしています。ad_account_idのように、太字でイタリックになっている値は、実際の値に置き換えてください。
curl -X POST "https://graph.facebook.com/v19.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"] 
           } 
         }'

成功すると、アプリは広告セットのIDを含む次のJSONの応答を受け取ります。

{
  "id": "adset_id"
}

ステップ3. 広告クリエイティブを作成する

広告クリエイティブを使用して、広告にアセットを追加することができます。カルーセル、画像、text0nly、動画の広告がサポートされています。

広告クリエイティブを作成するには、POSTリクエストを/act_ad_account_id/adcreativesエンドポイントに送信します。このad_account_idは、Meta広告アカウントのIDです。リクエストには以下を含める必要があります。

  • name
  • object_story_spec
  • object_story_speclink_dataオブジェクト。これはtypeCALL_NOWに設定されたcall_to_actionを定義します。valueはビジネスの電話番号です。

広告画像のリクエストの例

読みやすくするためにフォーマットしています。page_access_tokenのように、太字でイタリックになっている値は、実際の値に置き換えてください。
curl -X POST "https://graph.facebook.com/v19.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" }
               }   
             }
           }
         }'          

成功すると、アプリは広告クリエイティブのIDを含む次のJSONの応答を受け取ります。

{
  "id": "ad_creative_id"
}

ステップ4. 広告を作成する

広告を作成するために広告クリエイティブと広告セットを関連付ける必要があります。広告を作成するには、POSTリクエストを/act_ad_account_id/adsエンドポイントに送信します。このad_account_idは、Meta広告アカウントのIDです。リクエストには以下を含める必要があります。

クリエイティブ広告のリクエストの例

読みやすくするためにフォーマットしています。ad_account_idのように、太字でイタリックになっている値は、実際の値に置き換えてください。
curl -X POST "https://graph.facebook.com/v19.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"
         }'

成功すると、アプリは広告のIDを含む次のJSON応答を受け取ります。

{
  "id": "ad_id"
}

次のステップ

広告を審査に提出する方法については、スタートガイドをご覧ください。