Condividi tramite

Product Ad Record - Bulk

  • Articolo

Definisce un annuncio di prodotto che può essere scaricato e caricato in un file bulk.

Un annuncio di prodotto non viene usato direttamente per la copia dell'annuncio recapitata. Al contrario, il motore di distribuzione genera annunci di prodotto dai dettagli del prodotto trovati nel catalogo del negozio Microsoft Merchant Center del cliente.

È possibile scaricare tutti i record di Product Ad nell'account includendo il valore DownloadEntity di ProductAds nella richiesta di servizio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Inoltre, la richiesta di download deve includere l'ambito EntityData . Per altre informazioni sul servizio bulk, incluse le procedure consigliate, vedere Download e caricamento in blocco.

L'esempio csv bulk seguente aggiunge un nuovo annuncio di prodotto se viene fornito un valore id padre valido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,
Product Ad,Active,,-1112,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,,,Find New Customers & Increase Sales!,,,,,,,,,,,,,

Se si usano gli SDK Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkProductAd , anziché chiamare direttamente le operazioni del servizio e scrivere codice personalizzato per analizzare ogni campo nel file bulk.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkProductAd
var bulkProductAd = new BulkProductAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ProductAd object of the Campaign Management service.
    ProductAd = new ProductAd
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Promotion' column header in the Bulk file
        PromotionalText = "Find New Customers & Increase Sales!",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
    },
};

uploadEntities.Add(bulkProductAd);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Per un record product ad , i campi dell'attributo seguenti sono disponibili nello schema file bulk.

Gruppo di annunci

Nome del gruppo di annunci che contiene l'annuncio.

Aggiungere: Sola lettura e Obbligatorio
Aggiornare: Sola lettura e Obbligatorio
Cancellare: Sola lettura e Obbligatorio

Nota

Per aggiungere, aggiornare ed eliminare, è necessario specificare il campo Id padre o Gruppo di annunci .

Campagna

Nome della campagna che contiene il gruppo di annunci e l'annuncio.

Aggiungere: Sola lettura
Aggiornare: Sola lettura
Cancellare: Sola lettura

ID Client

Usato per associare i record nel file di caricamento bulk ai record nel file dei risultati. Il valore di questo campo non viene utilizzato o archiviato dal server; viene semplicemente copiato dal record caricato nel record di risultati corrispondente. Può essere qualsiasi stringa valida fino a 100 di lunghezza.

Aggiungere: Opzionale
Aggiornare: Opzionale
Cancellare: Sola lettura

Stato di appello editoriale

Determina se è possibile fare ricorso ai problemi rilevati dalla recensione editoriale.

I valori possibili sono descritti nella tabella seguente.

Valore Descrizione
Appellabile La questione editoriale è di grande interesse.
AppelloPending La questione editoriale è impugnabile ed è stato presentato un ricorso.
NotAppealable La questione editoriale non è utilizzabile.

Aggiungere: Sola lettura
Aggiornare: Sola lettura
Cancellare: Sola lettura

Posizione editoriale

Componente o proprietà dell'annuncio che ha avuto esito negativo nella revisione editoriale.

Aggiungere: Sola lettura
Aggiornare: Sola lettura
Cancellare: Sola lettura

Codice motivo editoriale

Codice che identifica il motivo dell'errore. Per un elenco dei possibili codici motivo, vedere Codici motivo editoriali.

Aggiungere: Sola lettura
Aggiornare: Sola lettura
Cancellare: Sola lettura

Stato editoriale

Lo stato editoriale dell'annuncio.

I valori possibili sono descritti nella tabella seguente.

Valore Descrizione
Attivazione L'annuncio ha superato la revisione editoriale.
ActiveLimited L'annuncio ha superato la revisione editoriale in uno o più mercati e uno o più elementi dell'annuncio sono sottoposti a revisione editoriale in un altro mercato. Ad esempio, l'annuncio ha superato la revisione editoriale per il Canada ed è ancora in attesa di revisione nel Stati Uniti.
Approvato La recensione editoriale dell'annuncio non è riuscita.
Inattivo Uno o più elementi dell'annuncio sono in fase di revisione editoriale.

Aggiungere: Sola lettura
Aggiornare: Sola lettura
Cancellare: Sola lettura

Termine editoriale

Il termine che ha fallito revisione editoriale.

Questo campo non verrà impostato se una combinazione di termini ha causato l'errore o se l'errore è stato basato su una violazione dei criteri.

Aggiungere: Sola lettura
Aggiornare: Sola lettura
Cancellare: Sola lettura

Id

Identificatore generato dal sistema dell'annuncio.

Aggiungere: Opzionale. È necessario lasciare vuoto questo campo o specificare un identificatore negativo. Un identificatore negativo impostato per l'annuncio può quindi essere fatto riferimento nel campo Id padre dei tipi di record dipendenti, ad esempio Product Ad Label. Questa operazione è consigliata se si aggiungono nuovi annunci e nuovi record dipendenti nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornare: Sola lettura e Obbligatorio
Cancellare: Sola lettura e Obbligatorio

Ora modifica

Data e ora dell'ultimo aggiornamento dell'entità. Il valore è espresso nell'ora UTC (Coordinated Universal Time).

Nota

Il valore di data e ora riflette la data e l'ora nel server, non nel client. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Aggiungere: Sola lettura
Aggiornare: Sola lettura
Cancellare: Sola lettura

Parent Id

Identificatore generato dal sistema del gruppo di annunci che contiene l'annuncio.

Questo campo bulk viene mappato al campo Id del record gruppo di annunci .

Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore del gruppo di annunci esistente o un identificatore negativo uguale al campo Id del record gruppo di annunci padre. Questo è consigliato se si aggiungono nuovi annunci a un nuovo gruppo di annunci nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornare: Sola lettura
Cancellare: Sola lettura

Nota

Per aggiungere, aggiornare ed eliminare, è necessario specificare il campo Id padre o Gruppo di annunci .

Paesi di pubblicazione

Elenco di paesi o aree di pubblicazione le cui linee guida editoriali non consentono il termine specificato.

In un file bulk l'elenco di paesi o aree di pubblicazione è delimitato da un punto e virgola (;).

Aggiungere: Sola lettura
Aggiornare: Sola lettura
Cancellare: Sola lettura

Stato

Stato dell'annuncio.

Nota

A partire dal 3 dicembre 2024, l'operazione di eliminazione non sarà più supportata nell'API bulk per i record degli annunci del prodotto. Questo perché l'entità dell'annuncio del prodotto è generata dal sistema.

I valori possibili sono Attivo, Sospeso o Eliminato.

Aggiungere: Opzionale. Il valore predefinito è Attivo.
Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Cancellare: Obbligatorio. Lo stato deve essere impostato su Eliminato.