基本的なターゲット設定には以下が含まれます。
住宅広告、雇用広告、クレジット広告、問題広告、選挙広告、政治広告を掲載している米国拠点の広告主、または米国をターゲットに設定した広告を掲載している広告主には、異なる制限があります。
ターゲット設定検索から基本的な利用者層データと位置ベースのターゲットデータを取得してターゲット設定を定義してから、targeting
仕様のオプションを指定します。この仕様には、広告を見る人を定義する広告セット属性が含まれています。
注:カスタムオーディエンスを使用している場合を除き、ターゲット設定で1つ以上の国を指定する必要があります。
curl -X POST \ -F 'name=My AdSet' \ -F 'optimization_goal=REACH' \ -F 'billing_event=IMPRESSIONS' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id=<CAMPAIGN_ID>' \ -F 'targeting={ "geo_locations": {"countries":["US"]}, "industries": [{"id":6009003307783,"name":"Accounting and finance"}], "life_events": [{"id":6003054185372,"name":"Recently Moved"}], "relationship_statuses": [2,4] }' \ -F 'status=ACTIVE' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0
/act_<AD_ACCOUNT_ID>/adsets
名前 | 説明 |
---|---|
| ターゲットに設定する性別。デフォルトはすべて。 |
| 最低年齢。デフォルトは18。使用する場合、13以上である必要があります。アプリに独自の年齢制限がある場合、アプリの年齢制限はAPP_INSTALL目標の広告に使用されます。例えば、 |
| 最高年齢。使用する場合、65以下である必要があります。 |
ターゲット設定検索で、ターゲット地域の値を検索して取得できます。このターゲット設定には、地域をターゲットにするためのgeo_locations
と、エリアを除外するためのexcluded_geo_locations
(任意)の2つのパラメーターが含まれます。
geo_locations
にcountry_groups
を使うと、ヨーロッパや北米などのより広い地域をターゲットとすることができます。
Using radius
can cause an error, code: 100, subcode 1815946, when targeting multiple locations. We recommend creating an ad for each location or not using radius
in your call.
名前 | 説明 |
---|---|
| 国のターゲット設定。国コードの配列が必要。ターゲット設定検索、国を参照してください。 |
| 州、都道府県、または地域。使用可能な値については、ターゲット設定検索、地域を参照してください。上限:200。 |
|
|
| 郵便番号のターゲット設定については、ターゲット設定検索APIを参照してください。上限: 50,000 (以前は2,500)。2,500を超えて指定すると、一連の郵便番号を表す、
|
| 特定の場所を指定します。上限: 200。 |
| すべての目的で利用できます。地域の中心として、正確な位置情報を緯度と経度、または住所で指定します。位置情報の半径を、0.63から50マイル、または1から80キロメートルの範囲で指定します。 |
| 位置情報の緯度 |
| 位置情報の経度 |
| 住所の名前。地理的所在地のターゲット設定の |
| 緯度/経度を中心とした半径、 |
| 任意。
|
| 緯度/経度の住所、例: 1601 Willow Rd, Menlo Park, CA。推奨形式: ストリート番号、ストリート名、都市、州/都道府県、国。郵便番号は不要です。 |
| DMAやComscore Marketsを使用したジオマーケット。上限: 2500。 |
| 選挙区のキー。ターゲット設定検索、選挙で選挙区を取得します。 |
| 配列
|
| 世界の地理的地域と、自由貿易地域。ターゲット設置検索、国グループを参照してください。 国グループコードの配列を指定します。
例: |
curl -X POST \ -F 'name="My Reach Ad Set"' \ -F 'optimization_goal="REACH"' \ -F 'billing_event="IMPRESSIONS"' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id="<AD_CAMPAIGN_ID>"' \ -F 'targeting={ "geo_locations": { "countries": [ "US" ] }, "facebook_positions": [ "feed" ] }' \ -F 'status="PAUSED"' \ -F 'promoted_object={ "page_id": "<PAGE_ID>" }' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/act_<AD_ACCOUNT_ID>/adsets
curl -X POST \ -F 'name="My Reach Ad Set"' \ -F 'optimization_goal="REACH"' \ -F 'billing_event="IMPRESSIONS"' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id="<AD_CAMPAIGN_ID>"' \ -F 'targeting={ "excluded_geo_locations": { "regions": [ { "key": "3847" } ] }, "geo_locations": { "countries": [ "US" ] }, "facebook_positions": [ "feed" ] }' \ -F 'status="PAUSED"' \ -F 'promoted_object={ "page_id": "<PAGE_ID>" }' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0
/act_<AD_ACCOUNT_ID>/adsets
curl -X POST \ -F 'name=My AdSet' \ -F 'optimization_goal=REACH' \ -F 'billing_event=IMPRESSIONS' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id=<CAMPAIGN_ID>' \ -F 'targeting={ "geo_locations":{ "zips":[{"key":"US:94304"},{"key":"US:00501"}]} }' \ -F 'status=ACTIVE' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0
/act_<AD_ACCOUNT_ID>/adsets
次のコードは、以下のターゲット設定を行います。
curl -X POST \ -F 'name=My AdSet' \ -F 'optimization_goal=REACH' \ -F 'billing_event=IMPRESSIONS' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id=<CAMPAIGN_ID>' \ -F 'targeting={ "geo_locations": { "custom_locations": [ {"address_string":"1601 Willow Road, Menlo Park, CA","radius":"5"}, { "latitude": "36", "longitude": "-121.0", "radius": "5", "distance_unit": "kilometer" } ], "geo_markets": [ {"key":"DMA:501","name":"New York"}, {"key":"DMA:543","name":"Springfield-Holyoke"}, {"key":"COMSCORE_MARKET:2001","name":"New York, NY"}, {"key":"COMSCORE_MARKET:2051","name":"New Orleans, LA"} ], "location_types": ["recent","home"] } }' \ -F 'status=ACTIVE' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0
/act_<AD_ACCOUNT_ID>/adsets
カリフォルニア州メンローパークから10マイル以内またはテキサスもしくは日本に住んでいる20〜24歳の男性をターゲットとして設定するには、次のようにします。
まず日本の国コードを取得します。
curl -G \ -d 'location_types=["country"]' \ -d 'type=adgeolocation' \ -d 'q=japan' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0
/search
テキサスの地域コードを取得します。
curl -G \ -d 'location_types=["region"]' \ -d 'type=adgeolocation' \ -d 'q=texas' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0
/search
カリフォルニア州メンローパークの都市コードを検索します。
curl -G \ -d 'location_types=["city"]' \ -d 'type=adgeolocation' \ -d 'q=menlo' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0
/search
genders
と、年齢をage_min
およびage_max
で指定します。
国、地域、都市コードを使ったターゲット仕様が整いました。
curl \ -F 'name=My First AdSet' \ -F 'daily_budget=10000' \ -F 'bid_amount=300' \ -F 'billing_event=IMPRESSIONS' \ -F 'optimization_goal=REACH' \ -F 'campaign_id=<CAMPAIGN_ID>' \ -F 'promoted_object={"page_id":"<PAGE_ID>"}' \ -F 'targeting={ "age_max": 24, "age_min": 20, "device_platforms": ["mobile"], "genders": [1], "geo_locations": { "countries": ["JP"], "regions": [{"key":"3886"}], "cities": [ { "key": "2420605", "radius": 10, "distance_unit": "mile" } ] }, "publisher_platforms": ["facebook","audience_network"] }' \ -F 'status=PAUSED' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0
/act_<AD_ACCOUNT_ID>/adsets
custom_type
をmulti_city
に設定し、country
またはcountry_group
を前述のように定義します。
curl \ -F 'name=My AdSet' \ -F 'optimization_goal=REACH' \ -F 'billing_event=IMPRESSIONS' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id=<CAMPAIGN_ID>' \ -F 'targeting={ "geo_locations": { "custom_locations": [ { "custom_type": "multi_city", "min_population": 500000, "max_population": 1000000, "country": "BR" }, {"custom_type":"multi_city","country_group":"Europe"} ], "location_types": ["recent","home"] } }' \ -F 'status=ACTIVE' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0
/act_<AD_ACCOUNT_ID>/adsets
名前 | 説明 |
---|---|
| 都市をターゲット設定に含めるための、人口の最小閾値。 |
| 都市をターゲット設定に含めるための、人口の最大閾値。 |
利用者のタイムライン、「いいね!」したページ、ページと関連付けられたキーワードまたは使用しているアプリからの興味・関心に基づいてターゲットを設定します。ターゲット設定検索、興味・関心を参照してください。
サッカーに興味がある利用者をターゲットとして設定するには、まず次のクエリを実行します。
curl -G \ -d 'type=adinterest' \ -d 'q=soccer' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0
/search
この興味・関心をname
とid
を使ってターゲット仕様に追加します。path
は、広告ツール内のこの興味・関心のパスです。
curl -X POST \ -F 'name="My First AdSet"' \ -F 'daily_budget=10000' \ -F 'bid_amount=300' \ -F 'billing_event="IMPRESSIONS"' \ -F 'optimization_goal="REACH"' \ -F 'campaign_id="<CAMPAIGN_ID>"' \ -F 'promoted_object={ "page_id": "<PAGE_ID>" }' \ -F 'targeting={ "facebook_positions": [ "feed" ], "geo_locations": { "countries": [ "US" ], "regions": [ { "key": "4081" } ], "cities": [ { "key": 777934, "radius": 10, "distance_unit": "mile" } ] }, "genders": [ 1 ], "age_max": 24, "age_min": 20, "publisher_platforms": [ "facebook", "audience_network" ], "device_platforms": [ "mobile" ], "flexible_spec": [ { "interests": [ { "id": "<INTEREST_ID>", "name": "<INTEREST_NAME>" } ] } ] }' \ -F 'status="PAUSED"' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0
/act_<AD_ACCOUNT_ID>/adsets
別の例を示します。
curl \ -F 'name=My AdSet' \ -F 'optimization_goal=REACH' \ -F 'billing_event=IMPRESSIONS' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id=<CAMPAIGN_ID>' \ -F 'targeting={ "geo_locations": {"countries":["US"]}, "interests": [ {"id":6003139266461,"name":"Movies"}, {"id":6003397425735,"name":"Tennis"}, {"id":6003659420716,"name":"Cooking"} ] }' \ -F 'status=ACTIVE' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0
/act_<AD_ACCOUNT_ID>/adsets
名前 | 説明 |
---|---|
|
|
デジタルアクティビティ、利用者が使用するデバイス、過去の購入または購入意図、および旅行に基づいて、ターゲットを設定します。「よく旅行する」などの、Browse
のオプションを表示します。ターゲット設定検索APIをご覧ください。
curl -G \ -d 'type=adTargetingCategory' \ -d 'class=behaviors' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0
/search
次のように、行動をtargeting
仕様に追加します。
curl \ -F 'name=My First AdSet' \ -F 'daily_budget=10000' \ -F 'bid_amount=300' \ -F 'billing_event=IMPRESSIONS' \ -F 'optimization_goal=REACH' \ -F 'campaign_id=<CAMPAIGN_ID>' \ -F 'promoted_object={"page_id":"<PAGE_ID>"}' \ -F 'targeting={ "age_max": 24, "age_min": 20, "behaviors": [{"id":6002714895372,"name":"All frequent travelers"}], "device_platforms": ["mobile"], "genders": [1], "geo_locations": { "countries": ["JP"], "regions": [{"key":"3886"}], "cities": [ { "key": "2420605", "radius": 10, "distance_unit": "mile" } ] }, "interests": [{"id":6003107902433,"name":"Association football (Soccer)"}], "publisher_platforms": ["facebook","audience_network"] }' \ -F 'status=PAUSED' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0
/act_<AD_ACCOUNT_ID>/adsets
別の例を示します。
curl -X POST \ -F 'name="My AdSet"' \ -F 'optimization_goal="REACH"' \ -F 'billing_event="IMPRESSIONS"' \ -F 'bid_amount=2' \ -F 'daily_budget=1000' \ -F 'campaign_id="<CAMPAIGN_ID>"' \ -F 'targeting={ "facebook_positions": [ "feed" ], "geo_locations": { "countries": [ "US" ] }, "behaviors": [ { "id": 6007101597783, "name": "Business Travelers" }, { "id": 6004386044572, "name": "Android Owners (All)" } ] }' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0
/act_<AD_ACCOUNT_ID>/adsets
名前 | 説明 |
---|---|
|
|
他のターゲット設定