Kā nosūtīt notikumus uz Pixel no bota

Lai pārsūtītu notikumus no bota darbplūsmas, jums ir nepieciešams biznesa konts. Jūs varat reģistrēties šeit.

Kā izveidot jaunu pixel

Izvēlieties API Conversions.

Uzmanību! Ja, konfigurējot Conversion API, tiek atvērts šāds logs, labāk atstāt iestatījumus un sākt no jauna.

Ja, konfigurējot Conversion API, tiek atvērts šāds logs, labāk atstāt iestatījumus un sākt no jauna.

Izvēlieties nepieciešamo Pixel.

Ģenerējiet piekļuves pilnvaru un saglabājiet to drošā vietā.

Kā pārsūtīt notikumus uz Facebook

Lai pārsūtītu notikumus uz Facebook, jums ir jābūt savam domēnam, kas iestatīts mini-galvenē. Tam ir jābūt apstiprinātam Facebook, un Saglabāt vērtības no sīkfailiem klienta mainīgajos ir jābūt ieslēgtam Facebook mini-galvenes iestatījumos:

Tagad klienta kartē, kas nāk no mini-galvenes, būs automātiski aizpildīts mainīgais _fbp. Šo mainīgo var pārsūtīt uz Pixel kopā ar notikumu.

Jums ir jākonfigurē šādi iestatījumi blokā, caur kuru vēlaties pārsūtīt notikumu:

Funkcijas URL:

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

Parametru piemērs:

{
  "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}"
}

Obligātie parametri

pixel_id — pixela ID.

access_token — pilnvara piekļuvei API.

event_name — notikuma nosaukums. Varat izmantot standarta nosaukumus, piemēram, Lead, PageView, Purchase un citus (skatiet vairāk šeit), kā arī savus nosaukumus, piemēram, Entered the bot.

event_source_url — domēns, kas apstiprināts Facebook.

fbp — klienta pārlūkprogrammas ID.

Neobligātie parametri

action_source — (pēc noklusējuma other) šis lauks ļauj norādīt, kur tieši notika konversija. Informācija par to, kur notikumi notika, palīdz nodrošināt, ka jūsu reklāmas tiek rādītas pareizajai auditorijai.

Laukā action_source varat iestatīt šādas vērtības:

Vērtība Apraksts
email Konversija notika pa e-pastu
website Konversija notika vietnē
phone_call Konversija notika pa tālruni
chat Konversija notika, izmantojot ziņojumapmaiņas lietotni, SMS vai tiešsaistes tērzēšanu
physical_store Konversija notika fiziskā veikalā
system_generated Konversija notika automātiski, t.i., ikmēneša abonementa atjaunošanas rezultātā
business_messaging Konversija notika sarunā pēc tam, kad klients noklikšķināja uz Click-to-WhatsApp reklāmas
other Konversija notika citā veidā

Kā testēt notikumus

Lai testētu notikumus, pievienojiet pieprasījuma pamattekstam parametru test_event_code ar tekstu, kas saglabāts cilnē Testing messages.

{
  "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"
}

Uzmanību! Neaizmirstiet izdzēst parametru test_event_code no pieprasījuma, kad palaižat ražošanas versiju.

Papildu neobligātie parametri

fn — vārds.

ln — uzvārds.

email — klienta e-pasts.

phone — klienta tālruņa numurs.

fbc — klikšķa ID.

gender — klienta dzimums (f — sieviete, m — vīrietis).

country — valsts.

state — štats.

city — pilsēta.

index — klienta pasta indekss (ZIP kods).

external_id — jebkurš unikāls klienta ID, piemēram, lietotāja ID vai trešās puses sīkfailu ID.

client_ip_address — klienta IP adrese.

client_user_agent — klienta pārlūkprogrammas lietotāja aģents.

Varat arī pārsūtīt savus parametrus uz Pixel. Lai to izdarītu, pievienojiet neobligāto parametru my_params un norādiet tajā savus laukus.

Piemērs:

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

Pilns piemērs

{
  "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"
  }
}

Uzmanību! Neaizmirstiet izdzēst parametru test_event_code no pieprasījuma, kad palaižat ražošanas versiju.

Kā pievienot reklāmas kontu

Pirmkārt, jums ir jāatver piekļuve savam kontam.

Saglabājiet un pārejiet uz cilni Related Objects → Add Objects.

Pēc tam pievienojiet savu reklāmas kontu.

Click-to-WhatsApp reklāmu konversijas

Papildinājums dokumentācijai par funkciju fb_pixel_event().

Meta* atzīmē katru klikšķi no Click-to-WhatsApp reklāmas ar klikšķa identifikatoru ctwa_clid. Tas tiek saņemts kopā ar klienta pirmo WhatsApp ziņojumu un tiek izmantots, lai attiecinātu konversiju no sarunas uz konkrētu reklāmu — līdzīgi kā pixel notikumi tiek attiecināti uz vietnes klikšķi.

Paraksts

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

Jaunie parametri

Parametrs Apraksts
ctwa_clid Klikšķa identifikators Click-to-WhatsApp reklāmai. Ja šis parametrs nav norādīts, tiek izmantots klienta mainīgais ctwa_clid, ko bots saglabā automātiski. Neobligāts.
messaging_channel Ziņojumapmaiņas kanāls, kurā notika konversija. Pēc noklusējuma ir whatsapp. Neobligāts.

Jauna action_source vērtība

action_source ir pieejama šāda vērtība:

Vērtība Apraksts
business_messaging Konversija notika sarunā pēc tam, kad klients noklikšķināja uz Click-to-WhatsApp reklāmas.

Notikums tiek nosūtīts kā ziņojumapmaiņas konversija, ja ir izpildīts vismaz viens no šiem nosacījumiem:

  • ir norādīts action_source="business_messaging";
  • ir norādīts ctwa_clid;
  • ir norādīts messaging_channel.

Šajā gadījumā Meta* saņem kombināciju action_source + messaging_channel + ctwa_clid. Bez šīs kombinācijas reklāmas klikšķis netiks attiecināts uz konversiju.

Vērtība website nedrīkst tikt izmantota ziņojumapmaiņas konversijām: notikums sasniegs pixel, bet tas netiks attiecināts uz reklāmu.

Klienta mainīgie

Kad klients nosūta WhatsApp ziņojumu pēc klikšķa uz reklāmas, bots saglabā klikšķa datus klienta mainīgajos. Jums nav nepieciešams aizpildīt šos mainīgos manuāli.

Mainīgais Apraksts
ctwa_clid Klikšķa identifikators. Automātiski pievienots notikumam.
ctwa_clid_time Laiks, kad identifikators tika saņemts, Unix laika formātā. To var izmantot, lai noteiktu, cik daudz laika ir pagājis kopš klikšķa.
wa_ads_data Reklāmas dati JSON formātā: reklāmas URL, reklāmas ID (source_id), virsraksts, apraksts, radošais veids un radošais URL.

Klikšķa identifikators tiek automātiski ņemts no klienta mainīgā, tāpēc jums tas nav jānodod funkcijai tieši.

Klienta tālruņa numurs tiek automātiski pievienots notikumam, ja tas nav norādīts data.

Parametrs event_source_url netiek izmantots ziņojumapmaiņas konversijām.

Ierobežojumi

Klikšķa identifikators tiek saņemts tikai ar klienta pirmo ziņojumu pēc tam, kad viņš noklikšķina uz pogas reklāmā. Tas netiek iekļauts turpmākajos ziņojumos. Tāpēc notikumu var nosūtīt jebkurā sarunas brīdī, bet tikai tad, ja pirmais ziņojums nāca no reklāmas.

Meta nodrošina ctwa_clid klikšķiem no Facebook un Instagram lietotnēm Android un iOS.

Identifikators netiek nodrošināts, ja klients noklikšķina no pārlūkprogrammas vai noklikšķina uz parasta ieraksta, nevis reklāmas pogas. Konversijas no šādām mijiedarbībām nevar attiecināt uz reklāmu.

Ja klients vēlāk noklikšķina uz citas reklāmas, mainīgie tiek pārrakstīti. Konversija tiek attiecināta uz jaunāko reklāmu, no kuras klients nāca.

Ja klikšķa identifikators trūkst gan funkcijas parametros, gan klienta mainīgajos, funkcija atgriež šādu kļūdu un notikums netiek nosūtīts:

No ctwa_clid variable in client variables