Moltiplicatori di offerta

Questa API è disponibile su base limitata per i partner e gli inserzionisti inclusi nella lista di elementi consentiti. Per utilizzarla, contatta il tuo rappresentante di Meta.

I moltiplicatori di offerta consentono agli inserzionisti di ridurre la quantità di segmentazione del pubblico richiesta, in quanto consente loro di mantenere una strategia di offerta articolata in un singolo gruppo di inserzioni con un unico pubblico targetizzato. Ad esempio, di solito gli inserzionisti creano gruppi di inserzioni per poter impostare offerte diverse per diversi segmenti di pubblico. Ad esempio, un inserzionista può creare 3 gruppi di inserzioni corrispondenti a 3 diverse fasce di età: 18-25, 26-35, 36-65. Con il moltiplicatore di offerta, un inserzionista può creare un singolo gruppo di inserzioni e utilizzare i moltiplicatori di offerta per impostare offerte diverse per ciascuna fascia.

Gli inserzionisti che pubblicano inserzioni relative al settore abitativo, creditizio e dell'occupazione, che hanno sede negli Stati Uniti o che pubblicano inserzioni destinate agli Stati Uniti, hanno serie diverse di restrizioni ed è disponibile un sottoinsieme di categorie di pubblico per modificare le offerte. Nelle campagne relative al settore abitativo, creditizio e dell'occupazione è vietato modificare le offerte per le categorie di pubblico age, gender, locale, home_location, user_bucket, e simile custom_audience (un pubblico personalizzato derivato da un pubblico simile). Consulta Categorie speciali di inserzioni.

A partire dal 30 gennaio 2023, le inserzioni che usano un moltiplicatore di offerta con categorie di dati di terzi (booking_window, custom_audience compreso il pubblico personalizzato simile, lungthofstay, travelstartdate, travelstartdayofweek, user_recency, user_bucket) non saranno più mostrate agli utenti che hanno rifiutato esplicitamente di fornire il consenso.

Best practice per i moltiplicatori di offerta

  • Adotta strategie di offerta personalizzate senza dover creare troppi segmenti di pubblico o gruppi di inserzioni. Questo contribuisce a ottenere una migliore pubblicazione delle inserzioni, consentendo di evitare una segmentazione delle campagne pubblicitarie in un numero eccessivo di gruppi di inserzioni con segmenti di pubblico relativamente piccoli.
  • In passato, potevi creare 3 gruppi di inserzioni corrispondenti a 3 diverse fasce di età. Quindi potevi impostare offerte separate per ciascuno di quei gruppi di inserzioni. Ora è invece possibile creare un singolo gruppo di inserzioni e utilizzare i moltiplicatori di offerta per impostare offerte diverse per ciascuna fascia di età; i moltiplicatori di offerta rientrano nell'intervallo da 0,09 a 1,0.
  • I moltiplicatori di offerta devono essere specificati sotto un'unica chiave user_groups.
  • I moltiplicatori di offerta sono disponibili per le campagne basate su aste.
  • Tutte le strategia di offerta sono supportate da moltiplicatori di offerta, nello specifico: limite di offerta, limite di costo e costo inferiore.

Configurare le categorie di pubblico

Con il moltiplicatore di offerta, puoi definire le categorie di pubblico e assegnare un moltiplicatore di offerta a ogni categoria. Le categorie di pubblico sono definite in base ai dati demografici dell'utente, al dispositivo dell'utente e ai dati personalizzati dell'inserzionista. Per le campagne relative al settore abitativo, creditizio e dell'occupazione è vietato assegnare le offerte in base alle categorie di pubblico age, gender, locale, home_location, user_bucket, e simile custom_audience (un pubblico personalizzato derivato da un pubblico simile).

PrioritàDescrizione

age

Consente di impostare offerte diverse in base all'età o alla fascia di età (non disponibile per campagne relative al settore abitativo, creditizio e dell'occupazione).

booking_window

Consente di impostare offerte diverse in base al numero di giorni che mancano all'inizio del viaggio.

custom_audience

Consente di impostare offerte in base al custom_audience di cui l'utente fa parte. Per questa opzione sono supportati i gruppi di pubblico simile, eccetto per le campagne relative al settore abitativo, creditizio e dell'occupazione.

device_platform

Consente di impostare offerte diverse in base alla piattaforma del dispositivo dell'utente, ad esempio dispositivo mobile o computer.

gender

Consente di impostare offerte diverse in base al genere. (non disponibile per campagne relative al settore abitativo, creditizio e dell'occupazione).

home_location

Consente di impostare offerte in base alla home_location dell'utente. Questo campo rappresenta la località di residenza dell'utente. Il moltiplicatore home_location può essere suddiviso in città, aree geografiche e Paesi. (non disponibile per campagne relative al settore abitativo, creditizio e dell'occupazione).

lengthofstay

Consente di impostare offerte in base al numero di giorni compresi tra l'inizio e la fine del viaggio.

locale

Consente di impostare offerte diverse in base alla lingua, ad esempio inglese o spagnolo (non disponibile per campagne relative al settore abitativo, creditizio e dell'occupazione).

position_type

Consente di impostare offerte in base alla posizione mostrata da un'inserzione; ad esempio, facebook_feed, facebook_marketplace o instagram_story.

publisher_platform

Consente di impostare offerte in base alla publisher_platform, ad esempio facebook, instagram, audience_network, messenger.

travelstartdate

Consente di impostare offerte diverse in base alla data di inizio del viaggio; ad esempio, 20181231 corrisponde al 31 dicembre 2018.

travelstartdayofweek

Consente di impostare offerte in base al giorno della settimana in cui inizia il viaggio. 0 corrisponde a lunedì, 6 corrisponde a domenica.

user_bucket

Consente di impostare offerte in base al valore user_bucket definito nell'attivazione del pixel o nell'evento nell'app dell'inserzionista. Il campo user_bucket è un parametro opzionale espresso con un numero intero compreso tra 0 e 100. (NOTA: 1. Non disponibile per campagne relative al settore abitativo, creditizio e dell'occupazione; 2. Disponibile soltanto per il settore degli hotel, ad es. se content_type="hotel")

user_device

Consente di impostare offerte in base al campo user_device, ad esempio iPhone. Vedi user_device

user_os

Consente di impostare offerte in base al campo user_os, come iOS o Android.

user_recency

Consente di impostare offerte in base all'ultima visita dell'utente sul sito o sull'app.

age

Consente di raggruppare gli utenti per fascia di età; ad esempio, 18-25, 26-35. A titolo di esempio, per un gruppo di inserzioni con un'offerta massima di 5 USD, imposta un'offerta di 2,5 USD per gli utenti di età compresa tra 18 e 25 anni, di 3,5 USD per gli utenti di età compresa tra 26 e 40 anni e di 5 USD per tutti gli altri utenti. Nota: la configurazione di un'impostazione predefinita è opzionale. Puoi applicare 1.0 come moltiplicatore.

Esempio

{
    "user_groups": {
      "age": {
        "18-25": 0.5,
        "26-40": 0.7,
        "default": 1.0
      }
    }
}

booking_window

I possibili valori dei dettagli includono qualsiasi intervallo di numeri interi pari o superiore a 1, ad esempio, 1-3, 4-9 e così via.

Esempio

curl -X POST \ 
  -F 'bid_adjustments=
     {"user_groups":{"booking_window":{"event_sources":["123456789"],"1-2":0.1,"3-5":0.2,"default":0.5}}}' \ 
  -F 'access_token='$access_token \ 
  https://graph.facebook.com/<API_VERSION>/<ad_set_id>

Consulta anche Esempio di moltiplicatore di viaggio.

custom_audience

A partire dal 30 gennaio 2023, le inserzioni che usano un moltiplicatore di offerta con categorie di dati di terzi (booking_window, custom_audience compreso il pubblico personalizzato simile, lungthofstay, travelstartdate, travelstartdayofweek, user_recency, user_bucket) non vengono più mostrate agli utenti che hanno rifiutato esplicitamente di fornire il consenso.

Puoi adeguare le offerte in base ai tuoi gruppi di pubblico personalizzato.

Esempio

curl -X POST \ 
  -F 'bid_adjustments=
     {"user_groups":{"custom_audience":{"<CUSTOM_AUDIENCE_ID>":0.8, "<CUSTOM_AUDIENCE_ID>":1.0, "default":0.5}}}' \ 
  -F 'access_token='$access_token \ 
  https://graph.facebook.com/<API_VERSION>/<ad_set_id>

device_platform

I possibili valori dei dettagli sono:

  • mobile
  • desktop

Esempio

{
  "user_groups": {
    "device_platform": {
      "mobile": 0.7,
      "desktop": 0.9
    }
  }
}

gender

Per raggruppare gli utenti per genere:

  • male
  • female
  • default

Esempio

{
  "user_groups": {
    "gender": {
      "male": 0.5,
      "female": 0.7,
      "default": 1.0
    }
  }
}

home_location

I possibili valori dei dettagli sono:

  • city id
  • region id
  • Codice Paese di 2 cifre

Puoi trovare city id e region id nell'API Search. Puoi effettuare query dal Tool di esplorazione per la API Graph o dal tuo terminale.

Nota: il valore di default può essere impostato solo in home_location, non per cities, regions o countries.

Esempio

{
  "user_groups": {
    "home_location": {
      "cities": {
         "2420605": 0.2
      },
      "regions": {
         "3847": 0.5
      },
      "countries": {
         "US": 0.2
      },
      "default": 0.8
     }
  }
}

length_of_stay

I possibili valori dei dettagli includono qualsiasi intervallo di numeri interi pari o superiore a 1, ad esempio, “1-3”, “4-9” e così via.

Esempio

curl -X POST \ 
  -F 'bid_adjustments=
  {"user_groups":{"length_of_stay":{"event_sources":["123456789"],"1-2":0.1,"3-     5":0.2,"default":0.5}}}' \ 
  -F 'access_token='$access_token \ 
  https://graph.facebook.com/<API_VERSION>/<ad_set_id>

Consulta anche Esempio di moltiplicatore di viaggio.

locale

Puoi utilizzare l'ID lingua o l'ID gruppo lingua, ad esempio 6 per l'inglese degli Stati Uniti o 5 per il tedesco.

Puoi trovare gli ID lingua con Targetizzazione ricerca, Lingua con type=adlocale. Ad esempio:

{
  "user_groups": {
    "locale": {
      6: 0.8,
      5: 0.3
    }
  }
}

position_type

Questa categoria è simile alle opzioni di posizione nell'API Targeting. I possibili valori dei dettagli sono:

PosizionamentoValore

Feed di Facebook

facebook_feed

Facebook Marketplace

facebook_marketplace

Feed dei video di Facebook

facebook_suggested_video

Colonna destra di Facebook

facebook_right_hand_column

Sezione Esplora aziende di Facebook

facebook_biz_disco_feed

Feed di Instagram

instagram_stream

Feed del profilo Instagram

instagram_profile_feed

Esplora di Instagram

instagram_explore

Home di Esplora di Instagram

instagram_explore_home

Posta di Messenger

messenger_messenger_home

Instagram Stories

instagram_story

Facebook Stories

facebook_story

Messenger Stories

messenger_story

Instagram Reels

instagram_reels

Facebook Reels

facebook_facebook_reels

Video in-stream di Facebook

facebook_instream_video

Inserzioni su Facebook Reels

facebook_facebook_reels_overlay

Risultati della ricerca di Facebook

facebook_search

Risultati della ricerca di Instagram

instagram_ig_search

Messaggi sponsorizzati di Messenger

Non supportato

Formato nativo, banner e interstitial di Audience Network

audience_network_classic

Video con premio di Audience Network

audience_network_rewarded_video

Video in-stream di Audience Network

Non supportato

Esempio

{
  "user_groups": {
    "position_type":{
        "facebook_feed":0.9,
        "messenger_messenger_home":0.7,
        "instagram_stream":0.8,
        "audience_network_classic":0.5,
        "default":0.4
    }
  }
}

publisher_platform

I possibili valori dei dettagli sono:

  • facebook
  • instagram
  • audience_network
  • messenger

Esempio

{
  "user_groups": {
    "publisher_platform": {
      "facebook": 0.7,
      "instagram": 0.9,
      "default": 1.0 // We'll apply bid multiplier 1.0 if no default is specified anyway
    }
  }
}

travel_start_date

I possibili valori dei dettagli includono qualsiasi intervallo di date in formato _yyyymmdd_-_yyyymmdd_.

Esempio

curl -X POST \ 
  -F 'bid_adjustments=
     {"user_groups":{"travel_start_date":{"event_sources":["123456789"],"20180901-20181001":0.2,"default":0.9}}}' \ 
  -F 'access_token='$access_token \ 
  https://graph.facebook.com/<API_VERSION>/<ad_set_id>

Consulta anche Esempio di moltiplicatore di viaggio.

travel_start_day_of_week

I possibili valori dei dettagli includono qualsiasi numero intero compreso tra 0 e 6, inclusi. 0 corrisponde a lunedì, 6 corrisponde a domenica.

Esempio

curl -X POST \ 
  -F 'bid_adjustments=
  {"user_groups":{"travel_start_day_of_week":{"event_sources":        ["123456789"],"0":0.1,"2":0.2,"6":0.3,"default":0.9}}}' \ 
  -F 'access_token='$access_token \ 
  https://graph.facebook.com/<API_VERSION>/<ad_set_id>

Consulta anche Esempio di moltiplicatore di viaggio.

user_bucket

Puoi inviarci i risultati del tuo sistema di classificazione utenti. Quindi, inviaci un parametro user_bucket aggiuntivo nelle attivazioni del pixel o negli eventi nell'app. Le fasce di utenti sono numeri interi da 0 a 100.

Specifica la definizione del gruppo della fascia di utenti con il seguente formato:

  • event_sources: origine dell'attivazione del pixel o dell'evento nell'app da monitorare.
  • event_retention: opzionale. Tempo, in secondi, per ignorare i valori user_bucket precedenti.
  • events_dedup_mode: opzionale. Flag per indicare quale valore user_bucket utilizzare quando una singola origine di eventi invia diversi valori user_bucket per lo stesso utente. Il valore predefinito è latest.
  • event_source_preference: opzionale. Flag per indicare quale user_bucket utilizzare quando più origini di eventi inviano diversi valori user_bucket per lo stesso utente. Il valore predefinito è latest.

Esempio

{
  "user_groups": {
   "user_bucket": {
      "event_sources": [<pixel_id>,<app_id>,...],
      "event_retention": 604800, // optional, exclude old events
      
      //optional, useful when multiple event sources have user_bucket
      "events_dedup_mode": "max"|"min"|"latest",
      
      //optional, dedup user_bucket values sent from one single event source
      "event_source_preference": "max"|"min"|"latest",
      
      "1":0.7, // these are the bid multipliers
      "2":1.0,
     }
  }
}

user_device

I possibili valori dei dettagli sono:

  • iPad
  • iPhone

Consulta altri valori possibili nell'API Targeting Search con type=adTargetingCategory e class=user_device.

Esempio

{
  "user_groups": {
    "user_device": {
      "iPad": 0.7,
      "iPhone": 0.9,
      "default": 1.0
    }
  }
}

Esempio

curl
  -F 'name=Test BM Adset '$(date +%s) \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=23843038336220329' \
  -F 'promoted_object={"product_set_id":"267888283975766"}' \
  -F 'targeting={
     "geo_locations": {"countries":["AQ"]},
     "dynamic_audience_ids": ["23842885952670329"],
     "publisher_platforms": ["facebook"]
    }' \
  -F 'bid_adjustments={"user_groups":{"user_device": {"iPad": 0.7, "iPhone": 0.9, "default": 1.0}}}' \
  -F 'status=PAUSED' \
  -F 'access_token='$access_token \
  https://graph.facebook.com/<API_VERSION>/act_1653439931385336/adsets

Esempio

curl
  -F 'name=Test BM Adset '$(date +%s) \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=23843038336220329' \
  -F 'promoted_object={"product_set_id":"267888283975766"}' \
  -F 'targeting={
     "geo_locations": {"countries":["AQ"]},
     "dynamic_audience_ids": ["23842885952670329"],
     "publisher_platforms": ["facebook"]
     }' \
  -F 'bid_adjustments={"user_groups":{"user_device": {"iPad": 0.7, "iPhone": 0.9, "default": 1.0}}}' \
  -F 'status=PAUSED' \
  -F 'access_token='$access_token \
   https://graph.facebook.com/<API_VERSION>/act_1653439931385336/adsets
   {"id":"23843038339320329"}

Esempio

curl
  -F 'access_token='$access_token \
  https://graph.facebook.com/VERSION/ID?fields=bid_adjustments
  {"bid_adjustments":{"user_groups":"{\"user_device\":    {\"default\":1,\"iPad\":0.7,\"iPhone\":0.9}}"},"id":"ID"}

Consulta anche Esempio avanzato.

user_group_weight_spec

I possibili valori dei dettagli sono:

  • age
  • gender
  • device_platform
  • publisher_platform
  • user_device
  • user_os

Consulta anche Esempio avanzato.

Esempio: user_group_weight_spec è una struttura JSON e ha un aspetto simile al seguente:

{
  <BREAKDOWN_NAME>: {
    <BREAKDOWN_VALUE_1>: <WEIGHT_VALUE> OR <NESTED_USER_GROUP_WEIGHT_SPEC>,
    <BREAKDOWN_VALUE_2>: <WEIGHT_VALUE> OR <NESTED_USER_GROUP_WEIGHT_SPEC>,
    <BREAKDOWN_VALUE_3>: <WEIGHT_VALUE> OR <NESTED_USER_GROUP_WEIGHT_SPEC>,
    ...
    "default": <WEIGHT_VALUE> OR <NESTED_USER_GROUP_WEIGHT_SPEC>, // optional, if not specified, we'll use 1.0
  }
}
{
  "age": {
    "18-25": 0.7,
    "26-35": {
      "gender": {
        "male": 0.9,
        "female": 1.0
      }
    },
    "default": 0.85
  }
}

* For users between the ages of 18 and 25, we apply bid multiplier 0.7.
* For male users between the ages of 26 and 35, we apply bid multiplier 0.9.
* For female users between the ages of 26 and 35, we apply bid multiplier 1.0.
* For all other users, we apply bid multiplier 0.85.

I valori dei dettagli corrispondono a fasce di età rappresentate da numeri interi, ad esempio 18-25, dove l'età minima è 18; gli intervalli non devono sovrapporsi.

Esempio

{
  "user_groups": {
    "age": {
      "18-25": 0.7,
      "30-40": 1.0,
      "default": 0.3
    }
  }
}

Esempio avanzato

> curl 
    -F 'bid_adjustments={"user_groups":{"user_device":{"iPad":0.3,"iPhone":{"user_os":{"Android":0.3,"iOS":{"age":{"18-35":0.3,"35-45":0.4}}}}}}}' -F access_token=$token https://graph.intern.facebook.com/v2.12/6089875504114
{"success":true}%
> curl -G 
   -d access_token=$token https://graph.intern.facebook.com/v2.12/6089875504114\?  fields\=bid_adjustments
{"bid_adjustments":{"user_groups":"{\"user_device\":{\"iPad\":0.3,\"iPhone\":{\"user_os\":{\"Android\":0.3,\"iOS\":{\"age\":{\"18-35\":0.3,\"35-45\":0.4}}}}}}"},"id":"6089875504114"}%

Esempi di moltiplicatore di viaggio

curl -X POST \
  -F 'bid_adjustments={"user_groups":{"travel_start_day_of_week":{"event_sources":["1862565504034757"],"1":0.1,"3":0.1,"default":0.9}}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<ADSET_ID>

  Length of Stay 'bid_adjustments={"user_groups":{"length_of_stay":{"event_sources":["1862565504034757"],"1-2":0.1,"3-7":0.2,"default":0.5}}}'
  Booking window 'bid_adjustments={"user_groups":{"booking_window":{"event_sources":["1862565504034757"],"1-2":0.1,"3-7":0.2,"default":0.5}}}'
  Travel start date: 'bid_adjustments={"user_groups":{"travel_start_date":{"event_sources":["1862565504034757"],"20180918-20190101":0.1,"default":0.5}}}'
  Day of week: 'bid_adjustments={"user_groups":{"travel_start_day_of_week":{"event_sources":["1862565504034757"],"1":0.1,"2":0.1,"0":0.2,"default":0.5}}}'

user_os

I possibili valori dei dettagli sono:

  • iOS
  • Windows

Consulta altri valori possibili nell'API Targeting Search con type=adTargetingCategory e class=user_os.

Valori attualmente supportati:

  • Android
  • Windows
  • Windows Phone
  • iOS

Esempio

{
  "user_groups": {
    "user_os": {
      "Android": 0.7,
      "iOS": 0.9,
      "default": 1.0
    }
  }
}

iOS14 Impact

Il moltiplicatore di offerta per le campagne di conversione sul sito web sarà interessato dalle modifiche alla normativa per iOS 14?

Sì, prevediamo una perdita di segnale e un'attribuzione meno identificabile dovuta alle modifiche per iOS 14, con conseguente riduzione dei segnali per gruppo di inserzioni. Nonostante la maggior parte delle categorie su cui fare offerte dovrebbe continuare a funzionare normalmente, i moltiplicatori per vicinanza nel tempo, pubblico personalizzato e user_bucket saranno interessati in caso di targetizzazione degli utenti di iOS 14.5, in quanto moltiplicatori dipendenti dagli eventi misurati dal pixel di FB o dall'API Conversions. Tutti gli altri moltiplicatori derivano dai dati del sito e non dipendono né dal pixel di FB né dall'API Conversions.

user_recency

Consente di raggruppare gli utenti in base al tempo considerando la presenza di attivazioni del pixel o eventi nell'app. Devi specificare le origini degli eventi da monitorare e le finestre temporali.

Esempio

Questo esempio mostra come applicare il moltiplicatore di offerta 1.0 agli utenti con attivazione del pixel o eventi nell'app entro 86400 secondi e così via.

{
  "user_groups": {
    "user_recency": {
      "event_sources": [<pixel_id>,<app_id>,...],
      "0-86400": 1.0,
      "86401-172800": 0.7,
      "default": 0.5
    }
  }
}

Presentazione di più dettagli

Puoi anche definire gruppi di utenti con dettagli multipli sostituendo il numero di un moltiplicatore di offerta mobile con un'ulteriore specificazione di dettagli. Ad esempio, un gruppo di inserzioni con configurazione di offerta massima di 5 USD e inferiore avrebbe un aspetto simile al seguente:

  • offerta di 4,5 USD per utenti di sesso maschile
  • offerta di 3,5 USD per utenti di sesso femminile di età compresa tra 18 e 25 anni
  • offerta di 4,0 USD per utenti di sesso femminile di età compresa tra 26 e 35 anni
  • offerta di 5,0 USD per tutti gli altri utenti
{
  "user_groups": {
    "gender": {
      "male": 0.9,
      "female": {
        "age": {
          "18-25": 0.7,
          "26-35": 0.8
        }
      }
    }
  }
}

Requisiti di utilizzo

  • Il valore del moltiplicatore di offerta può variare da 0.09 a 1.0.

Chiamate API

Ottieni

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<ADSET_ID>?fields=bid_adjustments

Aggiorna

curl \
  -F 'bid_adjustments={"user_groups":<USER_GROUP_WEIGHT_SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/<ADSET_ID>

Creazione o aggiornamento del moltiplicatore di offerta per un gruppo di inserzioni

In basso è riportato un esempio di chiamata API per aggiornare un gruppo di inserzioni esistente (dovrai sostituire ID del gruppo di inserzioni, token d'accesso, origini dell'evento e i moltiplicatori di offerta desiderati).

curl -X POST \
  -F 'bid_adjustments={
       "user_groups": {
         "user_bucket": {
           "event_sources": [
             "<PIXEL_ID>",
             "<APP_ID>"
           ],
           "1": 0.1,
           "2": 0.2,
           "3": 0.3,
           "default": {
             "gender": {
               "male": 0.99,
               "female": 0.12
             }
           }
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<AD_SET_ID>/

Configurazione di una campagna di prova

Crea le tue campagne di prova utilizzando un conversion lift o un test A/B, lavorando con il tuo team commerciale di Meta e il responsabile delle misurazioni. Per valutare le prestazioni, suggeriamo le seguenti celle in un test A/B a 3 vie:

  • Cella 1 (Controllo A), Campagna 1: 1 gruppo di inserzioni con 1 offerta per tutti gli utenti targetizzati
  • Cella 2 (Controllo B), Campagna 2: gruppi di inserzioni multipli in cui creiamo un gruppo di inserzioni per ciascun gruppo di utenti (puoi utilizzare le regole relative al pubblico personalizzato dal sito web/dispositivo mobile per effettuare la segmentazione in base ai parametri pixel/app).
  • Cella 3 (Test), Campagna 3: 1 gruppo di inserzioni con diversi moltiplicatori di offerta per diversi gruppi di utenti. Assicurati che l'offerta adeguata a ciascun gruppo di utenti qui coincida con l'offerta al livello del gruppo di inserzioni per il gruppo di inserzioni corrispondente nella Cella 2.

Configurazione dei test A/B

A questo punto, dovresti configurare i test A/B e i gruppi di controllo per verificare le prestazioni utilizzando il moltiplicatore di offerta. Noi eseguiamo i test per 1-2 settimane e non richiediamo un budget minimo. Configura i test A/B come segue:

  • Cella 1, Controllo A Deve contenere un gruppo di inserzioni con un importo dell'offerta e la targetizzazione deve essere basata su tutti i valori user_bucket.
  • Cella 2, Controllo B Deve contenere più gruppi di inserzioni con un gruppo di inserzioni per user_bucket. Ogni gruppo di inserzioni deve targetizzare un valore user_bucket separato e l'offerta corrispondente. Puoi utilizzare le regole relative al pubblico personalizzato dal sito web o dai dispositivi mobili per effettuare un'ulteriore segmentazione del tuo pubblico in base ad altri parametri relativi al pixel di Meta o ad App Events. Consulta Pubblico personalizzato dal sito web e Pubblico personalizzato dall'app mobile.
  • Cella 3, Test Contiene un gruppo di inserzioni con la tua proprietà bid_adjustment per determinare diverse offerte per ciascun valore user_bucket. I tuoi moltiplicatori devono corrispondere alle singole offerte dei gruppi di inserzioni per la Cella 2, Controllo B.

Per maggiori informazioni, consulta Test A/B.

Configurazione di una campagna di prova

Configura una campagna pubblicitaria in modo analogo alle campagne normali. Contatta il tuo rappresentante di Meta per ottenere aiuto con la configurazione dell'adeguamento dell'offerta.

Configura user_groups e diversi moltiplicatori di offerta per ogni gruppo. I tuoi gruppi si basano su proprietà relative ai dati demografici, come l'età e il genere, e su proprietà specifiche, come il punteggio utente o il programma fedeltà. Ad esempio:

{
   "user_bucket":{
      "business_id":253286871795863,
      "1":0.7,
      "2":1.0,
      "3":{
         "gender":{
            "male":1.0,
            "female":0.8
         }
      },
      "default": 0.9
   }
}

In questo esempio:

  • Per gli utenti con valore loyalty_program pari a 1, applica il moltiplicatore di offerta 0,7
  • Per gli utenti con valore loyalty_program pari a 2, applica il moltiplicatore di offerta 1,0
  • Per gli utenti di sesso maschile con valore loyalty_program pari a 3, applica il moltiplicatore di offerta 1,0
  • Per gli utenti di sesso femminile con valore loyalty_program pari a 3, applica il moltiplicatore di offerta 0,8
  • Per gli utenti con loyalty_program diverso da 1, 2 o 3, applica il moltiplicatore di offerta 0,9
  • Per tutti gli altri utenti, applica il moltiplicatore di offerta 1,0

Ora puoi creare la campagna pubblicitaria:

curl -X POST \
  -F 'name="My Adset with bid multiplier"' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'daily_budget=3000' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'optimization_goal="OFFSITE_CONVERSIONS"' \
  -F 'bid_amount=500' \
  -F 'bid_adjustments={
       "user_groups": {
         "gender": {
           "male": 0.8,
           "female": 1
         }
       }
     }' \
  -F 'promoted_object={
       "product_set_id": "<PRODUCT_SET_ID>",
       "custom_event_type": "ADD_TO_CART"
     }' \
  -F 'targeting={
       "facebook_positions": [
         "feed"
       ],
       "geo_locations": {
         "countries": [
           "US"
         ]
       }
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

Una volta creati i tuoi gruppi di inserzioni, imposta bid_adjustments sul gruppo di inserzioni tramite l'API. Dovresti visualizzare un parametro simile a questo:

{
  "user_groups": {
    "user_bucket": {
      "event_sources": [<pixel_id>,<app_id>,...],
      "event_source_preference": "max"|"min"|"latest", //optional, useful when multiple event sources have user_bucket
      "events_dedup_mode": "max"|"min"|"latest", //optional, dedup user_bucket values sent from one single event source
      "event_retention": 604800, // optional, exclude old events
      "1":0.7, // these are the bid multipliers
      "2":1.0,
      "default": { // used in the case that we don't have user_bucket for that user
         gender:{ // this is a nested example, but you could just do "default": 1.0,
            "male": {
              home_location: {
                  cities: { // city id, can be found in search API, eg: search?type=adgeolocation&q=Menlo Park&limit=10
                    "2420605": 0.2,
                  },
                  regions: {
                    "3847": 0.5
                  },
                  countries: {
                    "US": 0.2
                  }
                }
              }
            },
            "female": {
              "user_recency": {
                "event_sources": [<pixel_id>,<app_id>,...],
                "0-86400": 0.5,
                "86400-172800": 0.7,
                "default": 0.2
              }
            }
         },
      },
   },
}

Attualmente non convalidiamo questo parametro. Invia il tuo ID del gruppo di inserzioni al tuo rappresentante di Meta così potremo verificarlo manualmente.

Per ciascuna origine dell'evento, viene utilizzato il valore user_bucket ricevuto più di recente per quell'utente. Tuttavia, se sono specificate più origini dell'evento (ad es., pixel e app) e 2 o più di esse hanno il proprio valore user_bucket registrato, prendiamo in considerazione il valore massimo.

In basso è riportato un esempio di chiamata per aggiornare un gruppo di inserzioni esistente. Devi fornire il tuo ID del gruppo di inserzioni, il token d'accesso, le origini dell'evento e i moltiplicatori di offerta:

curl -X POST 
  -F access_token=<access_token> \
  -F 'bid_adjustments={"user_groups": {"user_bucket": {"event_sources": [<pixel_id>,  <app_id>,...], "1": 0.1, "2": 0.2, "3": 0.3, "default": {"gender": {"male": 0.99, "female": 0.1}} }} }' \ 
  https://graph.facebook.com/<VERSION>/<ad-set-id>