وصف الاستهداف

احصل على أوصاف قابلة للقراءة البشرية لمجموعة من مواصفات الاستهداف. لقراءة أوصاف الاستهداف لـ 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"
        ]
    }]
}

تحتوي الاستجابات على هذه الحقول:

الاسم الوصف

id

النوع: string (سلسلة)

معرف targetingsentencelines

targetingsentencelines

النوع: array of JSON objects (مصفوفة كائنات بلغة JSON)

وصف قابل للقراءة البشرية لمواصفات الاستهداف. يحتوي كل كائن على content أو نوع الاستهداف، وchildren أو مواصفات الاستهداف. يقرأ هذا الحقل المواضع الفعالة فقط.

وصف الاستهداف للحسابات الإعلانية

يمكنك أيضًا الحصول على أوصاف الاستهداف ومواصفات الاستهداف من خلال طلب 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"
        ]
    }]
}

تتضمن المعلمات الإضافية ما يلي:

الاسم الوصف

targeting_spec

النوع: JSON object (كائن بلغة JSON)

مطلوب.

الحصول على وصف الاستهداف لمواصفات الاستهداف هذه.

hide_targeting_spec_from_return

النوع: bool (قيمة منطقية)

اختياري.

ما إذا كانت الاستجابة المطلوبة تتضمن targeting_spec. علمًا بأن القيمة الافتراضية هي false.

تحتوي الاستجابات على هذه الحقول:

الاسم الوصف

targetingsentencelines

النوع: array of JSON objects (مصفوفة كائنات بلغة JSON)

وصف قابل للقراءة البشرية لمواصفات الاستهداف. يحتوي كل كائن على content أو نوع الاستهداف، وchildren أو مواصفات الاستهداف.

params

النوع: JSON object (كائن بلغة JSON)

مواصفات الاستهداف التي تم توفيرها من جانبك.