Tìm kiếm nhắm mục tiêu

Nhắm mục tiêu Nhóm quảng cáo theo một số tiêu chí mà bạn cung cấp trong quy cách nhắm mục tiêu. Hầu hết mục tiêu là các giá trị được xác định trước, như quốc gia "Nhật Bản" hoặc thành phố "Tokyo".

Hãy tìm các giá trị hợp lệ bằng API Marketing, Tìm kiếm nhắm mục tiêu: https://graph.facebook.com/{API_VERSION}/search. Bạn phải cung cấp chuỗi truy vấn ở định dạng UTF8.

Trạng thái tùy chọn nhắm mục tiêu

Để xác minh trạng thái hiện tại và/hoặc dự kiến của đối tượng nhắm mục tiêu, hãy sử dụng thông số targeting_option_list:

curl -G \
  -d 'targeting_option_list=[<TARGETING_OPTION_ ID>,<TARGETING_OPTION_ID>]' 
  -d 'type=targetingoptionstatus'  
  https://graph.facebook.com/<API_VERSION>/search

Phản hồi:

{"data":[{"id":"<TARGETING_OPTION_ ID>","current_status":"NON-DELIVERABLE"},{"id":"<TARGETING_OPTION_ID>","current_status":"NON-DELIVERABLE","future_plan":[{"key":"2018-05-10T00:00:00+0000","value":"DEPRECATING"}]}]

Trường trả về

Khu vực địa lý

Tìm kiếm nhắm mục tiêu theo quốc gia, nhóm quốc gia, thành phố, tiểu bang, mã zip và các khu vực địa lý khác tại type=adgeolocation. Bạn có thể chỉ định các thông số không bắt buộc bằng type=adgeolocation. Cách tìm mã quốc gia của Hoa Kỳ như sau:

curl -G \
  -d 'location_types=["country"]' \
  -d 'type=adgeolocation' \
  -d 'q=un' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Phản hồi:

{
  "data": [
    {
      "key": "GB", 
      "name": "United Kingdom", 
      "type": "country", 
      "supports_city": false, 
      "supports_region": false
    }, 
    {
      "key": "AE", 
      "name": "United Arab Emirates", 
      "type": "country", 
      "supports_city": false, 
      "supports_region": false
    }, 
    {
      "key": "UM", 
      "name": "United States Minor Outlying Islands", 
      "type": "country", 
      "supports_city": false, 
      "supports_region": false
    }
  ]
}

key là số cố định duy nhất trong mỗi hạng mục, chẳng hạn như quốc gia hoặc nhóm quốc gia. Các trường khác, bao gồm cả name, đều có thể thay đổi. Hãy sử dụng key để xác định Quy cách nhắm mục tiêu.

Trong phản hồi:

• nếu supports_region là true, quốc gia này có mã khu vực
• nếu supports_city là true, quốc gia này có mã thành phố

Quốc gia

Mọi quốc gia mà bạn có thể nhắm mục tiêu đều có mã quốc gia. Các thông số không bắt buộc cho type=adgeolocation&location_types=['country'] là:

Nhóm quốc gia

Tất cả các nhóm quốc gia đều có mã để tìm kiếm và lấy danh sách quốc gia. Đối với tất cả các nhóm quốc gia có tên mercosur:

curl -G \
  -d 'location_types=["country_group"]' \
  -d 'type=adgeolocation' \
  -d 'q=mercosur' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Phản hồi:

{
  "data": [
    {
      "key": "mercosur",
      "name": "Mercosur",
      "type": "country_group",
      "country_codes": [
        "BR",
        "AR",
        "UY",
        "PY",
        "VE"
      ],
      "is_worldwide": false,
      "supports_region": true,
      "supports_city": true
    }
  ]
}

Nếu is_worldwide là true, đây là nhóm quốc gia trên toàn thế giới. Nếu supports_region là true, nhóm quốc gia này có mã khu vực. Nếu supports_city là true, nhóm này có mã thành phố.

Khu vực

Cách tìm kiếm tất cả các khu vực bắt đầu bằng mã al như sau:

curl -G \
  -d 'location_types=["region"]' \
  -d 'type=adgeolocation' \
  -d 'q=al' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Phản hồi:

{
  "data": [
    {
      "key": "3843",
      "name": "Alabama",
      "type": "region",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "3844",
      "name": "Alaska",
      "type": "region",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "527",
      "name": "Alberta",
      "type": "region",
      "country_code": "CA",
      "country_name": "Canada",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "1089",
      "name": "Alsace",
      "type": "region",
      "country_code": "FR",
      "country_name": "France",
      "supports_region": true,
      "supports_city": true
    }
  ]
}

Các tùy chọn cho type=adgeolocation&location_types=['region'] là:

Nếu supports_region là true, bạn có thể nhắm mục tiêu khu vực này. Nếu supports_city là true, khu vực này có mã thành phố.

Thành phố

Kể từ tháng 03/2019, chúng tôi đã phân loại lại một vài thành phố cho các vai trò khác, nhưng bạn có thể tiếp tục sử dụng city. Yêu cầu tìm kiếm sẽ trả về các kết quả trước đây là thành phố.

Cách tìm kiếm mã cho tất cả các thành phố bắt đầu bằng Manhattan:

curl -G \
     -d 'location_types=["city"]' \
     -d 'type=adgeolocation' \
     -d 'q=Manhattan' \
     -d 'access_token=ACCESS_TOKEN' \
     https://graph.facebook.com/VERSION/search

Phản hồi:

{
  "data": [
    {
      "key": "2447439",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Kansas",
      "region_id": 3859,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2439596",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Illinois",
      "region_id": 3856,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2479541",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Montana",
      "region_id": 3869,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2428908",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Florida",
      "region_id": 3852,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2703980",
      "name": "Manhattan",
      "type": "subcity",
      "country_code": "US",
      "country_name": "United States",
      "region": "New York",
      "region_id": 3875,
      "supports_region": true,
      "supports_city": true,
      "geo_hierarchy_level": "SUBCITY",
      "geo_hierarchy_name": "BOROUGH"
    },
   ...

Nếu supports_region là true, khu vực của thành phố này hiện có thể nhắm mục tiêu được. Nếu supports_city được đặt thành true, thành phố này có thể nhắm mục tiêu được.

Khu vực địa lý

Chúng tôi có các khu vực địa lý khác mà bạn có thể sử dụng để nhắm mục tiêu. Một số các khu vực trong số này chưa được xác định, như ghi chú dưới đây.

Phân cấp của các khu vực địa lý như sau, từ lớn nhất đến nhỏ nhất:

• REGION
• LARGE_GEO_AREA
• MEDIUM_GEO_AREA
• SMALL_GEO_AREA
• METRO_AREA
• CITY
• SUBCITY
• NEIGHBORHOOD
• SUBNEIGHBORHOOD

Mã zip

Bạn cũng có thể tìm kiếm mã zip để nhắm mục tiêu trên Facebook. Để tìm kiếm mã zip, bạn nên sử dụng adgeolocation với location_types=['zip']. Hãy truy cập vào Trung tâm trợ giúp của Meta để xem danh sách các quốc gia có mã Zip được hỗ trợ.

Tìm kiếm các mã zip bắt đầu bằng 9:

curl -G \
  -d 'location_types=["zip"]' \
  -d 'type=adgeolocation' \
  -d 'q=9' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/LATEST-API-VERSION/search

Phản hồi:

{
  "data": [
    {
      "key": "US:90028",
      "name": "90028",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "Los Angeles",
      "primary_city_id": 2420379,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:94110",
      "name": "94110",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "San Francisco",
      "primary_city_id": 2421836,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:94501",
      "name": "94501",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "Alameda",
      "primary_city_id": 2417628,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:95190",
      "name": "95190",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "San Jose",
      "primary_city_id": 2421846,
      "supports_region": true,
      "supports_city": true
    }
  ]
}

Ngôn ngữ

Các ngôn ngữ có thể nhắm mục tiêu theo mã ngôn ngữ. Cách tìm kiếm tất cả các ngôn ngữ bắt đầu bằng en như sau:

curl -G \
  -d 'type=adlocale' \
  -d 'q=en' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Phản hồi:

{
{
      "data": [
        {
          "key": 51, 
          "name": "English (Upside Down)"
        }, 
        {
          "key": 6, 
          "name": "English (US)"
        }, 
        {
          "key": 24, 
          "name": "English (UK)"
        }
      ]
    }
}

Mã DMA

Để lấy các mã này, hãy chỉ định type=adgeolocation và location_types=['geo_market'] trong truy vấn của bạn. Cách tìm kiếm các mã DMA bắt đầu bằng "New" như sau:

curl -G \
  -d 'location_types=["geo_market"]' \
  -d 'type=adgeolocation' \
  -d 'q=New' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Kết quả:

{
  "data": [
    {
      "key": "DMA:622",
      "name": "New Orleans",
      "type": "geo_market",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "DMA:501",
      "name": "New York",
      "type": "geo_market",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "DMA:533",
      "name": "Hartford & New Haven",
      "type": "geo_market",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
....
    }
  ]
}

Quận bầu cử

Để tìm kiếm các Quận bầu cử cần nhắm mục tiêu, hãy chỉ định type=adgeolocation và location_types=['electoral_district']. Cách tìm kiếm các Quận bầu cử ở California như sau:

curl -G \
  -d 'location_types=["electoral_district"]' \
  -d 'type=adgeolocation' \
  -d 'q=California' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Phản hồi:

{
  "data": [
    {
      "key": "US:CA14",
      "name": "California's 14th District",
      "type": "electoral_district",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:CA02",
      "name": "California's 2nd District",
      "type": "electoral_district",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "supports_region": true,
      "supports_city": true
    },
 ...
}

Siêu dữ liệu vị trí địa lý

Bạn có thể sử dụng các thông số không bắt buộc khác bằng type=adgeolocationmeta:

curl -G \
  -d 'cities=[2418779]' \
  -d 'zips=["US:90210"]' \
  -d 'countries=["US","JP"]' \
  -d 'regions=[10]' \
  -d 'type=adgeolocationmeta' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Phản hồi là đối tượng JSON có siêu dữ liệu dành cho vị trí địa lý được chỉ định:

{
  "data": {
    "countries": {
      "US": {
        "key": "US", 
        "type": "country", 
        "name": "United States", 
        "supports_city": true, 
        "supports_region": true
      }, 
      "JP": {
        "key": "JP", 
        "type": "country", 
        "name": "Japan", 
        "supports_city": true, 
        "supports_region": true
      }
    }, 
    "regions": {
      "10": {
        "key": "10", 
        "type": "region", 
        "name": "Dubai", 
        "country_code": "AE", 
        "supports_city": true, 
        "supports_region": false
      }
    }, 
    "cities": {
      "2418779": {
        "key": "2418779", 
        "type": "city", 
        "name": "Danville", 
        "region_id": 3847, 
        "region": "California", 
        "country_code": "US", 
        "supports_city": true, 
        "supports_region": true
      }
    }, 
    "zips": {
      "US:90210": {
        "key": "US:90210", 
        "type": "zip", 
        "name": "90210", 
        "primary_city": "Beverly Hills", 
        "region_id": 3847, 
        "region": "California", 
        "country_code": "US", 
        "supports_city": true, 
        "supports_region": true
      }
    }
  }
}

Tùy chọn:

Gợi ý về bán kính

Để nhắm mục tiêu xung quanh một vị trí cụ thể, hãy tiếp cận đủ số người theo bán kính gợi ý bằng suggested_radius:

curl -G \
  -d 'latitude=37.449478' \
  -d 'longitude=-122.173016' \
  -d 'type=adradiussuggestion' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Phản hồi là đối tượng JSON có suggested_radius và distance_unit.

{
  "data": [
    {
      "suggested_radius": 10,
      "distance_unit": "mile"
    }
  ]
}

Ví dụ về tìm nạp suggested_radius khi đã chỉ định distance_unit:

curl -G \
  -d 'latitude=37.449478' \
  -d 'longitude=-122.173016' \
  -d 'type=adradiussuggestion' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

{
  "data": [
    {
      "suggested_radius": 16,
      "distance_unit": "kilometer"
    }
  ]
}

Hãy sử dụng các thông số sau:

Xem thêm phần Quảng cáo tăng mức độ nhận biết tại địa phương để sử dụng cùng với các gợi ý.

Sở thích

Gửi yêu cầu GET đến điểm cuối /search, đặt type thành adinterest và q thành sở thích cụ thể cần tìm kiếm:

curl -G \
  -d 'type=adinterest' \
  -d 'q=baseball' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Phản hồi sẽ trả về các trường sau:

Gợi ý về sở thích

Gửi yêu cầu GET đến điểm cuối /search và đặt type thành adinterestsuggestion để lấy danh sách các sở thích gợi ý có liên quan đến sở thích của bạn.

Truy vấn mẫu

curl -G \
  -d 'interest_list=["Basketball"]' \
  -d 'type=adinterestsuggestion' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/search

Phản hồi mẫu

{
  "data": [
    {
      "id": "6003598240487",
      "name": "la biblia",
      "audience_size": 7419780,
      "path": [
  ],
      "description": null
   },
   {
      "id": "6003022269556",
      "name": "Rugby football",
      "audience_size": 13214830,
      "path": [
  ],
      "description": null
   },
   {
      "id": "6003146664949",
      "name": "Netball",
      "audience_size": 4333770,
      "path": [
  ],
"description": null
   },
   {
      "id": "6003013291881",
      "name": "Kaizer Chiefs F.C.",
      "audience_size": 1812850,
      "path": [
  ],
      "description": null
  },
  ....
  {
      "id": "6003400886535",
      "name": "espn sportscenter",
      "audience_size": 222960,
      "path": [
  ],
     "description": null
  },
  {
     "id": "6002925969459",
     "name": "watching movies",
     "audience_size": 4630950,
     "path": [
  ],
     "description": null
  },
  {
     "id": "6003214125247",
     "name": "lakers",
     "audience_size": 340360,
     "path": [
  ],
     "description": null
  }

Tùy chọn bao gồm:

Giới hạn

• Không phải sở thích hiện có nào cũng sẽ được trả về trong lượt tìm kiếm.
• Sở thích có thể được đổi tên bất cứ lúc nào và xác thực theo tên có thể không thành công khi điều này xảy ra. Vì vậy, bạn nên xác thực sở thích theo interest_fbid_list thay vì theo tên. Kiểm tra xem cụm từ có hợp lệ hay không bằng cách gửi truy vấn qua type=adinterestvalid và sở thích cần xác thực:

curl -G \
  -d 'interest_list=["Japan","nonexistantkeyword"]' \
  -d 'type=adinterestvalid' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Phản hồi:

{
  "data": [
    {
      "name": "Japan",
      "valid": true,
      "id": 6003700426513,
      "audience_size": 68310258
    },
    {
      "name": "nonexistantkeyword",
      "valid": false
    }
  ]
}

Tùy chọn:

Sở thích

Để lướt xem các sở thích có thể nhắm mục tiêu, hãy gửi yêu cầu GET đến điểm cuối /search, đặt type thành adTargetingCategory và class thành interests.

curl -G \
  -d 'type=adTargetingCategory' \
  -d 'class=interests' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Giới hạn

• Không phải sở thích hiện có nào cũng sẽ được trả về trong lượt tìm kiếm.

Hành vi

Nhắm mục tiêu dựa trên hành động hoặc hành vi mua hàng trước đây của người dùng. Truy xuất tất cả các tùy chọn nhắm mục tiêu theo hành vi có thể sử dụng bằng type=adTargetingCategory&class=behaviors.

curl -G \
  -d 'type=adTargetingCategory' \
  -d 'class=behaviors' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Phản hồi chứa các dữ liệu sau đây:

Thông tin nhân khẩu học

Thông tin nhân khẩu học bao gồm nơi làm việc, học vấn, loại chức danh và loại tình trạng quan hệ. Bạn cũng có thể nhắm mục tiêu dựa trên sự kiện trong đời xảy ra gần đây: 3 tháng, 6 tháng và 1 năm. Bạn có thể tham chiếu các trường học để nhắm mục tiêu theo id và tên.

Cách tìm kiếm tất cả các trường học bắt đầu bằng ha:

curl -G \
  -d 'type=adeducationschool' \
  -d 'q=ha' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Phản hồi:

 {
  "data": [
    {
      "name": "Harvard University", 
      "id": 105930651606,
      "coverage": 8395398,
      "subtext": "Cambridge, Massachusetts"
    }, 
    {
      "name": "Hajvery University", 
      "id": 148971135122588,
      "coverage": 124162
    }, 
    {
      "name": "Harvard-Westlake School", 
      "id": 107799365910274,
      "coverage": 14106
    }
  ]
}

Chuyên ngành giáo dục chính

Bạn có thể nhắm mục tiêu các chuyên ngành chính theo id và tên. Cách tìm kiếm tất cả các chuyên ngành chính bắt đầu bằng ph như sau:

curl -G \
  -d 'type=adeducationmajor' \
  -d 'q=ph' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Phản hồi:

{
  "data": [
    {
      "name": "Photography", 
      "id": 108170975877442,
      "coverage": 613618
    }, 
    {
      "name": "Physics", 
      "id": 109279729089828,
      "coverage": 942491
    }, 
    {
      "name": "Philosophy", 
      "id": 108026662559095,
      "coverage": 701271
    }
  ]
}

Công ty làm việc

Tham chiếu các công ty có thể nhắm mục tiêu theo id và tên. Cách tìm kiếm tất cả công ty làm việc bắt đầu bằng mic như sau:

curl -G \
  -d 'type=adworkemployer' \
  -d 'q=mic' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Phản hồi:

{
  "data": [
    {
      "name": "Western Michigan University", 
      "id": 10022826163,
      "coverage": 24366
    }, 
    {
      "name": "University of Michigan", 
      "id": 21105780752,
      "coverage": 17357
    }, 
    {
      "name": "Michigan State University - SPARTANS", 
      "id": 8891783019,
      "coverage": 65853
    }
  ]
}

Chức danh

Mỗi chức danh tự khai báo, có thể nhắm mục tiêu đều có id và tên. Cách lấy tất cả chức danh có Business Analyst như sau:

curl -G \
  -d 'type=adworkposition' \
  -d 'q=Business Analyst' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Phản hồi:

{
   "data": [
    {
      "name": "Business Analyst", 
      "id": 105763692790962,
      "coverage": 282124
    }, 
    {
      "name": "Financial Analyst", 
      "id": 112930925387573,
      "coverage": 212889
    }
  ]
}

Phản hồi có các trường sau:

Bảng dưới đây là các thông số phổ biến cho API này. Để biết các thông số nhập cụ thể theo từng loại, hãy xem thông tin chi tiết bên dưới.

Tùy theo hạng mục dữ liệu tự động điền, hãy cung cấp type thích hợp. Để truy xuất ngôn ngữ, hãy chỉ định type=adlocale. Các loại hợp lệ là:

Duyệt thông tin nhân khẩu học

Truy xuất tất cả các tùy chọn nhắm mục tiêu theo nhân khẩu học có thể sử dụng bằng type=adTargetingCategory và class.

Phản hồi chứa các trường sau đây: