So senden Sie Ereignisse an Pixel vom Bot

Um Ereignisse aus dem Bot-Workflow zu übertragen, benötigen Sie ein Geschäftskonto. Sie können sich hier registrieren.

So erstellen Sie ein neues Pixel

Wählen Sie API Conversions.

Achtung! Wenn während der Konfiguration der Conversion API das folgende Fenster geöffnet wird, ist es besser, die Einstellungen zu verlassen und neu zu starten.

Wenn während der Konfiguration der Conversion API das folgende Fenster geöffnet wird, ist es besser, die Einstellungen zu verlassen und neu zu starten.

Wählen Sie das benötigte Pixel aus.

Generieren Sie ein Zugriffstoken und speichern Sie es an einem sicheren Ort.

So übertragen Sie Ereignisse an Facebook

Um Ereignisse an Facebook zu übertragen, müssen Sie Ihre eigene Domain in der Mini-Landingpage eingerichtet haben. Sie muss auf Facebook genehmigt sein, und Werte aus Cookies in Client-Variablen speichern muss für Facebook in den Einstellungen der Mini-Landingpage aktiviert sein:

Jetzt wird in der Karte des Clients, der von der Mini-Landingpage kam, automatisch eine Variable _fbp ausgefüllt. Diese Variable kann mit dem Ereignis an Pixel übertragen werden.

Sie müssen die folgenden Einstellungen im Block konfigurieren, über den Sie das Ereignis übertragen möchten:

URL der Funktion:

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

Beispielparameter:

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

Pflichtparameter

pixel_id — ID des Pixels.

access_token — das Token für den Zugriff auf die API.

event_name — der Name des Ereignisses. Sie können Standardnamen wie Lead, PageView, Purchase usw. verwenden (weitere Informationen hier) sowie eigene Namen wie Entered the bot.

event_source_url — die auf Facebook genehmigte Domain.

fbp — die Browser-ID des Clients.

Optionale Parameter

action_source — (standardmäßig other) Dieses Feld ermöglicht es Ihnen, genau anzugeben, wo die Konversion stattgefunden hat. Informationen darüber, wo Ereignisse stattgefunden haben, helfen sicherzustellen, dass Ihre Anzeigen der richtigen Zielgruppe angezeigt werden.

Sie können die folgenden Werte im Feld action_source festlegen:

Wert Beschreibung
email Konversion erfolgte per E-Mail
website Konversion erfolgte auf einer Website
phone_call Konversion erfolgte über das Telefon
chat Konversion erfolgte über einen Messenger, SMS oder Online-Chat
physical_store Konversion erfolgte in einem physischen Geschäft
system_generated Konversion erfolgte automatisch, z. B. als Ergebnis einer monatlichen Abonnementverlängerung
business_messaging Konversion erfolgte in einem Gespräch, nachdem der Kunde auf eine Click-to-WhatsApp-Anzeige geklickt hat
other Konversion erfolgte auf andere Weise

So testen Sie Ereignisse

Um Ereignisse zu testen, fügen Sie den Parameter test_event_code mit dem Text aus dem Tab Testnachrichten zum Anfragetext hinzu.

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

Achtung! Vergessen Sie nicht, den Parameter test_event_code aus der Anfrage zu entfernen, wenn Sie die Produktionsversion starten.

Zusätzliche optionale Parameter

fn — Vorname.

ln — Nachname.

email — die E-Mail-Adresse des Clients.

phone — die Telefonnummer des Clients.

fbc — Klick-ID.

gender — das Geschlecht des Clients (f — weiblich, m — männlich).

country — Land.

state — Bundesland/Bundesstaat.

city — Stadt.

index — die Postleitzahl des Clients (ZIP-Code).

external_id — eine beliebige eindeutige Client-ID, z. B. Benutzer-ID oder ID von Drittanbieter-Cookie-Dateien.

client_ip_address — die IP-Adresse des Clients.

client_user_agent — der User-Agent des Browsers des Clients.

Sie können auch eigene Parameter an Pixel übertragen. Fügen Sie dazu den optionalen Parameter my_params hinzu und geben Sie Ihre eigenen Felder darin an.

Beispiel:

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

Vollständiges Beispiel

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

Achtung! Vergessen Sie nicht, den Parameter test_event_code aus der Anfrage zu entfernen, wenn Sie die Produktionsversion starten.

So fügen Sie ein Werbekonto hinzu

Zuerst müssen Sie den Zugriff auf Ihr Konto öffnen.

Speichern Sie und wechseln Sie zum Tab Verknüpfte Objekte → Objekte hinzufügen.

Fügen Sie dann Ihr Werbekonto hinzu.

Click-to-WhatsApp-Anzeigenkonversionen

Eine Ergänzung zur Dokumentation für die Funktion fb_pixel_event().

Meta* markiert jeden Klick von einer Click-to-WhatsApp-Anzeige mit einer Klick-Kennung ctwa_clid. Sie wird zusammen mit der ersten WhatsApp-Nachricht des Kunden empfangen und verwendet, um eine Konversion aus dem Gespräch einer bestimmten Anzeige zuzuordnen — ähnlich wie Pixel-Ereignisse einem Website-Klick zugeordnet werden.

Signatur

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

Neue Parameter

Parameter Beschreibung
ctwa_clid Klick-Kennung für eine Click-to-WhatsApp-Anzeige. Wenn dieser Parameter nicht angegeben wird, wird die Client-Variable ctwa_clid verwendet, die automatisch vom Bot gespeichert wird. Optional.
messaging_channel Der Messaging-Kanal, auf dem die Konversion stattgefunden hat. Standardmäßig whatsapp. Optional.

Neuer action_source-Wert

Der folgende Wert ist für action_source verfügbar:

Wert Beschreibung
business_messaging Die Konversion erfolgte in einem Gespräch, nachdem der Kunde auf eine Click-to-WhatsApp-Anzeige geklickt hat.

Ein Ereignis wird als Messaging-Konversion gesendet, wenn mindestens eine der folgenden Bedingungen erfüllt ist:

  • action_source="business_messaging" wird angegeben;
  • ctwa_clid wird angegeben;
  • messaging_channel wird angegeben.

In diesem Fall empfängt Meta* die Kombination action_source + messaging_channel + ctwa_clid. Ohne diese Kombination wird der Anzeigenklick nicht der Konversion zugeordnet.

Der Wert website darf nicht für Messaging-Konversionen verwendet werden: Das Ereignis erreicht das Pixel, wird aber nicht der Anzeige zugeordnet.

Client-Variablen

Wenn ein Kunde nach dem Klicken auf eine Anzeige eine WhatsApp-Nachricht sendet, speichert der Bot die Klickdaten in den Client-Variablen des Kunden. Sie müssen diese Variablen nicht manuell ausfüllen.

Variable Beschreibung
ctwa_clid Klick-Kennung. Wird automatisch zum Ereignis hinzugefügt.
ctwa_clid_time Zeitpunkt, zu dem die Kennung empfangen wurde, im Unix-Zeitformat. Sie kann verwendet werden, um zu bestimmen, wie viel Zeit seit dem Klick vergangen ist.
wa_ads_data Anzeigendaten im JSON-Format: Anzeigen-URL, Anzeigen-ID (source_id), Titel, Beschreibung, Kreativtyp und Kreativ-URL.

Die Klick-Kennung wird automatisch aus der Client-Variable übernommen, sodass Sie sie nicht explizit an die Funktion übergeben müssen.

Die Telefonnummer des Kunden wird automatisch zum Ereignis hinzugefügt, wenn sie nicht in data angegeben ist.

Der Parameter event_source_url wird für Messaging-Konversionen nicht verwendet.

Einschränkungen

Die Klick-Kennung wird nur mit der ersten Nachricht des Kunden empfangen, nachdem er auf die Schaltfläche in der Anzeige geklickt hat. Sie ist nicht in nachfolgenden Nachrichten enthalten. Daher kann das Ereignis zu jedem Zeitpunkt während des Gesprächs gesendet werden, aber nur, wenn die erste Nachricht von der Anzeige stammt.

Meta stellt ctwa_clid für Klicks aus den Facebook- und Instagram-Apps auf Android und iOS bereit.

Die Kennung wird nicht bereitgestellt, wenn der Kunde aus einem Browser klickt oder auf einen regulären Beitrag statt auf die Anzeigenschaltfläche klickt. Konversionen aus solchen Interaktionen können nicht der Anzeige zugeordnet werden.

Wenn der Kunde später auf eine andere Anzeige klickt, werden die Variablen überschrieben. Die Konversion wird der letzten Anzeige zugeordnet, von der der Kunde kam.

Wenn die Klick-Kennung sowohl in den Funktionsparametern als auch in den Client-Variablen fehlt, gibt die Funktion den folgenden Fehler zurück und das Ereignis wird nicht gesendet:

No ctwa_clid variable in client variables