Audience Activation

Il Audience Activation estensione consente di attivare i tipi di pubblico di Real-Time CDP in Adobe Commerce per creare offerte univoche nel carrello. Queste offerte e incentivi includono tecniche di merchandising comuni per l’e-commerce, come acquistare 2 ottenere 1 gratis, i banner hero rivolti a quel cliente e i prezzi dei prodotti modificati attraverso varie offerte. I tipi di pubblico generati in Real-Time CDP si basano su dati provenienti da vari sistemi aziendali, come Enterprise Resource Planning (ERP), Customer Relationship Management (CRM), punti vendita e sistemi di marketing. Poiché le informazioni sui segmenti dei clienti vengono costantemente aggiornate, i clienti possono associarsi e dissociarsi da un segmento mentre fanno acquisti nel negozio.

Puoi attivare i tipi di pubblico in una vetrina Luma o headless vetrina. In una vetrina Luma, le informazioni sul pubblico (iscrizione al segmento) vengono memorizzate in un cookie sul lato Commerce. In una vetrina headless, le informazioni sul pubblico vengono trasmesse nell’intestazione API di GraphQL come parametro denominato: aep-segments-membership.

Note sulla versione

Questa sezione contiene informazioni sugli aggiornamenti dell'estensione Audience Activation e include:

Nuovo - Nuove funzioni
Correzione - Correzioni e miglioramenti
Bug - Problemi noti

Consulta Prossime versioni per informazioni sulle pianificazioni delle versioni e sul supporto.

Consulta la documentazione per gli sviluppatori per informazioni sulla compatibilità dei prodotti.

Aggiornamenti dei servizi supportati

Queste note sulla versione descrivono modifiche e correzioni di funzioni relative alle estensioni utilizzate da Audience Activation.

Aggiornamenti dei servizi supportati

15 agosto 2023

Correzione - Aggiornato il Dashboard di Real-Time CDP Audiences per semplificare il filtro.

27 giugno 2023

Correzione - Aggiunta del supporto per PHP 8.2 nel magento/module-data-services-graphql pacchetto.

30 maggio 2023

Nuovo - Aggiornato il Dashboard di Real-Time CDP Audiences per includere la possibilità di ordinare, cercare e filtrare i tipi di pubblico attivi all’interno della tua istanza di Adobe Commerce.

2.1.1.

[Compatibilità]{class="badge informative" title="Compatibilità"}

4 aprile 2024

Nuovo - Aggiunta del supporto per PHP 8.3.

2.2.0-beta1

[Compatibilità]{class="badge informative" title="Compatibilità"}

16 febbraio 2024

Nuovo - Se partecipi alla versione beta, assicurati che il tuo composer.json il file presenta le seguenti caratteristiche a livello di radice: "minimum-stability": "beta".
Nuovo - (Beta a) Aggiunta la possibilità di creare regole prodotto correlate informato dal pubblico.

2.1.0.

[Compatibilità]{class="badge informative" title="Compatibilità"}

24 gennaio 2024

Nuovo - Aggiornato il Dashboard di Real-Time CDP Audiences per includere i siti web che contengono i tipi di pubblico e specificare quali blocchi dinamici e regole di prezzo del carrello sono configurati per utilizzare tali tipi di pubblico.

2.0.1.

[Compatibilità]{class="badge informative" title="Compatibilità"}

16 novembre 2023

Correzione - Maggiore stabilità.

2,0,0

[Compatibilità]{class="badge informative" title="Compatibilità"}

10 ottobre 2023

Nuovo - Aggiunta del supporto per OAuth 2.0 quando configura l’estensione Audience Activation.
Correzione - Maggiore stabilità.

1.2.0.

[Compatibilità]{class="badge informative" title="Compatibilità"}

15 agosto 2023

Correzione - È stata aggiornata la versione dei componenti dell’interfaccia utente.

1.1.0.

30 maggio 2023

[Compatibilità]{class="badge informative" title="Compatibilità"}

Nuovo - Aggiunta del supporto per blocchi dinamici in una vetrina headless.

1.0.1.

11 maggio 2023

[Compatibilità]{class="badge informative" title="Compatibilità"}

Correzione - È stato risolto un problema a causa del quale una regola del prezzo di blocco dinamico o carrello non veniva applicata alla vetrina.
Correzione - È stato risolto un problema che causava un errore durante l’installazione non configurata dell’estensione Audience Activation quando un commerciante tentava di creare o aggiornare un blocco dinamico.

1,0,0

31 marzo 2023

[Compatibilità]{class="badge informative" title="Compatibilità"}

Nuovo - Versione di disponibilità generale

Implementazione

Le seguenti attività si applicano sia alle implementazioni Luma che alla vetrina headless. Per attivare i tipi di pubblico in Adobe Commerce, devi:

  • Installare Adobe Commerce versione 2.4.4 o successiva
  • Attiva Adobe Commerce come destinazione in Real-Time CDP
  • Installa il Audience Activation estensione in Admin
  • Configura il Audience Activation estensione in Admin

Installare l’estensione

Installare Audience Activation estensione da marketplace, o esegui il seguente comando:

composer require magento/audiences

Configurare l'estensione

Dopo aver installato Audience Activation devi accedere al tuo amministratore Commerce e completare le seguenti operazioni:

  1. Il giorno Amministratore barra laterale, vai a System > Services>Commerce Services Connector.

  2. Accedi sul tuo account Adobe e seleziona il tuo ID organizzazione.

  3. Il giorno Amministratore barra laterale, vai a System > Services>Data Connection.

  4. In Datastream ID incolla l’ID dello stream di dati creato quando attivato Adobe Commerce come destinazione in Real-Time CDP.

    Questo flusso di dati invia i dati dal sito Web Commerce a Real-Time CDP per determinare se un acquirente appartiene a un pubblico. Se non hai ancora creato un flusso di dati, creare uno in Experience Platform, aggiungi alla destinazione Commerce in Real-Time CDP e alla Data Connection in Admin.

    note note
    NOTE
    Quando specifichi un ID dello stream di dati, associarlo a un sito Web specifico nel Data Connection estensione. Se il tuo punto vendita Commerce ha più siti web, creare una destinazione per ogni sito web in Real-Time CDP e utilizza un ID di flusso di dati diverso per ciascuno di essi.
  5. Il giorno Amministratore barra laterale, vai a Stores > Settings>Configuration.

  6. Espandi Services e seleziona Data Connection.

  7. Aggiungi dettagli dell'account del servizio e delle credenziali.

Dove utilizzare i tipi di pubblico di Real-Time CDP in Commerce

Con il Audience Activation abilitata, puoi:

Dashboard dei tipi di pubblico di Real-Time CDP

Puoi visualizzare tutto attivo tipi di pubblico disponibili per la personalizzazione all’interno dell’istanza di Adobe Commerce utilizzando Pubblico Real-Time CDP dashboard.

Per accedere al Pubblico Real-Time CDP dashboard, vai al Amministratore barra laterale, quindi vai a Customers > Real-time CDP Audience.

Dashboard di Real-Time CDP Audiences {width="700" modal="regular"}

Il dashboard contiene i campi seguenti:

Colonna
Descrizione
Hide filters
Consente di mostrare o nascondere i filtri che è possibile applicare al dashboard. Attualmente, l’unico filtro applicabile è Last updated. Questo filtro consente di selezionare un intervallo di date per i tipi di pubblico in base a quando sono stati aggiornati l’ultima volta.
Search
Consente di cercare i tipi di pubblico attivi nell’istanza Commerce.
Name
Nome assegnato al pubblico in Real-Time CDP.
Origin
Indica da dove proviene il pubblico, ad esempio Experience Platform.
Websites
Indica quali siti web sono configurati per utilizzare i tipi di pubblico.
Dynamic Blocks
Indica quali blocchi dinamici sono configurati per utilizzare i tipi di pubblico.
Cart Price Rules
Indica quali regole di prezzo del carrello sono configurate per utilizzare i tipi di pubblico.
Last updated
Indica quando il pubblico è stato modificato in Real-Time CDP.
Sync now
Recupera il pubblico nuovo o aggiornato da Real-Time CDP.
Customize table
Consente di mostrare o nascondere Origin, Websites, Dynamic Blocks, Cart Price Rules, e Last updated colonne.

Supporto headless

Puoi attivare i tipi di pubblico in un’istanza di Adobe Commerce headless, ad esempio AEM e PWA, per visualizzare le regole del prezzo del carrello, le regole dei prodotti correlate o i blocchi dinamici in base ai tipi di pubblico.

Regole di prezzo del carrello e regole di prodotto correlate

Per le regole di prezzo del carrello e le regole di prodotto correlate, una vetrina headless comunica all’Experience Platform tramite Commerce integration framework (CIF). Il framework fornisce un’API lato server che viene implementata utilizzando GraphQL. Le informazioni sul pubblico, come il segmento di un acquirente, passano a Commerce tramite un parametro di intestazione GraphQL denominato: aep-segments-membership.

L’architettura generale è la seguente:

Invio di dati da Headless Storefront al back-end {width="700" modal="regular"}

Dopo di te installare e configura L’estensione, Experienci Platform Web SDK, contiene le informazioni sul pubblico sotto forma di iscrizione al segmento.

Per acquisire le appartenenze ai segmenti dall’SDK, consulta questa frammento di codice.

Una volta recuperato, puoi passare tali segmenti a Commerce all’interno dell’intestazione GraphQL. Ad esempio:

curl 'http://magento.config/graphql' -H 'Authorization: Bearer abc123' -H 'aep-segments-membership: urlencoded_list_of_segments' -H 'Content-Type: application/json' --data-binary '{"query":"query {\ncustomer {\nfirstname\nlastname\nemail\n}\n}"}'

Blocchi dinamici

Per i blocchi dinamici, GraphQL dynamicBlocks le query possono contenere audience_id attributo di input. Se si specificano uno o più audience_id valori in una dynamicBlocks restituisce un elenco di blocchi dinamici assegnati a tali tipi di pubblico.

Esempio di utilizzo

La query seguente restituisce tutti i blocchi dinamici associati a più ID di pubblico.

Richiesta:

{
  dynamicBlocks(input:
  {
    type: SPECIFIED
    audience_id: {
      in: [
        "cd29a789-9be8-40ad-a1ef-640c33b3742e"
        "92c3e14d-c72b-40d0-96b7-b96801dcc135"
      ]
    }
  })
  {
    items {
      uid
      audience_id
      content {
        html
      }
    }
    page_info {
      current_page
      page_size
      total_pages
    }
    total_count
  }
}

Risposta:

{
  "data": {
    "dynamicBlocks": {
      "items": [
        {
          "uid": "MQ==",
          "audience_id": [
            "cd29a789-9be8-40ad-a1ef-640c33b3742e"
          ],
          "content": {
            "html": "<h2><strong>SAVE 20%</strong></h2>\r\n<p>(some restrictions apply)</p>\r\n<p>&nbsp;</p>"
          }
        },
        {
          "uid": "Mg==",
          "audience_id": [
            "cd29a789-9be8-40ad-a1ef-640c33b3742e",
            "92c3e14d-c72b-40d0-96b7-b96801dcc135"
          ],
          "content": {
            "html": "<p><img src=\"{{media url=&quot;wysiwyg/save20.png&quot;}}\" alt=\"save 20% red\"></p>"
          }
        }
      ],
      "page_info": {
        "current_page": 1,
        "page_size": 20,
        "total_pages": 1
      },
      "total_count": 2
    }
  }
}

Ulteriori informazioni su dynamicBlocks Query GraphQL in documentazione per sviluppatori.

Recuperare il pubblico con l’SDK di Adobe Experience Platform Mobile

Puoi recuperare il pubblico di Real-Time CDP utilizzando l’SDK di Adobe Experience Platform Mobile.

IMPORTANT
L’SDK di Adobe Experience Platform Mobile per iOS supporta iOS 11 o versione successiva.

Dopo aver completato la configurazione, utilizza le operazioni SDK per dispositivi mobili per recuperare i dati sul pubblico. Ad esempio:

Edge.sendEvent(experienceEvent: experienceEvent) { (handles: [EdgeEventHandle]) in
    for handle in handles {
        if handle.type == "activation:pull" {
        let payloadItems = handle.payload ?? []
            for payloadItem in payloadItems {
                if let segments = payloadItem["segments"] as? any Sequence {
                    var segmentsArr = [Any]()
                    for segment in segments {
                        let response = segment as AnyObject?
                        segmentsArr.append(response?.object(forKey: "id")! ?? "")
                    }
                    print("Saving segments ->  \(segments)")
                    storage.set(segmentsArr, forKey: "segments")
                    print("End saving segments")
                }

                // Show segments
                let rSegments = storage.object(forKey: "segments") ?? nil;
                print("Retrieving segments -> \(rSegments)")
            }
        }
    }
}

Una volta recuperati i dati, puoi utilizzarli per creare contenuti informati sul pubblico regole prezzi carrello, blocchi dinamici e regole prodotto correlate nell’app Commerce.

I tipi di pubblico non vengono visualizzati in Commerce

Se i tipi di pubblico di Real-Time CDP non vengono visualizzati in Commerce, la causa potrebbe essere:

  • Tipo di autenticazione non corretto selezionato in Connessione dati pagina di configurazione
  • Privilegi insufficienti sul token generato

Nelle due sezioni seguenti viene descritto come risolvere i problemi relativi a entrambi i casi.

Tipo di autenticazione non corretto selezionato nella configurazione

  1. Apri l’istanza Commerce.
  2. Il giorno Amministratore barra laterale, vai a Stores > Settings>Configuration.
  3. Espandi Services e seleziona Data Connection.
  4. Verificare il metodo di autorizzazione server-to-server specificato in Authentication Type il campo è corretto. L’Adobe consiglia di utilizzare OAuth. Il codice JWT è stato dichiarato obsoleto. Ulteriori informazioni.

Privilegi insufficienti sul token generato

Questo problema può essere causato da privilegi API insufficienti per il token generato. Per verificare che il token disponga dei privilegi corretti:

  1. Identifica l’amministratore di sistema per Adobe Experience Platform nella tua organizzazione.
  2. Trova il progetto e le credenziali che userai.
  3. Identifica l’e-mail dell’account tecnico, ad esempio: fe3c9476-1234-1234-abcd-2a51a785009a@techacct.adobe.com.
  4. Chiedere all'amministratore di sistema di avviare Adobe Experience Platform e passare a Permissions -> Users -> API credentials.
  5. Utilizzando l’e-mail dell’account tecnico di cui sopra, cerca le credenziali da modificare.
  6. Apri le credenziali, quindi seleziona Roles -> Add roles.
  7. Aggiungi Production all access.
  8. Clic Save.
  9. Rigenera il token di accesso nella console.
  10. Verifica che il token fornisca una risposta valida utilizzando API connessioni di Target.
recommendation-more-help
09e7db7e-4210-474a-8bbf-c72a92c7537c