API-Kampagnen

Dieser Referenzartikel beschreibt, wie Sie eine campaign_id generieren, die Sie in Ihre API-Aufrufe einbinden können, und wie Sie diese Kampagne konfigurieren.

API-Kampagnen werden in der Regel für transaktionsbezogene Nachrichten verwendet. Bei der Erstellung von API-Kampagnen (nicht API-getriggerten Kampagnen) wird das Braze-Dashboard nur verwendet, um eine campaign_id zu generieren, mit der Sie Analytics für die Kampagnenberichterstattung verfolgen können. Sie können auch eine Nachrichtenvarianten-ID generieren, die für jede Variante Ihrer Kampagne unterschiedlich ist.

Diese Informationen senden Sie dann an Ihr Entwicklungsteam, um sie in der API-Anfrage zu verwenden, zusammen mit:

• Texte für die Kampagne
• Zielgruppenzugehörigkeit
• Assets

Nachdem die Kampagne begonnen hat, können Sie die Ergebnisse im Dashboard einsehen. API-Kampagnen verwenden die Messaging-APIs von Braze, die über die gleichen detaillierten Berichts- und Retargeting-Optionen verfügen wie Kampagnen, die vollständig über das Dashboard erstellt wurden.

Da API-Kampagnen immer eine campaign_id enthalten, werden ihre Sendungen in den Dashboard-Statistiken berücksichtigt. Wenn Sie /messages/send ohne eine campaign_id aufrufen, erhöht Braze diese Metriken nicht – die Sendungen erscheinen weiterhin im Nachrichtenaktivitätsprotokoll, aber nicht in den E-Mail-Performance-Metriken im Dashboard.

Warnung

Da API-Kampagnen in der Regel transaktionsbezogen sind, kommen alle Nutzer:innen für API-Kampagnen in Frage, auch diejenigen in Ihrer globalen Kontrollgruppe. Eine Ein-Klick-Listenabmeldung-Kopfzeile wird diesen Sendungen standardmäßig nicht hinzugefügt. Informationen zum Hinzufügen einer Ein-Klick-Listenabmeldung-Kopfzeile zu einer API-Kampagne finden Sie unter Ein-Klick-Listenabmeldung zu API-Kampagnen hinzufügen. Wenn Sie allen API-Kampagnen eine Ein-Klick-Listenabmeldung-Kopfzeile hinzufügen möchten, wenden Sie sich an Ihren Customer-Success-Manager.

Neue Campaign erstellen

Gehen Sie zu Messaging > Campaigns und wählen Sie Create Campaign aus. Wählen Sie dann API Campaigns aus. Nun können Sie mit der Konfiguration Ihrer API-Campaign fortfahren.

Eine API-getriggerte Campaign unterscheidet sich von einer API-Campaign.

Campaign konfigurieren

Um Ihre Campaign zu konfigurieren, führen Sie die folgenden Schritte aus:

1. Fügen Sie einen aussagekräftigen Titel hinzu, damit Sie die Ergebnisse auf der Campaigns-Seite finden können, nachdem Sie Ihre Nachrichten gesendet haben.
2. Wählen Sie Nachricht hinzufügen aus und fügen Sie die Nachrichtentypen hinzu, die in Ihrer API-Campaign enthalten sind. So können Sie eine campaign_id und eine Nachrichtenvarianten-ID generieren, die sich für jeden enthaltenen Kanal unterscheidet.
3. Optional können Sie ein Konversions-Event hinzufügen, um Nutzer:innen-Konversionen für eine bestimmte Aktion oder ein Campaign-Ziel zu verfolgen.
4. Wählen Sie Campaign speichern aus, um Ihre API-Campaign zu starten.

API-Aufrufe

Nachdem Sie Ihre API-Campaign gespeichert haben, fügen Sie Folgendes in Ihre API-Anfrage ein:

• Die generierten campaign_id-Felder in Ihrer API-Anfrage, wie in den Endpunkten zum Senden von Nachrichten angegeben.
• Ein Nachrichtenobjekt für jede in der Campaign enthaltene Plattform. Geben Sie im Nachrichtenobjekt die ID der Nachrichtenvariante an. Damit wird festgelegt, dass Statistiken unter dieser Variante erfasst und angezeigt werden. Die folgenden Nachrichtenobjekte werden unterstützt: Android, Content Cards, E-Mail, iOS, Kindle, SMS/MMS, Web-Push und Webhook.

Ein-Klick-Abmeldung per Liste zu API-Campaigns hinzufügen

Standardmäßig fügt Braze den Header für die Ein-Klick-Abmeldung per Liste nicht zu API-Campaigns hinzu. Sie können diesen Header zu einzelnen API-Campaign-Sendungen hinzufügen, indem Sie den Liquid-Tag {{${set_user_to_one_click_list_unsubscribe}}} im Feld für E-Mail-Header Ihrer API-Anfrage einfügen.

Um RFC 8058 für die Ein-Klick-Abmeldung per Liste einzuhalten, fügen Sie sowohl den List-Unsubscribe- als auch den List-Unsubscribe-Post-Header in Ihre API-Anfrage ein:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "external_user_ids": ["user_id"],
  "messages": {
    "email": {
      "app_id": "your_app_id",
      "subject": "Your Subject",
      "from": "Sender Name <[email protected]>",
      "body": "<p>Email body content</p>",
      "headers": {
        "List-Unsubscribe": "<{{${set_user_to_one_click_list_unsubscribe}}}>",
        "List-Unsubscribe-Post": "List-Unsubscribe=One-Click"
      }
    }
  }
}

Hinweis

Das Einfügen dieser Header garantiert nicht, dass der E-Mail-Client einen Abmelde-Button anzeigt. E-Mail-Clients entscheiden anhand von Faktoren wie Absender-Reputation und Nachrichteninhalt, ob die Abmeldeoption angezeigt wird.

E-Mail-Anhänge hinzufügen

Um Anhänge zu API-Campaign-E-Mails hinzuzufügen, fügen Sie ein attachments-Array in das E-Mail-Objekt ein. Sie können ein E-Mail-Template referenzieren, das im Drag-and-Drop- oder HTML-Editor erstellt wurde, indem Sie dessen email_template_id im E-Mail-Objekt angeben und dann Anhänge über den API-Aufruf hinzufügen.

Einzelheiten zu Anhängen, Größenbeschränkungen und Best Practices finden Sie unter Beispiel für ein E-Mail-Objekt mit Anhang.