このガイドでは、MetaのマーケティングAPIを使用して電話発信広告を作成し公開する方法について説明します。
このガイドは、以下のものがあることを前提としています。
このガイドのエンドポイントのどれについても、その呼び出しが成功するためには以下が必要です。
ADVERTIZE
タスクを実行できる人がリクエストしたページアクセストークンads_management
pages_manage_ads
pages_read_engagement
pages_show_list
Facebookページ設定でビジネスの営業時間を必ず設定してください
API呼び出しをテストする場合は、自分のアクセストークンに設定したaccess_token
パラメーターを含めることができます。ただし、アプリから安全な呼び出しを行う場合は、アクセストークンクラスを使用してください。
広告キャンペーンを作成するには、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
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"],
}'
成功すると、アプリはキャンペーンのIDを含むJSONの応答を受け取ります。
{ "id": "campaign_id" }
広告セットを作成するには、POST
リクエストをact_ad_account_id/adsets
エンドポイントに送信します。このad_account_idは、Meta広告アカウントのIDです。リクエストには以下を含める必要があります。
bid_amount
IMPRESSIONS
に設定したbilling_event
campaign_id
daily_budget
PHONE_CALL
に設定したdestination_type
name
QUALITY_CALL
に設定したoptimization_goal
targeting
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"]
}
}'
成功すると、アプリは広告セットのIDを含む次のJSONの応答を受け取ります。
{ "id": "adset_id" }
広告クリエイティブを使用して、広告にアセットを追加できます。カルーセル、画像、テキストのみ、動画の広告がサポートされています。
広告クリエイティブを作成するには、POST
リクエストを/act_ad_account_id/adcreatives
エンドポイントに送信します。このad_account_idは、Meta広告アカウントのIDです。リクエストには以下を含める必要があります。
name
object_story_spec
object_story_spec
とlink_data
オブジェクト。これはtype
がCALL_NOW
に設定されたcall_to_action
を定義します。value
はビジネスの電話番号です。
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" }
}
}
}
}'
成功すると、アプリは広告クリエイティブのIDを含む次のJSON応答を受け取ります。
{ "id": "ad_creative_id" }
広告を作成するには、広告クリエイティブと広告セットを関連付ける必要があります。広告を作成するには、POST
リクエストを/act_ad_account_id/ads
エンドポイントに送信します。このad_account_idは、Meta広告アカウントのIDです。リクエストには以下を含める必要があります。
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"
}'
成功すると、アプリは広告のIDを含む次のJSON応答を受け取ります。
{ "id": "ad_id" }
広告を審査に提出する方法については、スタートガイドをご覧ください。
マーケティングAPIについての詳細と電話発信広告の追加オプション。