API Conversions

Gateway dell'API Conversions - Risoluzione dei problemi, errori e avvisi

Se noti che mancano eventi del server o che il volume degli eventi del server è inferiore a quello del browser, fai riferimento a questa documentazione per risolvere il problema. Per informazioni sugli strumenti per la risoluzione dei problemi, consulta Gateway dell'API Conversions - Strumenti per la risoluzione dei problemi.

Usa la seguenti procedura di risoluzione dei problemi per identificare il problema:

  1. Vai a Gestione eventi.
  2. Apri il sito web nel browser.
  3. Interfaccia utente di amministrazione del gateway dell'API Conversions

Dominio non configurato per inviare eventi

Il gateway dell'API Conversions riceverà eventi dai domini collegati che imposti durante la configurazione dell'integrazione. Se il volume degli eventi del server appare più basso rispetto agli eventi del browser, potrebbe essere dovuto al fatto che il pixel si sta attivando su domini non ancora collegati a Meta.

Diagnostica

  • Accedi a Gestione eventi
  • Seleziona l'evento appropriato
  • Clicca su Vedi dettagli e seleziona Panoramica eventi
  • Dal menu a discesa a sinistra, seleziona Domini per trovare i domini da cui provengono gli eventi del browser
  • Se non li trovi o se non corrispondono ai domini configurati, gli eventi del browser non vengono acquisiti

Risoluzione

DNS non configurato o mappatura DNS errata

Il gateway dell'API Conversions è ospitato su AWS, che gli assegna un indirizzo IP al momento della creazione. Devi mappare un sottodominio del tuo dominio a questo indirizzo IP in modo che l'endpoint del gateway dell'API Conversions possa essere raggiungibile dal browser tramite una chiamata di richiesta della prima parte.

Diagnostica

  • Usa uno strumento di controllo DNS online come https://dnschecker.org/ per verificare che il dominio del gateway dell'API Conversions sia risolto nell'indirizzo IP giusto e completamente propagato. Se il tuo dominio non è risolto in nessun indirizzo IP, consulta la sezione sulla risoluzione per i passaggi successivi.
  • Ottieni il tuo indirizzo IP del server gateway dell'API Conversions dalla dashboard AWS EC2 o richiedi queste informazioni al punto di contatto dell'infrastruttura cloud.
  • Se i due indirizzi IP non corrispondono, consulta la sezione sulla risoluzione per i passaggi successivi.

Risoluzione

  • Lavora con un amministratore sul registrar del dominio.
  • Aggiorna il record DNS nel registrar del dominio con l'indirizzo IP del server gateway dell'API Conversions (quello mostrato nella dashboard AWS EC2).
    • Imposta un record DNS A che mappi il tuo sottodominio del gateway dell'API Conversions all'indirizzo IP del server generato durante la configurazione.

Certificato mai rilasciato

Se il gateway dell'API Conversions non ha mai ottenuto un certificato da Let's Encrypt, anche molto tempo dopo la corretta configurazione del DNS, significa che il tuo dominio è così popolare che Let's Encrypt si è rifiutato di rilasciare il certificato.

Risoluzione

  • Prendi in considerazione l'idea di mettere un AWS Load Balancer (ALB) davanti all'istanza del gateway dell'API Conversions e usarlo per ospitare il certificato che possiedi.

Certificato rilasciato ma scaduto

Questo problema si verifica se hai chiuso la porta 80 dopo la corretta installazione del gateway dell'API Conversions o se stai usando una versione non aggiornata.

Risoluzione

  • Apri la porta 80 e aggiorna il gateway dell'API Conversions all'ultima versione.

Interfaccia utente gateway non accessibile

Questo problema si verifica se hai chiuso la porta 80 dopo la corretta installazione del gateway dell'API Conversions o se stai usando una versione non aggiornata.

Risoluzione

  • Verifica che l'indirizzo IP per l'istanza del gateway dell'API Conversions corrisponda alla configurazione DNS. Se non corrisponde, fai riferimento alla sezione DNS non configurato o mappatura DNS errata.
  • Se il server non risponde, la causa può essere un errore di rete temporaneo, risolvibile riavviando l'istanza. Possono essere necessari alcuni minuti perché il gateway dell'API Conversions si avvii, attendi circa 10 minuti e poi effettua nuovamente l'accesso.

Richiesto aggiornamento di versione gateway

Sembrerebbe che il gateway dell'API Conversions delle versioni precedenti alla v1.0.8 abbia interrotto l'invio di eventi a Meta. Ti consigliamo di aggiornarlo almeno alla v1.0.8 per massimizzare i vantaggi della configurazione. Riprenderà il flusso degli eventi e garantirà aggiornamenti automatici in futuro.

Diagnostica

  • Per controllare la versione in uso del gateway dell'API Conversions:
    • Apri l'interfaccia utente di amministrazione del gateway dell'API Conversions:
https://<Conversions API Gateway Endpoint>/hub
  • Controlla la versione in uso del server del gateway dell'API Conversions:
    • Menu a sinistra > Impostazioni > Aggiornamenti

Risoluzione

Per aggiornare il gateway dell'API Conversions, segui questa procedura:

Risoluzione dei problemi con EKS Logs

Se riscontri problemi con l'installazione del gateway dell'API Conversions per versione la EKS con singolo account o con più account, puoi fare riferimento ai registri per risolvere il problema.

Il registro di installazione EKS è disponibile in AWS Cloudwatch sotto il nome del gruppo "ConversionsAPIGateway/cloud-init-output. log". Puoi controllare se sono presenti messaggi di errore. Gli errori comuni includono il superamento della limitazione delle risorse AWS e la mancanza di autorizzazioni AWS.



Il record DNS con tipo CAA non ha amazonaws.com

Se il record DNS che il gateway dell'API Conversions chiede di configurare ha un certificato TLS valido o non ha un record CAA, puoi ignorare questa sezione.

Se disponi di un record CAA per il dominio, assicurati di fornire amazonaws.com come valore per il record CAA se hai installato la versione AWS EKS del gateway dell'API Conversions (per account singolo) o del gateway dell'API Conversions per più account 1.10.* o versione successiva che utilizza AWS Certificate Manager per la creazione del dominio. Un esempio di record CAA sarebbe:

0 issue "amazonaws.com"

Se hai installato il gateway dell'API Conversions per più account versione 1.9.* o precedente, assicurati di fornire letsencrypt.org come valore per il record CAA. Un esempio sarebbe:

0 issue "letsencrypt.org"

Altri contenuti da consultare