Modifica di Meta/Facebook API Conversion (sezione)

== API Conversion implementazione manuale ==
Prima di tutto dal profilo di Facebook Businness, attivare le API Conversion e verrà fornito un '''TOKEN'''.<br/>
Con questo e il '''Pixel ID''' sarà possibile creare l' '''endpoint''' così
<pre>
https://graph.facebook.com/<FBGRAPHVERSION>/<PIXELID>/events?access_token=<TOKEN>
</pre>
Attualmente abbiamo:
<pre>
FBGRAPHVERSION:  v15.0
PIXELID:         507678989608118
TOKEN:           EAAI9me5dqpIBAFHpn9Y5sptiJ7ZCxRDImuY2hs4jgzBChCyZC7zbgHs9vueFulhjz7cZC1kx5EFnOZC2G9EHgwVJXE66bDi3e98IjHWF48R4qktCuJZALNYEaAFjcTwdnay4QLdfTc8NXJGrpj9hlzAVqCLesiZCBQpoTTZAxDO7F8jrnHyJjZCd
</pre>

* Si tratta fondamentalmente di fare '''chiamate alla REST-API di Facebook'''.
* Ognuna delle chiamate va piazzata nel codice a seconda dell'evento che rappresenta.
* Ogni chiamata alle API Conversion va messa in coppia alla classica <code>fbq()</code> del pixel.
* Per evitare duplicati è necessario passare il parametro <code>event_id</code>, lo stesso per entrambe le chiamate.


=== Eventi ===
Gli eventi principali che tracciamo sono
* ''PageView'' - Tutte le pagine
* ''Lead'' - Dopo aver inviato un messaggio da qualsiasi form
* ''Search'' - Atterraggio dopo una ricerca testuale (parametro: ricerca utente)
* ''CompleteRegistration'' - Dopo la registrazione di un utente
* ''AddToWishlist'' - Ogni volta che si aggiunge un prodotto alla Wishlist (parametro: id prodotto)
L'elenco degli '''eventi standard''' è disponibile qui<br/>
https://developers.facebook.com/docs/meta-pixel/reference#standard-events<br/><br/>

Per ognuno di questi eventi, se le ho disponibile, specifico queste ''UserData''
* User IP
* Nome
* Cognome
* Email
* Genere
* CAP
* Telefono
passate sotto l' ''algoritmo SHA256''

=== La Chiamata ===
Creare il seguente '''payload''' di base:
<syntaxhighlight lang="javascript">
// let userData= ...
// let customData = ...
// let testCode = ...
//let eventName = ...
let payload = {
	"data": [{
		"event_name": eventName,
		"event_time": Math.round(new Date().getTime() / 1000),
		"action_source": "website",
		"event_id": eventId,
		"event_source_url": location.href,
		"user_data": {
			"client_ip_address": "ip" in userData ? userData.ip : null,
			"client_user_agent": navigator.userAgent,
			"fn": [
				"name" in userData ? sha256(userData.name) : null
			],
			"ln": [
				"surname" in userData ? sha256(userData.surname) : null
			],
			"em": [
				"email" in userData ? sha256(userData.email) : null
			],
			"ge": [
				"gender" in userData ? sha256(userData.gender) : null
			],
			"zp": [
				"zip" in userData ? sha256(userData.zip) : null
			],
			"ph": [
				"phone" in userData ? sha256(userData.phone) : null
			]
		},
		"custom_data": customData
	}]
};
if (testCode) payload["test_event_code"] = testCode;
</syntaxhighlight>
::L'algoritmo consigliato per creare lo SHA256 è qui https://geraintluff.github.io/sha256/<br/>

E fare la chiamata in '''POST'''
<syntaxhighlight lang="javascript">
let endpoint = "https://graph.facebook.com/" + fbGraphVersion + "/" + fbPixelID + "/events?access_token=" + fbToken;

fetch(endpoint, {
	method: "POST",
	headers: { "Content-Type": "application/json" },
	body: JSON.stringify(payload),
})
  .then((response) => response.text())
  .then((data) => console.log(data));
</syntaxhighlight>

All'interno del portale, la chiamata alle ''API Conversion'' dovrà essere fatta in coppia con quella del ''FacebookPixel'', passando ad entrambe lo stesso parametro ''EventID''<br/>
Es.
<syntaxhighlight lang="javascript">
let eventID = "pageView." .Date.now();
fbq('track', 'PageView', {}, { eventID: eventID });  // Facebook Pixel
designbestConversion({ }, eventID);  // API Conversion
</syntaxhighlight>