Oggetto dati RemarketingList - Campaign Management

Definisce un elenco di remarketing.

Consiglio

Per una panoramica dell'implementazione, vedere la guida tecnica di Universal Event Tracking .

Nota

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. Per altri dettagli, vedere SimilarRemarketingList .

Sintassi

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

Elementi

L'oggetto RemarketingList include gli elementi seguenti: Rule, TagId.

Elemento Descrizione Tipo di dati
Regola Una regola include le condizioni usate per determinare chi aggiungere all'elenco di remarketing.

È possibile scegliere uno dei quattro tipi di regole per gruppi di destinatari diversi: CustomEventsRule, PageVisitorsRule, PageVisitorsWhoDidNotVisitAnotherPageRule e PageVisitorsWhoVisitedAnotherPageRule.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si desidera mantenere uno qualsiasi degli elementi della regola precedente, è necessario impostarli di nuovo in modo esplicito durante l'aggiornamento. È possibile scegliere di modificare il tipo di regola durante l'aggiornamento.
RemarketingRule
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 RemarketingList include elementi ereditati.

Elementi ereditati

Elementi ereditati dal gruppo di destinatari

L'oggetto RemarketingList 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 RemarketingList 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 Determina l'elenco di clienti e account che condividono il gruppo di destinatari. I dettagli includono i conteggi delle associazioni dei gruppi di destinatari.

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: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Impostare questo elemento su Null o vuoto per conservare le condivisioni account cliente esistenti. Per rimuovere tutte le condivisioni account cliente, impostare l'elemento CustomerAccountShares dell'oggetto CustomerShare su Null o vuoto. Per rimuovere un subset di condivisioni account cliente, specificare le condivisioni account cliente che si desidera mantenere nell'elemento CustomerAccountShares dell'oggetto CustomerShare .
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 minima è 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, la regola o l'identificatore di tag dell'elenco di remarketing.

Questa proprietà sarà nil o vuota se il tag UET associato all'elenco di remarketing ha lo stato Non verificato o Inattivo, perché l'elenco di remarketing non può ricevere le informazioni sul cliente dal sito Web necessario per compilare l'elenco.

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
Tipo Tipo di gruppo di destinatari. Questo valore è RemarketingList quando si recupera un gruppo di destinatari dell'elenco di remarketing. 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