Боттан Pixel-ге оқиғаларды қалай жіберуге болады

Боттың жұмыс процесінен оқиғаларды тасымалдау үшін сізде бизнес-аккаунт болуы керек. Сіз осы жерде тіркеле аласыз.

Жаңа pixel қалай жасауға болады

API Conversions таңдаңыз.

Назар аударыңыз! Conversion API конфигурациясы кезінде келесі терезе ашылса, параметрлерді қалдырып, қайта бастаған дұрыс.

Conversion API конфигурациясы кезінде келесі терезе ашылса, параметрлерді қалдырып, қайта бастаған дұрыс.

Қажетті Pixel таңдаңыз.

Қатынау токенін жасап, оны қауіпсіз жерде сақтаңыз.

Facebook-қа оқиғаларды қалай тасымалдауға болады

Facebook-қа оқиғаларды тасымалдау үшін мини-лендингте өз доменіңіз орнатылған болуы керек. Ол Facebook-та мақұлдануы керек, және мини-лендингтің параметрлерінде Facebook үшін Клиенттік айнымалыларға cookie мәндерін сақтау қосылған болуы керек:

Енді мини-лендингтен келген клиенттің картасында автоматты түрде толтырылған _fbp айнымалысы болады. Бұл айнымалыны оқиғамен бірге Pixel-ге тасымалдауға болады.

Оқиғаны тасымалдағыңыз келетін блокта келесі параметрлерді конфигурациялау керек:

Функцияның URL мекенжайы:

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

Мысал параметрлері:

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

Міндетті параметрлер

pixel_id — pixel идентификаторы.

access_token — API-ға қатынау токені.

event_name — оқиғаның атауы. Сіз Lead, PageView, Purchase сияқты стандартты атауларды (толығырақ осы жерде) қолдана аласыз, сондай-ақ өз атауларыңызды, мысалы Entered the bot.

event_source_url — Facebook-та мақұлданған домен.

fbp — клиенттің браузер идентификаторы.

Қосымша параметрлер

action_source — (әдепкі бойынша other) бұл өріс конверсияның қай жерде болғанын көрсетуге мүмкіндік береді. Оқиғалардың қай жерде болғаны туралы ақпарат жарнамаларыңыздың дұрыс аудиторияға көрсетілуін қамтамасыз етуге көмектеседі.

action_source өрісінде келесі мәндерді орнатуға болады:

Мән Сипаттама
email Конверсия электрондық пошта арқылы болды
website Конверсия сайтта болды
phone_call Конверсия телефон арқылы болды
chat Конверсия мессенджер, SMS немесе онлайн-чат арқылы болды
physical_store Конверсия физикалық дүкенде болды
system_generated Конверсия автоматты түрде болды, яғни ай сайынғы жазылымды жаңарту нәтижесінде
business_messaging Конверсия клиент Click-to-WhatsApp жарнамасын басқаннан кейін әңгімеде болды
other Конверсия басқа жолмен болды

Оқиғаларды қалай тексеруге болады

Оқиғаларды тексеру үшін сұраныс денесіне Testing messages қойындысында сақталған мәтінмен test_event_code параметрін қосыңыз.

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

Назар аударыңыз! Өндірістік нұсқаны іске қосқанда сұраныстан test_event_code параметрін жоюды ұмытпаңыз.

Қосымша қосымша параметрлер

fn — аты.

ln — тегі.

email — клиенттің электрондық поштасы.

phone — клиенттің телефон нөмірі.

fbc — басу идентификаторы.

gender — клиенттің жынысы (f — әйел, m — ер).

country — ел.

state — штат.

city — қала.

index — клиенттің пошталық индексі (ZIP коды).

external_id — кез келген бірегей клиент идентификаторы, мысалы, пайдаланушы ID немесе үшінші тарап cookie файлдарының ID.

client_ip_address — клиенттің IP мекенжайы.

client_user_agent — клиенттің браузерінің пайдаланушы агенті.

Сіз Pixel-ге өз параметрлеріңізді де тасымалдай аласыз. Ол үшін қосымша my_params параметрін қосып, оған өз өрістеріңізді көрсетіңіз.

Мысал:

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

Толық мысал

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

Назар аударыңыз! Өндірістік нұсқаны іске қосқанда сұраныстан test_event_code параметрін жоюды ұмытпаңыз.

Жарнамалық аккаунтты қалай қосуға болады

Алдымен, аккаунтыңызға қатынауды ашу керек.

Сақтап, Related Objects → Add Objects қойындысына өтіңіз.

Содан кейін жарнамалық аккаунтыңызды қосыңыз.

Click-to-WhatsApp жарнамасының конверсиялары

fb_pixel_event() функциясының құжаттамасына қосымша.

Meta* Click-to-WhatsApp жарнамасындағы әрбір басуды ctwa_clid басу идентификаторымен белгілейді. Ол клиенттің бірінші WhatsApp хабарламасымен бірге алынады және әңгімедегі конверсияны белгілі бір жарнамаға байланыстыру үшін қолданылады — сайттағы басуды pixel оқиғаларына байланыстыруға ұқсас.

Сигнатура

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

Жаңа параметрлер

Параметр Сипаттама
ctwa_clid Click-to-WhatsApp жарнамасының басу идентификаторы. Егер бұл параметр берілмесе, бот автоматты түрде сақтайтын ctwa_clid клиенттік айнымалысы қолданылады. Қосымша.
messaging_channel Конверсия болған хабарласу арнасы. Әдепкі бойынша whatsapp. Қосымша.

Жаңа action_source мәні

action_source үшін келесі мән қолжетімді:

Мән Сипаттама
business_messaging Конверсия клиент Click-to-WhatsApp жарнамасын басқаннан кейін әңгімеде болды.

Оқиға келесі шарттардың кем дегенде біреуі орындалғанда хабарласу конверсиясы ретінде жіберіледі:

  • action_source="business_messaging" берілген;
  • ctwa_clid берілген;
  • messaging_channel берілген.

Бұл жағдайда Meta* action_source + messaging_channel + ctwa_clid комбинациясын алады. Бұл комбинациясыз жарнаманы басу конверсияға байланыстырылмайды.

Хабарласу конверсиялары үшін website мәнін қолдануға болмайды: оқиға pixel-ге жетеді, бірақ жарнамаға байланыстырылмайды.

Клиенттік айнымалылар

Клиент жарнаманы басқаннан кейін WhatsApp хабарламасын жібергенде, бот басу деректерін клиенттің клиенттік айнымалыларына сақтайды. Бұл айнымалыларды қолмен толтырудың қажеті жоқ.

Айнымалы Сипаттама
ctwa_clid Басу идентификаторы. Оқиғаға автоматты түрде қосылады.
ctwa_clid_time Идентификатор алынған уақыт, Unix уақыт форматында. Оны басудан бері қанша уақыт өткенін анықтау үшін қолдануға болады.
wa_ads_data JSON форматындағы жарнама деректері: жарнама URL мекенжайы, жарнама ID (source_id), тақырып, сипаттама, креатив түрі және креатив URL мекенжайы.

Басу идентификаторы клиенттік айнымалыдан автоматты түрде алынады, сондықтан оны функцияға анық берудің қажеті жоқ.

Клиенттің телефон нөмірі data ішінде берілмесе, оқиғаға автоматты түрде қосылады.

event_source_url параметрі хабарласу конверсиялары үшін қолданылмайды.

Шектеулер

Басу идентификаторы тек клиент жарнамадағы түймені басқаннан кейінгі бірінші хабарламасымен бірге алынады. Ол кейінгі хабарламаларға қосылмайды. Сондықтан оқиға әңгіме кезінде кез келген уақытта жіберілуі мүмкін, бірақ тек бірінші хабарлама жарнамадан шыққан жағдайда ғана.

Meta ctwa_clid-ді Android және iOS платформаларындағы Facebook және Instagram қолданбаларындағы басулар үшін қамтамасыз етеді.

Идентификатор клиент браузерден басқанда немесе жарнама түймесінің орнына кәдімгі жазбаны басқанда берілмейді. Мұндай әрекеттесулерден болатын конверсиялар жарнамаға байланыстырылмайды.

Егер клиент кейінірек басқа жарнаманы басса, айнымалылар қайта жазылады. Конверсия клиент келген ең соңғы жарнамаға байланыстырылады.

Егер басу идентификаторы функция параметрлерінде де, клиенттік айнымалыларда да жоқ болса, функция келесі қатені қайтарады және оқиға жіберілмейді:

No ctwa_clid variable in client variables