API Marketing

Mô tả tùy chọn nhắm mục tiêu

Lấy nội dung mô tả con người đọc được cho một nhóm quy cách nhắm mục tiêu. Để đọc nội dung mô tả tùy chọn nhắm mục tiêu cho ads cụ thể, hãy gửi yêu cầu HTTP GET đến https://graph.facebook.com/{AD_ID}/targetingsentencelines.

Mô tả tùy chọn nhắm mục tiêu cho quảng cáo hiện có

Cách lấy kết nối targetingsentencelines của quảng cáo hiện có:

use FacebookAds\Object\Ad;

$ad = new Ad(<AD_ID>);
$targeting_description = $ad->getTargetingDescription();

// Output targeting description
foreach ($targeting_description->targetingsentencelines as $description) {
  echo $description['content'].PHP_EOL;
  foreach ($description['children'] as $child) {
    echo "\t".$child.PHP_EOL;
  }
}
from facebookads.adobjects.ad import Ad

ad = Ad(<AD_ID>)
targeting_description = ad.get_targeting_sentence_lines().get_one()

# Output the targeting description
for description in targeting_description['targetingsentencelines']:
    print(description['content'])
    for child in description['children']:
        print("\t" + child)
curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.5/<AD_ID>/targetingsentencelines

Phản hồi:

{
    "id": "<AD_ID>/targetingsentencelines",
    "targetingsentencelines": [
    {
        "content": "Location - Living In:",
        "children": [
            "Japan",
            "United States"
        ]
    },
    {
        "content": "Age:",
        "children": [
            "20 - 24"
        ]
    },
    {
        "content": "Gender:",
        "children": [
            "Male"
        ]
    }]
}

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

Tên Mô tả

id

loại: string

ID của targetingsentencelines.

targetingsentencelines

loại: mảng đối tượng JSON

Nội dung mô tả con người đọc được về quy cách nhắm mục tiêu. Mỗi đối tượng chứa content hoặc cách nhắm mục tiêu và children hoặc quy cách nhắm mục tiêu. Trường này chỉ xem xét các vị trí quảng cáo hiệu quả.

Mô tả tùy chọn nhắm mục tiêu cho tài khoản quảng cáo

Bạn cũng có thể lấy nội dung mô tả tùy chọn nhắm mục tiêu và quy cách nhắm mục tiêu cho tài khoản quảng cáo bằng cách gửi yêu cầu HTTP GET đến https://graph.facebook.com/{AD_ACCOUNT_ID}/targetingsentencelines.

Ví dụ: cách lấy nội dung mô tả tùy chọn nhắm mục tiêu cho những người sống ở Hoa Kỳ hoặc Nhật Bản và là nam giới trong độ tuổi từ 20 đến 24:

use FacebookAds\Object\AdAccount;
use FacebookAds\Object\Fields\TargetingFields;
use FacebookAds\Object\Targeting;

$account = new AdAccount('act_<AD_ACCOUNT_ID>');
$targeting = new Targeting();
$targeting->setData(array(
  TargetingFields::GEO_LOCATIONS => array(
    'countries' => array('US', 'JP')
  ),
  TargetingFields::GENDERS => array(1),
  TargetingFields::AGE_MIN => 20,
  TargetingFields::AGE_MAX => 24,
));

$params = array(
  'targeting_spec' => $targeting->exportData(),
);

foreach ($account->getTargetingSentenceLines(array(), $params) as $description) {
  echo $description->{'content'}.PHP_EOL;
  foreach ($description->{'children'} as $child) {
    echo " - ".$child.PHP_EOL;
  }
}
from facebookads.adobjects.adaccount import AdAccount
from facebookads.adobjects.targeting import Targeting

account = AdAccount('act_<AD_ACCOUNT_ID>')
params = {
    'targeting_spec': {
        Targeting.Field.geo_locations: {
            Targeting.Field.countries: ['US', 'JP'],
        },
        Targeting.Field.genders: [1],
        Targeting.Field.age_min: 20,
        Targeting.Field.age_max: 24,
    },
}

targeting_description = account.get_targeting_sentence_lines(params=params) \
    .get_one()

# Output the targeting description
for description in targeting_description['targetingsentencelines']:
    print(description['content'])
    for child in description['children']:
        print("\t" + child)
curl -G \
  --data-urlencode 'targeting_spec={ 
    "age_max": 24, 
    "age_min": 20, 
    "genders": [1], 
    "geo_locations": {"countries":["US","JP"]} 
  }' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/targetingsentencelines

Phản hồi:

{
    "params": {
        "genders": [1],
        "age_min": 20,
        "age_max": 24,
        "geo_locations": {
            "countries": [
                "US",
                "JP"
            ]
        }
    },
    "targetingsentencelines": [{
        "content": "Location - Living In:",
        "children": [
            "Japan",
            "United States"
        ]
    }, {
        "content": "Age:",
        "children": [
            "20 - 24"
        ]
    }, {
        "content": "Gender:",
        "children": [
            "Male"
        ]
    }]
}

Thông số bổ sung bao gồm:

Tên Mô tả

targeting_spec

loại: đối tượng JSON

Bắt buộc.

Lấy nội dung mô tả tùy chọn nhắm mục tiêu cho quy cách nhắm mục tiêu này.

hide_targeting_spec_from_return

loại: bool

Không bắt buộc.

Liệu phản hồi có yêu cầu bao gồm targeting_spec không. Giá trị mặc định là false.

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

Tên Mô tả

targetingsentencelines

loại: mảng đối tượng JSON

Nội dung mô tả con người đọc được về quy cách nhắm mục tiêu. Mỗi đối tượng có content hoặc cách nhắm mục tiêu và children hoặc quy cách nhắm mục tiêu.

params

loại: đối tượng JSON

Quy cách nhắm mục tiêu mà bạn cung cấp.