احصل على أوصاف قابلة للقراءة البشرية لمجموعة من مواصفات الاستهداف. لقراءة أوصاف الاستهداف لـ ads
محددة، أرسل طلب HTTP GET
إلى https://graph.facebook.com/{AD_ID}/targetingsentencelines
.
للحصول على اتصال targetingsentencelines
لإعلان موجود:
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
الاستجابة:
{ "id": "<AD_ID>/targetingsentencelines", "targetingsentencelines": [ { "content": "Location - Living In:", "children": [ "Japan", "United States" ] }, { "content": "Age:", "children": [ "20 - 24" ] }, { "content": "Gender:", "children": [ "Male" ] }] }
تحتوي الاستجابات على هذه الحقول:
الاسم | الوصف |
---|---|
النوع: string (سلسلة) | معرف |
النوع: array of JSON objects (مصفوفة كائنات بلغة JSON) | وصف قابل للقراءة البشرية لمواصفات الاستهداف. يحتوي كل كائن على |
يمكنك أيضًا الحصول على أوصاف الاستهداف ومواصفات الاستهداف من خلال طلب HTTP GET
لحساب إعلاني على https://graph.facebook.com/{AD_ACCOUNT_ID}/targetingsentencelines
.
على سبيل المثال، للحصول على أوصاف الاستهداف للأشخاص الذين يعيشون في الولايات المتحدة أو اليابان وهم من الذكور الذين تتراوح أعمارهم بين 20 و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
الاستجابة:
{ "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" ] }] }
تتضمن المعلمات الإضافية ما يلي:
الاسم | الوصف |
---|---|
النوع: JSON object (كائن بلغة JSON) | مطلوب. الحصول على وصف الاستهداف لمواصفات الاستهداف هذه. |
النوع: bool (قيمة منطقية) | اختياري. ما إذا كانت الاستجابة المطلوبة تتضمن |
تحتوي الاستجابات على هذه الحقول:
الاسم | الوصف |
---|---|
النوع: array of JSON objects (مصفوفة كائنات بلغة JSON) | وصف قابل للقراءة البشرية لمواصفات الاستهداف. يحتوي كل كائن على |
النوع: JSON object (كائن بلغة JSON) | مواصفات الاستهداف التي تم توفيرها من جانبك. |