API Marketing

Description du ciblage

Obtenez les descriptions d’un ensemble de spécifications de ciblage dans un format lisible. Pour lire les descriptions du ciblage relatives à des ads spécifiques, exécutez une requête HTTP GET vers https://graph.facebook.com/{AD_ID}/targetingsentencelines.

Description du ciblage de publicités existantes

Pour obtenir la connexion targetingsentencelines d’une publicité existante :

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

Réponse :

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

Les réponses contiennent les champs suivants :

Nom Description

id

type : chaîne

ID de targetingsentencelines.

targetingsentencelines

type : tableau d’objets JSON

Description de la spécification de ciblage dans un format lisible. Chaque objet contient content ou le type de ciblage, ainsi que children ou la spécification de ciblage. Ce champ prend uniquement en considération les placements efficaces.

Description du ciblage de comptes publicitaires

Vous pouvez également obtenir les descriptions du ciblage d’une spécification de ciblage en exécutant une requête HTTP GET pour un compte publicitaire vers https://graph.facebook.com/{AD_ACCOUNT_ID}/targetingsentencelines.

Par exemple, pour obtenir les descriptions du ciblage des personnes qui vivent aux États-Unis ou au Japon et qui sont des hommes âgés de 20 à 24 ans :

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

Réponse :

{
    "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"
        ]
    }]
}

Les autres paramètres possibles sont les suivants :

Nom Description

targeting_spec

type : objet JSON

Obligatoire.

Permet d’obtenir la description du ciblage de cette spécification de ciblage.

hide_targeting_spec_from_return

type : booléen

Facultatif.

Indique si la réponse inclut la targeting_spec demandée. Valeur par défaut : false.

Les réponses contiennent les champs suivants :

Nom Description

targetingsentencelines

type : tableau d’objets JSON

Description de la spécification de ciblage dans un format lisible. Chaque objet contient content ou le type de ciblage, ainsi que children ou la spécification de ciblage.

params

type : objet JSON

Spécification de ciblage que vous avez fournie.

params peut différer des valeurs que vous fournissez si Facebook corrige automatiquement vos paramètres. Par exemple, si vous exécutez la requête {'age_min':10}, params, vous obtenez la réponse {'age_min':13} qui correspond à l’âge minimal pris en charge.