Bot'tan Pixel'e etkinlikler nasıl gönderilir

Bot'un iş akışından etkinlikleri aktarmak için bir işletme hesabınızın olması gerekir. Buradan kayıt olabilirsiniz.

Yeni bir pixel nasıl oluşturulur

API Dönüşümleri'ni seçin.

Dikkat! Dönüşüm API'si yapılandırması sırasında aşağıdaki pencere açılırsa, ayarlardan çıkıp yeniden başlamak daha iyidir.

Dönüşüm API'si yapılandırması sırasında aşağıdaki pencere açılırsa, ayarlardan çıkıp yeniden başlamak daha iyidir.

İhtiyacınız olan Pixel'i seçin.

Bir erişim belirteci oluşturun ve güvenli bir yerde saklayın.

Facebook'a etkinlikler nasıl aktarılır

Facebook'a etkinlik aktarmak için mini açılış sayfanızda kendi alan adınızın ayarlanmış olması gerekir. Bu alan adının Facebook'ta onaylanmış olması ve mini açılış sayfası ayarlarında Facebook için Çerez değerlerini müşteri değişkenlerine kaydetme seçeneğinin açık olması gerekir:

Artık mini açılış sayfasından gelen müşterinin kartında otomatik olarak doldurulan _fbp değişkeni olacaktır. Bu değişken, etkinlikle birlikte Pixel'e aktarılabilir.

Etkinliği aktarmak istediğiniz blokta aşağıdaki ayarları yapılandırmanız gerekir:

Fonksiyon URL'si:

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

Örnek parametreler:

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

Zorunlu parametreler

pixel_id — Pixel'in kimliği.

access_token — API'ye erişim belirteci.

event_name — etkinliğin adı. Lead, PageView, Purchase gibi standart adları kullanabilirsiniz (daha fazlası burada), ayrıca Entered the bot gibi kendi adlarınızı da kullanabilirsiniz.

event_source_url — Facebook'ta onaylanmış alan adı.

fbp — müşterinin tarayıcı kimliği.

İsteğe bağlı parametreler

action_source — (varsayılan olarak other) bu alan, dönüşümün tam olarak nerede gerçekleştiğini belirtmenizi sağlar. Etkinliklerin nerede gerçekleştiği hakkındaki bilgiler, reklamlarınızın doğru kitleye gösterilmesini sağlamaya yardımcı olur.

action_source alanında aşağıdaki değerleri ayarlayabilirsiniz:

Değer Açıklama
email Dönüşüm e-posta yoluyla gerçekleşti
website Dönüşüm bir sitede gerçekleşti
phone_call Dönüşüm telefon yoluyla gerçekleşti
chat Dönüşüm bir mesajlaşma uygulaması, SMS veya çevrimiçi sohbet yoluyla gerçekleşti
physical_store Dönüşüm fiziksel bir mağazada gerçekleşti
system_generated Dönüşüm otomatik olarak, yani aylık abonelik yenilemesi sonucunda gerçekleşti
business_messaging Dönüşüm, müşterinin bir Click-to-WhatsApp reklamına tıklamasından sonra bir konuşmada gerçekleşti
other Dönüşüm başka bir şekilde gerçekleşti

Etkinlikler nasıl test edilir

Etkinlikleri test etmek için, istek gövdesine Test mesajları sekmesinde saklanan metinle birlikte test_event_code parametresini ekleyin.

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

Dikkat! Üretim sürümünü başlatırken istekten test_event_code parametresini silmeyi unutmayın.

Ek isteğe bağlı parametreler

fn — ad.

ln — soyad.

email — müşterinin e-postası.

phone — müşterinin telefon numarası.

fbc — tıklama kimliği.

gender — müşterinin cinsiyeti (f — kadın, m — erkek).

country — ülke.

state — eyalet.

city — şehir.

index — müşterinin posta kodu (ZIP kodu).

external_id — kullanıcı kimliği veya üçüncü taraf çerez dosyalarının kimliği gibi herhangi bir benzersiz müşteri kimliği.

client_ip_address — müşterinin IP adresi.

client_user_agent — müşterinin tarayıcısının kullanıcı aracısı.

Ayrıca Pixel'e kendi parametrelerinizi de aktarabilirsiniz. Bunu yapmak için isteğe bağlı my_params parametresini ekleyin ve içinde kendi alanlarınızı belirtin.

Örnek:

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

Tam örnek

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

Dikkat! Üretim sürümünü başlatırken istekten test_event_code parametresini silmeyi unutmayın.

Reklam hesabı nasıl eklenir

Öncelikle hesabınıza erişim açmanız gerekir.

Kaydedin ve İlgili Nesneler → Nesne Ekle sekmesine geçin.

Ardından reklam hesabınızı ekleyin.

Click-to-WhatsApp Reklam Dönüşümleri

fb_pixel_event() fonksiyonu için dokümantasyona ek.

Meta*, Click-to-WhatsApp reklamındaki her tıklamayı bir ctwa_clid tıklama tanımlayıcısıyla işaretler. Bu, müşterinin ilk WhatsApp mesajıyla birlikte alınır ve konuşmadaki bir dönüşümü belirli bir reklama atfetmek için kullanılır — pixel etkinliklerinin bir web sitesi tıklamasına atfedilmesine benzer şekilde.

İmza

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

Yeni parametreler

Parametre Açıklama
ctwa_clid Click-to-WhatsApp reklamı için tıklama tanımlayıcısı. Bu parametre sağlanmazsa, bot tarafından otomatik olarak kaydedilen ctwa_clid müşteri değişkeni kullanılır. İsteğe bağlı.
messaging_channel Dönüşümün gerçekleştiği mesajlaşma kanalı. Varsayılan olarak whatsapp. İsteğe bağlı.

Yeni action_source değeri

action_source için aşağıdaki değer kullanılabilir:

Değer Açıklama
business_messaging Dönüşüm, müşterinin bir Click-to-WhatsApp reklamına tıklamasından sonra bir konuşmada gerçekleşti.

Aşağıdaki koşullardan en az biri karşılanıyorsa, bir etkinlik mesajlaşma dönüşümü olarak gönderilir:

  • action_source="business_messaging" sağlanmışsa;
  • ctwa_clid sağlanmışsa;
  • messaging_channel sağlanmışsa.

Bu durumda Meta*, action_source + messaging_channel + ctwa_clid kombinasyonunu alır. Bu kombinasyon olmadan, reklam tıklaması dönüşüme atfedilmez.

website değeri mesajlaşma dönüşümleri için kullanılmamalıdır: etkinlik pixele ulaşır, ancak reklama atfedilmez.

Müşteri değişkenleri

Bir müşteri, bir reklama tıkladıktan sonra WhatsApp mesajı gönderdiğinde, bot tıklama verilerini müşterinin müşteri değişkenlerine kaydeder. Bu değişkenleri manuel olarak doldurmanız gerekmez.

Değişken Açıklama
ctwa_clid Tıklama tanımlayıcısı. Etkinliğe otomatik olarak eklenir.
ctwa_clid_time Tanımlayıcının alındığı zaman, Unix zaman biçiminde. Tıklamadan bu yana ne kadar zaman geçtiğini belirlemek için kullanılabilir.
wa_ads_data JSON biçiminde reklam verileri: reklam URL'si, reklam kimliği (source_id), başlık, açıklama, yaratıcı türü ve yaratıcı URL'si.

Tıklama tanımlayıcısı otomatik olarak müşteri değişkeninden alınır, bu nedenle onu fonksiyona açıkça iletmeniz gerekmez.

Müşterinin telefon numarası, data içinde sağlanmazsa etkinliğe otomatik olarak eklenir.

event_source_url parametresi mesajlaşma dönüşümleri için kullanılmaz.

Sınırlamalar

Tıklama tanımlayıcısı yalnızca müşterinin reklamdaki düğmeye tıkladıktan sonraki ilk mesajıyla alınır. Sonraki mesajlara dahil edilmez. Bu nedenle, etkinlik konuşma sırasında herhangi bir noktada gönderilebilir, ancak yalnızca ilk mesaj reklamdan kaynaklanmışsa.

Meta, ctwa_clid'i Android ve iOS'taki Facebook ve Instagram uygulamalarından gelen tıklamalar için sağlar.

Müşteri bir tarayıcıdan tıkladığında veya reklam düğmesi yerine normal bir gönderiye tıkladığında tanımlayıcı sağlanmaz. Bu tür etkileşimlerden gelen dönüşümler reklama atfedilemez.

Müşteri daha sonra başka bir reklama tıklarsa, değişkenler üzerine yazılır. Dönüşüm, müşterinin geldiği en son reklama atfedilir.

Tıklama tanımlayıcısı hem fonksiyon parametrelerinde hem de müşteri değişkenlerinde eksikse, fonksiyon aşağıdaki hatayı döndürür ve etkinlik gönderilmez:

No ctwa_clid variable in client variables