Condividi tramite

Rilevamento eventi universali

  • Articolo

UET è un potente strumento Microsoft Advertising. È sufficiente creare un singolo tag UET e quindi aggiungerlo una volta al sito Web. Questo tag registra ciò che i clienti fanno sul tuo sito Web, quindi Microsoft Advertising inizia a raccogliere i dati che ti consentono di tenere traccia delle conversioni (come acquisti o lead) o dei destinatari che usano elenchi di remarketing. UET è un prerequisito per il rilevamento delle conversioni e il remarketing nella ricerca a pagamento.

Universal Event Tracking

Per configurare questa configurazione, è necessario eseguire alcuni passaggi. Sarà necessario:

Per informazioni dettagliate, vedere queste sezioni di panoramica dell'API seguenti:

API di rilevamento eventi universali

Prima di poter tenere traccia delle conversioni o dei gruppi di destinatari usando un elenco di remarketing, è necessario creare un tag UET in Microsoft Advertising (applicazione Web o API) e quindi aggiungere il codice di rilevamento tag UET a ogni pagina del sito Web. Questa sezione descrive come configurare i tag UET usando l'API Bing Ads. Per informazioni sulla configurazione dei tag UET usando l'applicazione Web Microsoft Advertising, vedere Ricerca per categorie creare un tag UET? e Domande frequenti: Rilevamento eventi universali.

Nota

Per ognuna delle operazioni descritte in questa sezione, è necessario specificare l'identificatore del cliente nell'elemento di intestazione CustomerId .

  1. Per prima cosa è necessario chiamare l'operazione GetUetTagsByIds per verificare se è già stato creato un tag. È possibile lasciare l'elemento TagIds null o vuoto per richiedere tutti i tag UET disponibili per il cliente.
  2. È possibile usare un tag UET con tutti gli obiettivi di conversione e gli elenchi di remarketing. Prima di creare più tag UET, vedere Motivi per la creazione di più tag UET. Se non si dispone già di un tag UET che può essere usato o se è necessario un altro tag UET, chiamare l'operazione del servizio AddUetTags per creare un nuovo tag UET. Se la chiamata ha esito positivo, lo script di rilevamento da aggiungere al sito Web viene incluso in un UetTag corrispondente all'interno del messaggio di risposta. In seguito, in base alle esigenze, è possibile aggiornare il nome e la descrizione di un UetTag con l'operazione UpdateUetTags .

Dopo aver recuperato lo script di rilevamento dall'operazione AddUetTags o GetUetTagsByIds , il passaggio successivo consiste nell'aggiungere il codice di rilevamento tag UET al sito Web. È consigliabile aggiungerlo all'intero sito Web o all'amministratore del sito Web nelle sezioni head o body. Se il tuo sito Web ha una pagina di layout a livello di sito, allora questo è il posto migliore per aggiungerlo perché lo aggiungi una volta ed è incluso in tutte le pagine. Per altre informazioni, vedere Ricerca per categorie aggiungere il tag UET al sito Web?

A seconda delle operazioni da eseguire, configurare il rilevamento delle conversioni o i gruppi di destinatari.

API dell'obiettivo di conversione

Una delle proposte di valore più importanti di UET è che consente di installare un tag nel sito Web per tenere traccia di più tipi di conversioni. Dopo aver aggiunto il codice di rilevamento tag UET al sito Web, Microsoft Advertising può registrare le visite alle pagine e qualsiasi evento personalizzato, ad esempio la sottoscrizione a una newsletter o il download di un documento.

Tuttavia, non tutte le azioni vengono create uguali. Probabilmente hai un sottoinsieme di azioni che consideri più importanti per una campagna pubblicitaria di successo. Questi possono includere l'acquisto, la compilazione di un modulo di lead o la visione di un video. È qui che gli obiettivi di conversione possono essere utili. Gli obiettivi di conversione consentono di specificare le azioni (registrate da UET) da contare come conversioni. Per altre informazioni sulla conversione Goals, vedere Che cosa sono gli obiettivi di conversione e i tipi di obiettivo?.

API di gestione della campagna per l'obiettivo di conversione

Esistono cinque tipi di obiettivi di conversione. ConversionGoal è la classe di base da cui derivano tutti gli obiettivi.

Le operazioni seguenti sono disponibili per la gestione degli obiettivi di conversione.

API del gruppo di destinatari

Migliorare il ritorno sugli investimenti ottimizzando le campagne per un pubblico specifico, ovvero gruppi di persone che hanno qualcosa in comune con la tua campagna.

Tipi di destinatari

Microsoft Advertising supporta diversi tipi di destinatari.

Elenco combinato

Un elenco combinato è un gruppo di destinatari creato da una combinazione di più gruppi di destinatari esistenti.

È possibile combinare gruppi di destinatari personalizzati, elenchi di clienti, gruppi di destinatari di prodotti, gruppi di destinatari simili ed elenchi di remarketing. Non è possibile includere altri elenchi combinati o gruppi di destinatari sul mercato in un elenco combinato.

Puoi creare un massimo di 1.000 elenchi combinati per account pubblicitario e fino a 5.000 per cliente. Ogni elenco può includere fino a 100 regole di combinazione o set di condizioni logiche e ogni regola di combinazione può contenere fino a 100 ID gruppo di destinatari.

Con alcune restrizioni descritte di seguito, è possibile combinare i gruppi di destinatari usando questi operatori logici:

  • OPPURE: includerà i clienti che si trovano in uno di questi elenchi di destinatari.
  • AND: includerà solo i clienti che si trovano in ognuno di questi elenchi di destinatari.
  • NOT: escluderà i clienti che si trovano in uno di questi elenchi di destinatari.

La valutazione dell'espressione logica determina chi verrà aggiunto all'elenco combinato. Più combinazioni vengono sempre combinate con una funzione AND. Ciò significa che un cliente deve soddisfare tutti i criteri di ogni combinazione per poter essere visualizzato in questo elenco di gruppi di destinatari della combinazione personalizzata.

Un elenco combinato deve includere almeno un gruppo di destinatari che usa gli operatori OR o AND. Un elenco combinato non può usare solo l'operatore NOT. In questo caso è consigliabile usare invece le esclusioni di gruppi di destinatari.

I gruppi di destinatari personalizzati e gli elenchi di clienti non possono essere combinati con altri tipi di destinatari.

Gruppi di destinatari simili non possono essere combinati tramite gli operatori AND o NOT. Gruppi di destinatari simili possono essere usati solo in una singola condizione OR. In altre parole, può essere presente un solo set di gruppi di destinatari che contiene gruppi di destinatari simili e tale set deve usare l'operatore OR.

Sono consentiti gruppi di destinatari duplicati, anche se lo stesso ID gruppo di destinatari non può essere combinato tramite l'operatore AND e NOT.

Gruppi di destinatari personalizzati

Un gruppo di destinatari personalizzato viene generato usando i dati dei clienti per creare segmenti utente più completi. È possibile usare gruppi di destinatari personalizzati in combinazione con gli elenchi di remarketing, in genere tramite il provider di gestione dati (DMP). Quando il tuo DMP si connette alla nostra funzionalità di audience personalizzata, puoi importare i tuoi gruppi di destinatari personalizzati in Microsoft Advertising per il remarketing di ricerca. È possibile usare gruppi di destinatari personalizzati separatamente dal remarketing, senza uet obbligatorio. Solo i dati del gruppo di destinatari di prima parte (ad esempio i dati dei clienti raccolti dal sito Web o dalle app personali) sono consentiti per la destinazione nella rete Microsoft Advertising. Per altre informazioni, vedere Informazioni sui gruppi di destinatari personalizzati.

Nota

È possibile eliminare ma non aggiungere un gruppo di destinatari personalizzato usando l'API Bing Ads. Detto questo, è possibile aggiungere ed eliminare associazioni di destinatari ed esclusioni personalizzate.

A colpo d'occhio:

  • Usa i dati. I gruppi di destinatari personalizzati consentono di usare i dati del gruppo di destinatari già disponibili.
  • Crea gruppi di destinatari più completi. Creare segmenti di pubblico più completi usando più dati dei clienti.
  • Funziona come il remarketing. I gruppi di destinatari personalizzati possono essere associati a campagne e gruppi di annunci come target e offerte, solo offerte o come esclusione.

Per iniziare a usare i gruppi di destinatari personalizzati, il DMP deve:

  • Integrare le API del gruppo di destinatari personalizzate nella piattaforma.
  • Acconsenti alla nostra informativa sulla condivisione dei dati e sulla privacy.

A seconda del provider, avranno i propri passaggi di abilitazione all'interno del software. Assicurarsi di contattare il DMP per informazioni dettagliate su come abilitare questa funzionalità.

Una volta completata l'integrazione, i gruppi di destinatari personalizzati verranno visualizzati nella sezione Destinatari della libreria condivisa nell'applicazione Web Microsoft Advertising. È anche possibile scaricare gruppi di destinatari personalizzati tramite API Bulk e Campaign Management, come descritto di seguito.

Elenco clienti

Un elenco di clienti è un set di informazioni di contatto dei clienti compilate per abilitare la corrispondenza del cliente.

Nota

Gli elenchi dei clienti sono disponibili tramite l'API bulk, ma non sono ancora disponibili tramite l'API di gestione delle campagne.

Importante

Prima di caricare i dati dell'elenco clienti tramite l'API bulk, è necessario creare un gruppo di destinatari dell'elenco dei clienti e accettare i termini e le condizioni nell'interfaccia utente di Microsoft Advertising. L'elenco iniziale dei clienti non deve contenere dati dei clienti, ma è necessario selezionare Accetto.

Selezionando "Accetto" l'utente (1) accetta di essere in grado di divulgare legalmente i dettagli del pubblico, ovvero i dati personali, a Microsoft e (2) accettare le Condizioni di corrispondenza del cliente, il Contratto Microsoft Advertising e i criteri di Microsoft Advertising. Microsoft userà i dati caricati in base alle condizioni di corrispondenza del cliente.

Ogni elenco può includere più elementi Email.

È possibile aggiungere o aggiornare un record elenco clienti senza record di elementi elenco clienti nello stesso file di caricamento bulk; tuttavia, non è possibile caricare record di elementi elenco clienti senza il record elenco clienti padre associato.

Dopo 48 ore, controllare i campi Dimensioni gruppo di destinatari, ad esempio Dimensioni ricerca destinatari , per vedere quanti di questi clienti sono stati abbinati nella rete Bing. A quel punto, i tuoi annunci possono iniziare a essere visualizzati per questo nuovo pubblico.

gruppi di destinatari In-Market

I destinatari sul mercato sono elenchi curati di clienti che hanno mostrato segnali di finalità di acquisto all'interno di una determinata categoria, incluse ricerche e clic su Bing e visualizzazioni di pagina nei servizi Microsoft. Microsoft Advertising fornisce l'elenco curato di potenziali clienti, a differenza del remarketing nella ricerca a pagamento, in cui l'inserzionista crea l'elenco. Puoi indirizzare e modificare le offerte per questi gruppi di destinatari associando elenchi di destinatari sul mercato a gruppi di annunci o campagne, in modo simile a quello che fai con gli elenchi di remarketing. Per altre informazioni, vedere Pubblico sul mercato: Raggiungere le persone pronte per l'acquisto.

Nota

Non è possibile aggiungere, aggiornare o eliminare un gruppo di destinatari sul mercato usando l'API Bing Ads. Detto questo, è possibile aggiungere ed eliminare associazioni e esclusioni di destinatari sul mercato.

Nota

Questa funzionalità è disponibile in Australia, Canada, Francia, Germania, Regno Unito e Stati Uniti.

Destinatari del prodotto

Gli elenchi di remarketing dinamici associano i clienti a prodotti specifici in base a ciò che hanno esaminato, considerato o già acquistato sul tuo sito Web. È possibile usare elenchi di remarketing dinamici sia nelle campagne di ricerca che nelle campagne per i destinatari (non tutti hanno ancora campagne per il pubblico).

Nota

Gli elenchi di remarketing dinamici erano in precedenza noti come destinatari di prodotti in Microsoft Advertising. Nell'interfaccia utente di Microsoft Advertising verrà visualizzato "Elenco di remarketing dinamico", ma per evitare modifiche di rilievo, gli oggetti oggetti API sono ancora denominati "destinatari del prodotto".

Per altre informazioni, vedere Elenchi di remarketing dinamico: Remarketing per i prodotti.

Elenchi di remarketing

Il remarketing in Ricerca a pagamento consente di migliorare il ritorno sugli investimenti ottimizzando le campagne per gruppi di destinatari specifici, ovvero le persone che hanno già visitato il tuo sito Web. Quando si creano elenchi di remarketing, si specificano le azioni utente sul sito Web che li qualificano come parte degli elenchi di remarketing.

Quando gli utenti eseguono azioni idonee, vengono aggiunti agli elenchi di remarketing entro pochi minuti. Se viene soddisfatta la dimensione minima dell'elenco di remarketing pari a 1.000 (pool minimo di cookie) e hai associato l'elenco di remarketing a una campagna o a un gruppo di annunci e hai impostato un importo di offerta specifico, il motore di distribuzione degli annunci inizierà a distribuire annunci remarketing a tali utenti in Microsoft Advertising Network. Per altre informazioni sul remarketing nella ricerca a pagamento, vedere Raggiungere il pubblico e domande frequenti: Remarketing.

Dopo aver configurato il rilevamento degli eventi universali (UET), puoi usare l'API Bing Ads per creare elenchi di remarketing e associarli a campagne o gruppi di annunci.

Elenchi di remarketing simili

Microsoft Advertising genererà automaticamente gruppi di destinatari simili per gli elenchi di remarketing se si è un partecipante pilota. Non è possibile creare o modificare gruppi di destinatari simili per un elenco di remarketing. Detto questo, è possibile aggiungere ed eliminare associazioni ed esclusioni di elenchi di remarketing simili. Se si elimina l'elenco di remarketing di origine, verranno eliminati anche i destinatari simili. Se un pubblico simile è associato a una campagna o a un gruppo di annunci, non puoi eliminare l'elenco di remarketing di origine.

Nota

Per generare un pubblico simile, è necessario avere almeno un elenco di remarketing con associazioni attive con almeno 1.000 utenti.

Un pubblico simile deve avere almeno 300 utenti nella rete di ricerca o in Microsoft Audience Network prima che possa essere associato a una campagna attiva o a un gruppo di annunci.

Un pubblico simile impiega fino a 24 ore per la compilazione e l'assegnazione delle destinazioni non avrà effetto fino a quel punto.

API bulk del gruppo di destinatari

Con il servizio bulk è possibile usare i tipi di record seguenti per scaricare e caricare i gruppi di destinatari:

Nota

Con i gruppi di destinatari personalizzati, sono supportati solo l'aggiornamento del nome e della descrizione. È possibile eliminare ma non aggiungere un gruppo di destinatari personalizzato usando l'API Bing Ads. Detto questo, è possibile aggiungere ed eliminare associazioni di destinatari ed esclusioni personalizzate.

Non è possibile aggiungere, aggiornare o eliminare un gruppo di destinatari sul mercato usando l'API Bing Ads. Detto questo, è possibile aggiungere ed eliminare associazioni e esclusioni di destinatari sul mercato.

Microsoft Advertising genererà automaticamente gruppi di destinatari simili per gli elenchi di remarketing se si è un partecipante pilota. Non è possibile creare o modificare gruppi di destinatari simili per un elenco di remarketing. Detto questo, è possibile aggiungere ed eliminare associazioni ed esclusioni di elenchi di remarketing simili. Se si elimina l'elenco di remarketing di origine, verranno eliminati anche i destinatari simili. Se un pubblico simile è associato a una campagna o a un gruppo di annunci, non puoi eliminare l'elenco di remarketing di origine.

Con il servizio bulk è possibile usare i tipi di record seguenti per scaricare e caricare associazioni di destinatari:

Nota

Gli obiettivi del gruppo di destinatari non possono essere impostati sia a livello di campagna che di gruppo di annunci. Se imposti criteri di gruppo di destinatari a livello di campagna a livello di campagna, non puoi impostare criteri di gruppo di destinatari a livello di gruppo di annunci disponibili. Le esclusioni del pubblico possono essere impostate sia a livello di campagna che di gruppo di annunci. Microsoft Advertising applica un'unione di esclusioni a livello di campagna e gruppo di annunci.

Per impostazione predefinita, gli annunci in una campagna e in un gruppo di annunci possono essere visualizzati a tutti, ma la rettifica dell'offerta si applicherà alle persone incluse nel pubblico. Se vuoi che gli annunci vengano visualizzati solo alle persone incluse nel pubblico, dovrai impostare l'impostazione di destinazione "target and bid". Puoi usare il campo Impostazione destinazione nel record Campagna o Gruppo di annunci per determinare l'impostazione di destinazione applicabile a tutti i gruppi di destinatari (ad esempio elenchi combinati, gruppi di destinatari personalizzati, gruppi di destinatari sul mercato, gruppi di destinatari di prodotti, elenchi di remarketing e gruppi di destinatari simili per gli elenchi di remarketing) associati alla campagna o al gruppo di annunci. Ogni gruppo di destinatari può essere associato a più campagne e gruppi di annunci e ogni impostazione di destinazione viene applicata in modo indipendente per la distribuzione.

API audience Campaign Management

Gli oggetti CombinedList, CustomAudience, InMarketAudience, ProductAudience, RemarketingList e SimilarRemarketingList derivano tutti dalla classe di base Audience . Se si usa il servizio Campaign Management, è possibile aggiungere, ottenere, aggiornare o eliminare i destinatari con le rispettive operazioni AddAudiences, GetAudiencesByIds, UpdateAudiences ed DeleteAudiences .

Nota

Con i gruppi di destinatari personalizzati, sono supportati solo l'aggiornamento del nome e della descrizione. È possibile eliminare ma non aggiungere un gruppo di destinatari personalizzato usando l'API Bing Ads. Detto questo, è possibile aggiungere ed eliminare associazioni di destinatari ed esclusioni personalizzate.

Non è possibile aggiungere, aggiornare o eliminare un gruppo di destinatari sul mercato usando l'API Bing Ads. Detto questo, è possibile aggiungere ed eliminare associazioni e esclusioni di destinatari sul mercato.

Per aggiungere, ottenere, aggiornare o eliminare l'associazione tra il gruppo di destinatari e la campagna, usare l'oggetto BiddableCampaignCriterion con le rispettive operazioni AddCampaignCriterions, GetCampaignCriterionsByIds, UpdateCampaignCriterions ed DeleteCampaignCriterions . È possibile utilizzare l'oggetto NegativeCampaignCriterion con le stesse operazioni per impostare esclusioni di gruppi di destinatari.

Per aggiungere, ottenere, aggiornare o eliminare l'associazione tra il gruppo di destinatari e il gruppo di annunci, usare l'oggetto BiddableAdGroupCriterion con le rispettive operazioni AddAdGroupCriterions, GetAdGroupCriterionsByIds, UpdateAdGroupCriterions ed DeleteAdGroupCriterions . È possibile utilizzare l'oggetto NegativeAdGroupCriterion con le stesse operazioni per impostare esclusioni di gruppi di destinatari.

Nota

Gli obiettivi del gruppo di destinatari non possono essere impostati sia a livello di campagna che di gruppo di annunci. Se imposti criteri di gruppo di destinatari a livello di campagna a livello di campagna, non puoi impostare criteri di gruppo di destinatari a livello di gruppo di annunci disponibili. Le esclusioni del pubblico possono essere impostate sia a livello di campagna che di gruppo di annunci. Microsoft Advertising applica un'unione di esclusioni a livello di campagna e gruppo di annunci.

Per impostazione predefinita, gli annunci in una campagna e in un gruppo di annunci possono essere visualizzati a tutti, ma la rettifica dell'offerta si applicherà alle persone incluse nel pubblico. Se vuoi che gli annunci vengano visualizzati solo alle persone incluse nel pubblico, dovrai impostare l'impostazione di destinazione "target and bid". Puoi usare l'elemento Settings dell'oggetto Campaign o AdGroup per determinare l'impostazione di destinazione applicabile a tutti i gruppi di destinatari (ad esempio elenchi combinati, gruppi di destinatari personalizzati, gruppi di destinatari sul mercato, gruppi di destinatari di prodotti, elenchi di remarketing e gruppi di destinatari simili per gli elenchi di remarketing) associati alla campagna o al gruppo di annunci. Ogni gruppo di destinatari può essere associato a più campagne e gruppi di annunci e ogni impostazione di destinazione viene applicata in modo indipendente per la distribuzione.

Condividere gruppi di destinatari e tag UET

Una volta abilitate sia per la gerarchia dei clienti che per le funzionalità uet condivise e per i gruppi di destinatari, è possibile condividere i tag UET e gli elenchi di remarketing con altri clienti.

I tag UET condivisi e i gruppi di destinatari possono essere gestiti solo tramite l'API Gestione campagne. Anche se è possibile aggiungere, ottenere, aggiornare ed eliminare gruppi di destinatari con l'API bulk, non è possibile usare l'API bulk per gestire gli aspetti della condivisione dei gruppi di destinatari in una gerarchia di clienti.

Ecco alcune regole per le associazioni di destinatari che dipendono da un tag UET.

  • Solo i tag UET e gli elenchi di remarketing possono essere condivisi, ma i destinatari del prodotto possono anche usare un tag UET condiviso. Gli obiettivi di conversione che dipendono da UET possono anche usare un tag UET condiviso. Gli elenchi dei clienti possono essere condivisi, ma non è necessario associarli a un tag UET.
  • Un tag UET può essere condiviso solo a livello di cliente, noto anche come livello di account manager. Non puoi condividere un tag UET con un account inserzionista specifico.
  • È possibile aggiornare l'ambito dall'account al cliente, ma dopo aver impostato un ambito a livello di cliente non è possibile limitare l'ambito del gruppo di destinatari a singoli account. Ad esempio, nell'applicazione Web Microsoft Advertising se scegli "Condivisi con account manager e account inserzionisti selezionati", l'opzione "Solo usato da Account pubblicitario Foo (Bar)" non sarà più disponibile.
  • È possibile condividere tag UET e gruppi di destinatari con un subset della gerarchia. Si supponga, ad esempio, di avere una gerarchia dall'alto verso il basso dall'account manager L1 all'account manager L2 all'account manager L3. È possibile scegliere di condividere il tag UET e il gruppo di destinatari di proprietà dell'account manager L1 solo con l'account manager L3 e non è necessario condividere con l'account manager intermedio L2. In seguito, se l'account manager L4 viene aggiunto alla gerarchia sotto l'account di manager L3, il tag UET e il gruppo di destinatari non vengono condivisi automaticamente. Se questo è l'obiettivo, è necessario condividere il tag UET e il gruppo di destinatari con l'account manager L4 in modo esplicito.
  • Un gruppo di destinatari può essere condiviso solo dallo stesso set di account che condividono già il tag UET associato. Ad esempio, se i destinatari usano un tag UET condiviso solo dall'account manager L1, dall'account manager L2 e dall'account manager L3, non è possibile condividere il gruppo di destinatari con l'account manager L4 o con uno degli account dell'inserzionista che contiene.
  • Solo un utente super Amministrazione del cliente proprietario del gruppo di destinatari può eliminarlo.
  • Un utente super Amministrazione nel cliente proprietario del gruppo di destinatari o del tag UET può aggiornare l'ambito di condivisione dell'account del cliente di un gruppo di destinatari o di un tag UET. Anche gli utenti con Amministrazione superiore nei clienti padre della gerarchia possono aggiornare l'ambito. Ad esempio, se un elenco di remarketing è di proprietà dell'account manager L2, qualsiasi utente di Super Amministrazione sia nell'account manager L1 che nell'account di gestione L2 può aggiornare l'ambito.
  • Altre proprietà di tag UET o di gruppo di destinatari (diverse dall'ambito), ad esempio descrizione e nome, possono essere aggiornate solo da un utente super Amministrazione nel cliente proprietario del gruppo di destinatari o del tag UET. Gli utenti con Amministrazione superiore nei clienti padre della gerarchia non possono aggiornare questi dettagli. Ad esempio, se un elenco di remarketing è di proprietà dell'account manager L2, solo l'utente Super Amministrazione nell'account manager L2 può aggiornare il nome e la descrizione.
  • Quando il gruppo di destinatari o il tag UET non è condiviso in una gerarchia, un utente Standard del cliente proprietario del gruppo di destinatari o del tag UET può aggiornare le proprietà del gruppo di destinatari o dei tag UET (diversi dall'ambito), ad esempio descrizione e nome. Mentre il gruppo di destinatari o il tag UET è condiviso, un utente Standard non può aggiornare queste proprietà.

Esempi di condivisione del cliente

Verranno ora esaminati alcuni oggetti SOAP di esempio restituiti quando si recuperano i tag UET e gli elenchi di remarketing tramite GetUetTagsByIds e GetAudiencesByIds. Verrà ora illustrato l'esempio di gerarchia della guida Gerarchia account .

Si supponga, ad esempio, che una gerarchia dell'agenzia sia stata configurata nell'account manager L1 (ID cliente 111) con i collegamenti client dell'account cliente e dell'inserzionista:

  • Prima dell'installazione della gerarchia, era stato effettuato il provisioning di quattro account manager separati. L'account manager L1 contiene l'account pubblicitario 1A e l'account pubblicitario 1B. L'account manager L2 contiene l'account pubblicitario 2A e l'account pubblicitario 2B. L'account manager L3 contiene l'account pubblicitario 3A e l'account pubblicitario 3B. L'account manager L4 contiene l'account pubblicitario 4A e l'account pubblicitario 4B.
  • Account manager L1 (ID cliente 111) collegamenti all'account manager L2 (ID cliente 222) con un collegamento amministrativo.
  • L'account manager L2 (ID cliente 222) si collega all'account manager L3 (ID cliente 333) con un collegamento Standard.
  • L'account manager L3 (ID cliente 333) si collega all'account pubblicitario 4A (ID account 444111) con un collegamento a livello di account. L'account pubblicitario 4A (ID account 444111) si trova direttamente nell'account manager L4 (ID cliente 444), che a sua volta non è incluso nella gerarchia a livello di cliente. In questo esempio è possibile accedere all'account ad 4A (ID account 444111) tramite l'account di gestione L3 (ID cliente 333), ad esempio quando si chiamano operazioni di servizio che richiedono l'identificatore del cliente, è necessario usare l'account manager L3 (ID cliente 333) per accedere all'account 444111.

Si noti che se un cliente non è abilitato per tag UET condivisi e gruppi di destinatari o se non è possibile condividere un tipo di gruppo di destinatari, ad esempio SimilarRemarketingList, l'oggetto CustomerShare sarà null quando si ottiene il tag UET o il gruppo di destinatari.

<CustomerShare i:nil="true"/>

In questo scenario di esempio tutti i clienti nella gerarchia sono abilitati per i tag UET condivisi e i gruppi di destinatari. Si supponga che l'account manager L1 (ID cliente 111) abbia appena creato un tag UET e un elenco di remarketing (che dipende dallo stesso tag UET) e non li condivide ancora con i clienti nella gerarchia. Quando vengono recuperati gli oggetti UetTag e RemarketingList , solo OwnerCustomerId verrà impostato nell'oggetto CustomerShare , ovvero il cliente in cui è stato creato il tag UET o l'elenco di remarketing.

<CustomerShare>
    <CustomerAccountShares/>
    <OwnerCustomerId>111</OwnerCustomerId>
</CustomerShare>

Si supponga quindi che l'account manager L1 (ID cliente 111) consa solo il tag UET con l'account manager L2 (ID cliente 222) e l'account manager L3 (ID cliente 333). L'elenco di remarketing usa il tag UET condiviso, ma non è ancora condiviso.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v13">d79e5bc6-2b90-440b-9fd0-4b2b39d6f79e</h:TrackingId>
   </s:Header>
   <s:Body>
      <GetUetTagsByIdsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
         <UetTags xmlns:i="http://www.w3.org/2001/XMLSchema-instance">            
            <UetTag>
               <CustomerShare>
                    <CustomerAccountShares>
                        <CustomerAccountShare>
                            <AccountId i:nil="true"/>
                            <Associations/>
                            <CustomerId>333</CustomerId>
                        </CustomerAccountShare>
                        <CustomerAccountShare>
                            <AccountId i:nil="true"/>
                            <Associations/>
                            <CustomerId>222</CustomerId>
                        </CustomerAccountShare>
                        <CustomerAccountShare>
                            <AccountId i:nil="true"/>
                            <Associations>
                                <CustomerAccountShareAssociation>
                                    <AssociationCount>1</AssociationCount>
                                    <UsageType>UETTagAssociateToRemarketingList</UsageType>
                                </CustomerAccountShareAssociation>
                            </Associations>
                            <CustomerId>111</CustomerId>
                        </CustomerAccountShare>
                    </CustomerAccountShares>
                    <OwnerCustomerId>111</OwnerCustomerId>
                </CustomerShare>
               <!--Removed some elements for brevity-->
            </UetTag>
         </UetTags>
         <PartialErrors xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
      </GetUetTagsByIdsResponse>
   </s:Body>
</s:Envelope>

Si supponga infine che l'account manager L1 (ID cliente 111) condivida l'elenco di remarketing con l'account manager L3 (ID cliente 333) e l'account pubblicitario 2A (ID account 222111). Come indicato nell'introduzione allo scenario precedente, l'account pubblicitario 2A (ID account 222111) si trova direttamente nell'account manager L2 (ID cliente 222). In questo esempio si supponga anche che l'elenco di remarketing sia associato a un gruppo di annunci in Account pubblicitario 2A (ID account 222111).

  • Per ogni sottoinsieme di account cliente o inserzionista che condivide l'elenco di remarketing, un oggetto CustomerAccountShare è incluso nel customershare del tag UET.
  • L'elemento Associations è zero quando i clienti possono accedere all'elenco di remarketing, ma non lo hanno ancora usato, ad esempio Ad Account 2A (ID account 222111).
  • Poiché l'account manager L3 (ID cliente 333) ha associato l'elenco di remarketing a un gruppo di annunci, l'elemento Associations include un oggetto CustomerAccountShareAssociation con UsageType impostato su RemarketingListAssociateToAdGroup.
  • Un oggetto CustomerAccountShare è incluso anche per il proprietario.
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:TrackingId xmlns:h="https://bingads.microsoft.com/CampaignManagement/v13">d0751178-2049-4afa-8171-435c55effdf3</h:TrackingId>
   </s:Header>
   <s:Body>
      <GetAudiencesByIdsResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
         <Audiences xmlns:i="http://www.w3.org/2001/XMLSchema-instance">            
            <Audience i:type="RemarketingList">
               <!--Removed some elements for brevity-->
               <CustomerShare>
                  <CustomerAccountShares>
                     <CustomerAccountShare>
                        <AccountId>222111</AccountId>
                        <Associations/>
                        <CustomerId i:nil="true"/>
                     </CustomerAccountShare>
                     <CustomerAccountShare>
                        <AccountId i:nil="true"/>
                        <Associations>
                           <CustomerAccountShareAssociation>
                              <AssociationCount>1</AssociationCount>
                              <UsageType>RemarketingListAssociateToAdGroup</UsageType>
                           </CustomerAccountShareAssociation>
                        </Associations>
                        <CustomerId>333</CustomerId>
                     </CustomerAccountShare>
                     <CustomerAccountShare>
                        <AccountId i:nil="true"/>
                        <Associations/>
                        <CustomerId>111</CustomerId>
                     </CustomerAccountShare>
                  </CustomerAccountShares>
                  <OwnerCustomerId>111</OwnerCustomerId>
               </CustomerShare>
               <!--Removed some elements for brevity-->
            </Audience>
         </Audiences>
         <PartialErrors xmlns:i="http://www.w3.org/2001/XMLSchema-instance"/>
      </GetAudiencesByIdsResponse>
   </s:Body>
</s:Envelope>

Vedere anche

Indirizzi del servizio Web dell'API Bing Ads
Domande frequenti: Rilevamento eventi universali
Domande frequenti: Remarketing