基本ターゲット設定

基本的なターゲット設定には以下が含まれます。

住宅広告、雇用広告、クレジット広告、問題広告、選挙広告、政治広告を掲載している米国拠点の広告主、または米国をターゲットに設定した広告を掲載している広告主には、異なる制限があります。

利用者層データとイベント

ターゲット設定検索から基本的な利用者層データと位置ベースのターゲットデータを取得してターゲット設定を定義してから、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

フィールド

名前説明

genders

配列

ターゲットに設定する性別。デフォルトはすべて。1は男性をターゲットにし、2は女性をターゲットにします。

age_min

整数

最低年齢。デフォルトは18。使用する場合、13以上である必要があります。アプリに独自の年齢制限がある場合、アプリの年齢制限はAPP_INSTALL目標の広告に使用されます。例えば、age_minを13に設定していてもアプリの最低年齢が18に設定されている場合、広告のターゲット設定では18が使用されます。

age_max

整数

最高年齢。使用する場合、65以下である必要があります。

位置情報

ターゲット設定検索で、ターゲット地域の値を検索して取得できます。このターゲット設定には、地域をターゲットにするためのgeo_locationsと、エリアを除外するためのexcluded_geo_locations(任意)の2つのパラメーターが含まれます。

geo_locationscountry_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.

フィールド

名前説明

countries

配列

国のターゲット設定。国コードの配列が必要。ターゲット設定検索、国を参照してください。
: 'countries': ['US']

regions

配列

州、都道府県、または地域。使用可能な値については、ターゲット設定検索、地域を参照してください。上限:200。
: 'regions': [{'key':'3847'}]

cities

配列

keyradiusおよびdistance_unitを指定します。keyについては、ターゲット設定検索、都市を参照してください。radiusは都市の周囲の距離で、10から50マイルまたは17から80キロメートルを指定できます。distance_unitはマイルまたはキロメートルです。上限:250。
: 'cities': [{'key':'2430536', 'radius':12, 'distance_unit':'mile'}]

zips

配列

郵便番号のターゲット設定については、ターゲット設定検索APIを参照してください。上限: 50,000 (以前は2,500)。2,500を超えて指定すると、一連の郵便番号を表す、location_clusterと呼ばれる配列が作成されます。
: 'zips':[{'key':'US:94304'},{'key':'US:00501'}]

location_clusterを読み込み、ターゲットとされた地域を確認するには、GET /location_cluster_IDを実行します。

places

配列

特定の場所を指定します。上限: 200。
例:"places":[{"key":129672430416115,"name":"SFO", "radius":10, "distance_unit":"mile"}]

custom_locations

配列

すべての目的で利用できます。地域の中心として、正確な位置情報を緯度と経度、または住所で指定します。位置情報の半径を、0.63から50マイル、または1から80キロメートルの範囲で指定します。distance_unitはマイルまたはキロメートルです。デフォルトはマイルです。上限:200。私書箱のみの指定は、address_stringではサポートされていません。最低でも、住所を番地まで指定しなければなりません。
例:'custom_locations':[{'address_string': '1601 Willow Road, Menlo Park, CA', 'radius': 5},{'latitude': 36, 'longitude': -121.0, 'radius': 5, 'distance_unit': 'kilometer'},]

custom_locations.latitude

浮動小数点

位置情報の緯度

custom_locations.longitude

浮動小数点

位置情報の経度

custom_locations.name

文字列

住所の名前。地理的所在地のターゲット設定のlatitudelongitudeの値を、address_stringを指定せずに使うこともできます。

custom_locations.radius

浮動小数点

緯度/経度を中心とした半径、distance_unitで指定されていない限り、単位はマイルです。0.63から50マイル、または1から80キロメートルです。

custom_locations.distance_unit

文字列

任意。

kilometerまたはmile。デフォルトはmileです

custom_locations.address_string

文字列

緯度/経度の住所、例: 1601 Willow Rd, Menlo Park, CA。推奨形式: ストリート番号、ストリート名、都市、州/都道府県、国。郵便番号は不要です。

geo_markets

配列

DMAやComscore Marketsを使用したジオマーケット。上限: 2500。
例:'geo_markets':[{'key': 'DMA:501', 'name': 'New York'},{'key': COMSCORE_MARKET:2001', 'name': 'New York, NY'}, {'key': 'DMA:543', 'name': 'Springfield-Holyoke'},]

electoral_district

配列

選挙区のキー。ターゲット設定検索、選挙で選挙区を取得します。
: 'electoral_districts':[{'key':'US:AK00'},{'key':'US:CA01'},{'key':'US:NY14'}]

location_types

配列

配列['home', 'recent']が、利用可できる唯一のオプションです。location_types配列が指定されない場合、デフォルトで['home', 'recent']になります。

  • recent:モバイルデバイスデータから、最近の位置情報が選択されたエリア内であることが判明した人。位置情報の除外には使用できません。
  • home:Facebookプロフィールの「居住地」に指定した位置情報がエリア内にある人。Facebookは、IPと友達のプロフィールの位置情報によってこれを検証しています。

country_groups

配列

世界の地理的地域と、自由貿易地域。ターゲット設置検索、国グループを参照してください。

国グループコードの配列を指定します。

  • worldwide:世界。
  • africa:アフリカ。
  • afta:ASEAN自由貿易地域。
  • android_app_store: Androidアプリストアで有料アプリがサポートしている国。
  • android_free_store: Androidアプリストアで無料アプリがサポートしている国。
  • apec:アジア太平洋経済協力会議。
  • asia:アジア
  • caribbean:カリブ海地域。
  • central_america:中央アメリカ。
  • cisfta:独立国家共同体自由貿易地域。
  • eea:欧州経済地域。
  • emerging_markets: 新興成長市場の国々
  • europe:ヨーロッパ。
  • gcc:湾岸協力会議。
  • itunes_app_store: iTunesアプリストアでサポートされている国。
  • mercosur:南米南部共同市場。
  • nafta:北米自由貿易協定。
  • north_america:北アメリカ。
  • oceania:オセアニア。
  • south_america:南アメリカ。

: 'country_groups': ['asia','mercosur']

国によるターゲット設定

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

カスタム位置情報、ジオマーケット、位置情報タイプによるターゲット設定

次のコードは、以下のターゲット設定を行います。

  • カリフォルニア州メンローパーク市ウィローロード1601の周囲5マイル
  • 緯度36、経度-121.0の周囲5キロ
  • DMA 501と543、COMSCORE_MARKETS 2001と2054
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歳の男性をターゲットとして設定するには、次のようにします。

ステップ1

まず日本の国コードを取得します。

curl -G \ -d 'location_types=["country"]' \ -d 'type=adgeolocation' \ -d 'q=japan' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/search
ステップ2

テキサスの地域コードを取得します。

curl -G \ -d 'location_types=["region"]' \ -d 'type=adgeolocation' \ -d 'q=texas' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/search
ステップ3

カリフォルニア州メンローパークの都市コードを検索します。

curl -G \ -d 'location_types=["city"]' \ -d 'type=adgeolocation' \ -d 'q=menlo' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/search
ステップ4

gendersと、年齢をage_minおよびage_maxで指定します。

ステップ5

国、地域、都市コードを使ったターゲット仕様が整いました。

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_typemulti_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
パラメーター
名前 説明

min_population

整数

都市をターゲット設定に含めるための、人口の最小閾値。

max_population

整数

都市をターゲット設定に含めるための、人口の最大閾値。

興味・関心のターゲット設定

利用者のタイムライン、「いいね!」したページ、ページと関連付けられたキーワードまたは使用しているアプリからの興味・関心に基づいてターゲットを設定します。ターゲット設定検索、興味・関心を参照してください。

サッカーに興味がある利用者をターゲットとして設定するには、まず次のクエリを実行します。

curl -G \ -d 'type=adinterest' \ -d 'q=soccer' \ -d 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v24.0/search

この興味・関心をnameidを使ってターゲット仕様に追加します。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

フィールド

名前 説明

interests

配列

idフィールドと任意のnameフィールドを持つ配列:
'interests':[{id: 6003139266461, 'name': 'Movies'}, {id: 6003139266462}, 6003139266463]

行動のターゲット設定

デジタルアクティビティ、利用者が使用するデバイス、過去の購入または購入意図、および旅行に基づいて、ターゲットを設定します。「よく旅行する」などの、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

フィールド

名前 説明

behaviors

配列

idフィールドと任意のnameフィールドを持つ配列:
'behaviors':[{id: 6004386044572, 'name': 'Android Owners (All)'}, {id: 6004386044573}, 6004386044574]

詳しくはこちら

他のターゲット設定

  • Audience Network - Audience Network上で広告を実行し、リンクまたはアプリ広告のリーチを広げます

AltStyle によって変換されたページ (->オリジナル) /