DokumentationCampaignCampaign Standard – Dokumentation

Konfigurieren von Tag-Regeln zur Unterstützung von Adobe Campaign Standard-Anwendungsfällen configuring-rules-launch

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Experte
  • Admin

Erstellen Sie in der Datenerfassungs-UI Datenelemente und Regeln, damit personenbezogene Daten und andere Informationen von Mobile Apps an Adobe Campaign Standard gesendet werden können.

Damit alle Konfigurationsänderungen in der Datenerfassungs-UI in Kraft treten können, müssen Sie diese Änderungen veröffentlichen. Weitere Informationen finden Sie unter Veröffentlichen.

Gehen Sie wie folgt vor, um Regeln in der Datenerfassungs-UI zu erstellen:

  1. Datenelemente erstellen

  2. Regeln für Anwendungsfälle erstellen, die Sie unterstützen möchten:

Datenelemente erstellen create-data-elements

Im Folgenden finden Sie die Datenelemente, die Sie in der Datenerfassungs-UI erstellen sollten.
Je nach Bedarf können Sie zusätzliche Datenelemente erstellen.

  • Experience-Cloud-ID
  • Pkey
  • Campaign-Server

So erstellen Sie diese Datenelemente:

  1. Klicken Sie in der Datenerfassungs-UI über Ihr Mobile-App-Dashboard auf die Registerkarte Datenelemente.

  2. Um das Datenelement Experience-Cloud-ID zu erstellen, klicken Sie auf Neues Datenelement erstellen.

  3. Geben Sie im Feld Name beispielsweise mcid ein.

  4. Wählen Sie aus der Dropdown-Liste Erweiterung die Option Mobile Core aus. Wählen Sie anschließend Experience-Cloud-ID aus der Dropdown-Liste Datenelement aus.

  5. Klicken Sie auf Datenelement hinzufügen, um das Datenelement „Pkey“ zu erstellen.

  6. Geben Sie im Feld Name beispielsweise pkey ein.

  7. Wählen Sie aus der Dropdown-Liste Erweiterung die Option Adobe Campaign Standard aus. Wählen Sie anschließend pkey aus der Dropdown-Liste Datenelement aus.

  8. Klicken Sie auf Datenelement hinzufügen, um das Datenelement „Campaign Server“ zu erstellen.

  9. Geben Sie im Feld Name einen Namen ein, beispielsweise camp-server.

  10. Wählen Sie aus der Dropdown-Liste Erweiterung die Option Adobe Campaign Standard aus. Wählen Sie anschließend Campaign Server aus der Dropdown-Liste Datenelement aus.

Regeln erstellen creating-rules

Sie müssen Regeln für Folgendes erstellen:

Postback für personenbezogene Daten pii-postback

NOTE
Um personenbezogene Informationen von einer Mobile App an Adobe Campaign zu senden, müssen Sie eine SDK-API implementieren. Weitere Informationen finden Sie unter CollectPII.

Zum Senden von personenbezogenen Daten an Adobe Campaign Standard erstellen Sie eine Regel in der Datenerfassungs-UI:

  1. Klicken Sie in der Datenerfassungs-UI im Dashboard Ihrer Mobile App auf die Registerkarte Regeln und anschließend auf Neue Regel erstellen.

  2. Geben Sie einen Namen ein, beispielsweise Mobile Core – Collect PII.

  3. Klicken Sie im Bereich Ereignisse auf Hinzufügen.

  4. Wählen Sie aus der Dropdown-Liste Erweiterung die Option Mobile Core aus. Wählen Sie anschließend PII abrufen aus der Dropdown-Liste Ereignistyp aus.

  5. Klicken Sie auf Änderungen beibehalten.

  6. Klicken Sie im Bereich Aktionen auf Hinzufügen.

  7. Wählen Sie aus der Dropdown-Liste Erweiterung die Option Mobile Core aus. Wählen Sie anschließend PII senden aus der Dropdown-Liste Aktionstyp aus.

  8. Geben Sie die folgende URL in URL ein:

    code language-none 
    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/subscriptions/{%%mcid%%}

  9. Aktivieren Sie das Kontrollkästchen POST-Hauptteil hinzufügen.

  10. Geben Sie Folgendes in POST-Hauptteil ein:

    code language-none 
    {
"marketingCloudId":
"{%%mcid%%}",
"pushPlatform":
"{%contextdata.pushPlatform%}",
"cusEmail":
"{%contextdata.email%}",
"cusFirstName":
"{%contextdata.firstName%}",
"cusLastName":
"{%contextdata.lastName%}" }

    Die ID für Marketing Cloud ermöglicht Ihnen die Abstimmung Ihrer App-Abonnenten mit den Empfängern in der Datenbank und ist daher erforderlich. Sie können je nach Ihren Geschäftsanforderungen weitere Schlüssel-Werte-Paare angeben. Im obigen Beispiel werden E-Mail, Vorname und Nachname von der App übergeben.

    Die Schlüssel (z. B. cusEmail, cusFirstName und cusLastName) sollten mit den Feld-IDs übereinstimmen, die in Ihrer benutzerdefinierten Ressource in der Adobe Campaign Standard-Instanz definiert sind. Die Wertvariablen (z. B. E-Mail, Vorname und Nachname) sollten mit den Schlüsseln in den JSON-Daten übereinstimmen, die von der mobilen App gesendet werden, während die collectPII-API von AMS aus dem App-Code aufgerufen wird.

    Sie können auch abhängig von Ihren Ereignisauslösern Lebenszyklusdaten im Collect PII-Postback oder einem anderen Postback übergeben. Hier ist ein Beispiel für die Lebenszyklusdaten-JSON:

    code language-none 
    {
"marketingCloudId":"{%%mcid%%}",
"pushPlatform":"{%contextdata.pushPlatform%}",
"cusDayslastlaunch": "{%%DaysSinceLastUse%%}",
"cusDaysfirstlaunch": "{%%DaysSinceFirstUse%%}",
"cusLaunches": "{%%Launches%%}"
}

    Die Datenelemente, die in der Datenerfassungs-UI definiert sind, sollten in doppelte Prozentzeichen (z. B. %%mcid%%) und die Kontextvariablen der Mobile App in einfache Prozentzeichen (z. B. %contextdata.email%) eingeschlossen werden.

  11. Geben Sie unter Content-Typ den Wert application/json ein.

  12. Wählen Sie „0“ als Zeitüberschreitung aus.

Ihre Benutzerdaten sind nun konfiguriert und können an Campaign gesendet werden.

In-App-Tracking-Postback inapp-tracking-postback

NOTE
Wenn Sie Android ACPCore v1.4.0 oder höher bzw. iOS ACPCore v2.3.0 oder höher verwenden, ist die Konfiguration von Tracking-Postbacks nicht erforderlich.

Um Tracking-Daten zum Reporting über die Interaktion Ihrer Benutzer mit In-App-Nachrichten in der Mobile App an Adobe Campaign Standard zu senden, erstellen Sie die folgende Regel in der Datenerfassungs-UI:

  1. Wählen Sie in der Datenerfassungs-UI über das Dashboard Ihrer Mobile App die Registerkarte Regeln und klicken Sie auf Regel hinzufügen.

  2. Geben Sie einen Namen ein, beispielsweise Adobe Campaign - In-App Klick-Tracking.

  3. Klicken Sie im Bereich Ereignisse auf Hinzufügen.

  4. Wählen Sie aus der Dropdown-Liste Erweiterung die Option Adobe Campaign Standard aus. Wählen Sie anschließend In-App Klick-Tracking aus der Dropdown-Liste Ereignistyp aus.

  5. Klicken Sie auf Änderungen beibehalten.

  6. Klicken Sie im Bereich Aktionen auf Hinzufügen.

  7. Wählen Sie aus der Dropdown-Liste Erweiterung die Option Mobile Core aus. Wählen Sie anschließend Postback senden aus der Dropdown-Liste Ereignistyp aus.

  8. Geben Sie die folgende URL in URL ein:

    code language-none 
    https://{%%camp-server%%}/r/?id={%id%}&mcid={%%mcid%%}

  9. Aktivieren Sie das Kontrollkästchen POST-Hauptteil hinzufügen.

  10. Geben Sie in POST-Hauptteil {} ein.

  11. Geben Sie unter Content-Typ den Wert application/json ein.

  12. Wählen Sie „0“ als Zeitüberschreitung aus.

Tracking-Postback für Push-Benachrichtigungen push-tracking-postback

NOTE
Wenn Sie Android ACPCore v1.4.0 oder höher bzw. iOS ACPCore v2.3.0 oder höher verwenden, ist die Konfiguration von Tracking-Postbacks nicht erforderlich.

Um Tracking-Daten an Adobe Campaign Standard zu senden, damit Ihre Push-Benachrichtigung und die Benutzerinteraktionen mit Ihrer Mobile App getrackt werden können, müssen Sie eine Regel in der Datenerfassungs-UI erstellen.

Weitere Informationen zum Push-Tracking finden Sie im Abschnitt Push-Tracking.

Verwenden Sie die trackAction-API, um App-Aktionen zu tracken. Weitere Informationen finden Sie unter App-Aktionen tracken.

  1. Klicken Sie in der Datenerfassungs-UI über das Dashboard Ihrer Mobile App auf die Registerkarte Regeln und anschließend auf Neue Regel hinzufügen.

  2. Geben Sie einen Namen ein, beispielsweise Adobe Campaign - push click tracking.

  3. Klicken Sie im Bereich Ereignisse auf Hinzufügen.

  4. Wählen Sie aus der Dropdown-Liste Erweiterung die Option Mobile Core aus. Wählen Sie anschließend Aktion tracken aus der Dropdown-Liste Ereignistyp aus.

  5. Wählen Sie aus der Dropdown-Liste Aktion die Option Aktion aus. Wählen Sie ist gleich aus und geben Sie Tracking ein.

  6. Klicken Sie auf Änderungen beibehalten. Klicken Sie anschließend im Bereich Aktionen auf Hinzufügen.

  7. Wählen Sie aus der Dropdown-Liste Erweiterung die Option Mobile Core aus. Wählen Sie anschließend Postback senden aus der Dropdown-Liste Aktionstyp aus.

  8. Geben Sie die folgende URL in URL ein:

    code language-none 
    https://{%%camp-server%%}/r/?id={%contextdata.broadlogId%},{%contextdata.deliveryId%},{%contextdata.action%}&mcId={%%mcid%%}

  9. Aktivieren Sie das Kontrollkästchen POST-Hauptteil hinzufügen.

  10. Geben Sie Ihren POST-Hauptteil ein, beispielsweise „{ }“.

  11. Geben Sie unter Content-Typ den Wert application/json ein.

  12. Wählen Sie „0“ als Zeitüberschreitung aus.

Standort-Postback location-postback

  1. Klicken Sie in der Datenerfassungs-UI über das Dashboard Ihrer Mobile App auf die Registerkarte Regeln und anschließend auf Neue Regel hinzufügen.

  2. Geben Sie einen Namen ein, beispielsweise Standort-Postback.

  3. Klicken Sie im Bereich Ereignisse auf Hinzufügen.

  4. Erstellen Sie ein Ereignis, beispielsweise „Enter POI“ oder „Exit POI“. Wählen Sie aus der Dropdown-Liste Erweiterung die Option Places – Betaversion aus. Wählen Sie anschließend Enter POI oder Exit POI aus der Dropdown-Liste Ereignistyp aus.

  5. Geben Sie einen Namen ein, beispielsweise Places - Betaversion - Enter POI oder Exit POI.

  6. Klicken Sie im Bereich Aktionen auf Hinzufügen.

  7. Wählen Sie aus der Dropdown-Liste Erweiterung die Option Mobile Core aus. Wählen Sie anschließend Postback senden aus der Dropdown-Liste Aktionstyp aus.

  8. Geben Sie einen Namen ein, beispielsweise Mobile Core - Send Location Postback.

  9. Geben Sie die folgende URL in URL ein:

    code language-none 
    https://{%%camp-server%%}/rest/head/mobileAppV5/{%%pkey%%}/locations/

  10. Aktivieren Sie das Kontrollkästchen POST-Hauptteil hinzufügen und geben Sie Ihren POST-Hauptteil ein, beispielsweise:

    code language-none 
    {
"locationData": {
    "distances": "{%%Distance%%}",
    "poiLabel": "{%%POILabel%%}",
    "latitude": "{%%Latitude%%}",
    "longitude": "{%%Longitude%%}",
    "appId": "{%%AppId%%}",
    "marketingCloudId": "{%%ECID%%}"
}
}
    note note
    NOTE
    Im obigen Beispiel müssen die Datenelemente auf der rechten Seite in der Datenerfassungs-UI konfiguriert werden. Nutzen Sie dazu die Schritte unter Erstellen von Datenelementen. Die Datenelemente auf der linken Seite werden in Adobe Campaign Standard unterstützt und müssen nicht konfiguriert werden. Wenn Sie zusätzliche Daten benötigen, müssen Sie in Adobe Campaign Standard benutzerdefinierte Ressourcenerweiterungen ausführen.

  11. Geben Sie unter Content-Typ den Wert application/json ein.

  12. Wählen Sie „5“ als Zeitüberschreitung aus.

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff