Pubblico simile

Definisci come destinatari gli utenti più simili ai tuoi clienti abituali. Il pubblico simile prende a riferimento diversi gruppi di utenti come base di partenza, quindi Facebook crea un piccolo di utenti simili. Puoi usare un pubblico simile per qualsiasi obiettivo commerciale, che si tratti di targetizzazione di persone simili ai tuoi clienti per l'acquisizione di fan, registrazione al sito, acquisti fuori da Facebook, richieste di coupon o semplicemente per aumentare l'attenzione verso il marchio.

Il pubblico originale può essere:

Facebook aggiorna i membri di un pubblico simile ogni 3 giorni se appartengono a un gruppo di inserzioni.

Creazione

Per essere interamente popolato, un pubblico simile può richiedere da 1 a 6 ore. Mentre il pubblico si popola, puoi creare e inviare gruppi di inserzioni che definiscono come destinatario questo pubblico. Una volta che il pubblico è pronto, Facebook pubblica contenuti indirizzati alle persone popolate nel pubblico e la pubblicazione delle inserzioni funzionerà normalmente. Vedi Stato di pubblicazione. Crea un nuovo pubblico simile in: https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/customaudiences.

Esempio di chiamata per la creazione di un pubblico simile da un pubblico personalizzato:

use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;
use FacebookAds\Object\Values\CustomAudienceSubtypes;

$lookalike = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
$lookalike->setData(array(
  CustomAudienceFields::NAME => 'My lookalike audience',
  CustomAudienceFields::SUBTYPE => CustomAudienceSubtypes::LOOKALIKE,
  CustomAudienceFields::ORIGIN_AUDIENCE_ID => <SEED_AUDIENCE_ID>,
  CustomAudienceFields::LOOKALIKE_SPEC => array(
    'type' => 'similarity',
    'country' => 'US',
  ),
));
$lookalike->create();
from facebookads.adobjects.customaudience import CustomAudience

lookalike = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
lookalike.update({
    CustomAudience.Field.name: 'My lookalike audience',
    CustomAudience.Field.subtype: CustomAudience.Subtype.lookalike,
    CustomAudience.Field.origin_audience_id: '<SEED_AUDIENCE_ID>',
    CustomAudience.Field.lookalike_spec: {
        'type': 'similarity',
        'country': 'US',
    },
})

lookalike.remote_create()
print(lookalike)
curl \
  -F 'name=My lookalike audience' \
  -F 'subtype=LOOKALIKE' \
  -F 'origin_audience_id=<SEED_AUDIENCE_ID>' \
  -F 'lookalike_spec={"type":"similarity","country":"US"}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences

Per creare un pubblico simile con l'SDK di inserzioni PHP o con l'SDK di inserzioni Python usa CustomAudience.

La risposta contiene:

Nome Descrizione

id

tipo: intero

ID del pubblico simile

Pubblico simile personalizzato

Se hai un pubblico personalizzato di almeno 100 persone, puoi creare un pubblico simile basato su di esso. Questo include il pubblico personalizzato per il tuo sito web e il pubblico personalizzato per la tua app mobile.

Nome Descrizione

name

tipo: stringa

Obbligatorio.

Nome del pubblico personalizzato

origin_audience_id

tipo: long

Obbligatorio.

ID del pubblico personalizzato. Il pubblico originale deve avere almeno 100 membri.

lookalike_spec

tipo: array

Obbligatorio.

Vedi la descrizione sotto.

lookalike_spec.type

tipo: stringa

Obbligatorio. Imposta type o ratio.

similarity o reach

lookalike_spec.starting_ratio

tipo: float

Facoltativo.

Percentuale iniziale di somiglianza. As esempio, un valore starting_ratio di 0,01 e un valore ratio di 0,02 creano un pubblico simile dall'1% al 2% di un segmento simile. starting_ratio deve essere inferiore al rapporto

lookalike_spec.ratio

tipo: float

Obbligatorio. Imposta type o ratio.

0.01-0.20 incrementato di 0,01. x% principale di pubblico originale in un determinato Paese

lookalike_spec.allow_international_seeds

tipo: booleano

Facoltativo.

Almeno 100 membri del pubblico originale provenienti da un Paese. Se non sono presenti, allow_international_seeds impostato su true significa che Facebook trova questo numero minimo di membri del pubblico in un altro Paese. Impostazione predefinita false.

lookalike_spec.country

tipo: stringa

Obbligatorio. Imposta country o location_spec.

Trova i membri del pubblico simile in questo Paese

lookalike_spec.location_spec

tipo: array

Obbligatorio. country o location_spec.

Trova i membri del pubblico in questi luoghi. Lista di Paesi o gruppi di Paesi, ad esempio Asia

lookalike_spec.location_spec.geo_locations

tipo: array

Obbligatorio. Almeno una voce in countries o country_groups.

Includi questi luoghi

lookalike_spec.location_spec.geo_locations.countries

tipo: array di stringhe

Facoltativo.

Targetizza i Paesi. Array di prefissi internazionali, vedi API Targeting Search, Paesi. Esempio: 'countries': ['US']

lookalike_spec.location_spec.geo_locations.country_groups

tipo: array di stringhe

Facoltativo.

Targetizza i Paesi in regioni globali e aree di libero scambio. Array di codici gruppo di Paesi. Per le opzioni complete, vedi Targetizzazione, Posizione, country_groups e Ricerca targetizzazione, country_groups. Esempio: 'country_groups': ['asia','mercosur']

lookalike_spec.location_spec.excluded_geo_locations

tipo: array

Facoltativo.

Luoghi da escludere

lookalike_spec.location_spec.excluded_geo_locations.countries

tipo: array di stringhe

Facoltativo.

Come countries in geo_locations

lookalike_spec.location_spec.excluded_geo_locations.country_groups

tipo: array di stringhe

Facoltativo.

Come country_groups in geo_locations

Tipi

Ottimizza il tuo pubblico per "somiglianza" o "copertura maggiore".

  • Somiglianza: il pubblico include il migliore 1% delle persone che si trovano in un determinato Paese e che sono più simili al pubblico personalizzato di base. La copertura del nuovo pubblico è inferiore, la combinazione è più precisa.
  • Maggiore copertura: il pubblico include il migliore 5% delle persone che si trovano in un determinato Paese e che sono più simili al pubblico personalizzato di base, ma con una combinazione meno precisa.

Invece di usare i tipi puoi impostare manualmente il ratio in modo che rappresenti il migliore x% del pubblico nel Paese selezionato. Il ratio deve essere compreso tra l'1% e il 20% a intervalli dell'1%.

Pubblico simile di una campagna o un gruppo di inserzioni

In Facebook, il pubblico simile di una campagna o un gruppo di inserzioni permette di definire come destinatari le persone simili a quelle che vengono convertite da campagne o gruppi di inserzioni precedenti o attuali; ad esempio, campagne o inserzioni che ottimizzano le conversioni. Misuriamo le conversioni in base a un tipo di campagna o gruppo di inserzioni in Specifiche di conversione. Ad esempio definire come destinatari persone che hanno agito sul tuoi sito web o installato la tua app entro 28 giorni dal clic sulla tua inserzione.

use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;
use FacebookAds\Object\Values\CustomAudienceSubtypes;

$lookalike = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
$lookalike->setData(array(
  CustomAudienceFields::SUBTYPE => CustomAudienceSubtypes::LOOKALIKE,
  CustomAudienceFields::LOOKALIKE_SPEC => array(
    'origin_ids' => <CAMPAIGN_ID>,
    'starting_ratio' => 0.03,
    'ratio' => 0.05,
    'conversion_type' => 'campaign_conversions',
    'country' => 'US',
  ),
));
$lookalike->create();
from facebookads.adobjects.customaudience import CustomAudience

lookalike = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
lookalike.update({
    CustomAudience.Field.subtype: CustomAudience.Subtype.lookalike,
    CustomAudience.Field.lookalike_spec: {
        'origin_ids': '<CAMPAIGN_ID>',
        'starting_ratio': 0.03,
        'ratio': 0.05,
        'conversion_type': 'campaign_conversions',
        'country': 'US',
    },
})

lookalike.remote_create()
print(lookalike)
curl \
  -F 'subtype=LOOKALIKE' \
  -F 'lookalike_spec={ 
    "origin_ids": "<CAMPAIGN_ID>", 
    "starting_ratio": 0.03, 
    "ratio": 0.05, 
    "conversion_type": "campaign_conversions", 
    "country": "US" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences

Ti occorrono almeno 100 conversioni uniche dalle tue campagne o dai tuoi gruppi di inserzioni. Un numero maggiore di conversioni consente un modello predittivo migliore; suggeriamo almeno 200 conversioni. Devi anche selezionare campagne o gruppi di inserzioni con obiettivi simili.

Per creare questo pubblico simile, specifica una o più delle tue campagne o dei tuoi gruppi di inserzioni. Ad esempio, specifica una campagna e due gruppi di inserzioni di un'altra campagna.

Facebook usa i dati provenienti da conversioni risalenti fino a 180 giorni prima e identifica le conversioni nelle tue campagne e nei tuoi gruppi di inserzioni come esempi. Realizziamo un modello predittivo con cui creare un pubblico simile. Facebook aggiorna costantemente il modello predittivo soggiacente man mano che campagne e gruppi di inserzioni registrano nuove conversioni.

Nome Descrizione

lookalike_spec

tipo: array

Obbligatorio.

Vedi la descrizione sotto.

lookalike_spec.origin_ids

tipo: array di interi

Obbligatorio.

Array di ID degli oggetti pubblicitari. Le persone che effettuano conversioni su queste inserzioni vengono usate come modello per un pubblico simile. Uno o più ID della campagna o ID del gruppo di inserzioni oppure una combinazione dei due.

lookalike_spec.conversion_type

tipo: stringa

Obbligatorio.

campaign_conversions. Indica che il pubblico è un pubblico simile di conversione di una campagna

lookalike_spec.country

tipo: stringa

Obbligatorio.

Il Paese per trovare i membri simili

lookalike_spec.allow_international_seeds

tipo: booleano

Facoltativo.

Almeno 100 membri del pubblico originale provenienti da un Paese. Se non sono presenti, allow_international_seeds impostato su true significa che Facebook trova questo numero minimo di membri del pubblico in un altro Paese. Valore predefinito: false.

lookalike_spec.starting_ratio

tipo: float

Facoltativo.

Percentuale iniziale di somiglianza. Ad esempio, un valore starting_ratio di 0,01 e un valore ratio di 0,02 creano un pubblico simile dall'1% al 2% di un segmento simile. starting_ratio deve essere inferiore al ratio

lookalike_spec.ratio

tipo: float

Obbligatorio.

Intervallo 0.01-0.20. x% principale di pubblico originale nel Paese selezionato.

Attualmente, sono idonei per il pubblico simile i seguenti tipi di conversione delle campagne:

  • Clic sui link
  • Inserzioni con offerte
  • "Mi piace" sulla Pagina
  • Installazioni dell'app Canvas
  • Risposte all'evento
  • Interazione con i post
  • Conversioni sul sito web
  • Installazioni dell'app mobile
  • Interazione con l'app mobile
  • Visualizzazioni dei video
  • Notorietà nei dintorni

Pubblico simile di fan della Pagina

Crea un pubblico simile basato sulle persone che hanno messo "Mi piace" alla tua Pagina:

use FacebookAds\Object\CustomAudience;
use FacebookAds\Object\Fields\CustomAudienceFields;
use FacebookAds\Object\Values\CustomAudienceSubtypes;

$lookalike = new CustomAudience(null, 'act_<AD_ACCOUNT_ID>');
$lookalike->setData(array(
  CustomAudienceFields::SUBTYPE => CustomAudienceSubtypes::LOOKALIKE,
  CustomAudienceFields::LOOKALIKE_SPEC => array(
    'ratio' => 0.01,
    'country' => 'US',
    'page_id' => <PAGE_ID>,
    'conversion_type' => 'page_like',
  ),
));
$lookalike->create();
from facebookads.adobjects.customaudience import CustomAudience

lookalike = CustomAudience(parent_id='act_<AD_ACCOUNT_ID>')
lookalike.update({
    CustomAudience.Field.name: 'My lookalike audience',
    CustomAudience.Field.subtype: CustomAudience.Subtype.lookalike,
    CustomAudience.Field.lookalike_spec: {
        'ratio': 0.01,
        'country': 'US',
        'page_id': '<PAGE_ID>',
        'conversion_type': 'page_like',
    },
})

lookalike.remote_create()
print(lookalike)
curl \
  -F 'subtype=LOOKALIKE' \
  -F 'lookalike_spec={ 
    "ratio": 0.01, 
    "country": "US", 
    "page_id": "<PAGE_ID>", 
    "conversion_type": "page_like" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences
Nome Descrizione

lookalike_spec

tipo: array

Obbligatorio.

Vedi la descrizione sotto.

lookalike_spec.page_id

tipo: int

Obbligatorio.

ID Facebook della pagina i cui fan saranno usati per il pubblico simile

lookalike_spec.conversion_type

tipo: stringa

Obbligatorio.

page_like: indica che si tratta di un pubblico simile ai fan della pagina

lookalike_spec.country

tipo: stringa

Obbligatorio.

Il Paese per trovare il pubblico simile. L'impostazione predefinita è "US"

lookalike_spec.allow_international_seeds

tipo: booleano

Facoltativo.

Ti occorrono almeno 100 membri del pubblico originale provenienti da un Paese. Se questo numero minimo non è soddisfatto, allow_international_seeds impostato su true significa che Facebook trova questo numero minimo di membri del pubblico in un altro Paese. Valore predefinito: false.

lookalike_spec.starting_ratio

tipo: float

Facoltativo.

Percentuale di partenza del pubblico simile. Ad esempio, un rapporto di partenza di 0,01 e un rapporto di 0,02 creano un pubblico simile dall'1 al 2% di un segmento simile. Il valore del rapporto di partenza deve essere sempre inferiore a quello del rapporto

lookalike_spec.ratio

tipo: float

Obbligatorio.

Intervallo 0,01-0,20. Area del Paese che il pubblico simile deve targetizzare.

Targetizzazione

La targetizzazione del pubblico simile avviene allo stesso modo di quella del pubblico personalizzato. Vedi Pubblico personalizzato, Targetizzazione. Si applica anche per esclusione alla targetizzazione e alla targetizzazione congiuntiva AND. Per definire i destinatari quando crei un'inserzione:

use FacebookAds\Object\AdSet;
use FacebookAds\Object\Fields\AdSetFields;
use FacebookAds\Object\Values\AdSetBillingEventValues;
use FacebookAds\Object\Values\AdSetOptimizationGoalValues;
use FacebookAds\Object\Fields\TargetingFields;
use FacebookAds\Object\Targeting;

$adset = new AdSet(null, 'act_<AD_ACCOUNT_ID>');
$adset->setData(array(
  AdSetFields::NAME => 'My AdSet',
  AdSetFields::OPTIMIZATION_GOAL => AdSetOptimizationGoalValues::REACH,
  AdSetFields::BILLING_EVENT => AdSetBillingEventValues::IMPRESSIONS,
  AdSetFields::BID_AMOUNT => 2,
  AdSetFields::DAILY_BUDGET => 1000,
  AdSetFields::CAMPAIGN_ID => <CAMPAIGN_ID>,
  AdSetFields::TARGETING => (new Targeting())->setData(array(
    TargetingFields::GEO_LOCATIONS => array(
      'countries' => array('US'),
    ),
    TargetingFields::CUSTOM_AUDIENCES => array(
      array(
        'id' => <LOOKALIKE_AUDIENCE_ID>,
      ),
    ),
  )),
));

$adset->create(array(
  AdSet::STATUS_PARAM_NAME => AdSet::STATUS_ACTIVE,
));
from facebookads.adobjects.adset import AdSet

adset = AdSet(parent_id='act_<AD_ACCOUNT_ID>')
adset.update({
    AdSet.Field.name: 'My Adset',
    AdSet.Field.daily_budget: 10000,
    AdSet.Field.campaign_id: '<CAMPAIGN_ID>',
    AdSet.Field.optimization_goal: AdSet.OptimizationGoal.link_clicks,
    AdSet.Field.billing_event: AdSet.BillingEvent.link_clicks,
    AdSet.Field.bid_amount: 150,
    AdSet.Field.daily_budget: 2000,
    AdSet.Field.targeting: {
        'geo_locations': {
            'countries': ['US'],
        },
        'custom_audiences': [
            {
                'id': <LOOKALIKE_AUDIENCE_ID>,
            },
        ],
    },
})

adset.remote_create(params={
    'status': AdSet.Status.paused,
})
AdSet adSet = new AdAccount(act_<AD_ACCOUNT_ID>, context).createAdSet()
  .setName("My AdSet")
  .setOptimizationGoal(AdSet.EnumOptimizationGoal.VALUE_REACH)
  .setBillingEvent(AdSet.EnumBillingEvent.VALUE_IMPRESSIONS)
  .setBidAmount(2L)
  .setDailyBudget(1000L)
  .setCampaignId(<CAMPAIGN_ID>)
  .setTargeting(
    new Targeting()
      .setFieldCustomAudiences(Arrays.asList(
        new IDName()
          .setFieldId(<LOOKALIKE_AUDIENCE_ID>)
      ))
      .setFieldGeoLocations(
        new TargetingGeoLocation()
          .setFieldCountries(Arrays.asList("US"))
      )
  )
  .setStatus(AdSet.EnumStatus.VALUE_ACTIVE)
  .execute();
String ad_set_id = adSet.getId();
curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "custom_audiences": [{"id":"<LOOKALIKE_AUDIENCE_ID>"}], 
    "geo_locations": {"countries":["US"]} 
  }' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/adsets

Più esempi in Specifiche di targetizzazione.

Gestione di un pubblico

Ottieni dettagli sul pubblico personalizzato usato per creare pubblico simile. Restituiamo gli stessi campi come pubblico personalizzato. Sotto è riportato un esempio di risposta per un pubblico personalizzato usato per creare pubblico simile. lookalike_audience_ids specifica quale pubblico simile sia stato generato da questo pubblico.

 {
  "id": "6006164557194",
  "account_id": 12345,
  "approximate_count": 816400,
  "lookalike_audience_ids": [
    6006183285954,
    6006183285955
  ],
  "name": "Boys Apparel",
  "parent_audience_id": 0,
  "parent_category": "Custom",
  "status": "ready",
  "subtype": "CUSTOM",
  "type": 4,
  "type_name": "Advertiser Generated",
  "time_updated": 1362439491
}, 

Il pubblico simile contiene un subtype di 2. Restituiamo anche la lookalike_spec, un array in questo formato:

Nome Descrizione

type

tipo: stringa

Uno tra similarity, reach e custom_ratio viene sempre restituito

starting_ratio

tipo: float

Restituito se starting_ratio è specificato

ratio

tipo: float

Multiplo di 0.01. Restituito se type è custom_ratio

country

tipo: stringa

Prefisso internazionale

origin

tipo: array

Vedi la descrizione sotto.

origin.deleted

tipo: booleano

true, restituito quando l'origine viene eliminata

origin.id

tipo: int

ID origine

origin.name

tipo: stringa

Nome origine

origin.type

tipo: stringa

custom_audience o page

target_countries

tipo: array di stringhe

Tutti i Paesi usati per creare il pubblico

Di seguito è riportato un altro pubblico in cui subtype è LOOKALIKE:

{
 "id": "6006183285954",
 "account_id": 12345,
 "approximate_count": 1782100,
 "name": "Boys Apparel_lookalike_US_Similarity",
 "origin_audience_id": 6006567610735,
 "parent_audience_id": 0,
 "parent_category": "Custom",
 "status": "ready",
 "subtype": "LOOKALIKE",
 "type": 4,
 "type_name": "Advertiser Generated",
 "time_updated": 1362506552
},  

Stato di pubblicazione

Dopo aver creato un pubblico simile torniamo all'ID del pubblico personalizzato. Il processo di popolamento del pubblico può richiedere circa un'ora per essere completato. Puoi ottenere lo stato in: /{lookalike_audience_ID}?fields=delivery_status. Quando un pubblico si popola, viene restituita una risposta JSON con delivery_status o codice 200:

"delivery_status": {
  "code": 200, 
  "description": "This audience is ready for use."
},

Per i test, devi controllare lo stato della lista con Gestione inserzioni.

Puoi eliminare un pubblico simile nello stesso modo di un pubblico personalizzato.

Pubblico non attivo

Un pubblico simile si considera non attivo quando non viene usato nelle inserzioni attive per 90 giorni. Un pubblico simile non attivo ha approximate_count, operation_status e delivery_estimate diversi.

CampoModifiche per il pubblico simile non attivo

approximate_count

Non puoi recuperare le dimensioni. Una chiamata per questo campo restituisce -1 per il pubblico simile non attivo.

operation_status

450: questo pubblico simile non è attivo. Può essere utilizzato nelle inserzioni, ma non avrà una stima fino alla pubblicazione della campagna.
100: se un pubblico non è stato utilizzato in un gruppo di inserzioni attivo per oltre 2 anni, comincerà a scadere. I segmenti di pubblico in scadenza che rimangono inutilizzati per 90 giorni verranno eliminati.

delivery_estimate

Non puoi recuperare una stima di pubblicazione. Una chiamata per questo campo restituisce -1 per il pubblico simile non attivo. Questo campo è disponibile nei nodi Account pubblicitario e Gruppo di inserzioni. Entrambi mostrano lo stesso comportamento per il pubblico simile non attivo.

delete_time

Quando l'operation_status di un pubblico è stato contrassegnato come in scadenza (codice 100), il campo delete_time indica in tempo Unix quando il pubblico sarà eliminato.

Puoi iniziare una campagna anche con un pubblico simile non attivo. Le informazioni sulla stima della copertura sono disponibili dopo la pubblicazione della nuova inserzione.

Eliminazione

Per tutti gli inserzionisti a partire dall'8 giugno 2021 e in futuro, sposteremo automaticamente il pubblico alla fase "Pubblico in scadenza" quando sarà rimasto non attivo per oltre due anni. Ciò significa che, una volta che un pubblico raggiunge la soglia di non utilizzo in un gruppo di inserzioni attivo per oltre due anni, verrà automaticamente contrassegnato come "Pubblico in scadenza" e il campo delete_time sarà contrassegnato con il tempo di eliminazione stimato (ovvero 90 giorni dal momento in cui viene contrassegnato) quando è programmata l'eliminazione del pubblico.

Sarai quindi in grado di eliminare in modo proattivo il pubblico o utilizzare il pubblico in un gruppo di inserzioni attivo per impedire l'eliminazione. Puoi vedere quali dei tuoi segmenti di pubblico sono in scadenza in qualsiasi momento filtrando in base ai campi operation_status o delete_time.

Per ulteriori informazioni, consulta la documentazione relativa alla Panoramica dei gruppi di pubblico personalizzato.

Best practice

  • Pubblico personalizzato di base: rendilo il più ampio possibile per fornirci dati a sufficienza per trovare persone simili.
  • Pubblico simile combinato: con altri parametri di targetizzazione di Facebook per raccogliere ulteriori dati demografici o interessi.
  • Se il pubblico originale ha attributi come il genere o i dati geografici, il pubblico simile generato da esso può non aderire a questi attributi.

Modifiche per il pubblico simile in programma

AGGIORNAMENTO 28 APRILE 2021: La rimozione dei parametri location_spec e country dalla creazione del pubblico simile al momento è stata posticipata. Presto saranno comunicati aggiornamenti su quando entrerà in vigore questa modifica.

Rimuoveremo i parametri location_spec e country dalla creazione del pubblico simile. La posizione per il pubblico simile verrà definita dalla posizione del Paese nelle specifiche di targetizzazione della campagna. La posizione da targetizzare non farà parte delle specifiche del pubblico simile. La stima della copertura della campagna utilizzando un pubblico simile appena creato verrà popolata solo poche ore dopo la pubblicazione dell'inserzione.

Questa modifica non influirà in alcun modo sulle campagne esistenti, ma solo sulle campagne nuove e su quelle che sono state modificate.

Convertiremo automaticamente il pubblico simile legacy in uno nuovo senza posizione da targetizzare.

Modifiche alla creazione del pubblico simile

Modifiche del parametro relativo alla posizione

Endpoint:act_{AD_ACCOUNT_ID}/customaudiences

Esempio di richiesta

curl POST \
  -F 'name=My lookalike audience' \
  -F 'subtype=LOOKALIKE' \
  -F 'origin_audience_id=<SEED_AUDIENCE_ID>' \
  -F ‘lookalike_spec={
  "is_financial_service":false,
  "allow_international_seeds":true,
  "ratio":0.01,
  "type":"custom_ratio"}
  	’}\
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/customaudiences

I seguenti parametri verranno ignorati se passati durante la creazione:

  • lookalike_spec.country
  • lookalike_spec.location_spec
  • lookalike_spec.location_spec.geo_locations
  • lookalike_spec.location_spec.geo_locations.countries
  • lookalike_spec.location_spec.geo_locations.country_groups
  • lookalike_spec.location_spec.excluded_geo_locations
  • lookalike_spec.location_spec.excluded_geo_locations.countries
  • lookalike_spec.location_spec.excluded_geo_locations.country_groups

Modifiche del parametro relativo alla dimensione

Endpoint:act_{AD_ACCOUNT_ID}?fields=approximate_count

Non saranno presenti dimensioni associate ai nuovi gruppi di pubblico simile e il campo approximate_count restituirà -1 per tutti i gruppi di pubblico simile.

Esempio di risposta

{
    "approximate_count": -1,
    "id": "6126486105659",
}

Stato di pubblicazione e operativo

Endpoint:

  • {AD_ACCOUNT_ID}?fields=delivery_status
  • {AD_ACCOUNT_ID}?fields=operation_status

Il campo delivery_status per il precedente pubblico simile con specifiche della posizione restituirà un codice 400 con la descrizione This audience is disabled.. Per il nuovo pubblico simile restituirà una risposta con il codice 200.

Il campo operation_status restituirà una notifica di ritiro per il precedente pubblico simile con specifiche della posizione. Per il nuovo pubblico simile restituirà una risposta con il codice 200 e la descrizione Normal.

Consulta Pubblico personalizzato per maggiori informazioni su questi campi.

Modifiche ai gruppi di inserzioni

Modifica e creazione delle inserzioni

In caso di modifica della targetizzazione delle campagne esistenti con il pubblico simile legacy, aggiorneremo automaticamente le inserzioni in modo che utilizzino il nuovo pubblico simile. Il pubblico simile legacy non sarà più disponibile per essere utilizzato nelle campagne pubblicitarie appena create.

Poiché le specifiche della posizione non faranno più parte del processo di creazione del pubblico simile, dovrai impostare le posizioni da targetizzare durante la creazione di gruppi di inserzioni. Il tentativo di creare un gruppo di inserzioni senza la targetizzazione basata sulla posizione genererà un errore.

Tutte le modifiche precedenti saranno applicabili anche quando il pubblico è incluso in excluded_custom_audiences, flexible_spec, e exclusions nella campagna.

Endpoint:act_{AD_ACCOUNT_ID}/adsets

Esempio di richiesta

curl POST \
  -F 'targeting={
        "geo_locations":{
            "countries":["US"],
        },
        "age_min":25,
        "age_max":40,
        "custom_audiences":[{"id": <CUSTOM_AUDIENCE_ID>}]
  ‘}\
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/act_<AD_ACCOUNT_ID>/adsets

Il tentativo di creare un gruppo di inserzioni senza la targetizzazione basata sulla posizione genererà un errore.

{
  "error": {
    "message": "Invalid parameter",
    "type": "FacebookApiException",
    "code": 100,
    "error_data": {
      "blame_field_specs": [["targeting" ] ]
    },
    "error_subcode": 192342134,
    "is_transient": false,
    "error_user_title": "Missing Location while using Lookalike",
    "error_user_msg": "You need to use a location with your lookalike    audience.",
    "fbtrace_id": "F78cCCJoZPx"
  },
  "__fb_trace_id__": "F78cCCJoZPx",
  "__www_request_id__": "AcwlIc7_uK5uTXjzjIa38yc"
}

Si verificherà un errore se provi a modificare un gruppo di inserzioni contenente un pubblico simile legacy condiviso senza averne uno nuovo corrispondente nell'account pubblicitario titolare. Per risolvere il problema, devi richiedere all'account pubblicitario titolare di condividere il nuovo pubblico simile.

{
  "error": {
    "message": "Invalid parameter",
    "type": "FacebookApiException",
    "code": 100,
    "error_data": {
      "blame_field_specs": [["targeting" ] ]
    },
    "error_subcode": 192342135,
    "is_transient": false,
    "error_user_title": "",
    "error_user_msg": "Please ask the owner of the audience 1234 to share the new lookalike which does not contain location with you. You will be able to use the new audience"
    "fbtrace_id": "F78cCCJoZPx"
  },
  "__fb_trace_id__": "F78cCCJoZPx",
  "__www_request_id__": "AcwlIc7_uK5uTXjzjIa38yc"
}

Condivisione del pubblico simile

Durante il periodo di implementazioni di queste modifiche, la condivisione del pubblico simile tra gli account pubblicitari presenti e quelli non presenti nell'implementazione non è supportata tramite l'API. Utilizza Gestione del pubblico per gestire la condivisione. Dopo il 24 maggio 2021, puoi continuare a utilizzare la condivisione tramite API nel seguente documento per sviluppatori per condividere nuovi gruppi di pubblico simile tra gli account pubblicitari.

Endpoint:{AD_ACCOUNT_ID}/adaccounts?adaccounts={SHARED_TO_AD_ACCOUNT_ID}

Modifiche alla stima di copertura e pubblicazione

Endpoint:

  • act_{AD_ACCOUNT_ID}/reachestimate
  • act_{AD_ACCOUNT_ID}/delivery_estimate

Questi endpoint restituiranno un nuovo parametro targeting_status con una delle seguenti descrizioni:

  • lookalike_container_without_country: un nuovo pubblico simile non ha un Paese specificato nella targetizzazione della campagna. Per vedere il numero stimato di utenti è necessario un Paese.
  • lookalike_container_without_delivery_lookalike: un nuovo pubblico simile non ha un pubblico simile di back-end corrispondente. È necessario utilizzare il nuovo pubblico simile in un gruppo di inserzioni perché abbia effettivamente copertura.
  • none: non è presente alcun problema di copertura.

L'endpoint reachestimate restituirà -1 per il parametro users la prima volta in cui vengono utilizzati un nuovo pubblico simile e la targetizzazione basata sul Paese; successivamente verrà restituito il numero stimato degli utenti.

I parametri estimate_dau e estimate_mau restituiranno -1 per il parametro users la prima volta in cui vengono utilizzati un nuovo pubblico simile e la targetizzazione basata sul Paese; successivamente verrà restituito il numero stimato degli utenti.

Esempi di risposte

// Reach estimate response
{
    "users": -1,
    "estimate_ready": true,
    "targeting_status": "lookalike_container_without_delivery_lookalike"
}

// Delivery estimate response

{
    "data": [{
        "daily_outcomes_curve": [{
            "spend": 0,
            "reach": 0,
            "impressions": 0,
            "actions": 0
        }],
        "estimate_dau": -1,
        "estimate_mau": -1,
        "estimate_ready": true ,
        "targeting_status": "lookalike_container_without_delivery_lookalike"
    }]
}

FAQ

Queste modifiche entreranno in vigore dalla data di rilascio dell'API Marketing v11, quando applicheremo la modifica a tutte le versioni.

Durante il periodo tra l'API Marketing v10 e la v11, la condivisione del pubblico simile tra gli account pubblicitari presenti e quelli non presenti nell'implementazione non è supportata tramite l'API. Utilizza Gestione del pubblico per gestire la condivisione. Dopo il rilascio della versione 11 dell'API Marketing, puoi continuare a utilizzare la condivisione tramite API per condividere nuovi segmenti di pubblico simile tra gli account pubblicitari.