Experience Platform-publiek voorstellen en gebruiken

In de gebruikersinterface van Experience Platform:

1. Selecteer Customer > Audiences.

2. Selecteer Browse en zoek naar het publiek dat u in Customer Journey Analytics wilt opnemen en gebruiken. Noteer Audience Id voor elk publiek voor later gebruik.

   

Verzoek

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

Waarbij:

• DATASET_NAME is de vriendelijke naam van de dataset. Bijvoorbeeld Segment Export Job Dataset for CJA .

Antwoord

["@/dataSets/{DATASET_ID}"]

Waarbij:

• DATASET_ID is de id van de gegevensset voor de gemaakte gegevensset.

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

Wanneer

• COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES zou iets als _demoemea.identification.core.ecid, _demoemea.identification.core.email, _demoemea.identification.core.phoneNumber, person.gender, person.name.firstName, person.name.lastName kunnen zijn. Zorg ervoor dat u ten minste de relevante velden opneemt (zoals de persoon-id (e-mail)) die u wilt gebruiken in uw analyse van de reis van de klant.
• AUDIENCE_ID_x zijn de publiek-id's van het publiek dat u wilt exporteren.
• DATASET_ID is de dataset die u creeerde.

Antwoord

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

Wanneer

• EXPORT_JOB_ID is de id van de exporttaak.

Verzoek

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}'

Antwoord

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

In de gebruikersinterface van Experience Platform:

1. Selecteer Data Management > Datasets.

2. Selecteer de gegevensset die u hebt gemaakt, bijvoorbeeld: Segment Export Job Dataset for CJA .

   

3. Verifieer de opgenomen partijen. Als de dataset ontbroken partijen bevat, gebruik Data Management > Monitoring om te zien wat de reden is. U hebt bijvoorbeeld een veldnaam gebruikt die niet in het schema voorkomt.

4. Kopieer Table name van de dataset. Bijvoorbeeld: segment_export_job_dataset_for_cja . U gebruikt die naam in de volgende stap.

Gebruik een PSQL-client die verbinding maakt met de Experience Platform Query Service.

In de gebruikersinterface van Experience Platform:

1. Selecteer Data Management > Queries.
2. Selecteer Credentials.

Gebruik de referenties om uw PSQL-client te configureren voor verbinding met de Customer Journey Analytics Query Service.

Query

Voer deze vraag uit om de publieksgegevens van de dataset terug te winnen:

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')

Waarbij:

• IDENTITY_TO_USE_AS_PERSON_ID is een van de velden die u hebt gedefinieerd als onderdeel van de exporttaak. Bijvoorbeeld: _demoemea.identification.core.email .
• DATASET_TABLE_NAME is de tabelnaam van de gegevensset.
• AUDIENCE_ID_x is het publiek dat u hebt gedefinieerd als onderdeel van de exporttaak. U moet deze doelgroepen opnieuw opgeven omdat de specificatie in de exporttaak een filter op rijniveau is. Die rij-vlakke filter keert profielen voor de gespecificeerde segmenten met alle segmentlidmaatschap voor elk van de profielen terug.

Resultaten

Het resultaat van de query, in JSON-indeling, moet er als volgt uitzien:

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

]

Waarbij:

• PERSON_ID_x zijn de id-waarden voor de id die u als de persoon-id wilt gebruiken. john.doe@gmail.com bijvoorbeeld wanneer u e-mail gebruikt.
• AUDIENCE_ID_x zijn de publiek-id's.

De uiteindelijke JSON zou er als volgt moeten uitzien:

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

]

Waarbij:

• TENANT_NAME is de naam van de huurder. Bijvoorbeeld: _demoemea .
• PERSON_ID_x zijn de id-waarden voor de id die u als de persoon-id wilt gebruiken. john.doe@gmail.com bijvoorbeeld wanneer u e-mail gebruikt.
• AUDIENCE_ID_x zijn de publiek-id's.
• AUDIENCE_FRIENDLY_NAME_x zijn vriendelijke publieksnamen voor de doelgroepen. Bijvoorbeeld: Luma - Blue+ Members .

Gebruik uw favoriete gereedschap om de originele JSON om te zetten in deze indeling.

Het schema maken:

In de gebruikersinterface van Experience Platform:

1. Selecteer Data Management > Schemas.

2. Selecteer Create schema. Selecteer Standard in de vervolgkeuzelijst.

3. Selecteer Manual in het dialoogvenster Create a schema en gebruik Select om door te gaan.

4. In de wizard Create schema voert u in de stap Select a class de volgende handelingen uit:

   1. Selecteer Individual Profile.
   2. Selecteer Next.

5. In de wizard Create schema voert u in de stap Name and review de volgende handelingen uit:

   1. Voer een Schema display name in. Bijvoorbeeld: Audience Export for CJA Schema .
   2. (optioneel) Voer een Description in.
   3. Selecteer Finish.

6. Stel uw schema zo in dat het een aangepaste veldgroep bevat (bijvoorbeeld Audience Membership ) die twee velden met de naam audienceMembershipId en audienceMembershipName bevat.

7. Zorg ervoor dat het veld personID een Identity , Primary Identity is en Email heeft als de I ​ dentity namespace.

   

8. Apply alle wijzigingen. Selecteer Save om het schema op te slaan.

In de gebruikersinterface van Experience Platform:

1. Selecteer Data Management > Datasets.

2. Selecteer Create dataset.

3. Selecteer Create dataset from schema.

4. In de wizard Create dataset from schema voert u in de stap Select schema de volgende handelingen uit:

   1. Selecteer het schema dat u zojuist hebt gemaakt. Bijvoorbeeld: Audience Export for CJA Schema .
   2. Selecteer Next.

5. In de wizard Create dataset from schema voert u in de stap Configure dataset de volgende handelingen uit:

   1. Voer een Name in voor de gegevensset.
   2. (optioneel) Voer een Description in voor de gegevensset.
   3. Selecteer Finish.

6. In Datasets > naam van de dataset, sleep het getransformeerde JSON- gegevensdossier en laat vallen het dossier op Drag and drop files. Met deze handeling wordt de opname van de geëxporteerde JSON-gegevens in de gegevensset gestart.

7. Verifieer de opgenomen partijen. Als de dataset ontbroken partijen bevat, gebruik Data Management > Monitoring om te zien wat de reden is. U hebt bijvoorbeeld een veldnaam in de JSON gedefinieerd die niet in het schema bestaat.

In de gebruikersinterface van Customer Journey Analytics:

1. Selecteer Data Management > Connections .

2. Maak een nieuwe verbinding/ Define Connection settings en Data settings . Of selecteer een bestaande verbinding en gebruik Edit Connection uit om de verbinding uit te geven.

3. Selecteer Add datasets.

4. Selecteer de dataset die u creeerde en waarin u de getransformeerde JSON gegevens opnam.

5. Vorm de dataset. Bijvoorbeeld:

   

6. Save de verbinding.

1. Selecteer Data Management > Data views .

2. Bewerk een bestaande gegevensweergave of maak een nieuwe gegevensweergave.

3. Controleer in het tabblad Components van de gegevensweergave of Audience Membership Id en Audience Membership Name zijn toegevoegd als dimensie-componenten.

   

4. Selecteer Save and Continue om de gegevensweergave op te slaan.