A partire dal rilascio dell'API Marketing v15.0, non potrai più creare gruppi di pubblico dell'inserzione speciale. Per maggiori informazioni, consulta Gruppi di pubblico dell'inserzione speciale.
Tutte le aziende che utilizzano l'API Marketing sono tenute a indicare se le loro campagne (nuove o modificate) rientrano in una categoria speciale di inserzioni. Al momento, le categorie a disposizione sono: alloggi, occupazione, credito o temi sociali, elezioni e politica. Le aziende le cui inserzioni non rientrano in una categoria speciale devono indicare NONE
o inviare un array vuoto nel campo special_ad_categories
.
Nota: se è selezionata una qualsiasi delle special_ad_categories
, devi impostare anche un campo special_ad_category_country
.
Le aziende che pubblicano inserzioni relative ad abitazioni, impiego o credito devono rispettare le restrizioni del pubblico e della targetizzazione. L'etichetta special_ad_categories
non si applica alla targetizzazione delle inserzioni su temi sociali, elezioni e politica.
A partire dall'introduzione dell'API Marketing v7.0, il campo special_ad_category
è stato sostituito da special_ad_categories
(segnaliamo il passaggio dal singolare al plurale). Questo nuovo campo riceve un array.
Tutti gli inserzionisti devono indicare categorie speciali di inserzioni al momento della creazione delle campagne pubblicitarie. Il campo relativo alla categoria speciale di inserzioni può contenere una o più di queste voci:
HOUSING
CREDIT
EMPLOYMENT
ISSUES_ELECTIONS_POLITICS
NONE
Anche nel caso in cui la campagna non dovesse includere inserzioni relative al settore abitativo, dell'occupazione, creditizio o a temi sociali, elezioni e politica, gli inserzionisti devono comunque indicare una categoria scegliendo NONE
o inviando a Facebook un array vuoto.
Se selezioni il settore abitativo, dell'occupazione o creditizio, l'insieme di opzioni di targetizzazione disponibili per le inserzioni di queste campagne sarà limitato.
Se selezioni temi sociali, elezioni e politica, ti verrà chiesto di indicare il Paese in cui intendi pubblicare le inserzioni. Devi aver ottenuto l'autorizzazione a pubblicare inserzioni su temi sociali, elezioni e politica nel Paese indicato.
Il campo special_ad_category
è stato sostituito da special_ad_categories
(segnaliamo il passaggio dal singolare al plurale), quindi gli inserzionisti non possono più utilizzare il campo special_ad_category
. Più in basso troverai informazioni relative all'API Marketing v6.0 e precedenti.
La creazione di tutte le campagne richiede il campo special_ad_categories
. Se la tua campagna non richiede una categoria speciale di inserzioni, puoi inserire un array vuoto o usare il valore NONE
.
curl -X POST \ -F 'name="My special category campaign"' \ -F 'objective="LINK_CLICKS"' \ -F 'status="PAUSED"' \ -F 'access_token=<Access_TOKEN>' \ -F 'special_ad_categories="[\'EMPLOYMENT\']"'\ https://graph.facebook.com/v7.0/act_<AD_ACCOUNT_ID>/campaigns
Scopri di più sulle categorie speciali di inserzioni nel Centro assistenza per le inserzioni.
special_ad_category
per indicare una categoria speciale di inserzioni. NONE
nel campo special_ad_category
.ISSUES_ELECTIONS_POLITICS
Gli inserzionisti che pubblicizzano annunci su temi sociali, elezioni e politica devono specificare special_ad_categories
quando creano una campagna pubblicitaria. Inoltre, devono impostare il flag authorization_categor
al livello di creatività dell'inserzione: utilizzare POLITICAL
per le inserzioni politiche e, a partire dal 9 gennaio 2024, utilizzare POLITICAL_WITH_DIGITALLY_CREATED_MEDIA
per le inserzioni che contengono contenuto multimediale creato o modificato digitalmente.
Puoi creare intere campagne contenenti inserzioni su temi sociali, elezioni e politica invece che inserzioni individuali con questo tipo di contenuti. Non è più possibile combinare inserzioni su temi sociali, elezioni e politica con inserzioni su temi diversi all'interno di una singola campagna pubblicitaria. Inoltre, non è più possibile contrassegnare individualmente le inserzioni come riferite a temi sociali, elezioni e politica.
Per creare una campagna su temi sociali, elezioni o politica, passa il valore ISSUES_ELECTIONS_POLITICS
nel campo special_ad_categories
. Agli inserzionisti è consentito combinare questa categoria con altre, passando più valori nel campo.
Se è selezionata una qualsiasi delle special_ad_categories
, devi impostare anche un campo special_ad_category_country
, che indica il Paese in cui intendi pubblicare le inserzioni su temi sociali, elezioni o politica. Il campo special_ads_category_country
:
ISO Alpha 2
;Per pubblicare inserzioni su temi sociali, elezioni o politica:
Per creare una campagna su temi sociali, elezioni o politica:
curl -X POST \ -F 'name="My special category campaign"' \ -F 'objective="LINK_CLICKS"' \ -F 'status="PAUSED"' \ -F 'access_token=<Access_TOKEN>' \ -F 'special_ad_categories="[\'ISSUES_ELECTIONS_POLITICS\']" '\ -F 'special_ad_category_country="[\'US\']" '\ https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns
Per creare una campagna con categorie multiple:
curl -X POST \ -F 'name="My special category campaign"' \ -F 'objective="LINK_CLICKS"' \ -F 'status="PAUSED"' \ -F 'access_token=<Access_TOKEN>' \ -F 'special_ad_categories="[\'EMPLOYMENT\', \'ISSUES_ELECTIONS_POLITICS\']" '\ -F 'special_ad_category_country="[\'US\']" '\ https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns
Per tutte le campagne attive viene assegnato in maniera predefinita NONE
nel campo special_ad_category
. Se pubblichi inserzioni in una categoria speciale di inserzioni, devi effettuare queste modifiche:
Ricrea la campagna indicando special_ad_category
. Consulta Creazione di una nuova campagna per maggiori dettagli.
Aggiorna le impostazioni di targetizzazione e modifica special_ad_category
:
tune_for_category
al livello del gruppo di inserzioni. Usando tune_for_category
, rispetterai subito le nuove restrizioni:curl -i -X POST \ -F 'tune_for_category=EMPLOYMENT' https://graph.facebook.com/<API_VERSION>/<ADSET_ID>
special_ad_category
con una richiesta POST
a /<AD_CAMPAIGN_ID>
. Includi le informazioni sulla categoria:curl -i -X POST \ https://graph.facebook.com/<API_VERSION>/<AD_CAMPAIGN_ID>?special_ad_category=EMPLOYMENT
Usando tune_for_category
, otterrai questi risultati per la campagna pubblicitaria e i gruppi di inserzioni:
Funzioni mantenute | Funzioni rimosse |
---|---|
|
|
Funzioni aggiornate | Funzioni rimosse |
---|---|
|
|
Per creare una campagna pubblicitaria con una special_ad_category
, segui la procedura di creazione standard delle campagne e aggiungi special_ad_category
. Ecco un esempio:
curl -X POST \ -F 'name="My special category campaign"' \ -F 'objective="LINK_CLICKS"' \ -F 'status="PAUSED"' \ -F 'access_token=<ACCESS_TOKEN>' \ -F 'special_ad_category=EMPLOYMENT' \ https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns
Per creare una campagna con NONE
come special_ad_category
:
curl -X POST \ -F 'name="My campaign"' \ -F 'objective="LINK_CLICKS"' \ -F 'status="PAUSED"' \ -F 'access_token=<ACCESS_TOKEN>' \ -F 'special_ad_category=NONE' \ https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaignsRiferimento: Campagna
Le seguenti restrizioni valgono per gli inserzionisti che pubblicano inserzioni relative al settore abitativo, dell'occupazione e creditizio.
A partire da dicembre 2021, gli inserzionisti che pubblicano inserzioni relative al settore abitativo, dell'occupazione e creditizio devono indicare special_ad_categories
durante la creazione della campagna pubblicitaria. Se è selezionata una qualsiasi delle special_ad_categories
, devi impostare anche un campo special_ad_category_country
. Il campo special_ad_category_country
per le inserzioni relative al settore abitativo, dell'occupazione e creditizio:
Le aziende al di fuori degli Stati Uniti che targetizzano gruppi di pubblico al di fuori di Stati Uniti, Canada ed Europa, dove al momento valgono queste restrizioni, devono anche passare il campo relativo alle categorie speciali di inserzioni, ma possono scegliere di aderire o meno alle restrizioni della targetizzazione. A prescindere dal fatto che la campagna proponga opportunità relative al settore abitativo, dell'occupazione o creditizio, queste aziende possono non aderire indicando NONE
nel campo relativo alle categorie speciali di inserzioni o aderire alla targetizzazione di tali categorie indicando che l'inserzione propone opportunità in tali settori.
Scopri di più su conformità e applicazione.
Se vuoi pubblicare inserzioni su opportunità relative al settore abitativo, dell'occupazione o creditizio destinate all'Europa, dovrai dichiarare le categorie speciali di inserzioni pertinenti entro il 7 dicembre 2021. Le inserzioni che rientrano in una categoria speciale hanno a disposizione un insieme di categorie di targetizzazione ridotto.
Gli inserzionisti che pubblicano inserzioni relative al settore abitativo, dell'occupazione e creditizio e hanno sede negli Stati Uniti o pubblicano inserzioni destinate a Stati Uniti, Canada o Europa sono soggetti a queste limitazioni al livello di gruppo di inserzioni e inserzione:
HOUSING
in special_ad_category
.Gli inserzionisti che pubblicano inserzioni su opportunità relative al settore abitativo, dell'occupazione e creditizio con sede negli Stati Uniti o che pubblicano inserzioni destinate a Stati Uniti, Canada o Europa hanno un insieme di opzioni di targetizzazione limitato fra cui scegliere. Ad esempio, non sono disponibili le opzioni di targetizzazione che descrivono o possono sembrare correlate a categorie protette che potrebbero includere dati demografici, comportamenti o interessi.
Le restrizioni sono:
Le opzioni sono generalmente definite in modo da includere le fasce di età da 18 a più di 65 anni per le inserzioni relative al settore abitativo, dell'occupazione e creditizio. Tuttavia, gli inserzionisti che pubblicano inserzioni relative al settore creditizio destinate all'Europa possono selezionare una fascia di età diversa per soddisfare i requisiti del settore e locali per questa categoria speciale di inserzioni.
Non è possibile targetizzare generi specifici. Hai due opzioni a disposizione:
genders
.genders
predefinito: Tutti i generi.subcity
neighborhood
metro_area
small_geo_area
subneighborhood
electoral_district
zips
Non disponibile. Per raggiungere nuove persone, crea un pubblico dell'inserzione speciale.
A partire dal rilascio dell'API Marketing v15.0, non potrai più creare gruppi di pubblico dell'inserzione speciale. I seguenti endpoint saranno dichiarati obsoleti:
POST /{ad-account-id}/customaudiences?fields=subtype
POST /{custom-audience-id}
POST /{ad-account-id}/adsets?fields=subtype
POST /{ad-campaign}?fields=subtype
GET /{ad-account-id}/customaudiences?fields=operation_status
Aggiorna il codice per evitare errori.
Gli inserzionisti che pubblicano inserzioni relative al settore abitativo, dell'occupazione e creditizio non possono accedere al pubblico simile. Possono invece creare un Pubblico dell'inserzione speciale che avrà maggiori restrizioni relativamente ai fattori considerati.
Crea un nuovo pubblico con una richiesta POST
a /act_<AD_ACCOUNT_ID>/customaudiences
. Il campo subtype
deve essere impostato su REGULATED_CATEGORIES_AUDIENCE
.
curl -X POST \ -F 'origin_audience_id=<SEED_AUDIENCE_ID>' \ -F 'subtype=REGULATED_CATEGORIES_AUDIENCE' -F 'regulated_audience_spec={"country": "US", "ratio": 0.1}' \ https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/customaudiences
Carica il tuo pubblico dell'inserzione speciale con una richiesta GET
. Indica le informazioni che ti interessano in fields
:
curl -X GET \ -d 'fields=regulated_audience_spec' https://graph.facebook.com/<API_VERSION>/<AUDIENCE_ID>
I risultati si presenteranno così:
"regulated_audience_spec": { "country": "US", "origin": [ { "id": "<SEED_AUDIENCE_ID>", "name": "My Seed Audience", "type": "custom_audience" } ], "ratio": 0.05, "type": "custom_ratio", "target_country_names": [ "United States" ] }
Nell'API Marketing v3.2 abbiamo introdotto un nuovo stato di pubblicazione delle inserzioni grazie al quale è possibile impostare campagne, gruppi di inserzioni o inserzioni su WITH_ISSUES
, se per qualsiasi ragione non fosse possibile pubblicarli. Nella lettura di un oggetto, puoi esaminare WITH_ISSUES
per risolvere i problemi legati all'oggetto.
Una chiamata a un oggetto con "effective_status": "WITH_ISSUES"
restituisce un campo chiamato issues_info
, con informazioni relative ai problemi riscontrati. Lavorando con una categoria speciale di inserzioni, potresti imbatterti in questi problemi:
error_code | error_message | error_summary |
---|---|---|
| Certificazione obbligatoria | Un amministratore aziendale deve esaminare e accettare la nostra normativa di non discriminazione prima che tu possa pubblicare inserzioni. Può essere consultata in Impostazioni business > Utenti di sistema. Link al Centro assistenza: https://www.facebook.com/business/help/338925176776440. |
| Non è possibile selezionare una fascia di età personalizzata | La fascia d'età che hai selezionato per il tuo pubblico non è disponibile quando pubblichi inserzioni in questa categoria speciale di inserzioni. Seleziona la fascia d'età che soddisfa i tuoi requisiti locali e del settore per questa categoria speciale di inserzioni. |
| Pubblico salvato non disponibile | I gruppi di pubblico salvati non sono disponibili quando pubblichi inserzioni in questa categoria speciale di inserzioni. Per risolvere questo problema e completare la creazione della tua campagna, rimuovi tutti i gruppi di pubblico salvati selezionati. |
| Pubblico simile non disponibile | I gruppi di pubblico simile non sono disponibili quando pubblichi inserzioni in questa categoria speciale di inserzioni. Per risolvere questo problema e completare la creazione della tua campagna, rimuovi tutti i gruppi di pubblico simile che hai selezionato. Per raggiungere nuove persone, puoi creare un pubblico dell'inserzione speciale. |
| Non è possibile scegliere un raggio per il luogo | Non è possibile scegliere {category} come raggio per il luogo quando pubblichi inserzioni in questa categoria speciale di inserzioni. Per risolvere questo problema e completare la creazione della tua campagna, seleziona un raggio per il luogo superiore al valore minimo richiesto dal luogo personalizzato. |
| Selezione della targetizzazione dettagliata non disponibile | La selezione della targetizzazione dettagliata {name} ({id}) non è disponibile quando pubblichi inserzioni in questa categoria speciale di inserzioni. Per risolvere questo problema e completare la creazione della tua campagna, rimuovi questa selezione di targetizzazione. |
| L'esclusione del luogo non è disponibile | L'esclusione di luoghi specifici non è disponibile quando pubblichi inserzioni in questa categoria speciale di inserzioni. Per risolvere il problema e completare la creazione della tua campagna, rimuovi tutte le esclusioni di luoghi. |
| Non è possibile selezionare un genere personalizzato | Non è possibile selezionare un genere personalizzato quando pubblichi inserzioni in questa categoria speciale di inserzioni. Per risolvere il problema e completare la creazione della tua campagna, aggiorna il tuo pubblico per includere tutti i generi. |
| Non è possibile selezionare un luogo | Non è possibile scegliere {category} quando pubblichi inserzioni in questa categoria speciale di inserzioni. Per risolvere questo problema e completare la creazione della tua campagna, rimuovi questa selezione del luogo. Tutti i luoghi selezionati devono includere un raggio minimo dalla città o dall'indirizzo che è stato selezionato o dal luogo personalizzato. Non è possibile selezionare un CAP. |
| L'esclusione della targetizzazione dettagliata non è disponibile | L'esclusione di comportamenti, dati demografici o interessi non è disponibile quando pubblichi inserzioni in questa categoria speciale di inserzioni. Per risolvere questo problema e completare la creazione della tua campagna, rimuovi tutte le esclusioni della targetizzazione dettagliata. |
| L'espansione della targetizzazione non è disponibile | L'espansione della targetizzazione non è disponibile quando pubblichi inserzioni in questa categoria speciale di inserzioni. Per risolvere il problema e completare la creazione della tua campagna, rimuovi la selezione relativa all'espansione della targetizzazione. |
| Selezione degli interessi non disponibile | La selezione della targetizzazione dettagliata {category} non è disponibile quando si pubblicano inserzioni in questa categoria speciale di inserzioni. Per risolvere questo problema e completare la creazione della tua campagna, rimuovi questa selezione di targetizzazione. |
| Impossibile usare i moltiplicatori dell'offerta | Non puoi utilizzare i moltiplicatori dell'offerta in una categoria speciale di inserzioni. |
| Non è possibile escludere determinati gruppi di pubblico | L'esclusione di gruppi di pubblico simile e gruppi di pubblico per le inserzioni speciali non è disponibile quando pubblichi inserzioni in questa categoria speciale di inserzioni. Per risolvere il problema e completare la creazione della tua campagna, rimuovi tutte le esclusioni di gruppi di pubblico simile e gruppi di pubblico per le inserzioni speciali. |
Per ricevere assistenza sull'interpretazione di avvisi ed errori, consulta questo post sul blog per sviluppatori dedicato all'argomento.
Se utilizzi l'API Marketing v5.0 o successiva, il campo relativo alle categorie speciali di inserzioni è obbligatorio per tutte le inserzioni, a prescindere dal fatto che siano o meno su opportunità relative al settore abitativo, dell'occupazione o creditizio.
A partire dal 4 dicembre 2019, le aziende con sede negli Stati Uniti o che targetizzano utenti negli Stati Uniti sono tenute a indicare le campagne pubblicitarie nuove e modificate relative al settore abitativo, dell'occupazione o creditizio. Diversamente, non potranno pubblicare inserzioni. A partire da questa data, le aziende con sede negli Stati Uniti o che targetizzano utenti negli Stati Uniti devono indicare una special_ad_category
per le campagne nuove e modificate e usare i criteri del pubblico limitato disponibili per queste campagne. Questo vale per tutti i luoghi in cui è possibile acquistare inserzioni, compresa l'API Marketing.
L'11 febbraio 2020 è la data di riferimento per le inserzioni attive che offrono opportunità relative al settore abitativo, dell'occupazione o creditizio.
A partire dal 31 marzo 2020, tutte le inserzioni nuove e modificate che usano l'API Marketing, incluse tutte le aziende che non offrono opportunità relative al settore abitativo, dell'occupazione o creditizio, dovranno indicare NONE
in special_ad_category
.
A partire dal 3 dicembre 2020, gli inserzionisti che targetizzano persone in Canada e pubblicano inserzioni su opportunità relative al settore abitativo, dell'occupazione o creditizio sono tenuti a dichiarare le categorie speciali di inserzioni pertinenti.
A partire dal 7 dicembre 2021, gli inserzionisti che targetizzano persone in Europa e pubblicano inserzioni su opportunità relative al settore abitativo, dell'occupazione o creditizio sono tenuti a dichiarare le categorie speciali di inserzioni pertinenti.
Oltre a richiedere agli inserzionisti di indicare autonomamente la categoria delle proprie campagne, continuiamo ad affidarci a persone addette al controllo e all'apprendimento automatico per individuare inserzioni di questo tipo. Se ci invii il campo special_ad_category
errato, le tue inserzioni potrebbero essere messe in pausa fino a quando non correggerai le impostazioni della campagna.
Se selezioni HOUSING
, EMPLOYMENT
o CREDIT
come special_ad_category
, tutte le restrizioni della targetizzazione saranno applicate con un errore critico.
Facebook si impegna a proteggere le persone dalla discriminazione. Miglioriamo continuamente la nostra capacità di individuare e scoraggiare potenziali violazioni. È contro le nostre normative discriminare targetizzando o escludendo ingiustamente gruppi specifici di persone.
Come parte di un accordo transattivo storico, abbiamo apportato modifiche al modo in cui gestiamo le inserzioni relative a settore abitativo, creditizio e dell'occupazione. Abbiamo creato le categorie speciali di inserzioni per sostenere questo impegno. Gli inserzionisti che propongono inserzioni relative al settore abitativo, dell'occupazione o creditizio hanno possibilità di selezione limitate relativamente a targetizzazione e pubblico.