Aufnehmen und Verwenden von Experience Platform-Zielgruppen

In der Experience Platform-Benutzeroberfläche:

1. Wählen Sie Kunde > Audiences.

2. Wählen Sie Durchsuchen und suchen Sie nach den Zielgruppen, die Sie in Customer Journey Analytics aufnehmen und verwenden möchten. Notieren Sie Zielgruppen-ID für jede der Zielgruppen für die spätere Verwendung.

   

Anfrage

curl -X POST \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?requestDataSource=true' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
   "name": "{DATASET_NAME}",
   "schemaRef": {
      "id": "_xdm.context.profile__union",
      "contentType": "application/vnd.adobe.xed+json;version=1"
   },
   "fileDescription": {
      "persistet": true,
      "containerFormat": "parquet",
      "format": "parquet"
   }
}'

Dabei gilt:

• DATASET_NAME ist der Anzeigename des Datensatzes. Zum Beispiel Segment Export Job Dataset for CJA.

Antwort

["@/dataSets/{DATASET_ID}"]

Dabei gilt:

• DATASET_ID ist die Datensatzkennung für den erstellten Datensatz.

curl -X POST https://platform.adobe.io/data/core/ups/export/jobs \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "fields": "{COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES}",
    "filter": {
        "segments": [
            {
                "segmentId": "{AUDIENCE_ID_1}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ],
                "segmentId": "{AUDIENCE_ID_2}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ],
                "segmentId": "{AUDIENCE_ID_3}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ]
             }
        ]
    },
    "destination":{
        "datasetId": "{DATASET_ID}",
        "segmentPerBatch": false
    },
    "schema":{
        "name": "_xdm.context.profile"
    }
}'

Dabei wird

• COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES könnte so etwas wie _demoemea.identification.core.ecid, _demoemea.identification.core.email, _demoemea.identification.core.phoneNumber, person.gender, person.name.firstName, person.name.lastName sein. Stellen Sie sicher, dass Sie mindestens die relevanten Felder (z. B. die Personen-ID (E-Mail)) einbeziehen, die Sie in Ihrer Kunden-Journey-Analyse verwenden möchten.
• AUDIENCE_ID_x sind die Zielgruppenkennungen der Zielgruppen, die Sie exportieren möchten.
• DATASET_ID ist der von Ihnen erstellte Datensatz.

Antwort

{
  "..."
  "id": "{EXPORT_JOB_ID}",
  "..."
}

Dabei wird

• EXPORT_JOB_ID ist die Kennung des Exportvorgangs.

Anfrage

curl -X GET https://platform.adobe.io/data/core/ups/export/jobs/{EXPORT_JOB_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Antwort

{
  "..."
  "id": "{EXPORT_JOB_ID}",
  "..."
  "status": "SUCCEEDED",
  "..."
}

In der Experience Platform-Benutzeroberfläche:

1. Wählen Sie Daten-Management > Datensätze.

2. Wählen Sie den von Ihnen erstellten Datensatz aus, zum Beispiel: Segmentexportvorgangs-Datensatz für CJA.

   

3. Überprüfen Sie die aufgenommenen Batches. Wenn der Datensatz fehlgeschlagene Batches enthält, verwenden Sie Daten-Management > Monitoring, um den Grund anzuzeigen. Sie haben beispielsweise einen Feldnamen verwendet, der im Schema nicht vorhanden ist.

4. Kopieren Sie den Tabellennamen des Datensatzes. Beispiel: segment_export_job_dataset_for_cja. Sie verwenden diesen Namen im nächsten Schritt.

Verwenden Sie einen PSQL-Client, der eine Verbindung zum Abfrage-Service von Experience Platform herstellt.

In der Experience Platform-Benutzeroberfläche:

1. Wählen Sie Daten-Management > Queries.
2. Wählen Sie Credentials aus.

Verwenden Sie die Anmeldeinformationen, um Ihren PSQL-Client für die Verbindung mit dem Abfrage-Service von Customer Journey Analytics zu konfigurieren.

Abfrage

Führen Sie diese Abfrage aus, um die Zielgruppendaten aus dem Datensatz abzurufen:

SELECT ROW_NUMBER() OVER (ORDER BY key)::text as _id, personID, key as audienceMembershipId
FROM (
   SELECT {IDENTITY_TO_USE_AS_PERSON_ID} AS personID, explode(segmentMembership.ups)
   FROM {DATASET_TABLE_NAME}
)
WHERE value.status = 'realized' AND (key = '{AUDIENCE_ID_1}' OR key = 'AUDIENCE_ID_2' OR key = 'AUDIENCE_ID_3')

Dabei gilt:

• IDENTITY_TO_USE_AS_PERSON_ID ist eines der Felder, die Sie als Teil des Exportvorgangs definiert haben. Beispiel: _demoemea.identification.core.email.
• DATASET_TABLE_NAME ist der Tabellenname des Datensatzes.
• AUDIENCE_ID_x sind die Zielgruppen, die Sie als Teil des Exportvorgangs definiert haben. Sie müssen diese Zielgruppen erneut angeben, da die Spezifikation im Exportvorgang ein Filter auf Zeilenebene ist. Dieser Filter auf Zeilenebene gibt Profile für die angegebenen Segmente mit allen Segmentzugehörigkeiten für jedes der Profile zurück.

Ergebnisse

Das Ergebnis der Abfrage im JSON-Format sollte wie folgt aussehen:

[
   {
      "_id": "1",
      "personID": "{PERSON_ID_x}",
      "audienceMembershipId": "{AUDIENCE_ID_x}"
   },
   {
      "_id": "2",
      "personID": "PERSON_ID_y",
      "audienceMembershipId": "{AUDIENCE_ID_x}"
   }

]

Dabei gilt:

• PERSON_ID_x sind die Kennungswerte für die Kennung, die Sie als Personen-ID verwenden möchten. john.doe@gmail.com beispielsweise bei der Verwendung von E-Mails.
• AUDIENCE_ID_x sind die Zielgruppenkennungen.

Das endgültige JSON sollte wie folgt aussehen:

[
   {
      "_id": "1",
      "personID": "{PERSON_ID_x}",
      "{TENANT_NAME}": {
         "audienceMembershipId": "{AUDIENCE_ID_x}",
         "audienceMembershipName": "{AUDIENCE_FRIENDLY_NAME_x}"
      }
  },
  {
      "_id": "2",
      "personID": "{PERSON_ID_y}",
      "{TENANT_NAME}": {
         "audienceMembershipId": "{AUDIENCE_ID_y}",
         "audienceMembershipName": "{AUDIENCE_FRIENDLY_NAME_y}"
      }
    }
  }

]

Dabei gilt:

• TENANT_NAME ist der Name des Mandanten. Beispiel: _demoemea.
• PERSON_ID_x sind die Kennungswerte für die Kennung, die Sie als Personen-ID verwenden möchten. john.doe@gmail.com beispielsweise bei der Verwendung von E-Mails.
• AUDIENCE_ID_x sind die Zielgruppenkennungen.
• AUDIENCE_FRIENDLY_NAME_x sind Anzeigenamen für die Zielgruppen-IDs. Beispiel: Luma - Blue+ Members.

Verwenden Sie Ihr bevorzugtes Tool, um die ursprüngliche JSON in dieses Format umzuwandeln.

So erstellen Sie das Schema:

In der Experience Platform-Benutzeroberfläche:

1. Wählen Sie Daten-Management > Schemas aus.

2. Wählen Sie Schema erstellen. Wählen Standard aus dem Dropdown-Menü aus.

3. Wählen Sie Dialogfeld Schema erstellen die Option „Manuell aus und verwenden Sie Auswählen, um fortzufahren.

4. Gehen Sie im Schema erstellen im Schritt Klasse auswählen folgendermaßen vor:

   1. Wählen Sie Individuelles Profil aus.
   2. Klicken Sie auf Weiter.

5. Im Assistenten Schema erstellen im Schritt Name und Überprüfung:

   1. Geben Sie einen Anzeigenamen des Schemas ein. Beispiel: Audience Export for CJA Schema.
   2. (Optional) Geben Sie eine "".
   3. Wählen Sie Beenden aus.

6. Richten Sie Ihr Schema so ein, dass es eine benutzerdefinierte Feldergruppe (mit dem Namen Zielgruppenmitgliedschaft) enthält, die zwei Felder mit dem Namen audienceMembershipId und audienceMembershipName enthält.

7. Stellen Sie sicher dass das Feld personID) eine Identität Primäre Identität ist und email als I​identity-Namespace hat.

   

8. Übernehmen alle Änderungen. Klicken Sie auf Speichern, um das Schema zu speichern.

In der Experience Platform-Benutzeroberfläche:

1. Wählen Sie Daten-Management > Datensätze.

2. Wählen Sie Datensatz erstellen.

3. Wählen Sie Erstellen eines Datensatzes aus einem Schema aus.

4. Im Assistenten Datensatz aus Schema erstellen im Schritt Schema auswählen:

   1. Wählen Sie das soeben erstellte Schema aus. Beispiel: Zielgruppenexport für CJA-Schema.
   2. Klicken Sie auf Weiter.

5. Im Assistenten Erstellen eines Datensatzes aus) im Schritt Konfigurieren Datensatzes:

   1. Geben Sie einen Namen für den Datensatz ein.
   2. (Optional) Geben Sie eine Beschreibung für den Datensatz ein.
   3. Wählen Sie Beenden aus.

6. Ziehen Sie unter Datensätze > Name des Datensatzes die umgewandelte JSON-Datendatei und legen Sie die Datei auf Dateien per Drag-and-Drop. Diese Aktion startet die Aufnahme der exportierten JSON-Daten in den Datensatz.

7. Überprüfen Sie die aufgenommenen Batches. Wenn der Datensatz fehlgeschlagene Batches enthält, verwenden Sie Daten-Management > Monitoring, um den Grund anzuzeigen. Sie haben beispielsweise einen Feldnamen in der JSON definiert, der im Schema nicht vorhanden ist.

In der Customer Journey Analytics-Benutzeroberfläche:

1. Wählen Daten-Management > Verbindungen aus.

2. Erstellen einer neuen Verbindung/Definieren Verbindungseinstellungen und Dateneinstellungen. Oder wählen Sie eine vorhandene Verbindung aus und verwenden Sie Verbindung bearbeiten, um die Verbindung zu bearbeiten.

3. Wählen Sie Datensätze hinzufügen aus.

4. Wählen Sie den von Ihnen erstellten Datensatz aus, in den Sie die umgewandelten JSON-Daten aufgenommen haben.

5. Konfigurieren Sie den Datensatz. Zum Beispiel:

   

6. Speichern der Verbindung.

1. Wählen Daten-Management > Datenansichten aus.

2. Bearbeiten Sie eine vorhandene Datenansicht oder erstellen Sie eine neue Datenansicht.

3. Stellen auf der Registerkarte Komponenten“ der Datenansicht sicher, Zielgruppenzugehörigkeits-ID und Zielgruppenzugehörigkeits-) als Dimensionskomponenten hinzugefügt werden.

   

4. Wählen Sie Speichern und fortfahren, um die Datenansicht zu speichern.