Comment envoyer des événements à Pixel depuis le bot

Pour transférer des événements depuis le flux de travail du bot, vous devez disposer d'un compte professionnel. Vous pouvez vous inscrire ici.

Comment créer un nouveau pixel

Choisissez API Conversions.

Attention ! Si la fenêtre suivante s'ouvre lors de la configuration de l'API Conversions, il est préférable de quitter les paramètres et de recommencer.

Si la fenêtre suivante s'ouvre lors de la configuration de l'API Conversions, il est préférable de quitter les paramètres et de recommencer.

Choisissez le pixel dont vous avez besoin.

Générez un jeton d'accès et conservez-le dans un endroit sûr.

Comment transférer des événements à Facebook

Pour transférer des événements à Facebook, vous devez avoir votre propre domaine configuré dans la mini-landing. Il doit être approuvé sur Facebook, et l'option Enregistrer les valeurs des cookies dans les variables client doit être activée pour Facebook dans les paramètres de la mini-landing :

Désormais, une variable _fbp automatiquement remplie sera présente dans la fiche du client provenant de la mini-landing. Cette variable peut être transférée à Pixel avec l'événement.

Vous devez configurer les paramètres suivants dans le bloc via lequel vous souhaitez transférer l'événement :

URL de la fonction :

https://store.mavibot.ai/function/fb_pixel

Exemple de paramètres :

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "Entered the bot",
  "event_source_url": "https://my_best_site.com",
  "action_source": "chat",
  "fbp": "#{_fbp}",
  "fbc": "#{_fbc}"
}

Paramètres obligatoires

pixel_id — ID du pixel.

access_token — le jeton d'accès à l'API.

event_name — le nom de l'événement. Vous pouvez utiliser des noms standard tels que Lead, PageView, Purchase, etc. (voir plus ici), ainsi que vos propres noms, comme Entered the bot.

event_source_url — le domaine approuvé sur Facebook.

fbp — l'identifiant du navigateur du client.

Paramètres facultatifs

action_source — (par défaut other) ce champ vous permet de spécifier où exactement la conversion a eu lieu. Les informations sur l'endroit où les événements se sont produits aident à garantir que vos publicités sont diffusées auprès du bon public.

Vous pouvez définir les valeurs suivantes dans le champ action_source :

Valeur Description
email La conversion a eu lieu par e-mail
website La conversion a eu lieu sur un site
phone_call La conversion a eu lieu par téléphone
chat La conversion a eu lieu via un messager, SMS ou un chat en ligne
physical_store La conversion a eu lieu dans un magasin physique
system_generated La conversion s'est produite automatiquement, c'est-à-dire à la suite d'un renouvellement d'abonnement mensuel
business_messaging La conversion a eu lieu dans une conversation après que le client a cliqué sur une publicité Click-to-WhatsApp
other La conversion s'est produite d'une autre manière

Comment tester les événements

Pour tester les événements, ajoutez le paramètre test_event_code avec le texte stocké dans l'onglet Messages de test au corps de la requête.

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "Entered the bot",
  "event_source_url": "https://my_best_site.com",
  "fbp": "#{_fbp}",
  "fbc": "#{_fbc}",
  "test_event_code": "TEST11421"
}

Attention ! N'oubliez pas de supprimer le paramètre test_event_code de la requête lors du lancement de la version de production.

Paramètres facultatifs supplémentaires

fn — prénom.

ln — nom de famille.

email — l'e-mail du client.

phone — le numéro de téléphone du client.

fbc — ID de clic.

gender — le genre du client (f — féminin, m — masculin).

country — pays.

state — état.

city — ville.

index — l'index postal du client (code postal).

external_id — tout identifiant client unique, par exemple l'ID utilisateur ou l'ID des fichiers de cookies tiers.

client_ip_address — l'adresse IP du client.

client_user_agent — le user agent du navigateur du client.

Vous pouvez également transférer vos propres paramètres vers Pixel. Pour ce faire, ajoutez le paramètre facultatif my_params et spécifiez vos propres champs.

Exemple :

{
  "my_params": {
    "value1": "Hello",
    "val2": "Hi"
  }
}

Exemple complet

{
  "pixel_id": "#{pixel_id}",
  "access_token": "#{access_token}",
  "event_name": "Entered the bot",
  "event_source_url": "https://my_best_site.com",
  "email": "[email protected]",
  "phone": "1234567890",
  "currency": "USD",
  "value": "142.52",
  "test_event_code": "TEST11421",
  "external_id": "#{client_id}",
  "fn": "#{name}",
  "gender": "m",
  "post_index": "12345",
  "my_params": {
    "value1": "Hello",
    "val2": "Hi"
  }
}

Attention ! N'oubliez pas de supprimer le paramètre test_event_code de la requête lors du lancement de la version de production.

Comment ajouter un compte publicitaire

Tout d'abord, vous devez ouvrir l'accès à votre compte.

Enregistrez et passez à l'onglet Objets associés → Ajouter des objets.

Ensuite, ajoutez votre compte publicitaire.

Conversions des publicités Click-to-WhatsApp

Un ajout à la documentation pour la fonction fb_pixel_event().

Meta* marque chaque clic sur une publicité Click-to-WhatsApp avec un identifiant de clic ctwa_clid. Il est reçu avec le premier message WhatsApp du client et est utilisé pour attribuer une conversion de la conversation à une publicité spécifique — de la même manière que les événements pixel sont attribués à un clic sur un site web.

Signature

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data,
    ctwa_clid,
    messaging_channel
)

Nouveaux paramètres

Paramètre Description
ctwa_clid Identifiant de clic pour une publicité Click-to-WhatsApp. Si ce paramètre n'est pas fourni, la variable client ctwa_clid, enregistrée automatiquement par le bot, est utilisée. Facultatif.
messaging_channel Le canal de messagerie où la conversion a eu lieu. Par défaut, whatsapp. Facultatif.

Nouvelle valeur pour action_source

La valeur suivante est disponible pour action_source :

Valeur Description
business_messaging La conversion a eu lieu dans une conversation après que le client a cliqué sur une publicité Click-to-WhatsApp.

Un événement est envoyé comme conversion de messagerie si au moins une des conditions suivantes est remplie :

  • action_source="business_messaging" est fourni ;
  • ctwa_clid est fourni ;
  • messaging_channel est fourni.

Dans ce cas, Meta* reçoit la combinaison action_source + messaging_channel + ctwa_clid. Sans cette combinaison, le clic sur la publicité ne sera pas attribué à la conversion.

La valeur website ne doit pas être utilisée pour les conversions de messagerie : l'événement atteindra le pixel, mais il ne sera pas attribué à la publicité.

Variables client

Lorsqu'un client envoie un message WhatsApp après avoir cliqué sur une publicité, le bot enregistre les données de clic dans les variables client du client. Vous n'avez pas besoin de remplir ces variables manuellement.

Variable Description
ctwa_clid Identifiant de clic. Ajouté automatiquement à l'événement.
ctwa_clid_time Heure à laquelle l'identifiant a été reçu, au format Unix. Il peut être utilisé pour déterminer le temps écoulé depuis le clic.
wa_ads_data Données publicitaires au format JSON : URL de la publicité, ID de la publicité (source_id), titre, description, type de création et URL de création.

L'identifiant de clic est automatiquement extrait de la variable client, vous n'avez donc pas besoin de le passer explicitement à la fonction.

Le numéro de téléphone du client est automatiquement ajouté à l'événement s'il n'est pas fourni dans data.

Le paramètre event_source_url n'est pas utilisé pour les conversions de messagerie.

Limitations

L'identifiant de clic est reçu uniquement avec le premier message du client après qu'il a cliqué sur le bouton dans la publicité. Il n'est pas inclus dans les messages suivants. Par conséquent, l'événement peut être envoyé à tout moment de la conversation, mais uniquement si le premier message provient de la publicité.

Meta fournit ctwa_clid pour les clics depuis les applications Facebook et Instagram sur Android et iOS.

L'identifiant n'est pas fourni lorsque le client clique depuis un navigateur ou clique sur une publication ordinaire au lieu du bouton de la publicité. Les conversions de ces interactions ne peuvent pas être attribuées à la publicité.

Si le client clique sur une autre publicité plus tard, les variables sont écrasées. La conversion est attribuée à la publicité la plus récente d'où provient le client.

Si l'identifiant de clic manque à la fois dans les paramètres de la fonction et dans les variables client, la fonction renvoie l'erreur suivante et l'événement n'est pas envoyé :

No ctwa_clid variable in client variables