API Conversions per gli eventi nell'app

L'API Conversions consente agli inserzionisti di inviare eventi web, nell'app, nei punti vendita fisici e relativi alla messaggistica aziendale a Meta attraverso un unico endpoint anziché su più origini. Questo consolidamento semplificherà lo stack tecnologico degli inserzionisti e creerà una visione più completa in Gestione eventi di Meta usando i dataset.

Questa documentazione fornisce indicazioni per integrare gli eventi nell'app nell'API Conversions.

Prerequisiti

1. Dataset

Gli eventi nell'app inviati tramite l'API Conversions devono essere associati a un dataset.

Puoi effettuare la chiamata GET a https://graph.facebook.com /v16.0/{ads-pixel-id}/is_consolidated_container per rilevare se il dataset dell'inserzionista è consolidato e quindi idoneo per passare eventi nell'app tramite l'API Conversions.

2. Autorizzazioni

• Per implementare un'integrazione diretta come inserzionista, segui le istruzioni riportate qui per prerequisiti e autorizzazioni.

• Per implementare un'integrazione della piattaforma partner, segui le istruzioni riportate qui per prerequisiti e autorizzazioni.

Configurazione

Invio degli eventi nell'app all'API Conversions

a. Collegamento dell'ID del dataset e dell'ID dell'app

In Gestione eventi ci sono due modi per collegare la tua app a un dataset:

• Seleziona la tab "Origini dei dati", trova la tab "Impostazioni" della tua app ed effettua il collegamento.
• Seleziona la tab "Origini dei dati", nella tab "Panoramica" della tua app, usa il pulsante "Collega a dataset" nella sezione "Tutte le attività".

Una volta completato il collegamento, il dataset include l'app collegata.

b. Campi obbligatori

Puoi fare riferimento qui all'attuale insieme di parametri che possono essere inviati tramite l'API Conversions. Per l'invio di eventi nell'app, i seguenti campi server_event possono essere condivisi nel payload:

• Il parametro action_source deve contenere il valore app per gli eventi nell'app.
• event_id è obbligatorio per il caso di configurazione della deduplicazione.
• app_data fields
• user_data fields
• custom_data fields

Campi dati dell'app

Parametri delle informazioni dei clienti

Dati personalizzati

In sintesi, gli eventi nell'app condivisi usando l'API Conversions richiederanno i seguenti parametri dei dati:

• action_source: deve essere impostato su "app". (Usando l'API Conversions, dichiari che il parametro action_source, per quanto ne sai, è accurato).
• event_id: obbligatorio per la configurazione della deduplicazione, vedi i dettagli nella sezione "Configurazione della deduplicazione per più canali".
• advertiser_tracking_enabled
• application_tracking_enabled
• extinfo

Di seguito un esempio di extinfo. Assicurati che tutti i sottoparametri siano compilati e in ordine sequenziale. Se manca qualcosa, usa una stringa vuota come segnaposto.

c. Configurazione della deduplicazione per più canali

Il meccanismo di deduplicazione sarà necessario per rimuovere il traffico di eventi duplicati tra l'integrazione dell'API Conversions e tutte le altre integrazioni esistenti che hai con gli eventi nell'app, tra cui SDK, MMP e API App Events.

Per gli eventi nell'app, applichiamo la stessa funzionalità di deduplicazione esistente per gli eventi web. La logica sfrutta il campo event_id e la deduplicazione basata su event_name (eventi API Conversions e SDK/API App Events che hanno lo stesso event_id). Il parametro event_id è un identificatore che può distinguere in modo univoco eventi simili. ID evento inaccurati possono causare una deduplicazione errata della conversione, con conseguente impatto sul report sulle conversioni e sulle prestazioni della campagna.

Puoi consultare la seguente documentazione per gli sviluppatori per implementare la configurazione della deduplicazione:

• Come configurare gli eventi nell'app
• Esempio di configurazione della deduplicazione

Ecco un esempio di come registrare un evento personalizzato. Per farlo, passa il nome dell'evento come AppEvents.Name nell'SDK per iOS:

AppEvents.shared.logEvent(.achievedLevel, parameters: [AppEvents.ParameterName(rawValue: "event_id"): "123"])

Per gli eventi di installazione dell'app, esiste già un meccanismo di deduplicazione che assicura che solo un'installazione sia attribuita nell'ultima finestra di 90 giorni. Manteniamo il primo evento e ignoriamo quelli successivi, indipendentemente dall'origine dell'azione da cui provengono. Non è necessario implementare la deduplicazione per gli eventi nell'app relativi agli eventi di installazione.

d. Invio di eventi

Per inviare nuovi eventi, fai una richiesta POST all'API Conversions da questo percorso: https://graph.facebook.com/{API_VERSION}/{DATASET_ID}/events?access_token={TOKEN}. Quando pubblichi su questo segmento, Meta crea nuovi eventi del server dell'app. Per maggiori dettagli, consulta il seguente documento per gli sviluppatori.

Di seguito è riportata una panoramica di come si inseriscono i parametri nello schema complessivo del payload:

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": 1684389752,
            "action_source": "app",
            "user_data": {
                "em": [
                    "30a79640dfd8293d4f4965ec11821f640ca77979ca0a6b365f06372f81a3f602"
                ],
                "ph": [
                    "74234e98afe7498fb5daf1f36ac2d78acc339464f950703b8c019892f982b90b",
                    "74234e98afe7498fb5daf1f36ac2d78acc339464f950703b8c019892f982b90b"
                ],
                "madid": "bbbbbbbbbbbb",
      "anon_id": "cccccccc"
            },
            "custom_data": {
                "currency": "USD",
                "value": "142.52"
            },
            "app_data": {
                "advertiser_tracking_enabled": "True",
                "application_tracking_enabled": "True",
                "campaign_ids": "aaaaaaaaa",
                "extinfo": [
                    "a2",
                    "com.some.app",
                    "771",
                    "Version 7.7.1",
                    "10.1.1",
                    "OnePlus6",
                    "en_US",
                    "GMT-1",
                    "TMobile",
                    "1920",
                    "1080",
                    "2.00",
                    "2",
                    "128",
                    "8",
                    "USA/New York"
                ]
            }
        }
    ]
}

Risoluzione dei problemi

Puoi usare lo Strumento di assistenza per il payload per generare dati del payload:

• Quando applicabile, scegli app come origine dell'azione
• Compila le informazioni per gli eventi che verranno inviati a Meta
• Questo genererà il payload dell'evento, che può essere usato come modello per l'integrazione dell'API Conversions

Usa lo strumento Testa gli eventi in Gestione eventi per i test.

Altri contenuti da consultare

• Panoramica dell'API Conversions
• Utilizzo dell'API Conversions
• Parametri dell'API Conversions
• Best practice