API Integration Quality

Questa API è in versione beta. Per accedere, contatta il tuo rappresentante di Meta.

Gli inserzionisti che condividono eventi del server usando l'API Conversions possono vedere la Qualità dell'associazione degli eventi in Gestione eventi. Tuttavia, questo funziona solo su base individuale ed è difficile da scalare nei casi in cui un fornitore di soluzioni tecnologiche partner, un agency partner o un inserzionista gestisce centinaia e migliaia di pixel di Meta per le proprie aziende. L'API Integration Quality può aiutare a risolvere questo problema consolidando le metriche di qualità dell'integrazione in modo programmatico su larga scala.

Informazioni sulla Qualità dell'associazione degli eventi

Qualità dell'associazione degli eventi

La Qualità dell'associazione degli eventi (EMQ) è un punteggio (fino a 10) che indica quanto possano essere efficaci le informazioni sui clienti inviate dal tuo server nell'associare le istanze degli eventi a un account Facebook. Un punteggio alto della qualità dell'associazione degli eventi può migliorare l'attribuzione e le prestazioni delle inserzioni. Nota: questa metrica è in fase di sviluppo.

Modalità di calcolo

La Qualità dell'associazione degli eventi viene calcolata osservando quali parametri delle informazioni sui clienti vengono ricevuti dal tuo server tramite un'integrazione dell'API Conversions, la qualità delle informazioni ricevute e la percentuale di istanze di eventi associate a un account Meta.

Modalità di utilizzo

La Qualità dell'associazione degli eventi viene usata per valutare se invii tramite l'API Conversions le informazioni dei clienti corrette per associare i tuoi eventi a un account Meta e se hai configurato correttamente i parametri delle informazioni sui clienti. I parametri delle informazioni sui clienti ti aiutano ad associare i tuoi eventi a un account Meta, in modo che tu possa attribuire le conversioni alle tue inserzioni e mostrarle alle persone che hanno maggiori probabilità di effettuare una conversione.

La Qualità dell'associazione degli eventi viene calcolata in tempo reale. Scopri di più sulle best practice per la EMQ qui.

L'EMQ è attualmente disponibile solo per gli eventi web. Per gli altri tipi di eventi, come gli eventi offline e dei punti vendita fisici, gli eventi nell'app, i contatti di conversione o qualsiasi integrazione nelle fasi alfa o beta, contatta il tuo rappresentante Meta per indicazioni su come migliorare la qualità dell'associazione.

Casi d'uso comuni

Partner e agenzie possono usare l'API Integration Quality per fornire una dashboard e insight sulla qualità, aiutando gli inserzionisti a migliorare e ottimizzare le loro integrazioni. I partner possono usare questa integrazione anche per monitorare la stabilità della propria integrazione dell'API Conversions. Gli inserzionisti possono usare questo endpoint per aggregare i dati della qualità dell'integrazione da inserire nel proprio monitoraggio.

Autenticazione

Autenticazione degli inserzionisti tramite Business Manager

In Business Manager, vai alla sezione Utenti e seleziona la tab Utente di sistema. Clicca sull'utente di sistema specifico che stai usando per l'API Conversions.
Vai alla finestra di dialogo Assegna risorsa e scegli Pixel. Quindi, seleziona i pixel per conto dei quali vuoi inviare gli eventi.
Per ogni pixel, seleziona l'autorizzazione Gestisci pixel e clicca su Salva modifiche.
Torna alla pagina dei dettagli dell'utente di sistema. Verifica che i pixel selezionati siano visibili.
Per generare il token d'accesso, segui le istruzioni qui.

Autenticazione della piattaforma partner

Devi prima richiedere l'autorizzazione per inviare eventi per conto dei tuoi clienti. Hai a disposizione le opzioni di autenticazione riportate sotto.

Facebook Login for Business (consigliato)

Facebook Login for Business è la soluzione di autenticazione e autorizzazione preferita per i fornitori di soluzioni tecnologiche e gli sviluppatori di app business che hanno bisogno di accedere alle risorse dei propri clienti aziendali. Ti permette di specificare il tipo di token d'accesso, i tipi di risorse e le autorizzazioni necessarie per l'app e di salvare tutto come set (configurazione). Puoi quindi presentare il set ai tuoi clienti aziendali, affinché completino il flusso e consentano alla tua app di accedere alle loro risorse business.

Estensione Meta Business (consigliato)

Con questa opzione, l'estensione Meta Business (MBE) restituisce tutte le informazioni necessarie per inviare eventi per conto del cliente. MBE fornisce un endpoint per recuperare i token d'accesso dell'utente di sistema creati nel Business Manager del cliente. La procedura include le autorizzazioni per inviare eventi del server e avviene in maniera automatica e sicura. MBE è attualmente in versione beta, contatta il tuo rappresentante di Meta per accedere.

L'endpoint richiede un token d'accesso utente come parametro di input. I nuovi utenti MBE devono chiamare questo endpoint per recuperare il token d'accesso dell'utente di sistema dopo aver completato la configurazione di MBE. Gli utenti esistenti devono richiedere una nuova autenticazione prima di chiamare il nuovo endpoint dell'API.

Condivisione da parte del cliente di un pixel di Meta su un Business Manager del partner

Con questa opzione, il cliente condivide il suo pixel di Meta con il partner tramite le impostazioni di Business Manager o tramite l'API. Quindi, il partner può assegnare l'utente di sistema del partner al pixel del cliente e generare un token d'accesso per inviare eventi del server.

Recupero delle informazioni sulla qualità dell'integrazione del pixel

Puoi monitorare il punteggio di Qualità dell'associazione degli eventi per evento, insieme alle chiavi di corrispondenza inviate, usando i seguenti endpoint, parametri e campi dell'API:

Endpoint

https://graph.facebook.com/v21.0/<pixel_id>/integration_quality

Parametri

Parametro Descrizione

Parametro	Descrizione
`agent_name` stringa	Facoltativo. Il valore normalizzato del campo partner_agent viene usato per filtrare solo gli eventi inviati con il parametro partner_agent nella richiesta POST /{pixel_id}/events (consulta le best practice per l'attribuzione degli eventi qui e qui). Ad esempio, se il valore partner_agent è `[partner_name]_[majorversion]_[minorVersion]`, il valore della stringa dell'agente normalizzato sarà `partner_name` in minuscolo. `agent_name` ti permette di impostare il tuo identificativo della piattaforma quando invii eventi per conto di un cliente. Se sei un partner con contratto/un'agenzia, collabora con il tuo rappresentante di Meta per concordare un identificativo per la tua piattaforma. Se sei un inserzionista, la maggior parte delle volte non dovresti preoccuparti dell'attribuzione di `agent_name`. Se non fornisci un `agent_name`, tutti gli eventi, indipendentemente dal fatto che siano stati inviati da un agente o meno, saranno inclusi nel calcolo dell'EMQ.

agent_name

stringa

Facoltativo.
Il valore normalizzato del campo partner_agent viene usato per filtrare solo gli eventi inviati con il parametro partner_agent nella richiesta POST /{pixel_id}/events (consulta le best practice per l'attribuzione degli eventi qui e qui).

Ad esempio, se il valore partner_agent è [partner_name]_[majorversion]_[minorVersion], il valore della stringa dell'agente normalizzato sarà partner_name in minuscolo.

agent_name ti permette di impostare il tuo identificativo della piattaforma quando invii eventi per conto di un cliente. Se sei un partner con contratto/un'agenzia, collabora con il tuo rappresentante di Meta per concordare un identificativo per la tua piattaforma.

Se sei un inserzionista, la maggior parte delle volte non dovresti preoccuparti dell'attribuzione di agent_name.

Se non fornisci un agent_name, tutti gli eventi, indipendentemente dal fatto che siano stati inviati da un agente o meno, saranno inclusi nel calcolo dell'EMQ.

Campi

Campo	Descrizione
`event_name` stringa	Il nome di un evento standard o di un evento personalizzato.
`event_match_quality` AdsPixelCAPIEMQ	La Qualità dell'associazione degli eventi indica il grado di efficacia delle informazioni sui clienti inviate dal tuo server nell'associare le istanze degli eventi a un account Facebook.

Esempio

Tool di esplorazione per la API Graph

GET/v21.0/<PIXEL_ID>/integration_quality?fields=event_match_quality,event_name&agent_name=<AGENT_NAME>&access_token=<ACCESS_TOKEN>

cURL

curl -X GET -G \
  -d 'fields="event_match_quality,event_name"' \
  -d 'agent_name="&lt;AGENT_NAME&gt;"' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<LATEST_VERSION>/<PIXEL_ID>/integration_quality

Risposta API

{
  "data": [
    {
      "event_match_quality": {
        "composite_score": 5.1,
        "match_key_feedback": [
          {
            "identifier": "email",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "user_agent",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "external_id",
            "coverage": {
              "percentage": 100
            }
          }
        ]      
      },
      "event_name": "pLTVPurchase"
    },
    {
      "event_match_quality": {
        "composite_score": 7.2,
        "match_key_feedback": [
          {
            "identifier": "email",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "user_agent",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "phone",
            "coverage": {
              "percentage": 69.1
            }
          },
          {
            "identifier": "fbp",
            "coverage": {
              "percentage": 96.7
            }
          },
          {
            "identifier": "external_id",
            "coverage": {
              "percentage": 100
            }
          },
          {
            "identifier": "fbc",
            "coverage": {
              "percentage": 3.2
            }
          }
        ]
      },
      "event_name": "CompleteRegistration"
    }
  ]
}

FAQ

What is the access token used for?

The access token is used when partners send signal events or access the Setup Quality API on behalf of advertisers. The client system user access token onboarding method is not compatible with the EMQ API at the moment.

Permalink

How should the partner_agent field be formatted?

The partner_agent value in your API GET request should be a normalized lowercase format. This field is now optional.

Permalink

Per saperne di più

Best practice dell'API Conversions.
Aumenta le prestazioni con una configurazione ottimizzata dell'API Conversions.
Best practice per incorporare l'API Conversions per i partner
Guida sulla qualità della configurazione dell'API Conversions dal Centro assistenza per le aziende di Meta:

Best practice per l'API Conversions per contribuire al miglioramento delle prestazioni delle inserzioni. Queste best practice dell'API Conversions possono aiutare le aziende a migliorare le prestazioni delle loro inserzioni riducendo il costo per azione. Consigliamo di seguire queste best practice alla configurazione iniziale, ma possono essere usate anche per aggiornare le configurazioni esistenti.

Visualizzazione dei dettagli degli eventi del server in Gestione eventi di Meta. Dopo la configurazione dell'API Conversions da parte delle aziende, queste possono usare questo articolo per scoprire come monitorare eventi e parametri per assicurarsi che la loro configurazione funzioni in modo efficace e individuare opportunità di miglioramento. Possono anche usare questo articolo per imparare a usare i dettagli degli eventi del server (associazione degli eventi [Qualità dell'associazione degli eventi/EMQ]), aggiornamento dei dati, panoramica degli eventi e deduplicazione degli eventi) in Gestione eventi per migliorare la configurazione dell'API Conversions.