Inserzioni del catalogo Advantage+ per app mobili

Puoi configurare le inserzioni del catalogo Advantage+ su mobile con gli SDK di Facebook. Devi incorporare i deep link e i deferred deep link nella tua app per consentire alle persone di utilizzarla fruendo della migliore esperienza possibile.

Passaggio 1: configurazione dell'SDK di Facebook mobile per iOS/Android

Integra l'SDK di Facebook per iOS o Android.

Passaggio 2: configurazione degli eventi nell'app mobile

Sul web usa eventi del pixel di Meta come ViewContent per monitorare le interazioni degli eventi. Invece, sui dispositivi mobili puoi monitorare gli stessi eventi con App Events.

Devi inviare gli stessi tre eventi obbligatori dall'app nello stesso modo in cui esegui tale operazione dal pixel: ViewContent, AddToCart e Purchase. Questi eventi sono necessari per consentire il corretto funzionamento delle inserzioni del catalogo Advantage+.

Evento iOS	Evento Android	Equivalente web
`FBSDKAppEventNameViewedContent`	`AppEventsConstants:: EVENT_NAME_VIEWED_CONTENT`	`ViewContent`
`FBSDKAppEventNameAddedToCart`	`AppEventsConstants:: EVENT_NAME_ADDED_TO_CART`	`AddToCart`
`[[FBSDKAppEvents shared] logPurchase:(double) currency:(NSString ) parameters:(NSDictionary )];`	`AppEventsConstants:: EVENT_NAME_PURCHASED`	`Purchase`

Ad esempio, un evento ViewContent si attiva quando qualcuno guarda un prodotto in un'app:

[[FBSDKAppEvents shared] logEvent:FBSDKAppEventNameViewedContent
  valueToSum:54.23
  parameters:@{
    FBSDKAppEventParameterNameCurrency    : @"USD",
    FBSDKAppEventParameterNameContentType : @"product",
    FBSDKAppEventParameterNameContentID   : @"123456789"
  }
];

Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "1234");

logger.logEvent(AppEventsConstants.EVENT_NAME_VIEWED_CONTENT,
                120.00,
                parameters);

Puoi anche fornire un array di valori JSON per l'ID del prodotto quando si verifica un evento per più prodotti. Ad esempio, puoi inviare più prodotti con l'evento Purchase.

[[FBSDKAppEvents shared] logPurchase:54.23 currency : @"USD" parameters:@{
  FBSDKAppEventParameterNameContentID   : @"['1234','5678']",
  FBSDKAppEventParameterNameContentType : @"product"
  }
];

Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "['1234', '5678']");

logger.logEvent(AppEventsConstants.EVENT_NAME_PURCHASED,
                180.00,
                parameters);

Diversi ID contenuto

Se disponi di diversi ID contenuto, fornisci un array JSON preceduto da un carattere di escape, ad esempio:

"[\"1234\",\"5678\"]"

Parametri facoltativi

Per ciascun evento nell'app, puoi inviare ulteriori parametri da inviare quando qualcuno effettua un acquisto:

Nome	Descrizione
`_valueToSum` stringa	Facoltativo. Il valore del prodotto o l'importo dell'acquisto.
`fb_currency` stringa	Facoltativo. La valuta del prodotto o l'importo dell'acquisto.

Utilizzo di un Mobile Measurement Partner (MMP)

Se usi un Mobile Measurement Partner (MMP) approvato per riportare gli eventi a Facebook, puoi regolare la tua implementazione in modo da inviare anche gli eventi obbligatori. Anche se questo processo può variare a seconda dell'MMP, in genere è di questo tipo:

Regola la tua integrazione per riportare i tre eventi obbligatori all'MMP, insieme ai parametri obbligatori.
Con il tuo MMP, mappa i nomi degli eventi in base ai nomi degli eventi di Facebook.
Test degli eventi nell'app.

Eventi obbligatori per l'MMP

I seguenti eventi sono obbligatori:

Nome	Descrizione
`fb_mobile_content_view`	Quando un account del Centro gestione account ha visualizzato un prodotto.
`fb_mobile_add_to_cart`	Quando un articolo è stato aggiunto al carrello.
`fb_mobile_purchase`	Quando uno o più articoli sono stati acquistati.

Devi inviare anche altri due parametri affinché le inserzioni del catalogo Advantage+ funzionino:

L'ID dell'articolo visualizzato, aggiunto al carrello o acquistato.
Se l'ID è product o product_group.

I parametri aggiuntivi disponibili sono:

Nome	Descrizione
`fb_content_type` stringa	`product` o `product_group`
`fb_content_id` stringa	Obbligatorio. Una stringa contenente un array con codifica JSON di ID del gruppo di prodotti o del prodotto del rivenditore.
`_valueToSum` stringa	Facoltativo. Il valore del prodotto acquistato.
`fb_currency` stringa	Facoltativo. La valuta del prodotto o l'importo dell'acquisto.

Nota: devi inviare anche i parametri _valueToSum e fb_currency quando qualcuno acquista gli articoli.

Test degli eventi nell'app

Il modo più semplice per testare se l'integrazione funziona è lo Strumento di assistenza sulle inserzioni per le app per vedere gli eventi e i parametri segnalati a Facebook in tempo reale.

Seleziona un'app.
Vedrai due strumenti nella parte inferiore della pagina. Seleziona Test degli eventi nell'app.
Ci sono due opzioni: vedere gli eventi riportati da te o da uno specifico ID pubblicitario. Nella maggior parte dei casi, selezionare Io è sufficiente. Verifica di avere Facebook installato sul tuo dispositivo e di aver effettuato l'accesso.
Mentre effettui azioni nella tua app, gli eventi appaiono nello strumento con i relativi parametri.

Puoi vedere i nomi di questi tre eventi se la tua integrazione è stata eseguita correttamente:

FB_MOBILE_CONTENT_VIEW
FB_MOBILE_ADD_TO_CART
FB_MOBILE_PURCHASE

Scopri di più sugli eventi nell'app per iOS e Android.

Per verificare che gli eventi nell'app funzionino, puoi controllare gli eventi recenti in

Gestione eventi di Facebook

Passaggio 3: configurazione dei deep link

Includendo nel tuo elenco prodotti i deep link, chiunque interagisca con la tua inserzione su Facebook può andare direttamente a un luogo specifico della tua app. Ad esempio, quando qualcuno clicca su un'inserzione su Facebook da un dispositivo mobile, vede il prodotto nella tua app mobile. Per ulteriori informazioni, consulta Deep link e Verifica del deep link.

Fallback al web a confronto con l'app store

Se usi i deep link, puoi specificare il comportamento di fallback se qualcuno non ha installato la tua app. Quando includi i deep link nel tuo elenco prodotti, le persone che non dispongono della tua app vedono l'URL web del prodotto incluso nell'inserzione.

Dato che molto probabilmente il tuo obiettivo è aumentare le vendite nel catalogo, con altrettanta probabilità vuoi che le persone vedano le pagine del prodotto più che installino la tua app. Per questo, come impostazione predefinita usiamo gli URL web, ma puoi specificare un comportamento diverso per avere maggiore controllo. Imposta il comportamento di fallback su applink_treatment quando crei la tua inserzione del catalogo Advantage+ e utilizza una delle seguenti opzioni:

Nome	Descrizione
`web_only`	Invia sempre la persona all'URL web. In questo modo, verrà eseguito l'override di tutti i deep link nell'elenco.
`deeplink_with_web_fallback`	Se l'app è installata e abbiamo i tuoi deep link corrispondenti, invia l'utente alla tua app. Se una di queste condizioni non viene soddisfatta, invia l'utente all'URL del sito web.
`deeplink_with_appstore_fallback`	Se l'app è installata e abbiamo le informazioni sul deep link corrispondente, invia l'utente all'app. Se l'app non è installata, lo invia allo store delle app per scaricare l'app.

Passaggio 4: configurazione dell'elenco prodotti

Adesso devi fornire i deep link delle tue inserzioni del catalogo Advantage+. Per maggiori informazioni, consulta Catalogo prodotti, Deep link.

Passaggio 5: specifiche di monitoraggio

Per misurare gli eventi di conversione sia dal tuo sito web che dalle app mobili, assicurati che le inserzioni del catalogo Advantage+ abbiano l'insieme di Specifiche di monitoraggio corretto per questi eventi:

Evento	Specifica di monitoraggio
`offsite_conversion`	`{ 'action.type': 'offsite_conversion', 'fb_pixel': FB_PIXEL_ID }`
`app_custom_event`	`{'action.type':'app_custom_event','application':APP_ID}`
`mobile_app_install`	`{'action.type':'mobile_app_install','application':APP_ID}`

Facebook è quindi in grado di monitorare tutti gli eventi che si verificano da un'inserzione del catalogo Advantage+, indipendentemente dal fatto che qualcuno visualizzi il tuo sito web o la tua app. Per configurare le specifiche di monitoraggio:

use FacebookAds\Object\Ad;
use FacebookAds\Object\Fields\AdFields;

$ad = new Ad(<AD_ID>);

$ad->{'tracking_spec'} = array(
  array(
    'action.type' => array('app_custom_event'),
    'application' => array($app_id),
  ),
  array(
    'action.type' => array('offsite_conversion'),
    'offsite_pixel' => array(<PIXEL_ID>),
  ),
  array(
    'action.type' => array('mobile_app_install'),
    'application' => array($app_id),
  ),

);
$ad->update();

curl \
  -F 'tracking_spec=[ 
    {"action.type":["app_custom_event"],"application":["101"]}, 
    {"action.type":["offsite_conversion"],"offsite_pixel":["<PIXEL_ID>"]}, 
    {"action.type":["mobile_app_install"],"application":["101"]} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<AD_ID>