Audience Activation

L'estensione Audience Activation consente di attivare il pubblico di Real-Time CDP in Adobe Commerce per creare offerte univoche nel carrello. Queste offerte e incentivi includono tecniche comuni di merchandising per l'e-commerce, come acquistare 2 ottenere 1 gratis, banner hero rivolti a quel cliente e 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 in una vetrina headless. 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 passate 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:

- Nuove funzionalità
- Correzioni e miglioramenti
- Problemi noti

Per informazioni sulle pianificazioni e sul supporto, consulta le prossime versioni.

Per informazioni sulla compatibilità dei prodotti, consulta la documentazione per gli sviluppatori🔗.

Aggiornamenti dei servizi supportati

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

2.3.1.

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

12 novembre 2024

- È stato risolto un problema che si verificava quando si filtravano i tipi di pubblico di Real-Time CDP disponibili tra cui scegliere.

2.3.0.

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

29 luglio 2024

- È stata aggiunta la sintassi della riga di comando in modo da poter verificare le credenziali per determinare se devono essere aggiornate per estrarre i dati del pubblico da Adobe Experience Platform.

2.2.0.

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

12 giugno 2024

- Versione GA per regole prodotto correlate informata dal pubblico.

2.1.1.

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

4 aprile 2024

- Aggiunto supporto per PHP 8.3.

2.2.0-beta1

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

16 febbraio 2024

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

2.1.0.

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

24 gennaio 2024

- È stato aggiornato il dashboard Tipi di pubblico di Real-Time CDP 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

- Stabilità migliorata.

2,0,0

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

10 ottobre 2023

- È stato aggiunto il supporto per OAuth 2.0 quando configuri l'estensione Audience Activation.
- Stabilità migliorata.

1.2.0.

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

15 agosto 2023

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

1.1.0.

30 maggio 2023

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

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

1.0.1.

11 maggio 2023

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

- È stato risolto un problema che impediva l'applicazione di una regola di prezzo blocco dinamico o carrello alla vetrina.
- È stato risolto un problema che causava un errore durante il tentativo di un commerciante di creare o aggiornare un blocco dinamico a causa di un'installazione non configurata dell'estensione Audience Activation.

1,0,0

31 marzo 2023

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

- 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 l’estensione

Installa l'estensione Audience Activation dal marketplace oppure esegui il comando seguente:

composer require magento/audiences

Configurare l'estensione

Dopo aver installato l'estensione Audience Activation, è necessario accedere all'amministratore di Commerce e completare le operazioni seguenti:

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

Con l'estensione Audience Activation abilitata, è possibile:

Dashboard dei tipi di pubblico di Real-Time CDP

Puoi visualizzare tutti i tipi di pubblico attivi disponibili per la personalizzazione nell'istanza di Adobe Commerce utilizzando la dashboard Tipi di pubblico di Real-Time CDP.

Per accedere al dashboard Tipi di pubblico di Real-Time CDP, passa alla barra laterale Amministratore, quindi passa a Customers > Real-time CDP Audience.

{width="700" modal="regular"}

Il dashboard contiene i campi seguenti:

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 la Commerce integration framework (CIF). Il framework fornisce un’API lato server che viene implementata utilizzando GraphQL. Le informazioni sul pubblico, ad esempio il segmento di un acquirente, passano a Commerce tramite un parametro di intestazione GraphQL denominato: aep-segments-membership.

L’architettura generale è la seguente:

{width="700" modal="regular"}

Dopo aver installato e configurato l'estensione, Experience Platform Web SDK contiene le informazioni sul pubblico sotto forma di appartenenza al segmento.

Per acquisire tali appartenenze al segmento dall'SDK, vedi questo frammento di codice.

Una volta recuperato, puoi passare tali segmenti a Commerce all’interno dell’intestazione di 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, le query GraphQL dynamicBlocks possono contenere l'attributo di input audience_id. Se si specificano uno o più valori audience_id in una query dynamicBlocks, verrà restituito 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 sulla query GraphQL dynamicBlocks nella documentazione per gli 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.

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

Dopo il recupero dei dati, puoi utilizzarli per creare nell'app Commerce regole prezzo carrello, blocchi dinamici e regole prodotto correlate informate sul pubblico.

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:

Le sezioni seguenti descrivono come risolvere questi problemi.

Convalidare la connessione

Per convalidare le credenziali e la risposta da Adobe Experience Platform, esegui il comando seguente:

bin/magento audiences:config:status

Questo comando restituisce lo stato della connessione. Aggiungi il flag -v per fornire maggiore dettaglio:

./bin/magento audiences:config:status -v

Ad esempio:

+----------------------------------+---------------+---------------------------------------------+---------------------------------------------------------+--------------+
| Client ID                        | Client secret | Technical account ID                        | Technical account email                                 | Sandbox name |
+----------------------------------+---------------+---------------------------------------------+---------------------------------------------------------+--------------+
| 1234bd57fac8497d8933327c535347d8 | *****         | 12341E116638D6B00A495C80@techacct.adobe.com | 12345-b95b-4894-a41c-a4130d26bd80@techacct.adobe.com | dev          |

Tipo di autenticazione non corretto selezionato nella configurazione

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: