API Marketing

Descrizione della targetizzazione

Ottieni una descrizione leggibile per un insieme di specifiche di targetizzazione. Per leggere le descrizioni di targetizzazione per specifici ads, fai un HTTP GET a https://graph.facebook.com/{AD_ID}/targetingsentencelines.

Descrizione della targetizzazione per inserzioni esistenti

Per ottenere la connessione targetingsentencelines di un'inserzione esistente:

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

Risposta:

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

Le risposte contengono questi campi:

Nome Descrizione

id

tipo: stringa

ID di targetingsentencelines.

targetingsentencelines

tipo: array di oggetti JSON

Descrizione leggibile della specifica di targetizzazione. Ogni oggetto contiene content o il tipo di targetizzazione e children o la specifica di targetizzazione. Questo campo tiene in considerazione solo posizionamenti efficaci.

Descrizione della targetizzazione per account pubblicitari

Puoi anche ottenere descrizioni di targetizzazione di una specifica di targetizzazione con un HTTP GET per un account pubblicitario su https://graph.facebook.com/{AD_ACCOUNT_ID}/targetingsentencelines.

Ad esempio, per ottenere descrizioni della targetizzazione per persone che vivono negli Stati Uniti o in Giappone e sono maschi tra i 20 e i 24 anni:

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

Risposta:

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

Parametri aggiuntivi includono:

Nome Descrizione

targeting_spec

tipo: oggetto JSON

Obbligatorio.

Ottieni una descrizione della targetizzazione per queste specifiche di targetizzazione.

hide_targeting_spec_from_return

tipo: booleano

Facoltativo.

Indica se nella risposta è inclusa la targeting_spec richiesta. Impostazione predefinita false.

Le risposte contengono questi campi:

Nome Descrizione

targetingsentencelines

tipo: array di oggetti JSON

La descrizione leggibile della specifica di targetizzazione. Ogni oggetto contiene content o il tipo di targetizzazione e children o la specifica di targetizzazione.

params

tipo: oggetto JSON

La specifica di targetizzazione fornita.