Condividi tramite


Oggetto dati ProductAudience - Campaign Management

Definisce un gruppo di destinatari di prodotti che è possibile usare per remarketing dei prodotti dal negozio Microsoft Merchant Center.

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".

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

Gli elenchi di remarketing dinamici funzionano meglio sia con le campagne Shopping che con quelle basate su feed, ad esempio quelle campagne che sfruttano un ID negozio di Microsoft Merchant Center.

Importante

Assicurarsi di modificare lo script corrispondente all'ID tag UET nel sito Web in modo da includere i ecomm_prodid parametri e ecomm_pagetype . Il parametro ecomm_prodid è l'ID prodotto del prodotto nella pagina. È univoco per ogni elemento e deve corrispondere all'id o all'attributo item_group_id nel feed di prodotti. Solo caratteri numerici e alfanumerici (inclusi i trattini), con un massimo di 50 caratteri. Il parametro ecomm_pagetype identifica il tipo di pagina visitata dall'utente. Opzioni valide: home, searchresults, category, product, cart, purchase, other.

window.uetq = window.uetq || [];
window.uetq.push('event', '', {'ecomm_prodid': 'REPLACE_WITH_PRODUCT_ID', 'ecomm_pagetype': 'REPLACE_WITH_PAGE_TYPE'});

Sintassi

<xs:complexType name="ProductAudience" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence>
        <xs:element minOccurs="0" name="ProductAudienceType" nillable="true" type="tns:ProductAudienceType" />
        <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementi

L'oggetto ProductAudience include gli elementi seguenti: ProductAudienceType, TagId.

Elemento Descrizione Tipo di dati
ProductAudienceType Determina se rieseguire il mercato dei prodotti a visitatori generali, cercatori di prodotti, visualizzatori di prodotti, abbandoni del carrello acquisti o acquirenti passati.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
ProductAudienceType
TagId Identificatore microsoft advertising del tag UET (Universal Event Tracking) usato con l'elenco di remarketing.

Prima di assumere una dipendenza dall'ID tag, tenere presente che il tag UET può essere condiviso con o da un altro cliente. I tag UET condivisi e i gruppi di destinatari sono disponibili solo per i clienti pilota. Per una panoramica della condivisione di gruppi di destinatari e tag UET in una gerarchia di clienti, vedere la guida tecnica Condividi gruppi di destinatari e tag UET .

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
long

L'oggetto ProductAudience include elementi ereditati.

Elementi ereditati

Elementi ereditati dal gruppo di destinatari

L'oggetto ProductAudience deriva dall'oggetto Audience ed eredita gli elementi seguenti: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type. Le descrizioni seguenti sono specifiche di ProductAudience e potrebbero non essere applicabili ad altri oggetti che ereditano gli stessi elementi dall'oggetto Audience .

Elemento Descrizione Tipo di dati
AudienceNetworkSize Numero totale di persone che sono membri attivi di questo gruppo di destinatari nella rete Audience. In questo modo si ha un'idea del numero di utenti di rete audience che è possibile definire come target.

Il pubblico deve avere almeno 300 persone prima che Microsoft Advertising lo usi per le ottimizzazioni.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
long
CustomerShare Questo elemento non è supportato per i gruppi di destinatari di prodotti.

È possibile usare un TagId condiviso con i gruppi di destinatari del prodotto, ma non è possibile condividere un gruppo di destinatari del prodotto stesso.

Aggiungere: Non supportato
Aggiornamento: Non supportato
CustomerShare
Descrizione Descrizione del gruppo di destinatari. Usare una descrizione per ricordare il gruppo di destinatari di destinazione.

La descrizione può contenere un massimo di 1.024 caratteri.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Stringa
ForwardCompatibilityMap Elenco di stringhe di chiave e valore per la compatibilità con l'inoltro per evitare modifiche che altrimenti causano un'interruzione quando vengono aggiunti nuovi elementi nella versione corrente dell'API.

Le modifiche di compatibilità forward verranno annotate qui nelle versioni future. Attualmente non sono presenti modifiche di compatibilità per l'oggetto Audience .
Matrice KeyValuePairOfstringstring
Id Identificatore microsoft advertising del gruppo di destinatari.

Aggiungere: Sola lettura
Aggiornamento: Obbligatorio e di sola lettura
long
MembershipDuration Quando si crea un gruppo di destinatari, è possibile specificare quanto tempo fa Microsoft Advertising deve cercare le azioni che corrispondono alla definizione del gruppo di destinatari.

La durata del mimimum è di 1 giorno e la durata massima consentita è di 180 giorni.

Aggiungere: Opzionale. Se non specificato, la durata dell'appartenenza verrà impostata su 30 per impostazione predefinita.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
int
Nome Nome del gruppo di destinatari. Il nome può contenere un massimo di 128 caratteri.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Stringa
Parentid Identificatore microsoft advertising dell'account o del cliente.

Se l'ambito è impostato su Account, questo è l'ID account e in caso contrario è l'ID cliente.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura. Non è possibile modificare l'ID padre.
long
Ambito L'ambito definisce gli account che possono usare questo gruppo di destinatari.

Se l'ambito è impostato su Account, il pubblico può essere associato solo alle campagne e ai gruppi di annunci in un unico account, ad esempio tramite ParentId. Se l'ambito è impostato su Cliente, il pubblico può essere associato a campagne e gruppi di annunci in tutti gli account del cliente.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. È possibile modificare l'ambito da Account a Customer, ma non è possibile modificare l'ambito da Cliente a Account.
EntityScope
SearchSize Numero totale di persone che sono membri attivi di questo gruppo di destinatari nella rete di ricerca. In questo modo si ha un'idea del numero di utenti di ricerca di destinazione.

Il pubblico deve avere almeno 300 persone prima che Microsoft Advertising lo usi per le ottimizzazioni.

Questa proprietà sarà nil o vuota per un massimo di 24 ore durante la compilazione del gruppo di destinatari, ad esempio se si aggiunge o si aggiorna la durata dell'appartenenza o l'identificatore del tag.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
long
SupportedCampaignTypes Elenco dei tipi di campagna che supportano questo gruppo di destinatari.

I valori supportati sono Audience, DynamicSearchAds, Search e Shopping. In futuro potrebbero essere aggiunti nuovi tipi di campagna, quindi non è consigliabile assumere alcuna dipendenza da un set fisso di valori.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
matrice di stringhe
Digitare Tipo di gruppo di destinatari. Questo valore è ProductAudience quando si recupera un gruppo di destinatari di prodotti. Per altre informazioni sui tipi di gruppo di destinatari, vedere Le osservazioni sugli oggetti dati del gruppo di destinatari.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
AudienceType

Requisiti

Servizio: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13