Condividi tramite

Record dell'estensione dell'annuncio immagine del gruppo di annunci - Bulk

  • Articolo

Definisce un record di associazione tra un gruppo di annunci e un'estensione dell'annuncio immagine che può essere caricato e scaricato in un file bulk. Per caricare o scaricare il gruppo di annunci o l'estensione dell'annuncio immagine, usa il record Gruppo di annunci pubblicitari o Estensione annunci immagine .

È possibile scaricare tutti i record dell'estensione Ad Image Ad del gruppo ad nell'account includendo il valore DownloadEntity di AdGroupImageAdExtensions 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 associa un'estensione dell'annuncio immagine a un gruppo di annunci se vengono specificati valori id eID padre validi.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name
Format Version,,,,,,,,6.0
Ad Group Image Ad Extension,Active,-11,-1111,,,ClientIdGoesHere,,

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkAdGroupImageAdExtension , 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 BulkAdGroupImageAdExtension
var bulkAdGroupImageAdExtension = new BulkAdGroupImageAdExtension
{
    // Map properties in the Bulk file to the 
    // AdExtensionIdToEntityIdAssociation object of the Campaign Management service.
    AdExtensionIdToEntityIdAssociation = new AdExtensionIdToEntityIdAssociation
    {
        // 'Id' column header in the Bulk file
        AdExtensionId = imageAdExtensionIdKey,
        // 'Parent Id' column header in the Bulk file
        EntityId = adGroupIdKey,
    },
                
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active,
};

uploadEntities.Add(bulkAdGroupImageAdExtension);

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 di estensione dell'annuncio immagine del gruppo di annunci pubblicitari, i campi dell'attributo seguenti sono disponibili nello schema file bulk.

Gruppo di annunci

Nome del gruppo di annunci in cui l'estensione dell'annuncio è associata o rimossa.

Aggiungere: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio

Nota

Per l'aggiunta e l'eliminazione, è necessario specificare l'ID padre o entrambi i campi Gruppo di annunci e Campagna .

Campagna

Nome della campagna che contiene il gruppo di annunci in cui l'estensione dell'annuncio è associata o rimossa.

Aggiungere: Sola lettura
Elimina: Sola lettura

Nota

Per l'aggiunta e l'eliminazione, è necessario specificare l'ID padre o entrambi i campi Gruppo di annunci e Campagna .

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
Elimina: Sola lettura

Posizione editoriale

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

Aggiungere: Sola lettura
Elimina: 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
Elimina: Sola lettura

Stato editoriale

Stato editoriale dell'estensione dell'annuncio.

I valori possibili sono descritti nella tabella seguente.

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

Aggiungere: Sola lettura
Elimina: 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
Elimina: Sola lettura

Id

Identificatore dell'estensione dell'annuncio associata o rimossa dal gruppo di annunci.

Questo campo bulk esegue il mapping al campo Id del record image ad extension .

Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore di estensione dell'annuncio esistente oppure specificare un identificatore negativo uguale al campo Id del record padre image ad extension . Questo è consigliato se si aggiungono nuove estensioni e associazioni di annunci nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Elimina: 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
Elimina: Sola lettura

Parent Id

Identificatore del gruppo di annunci in cui l'estensione dell'annuncio è associata o rimossa.

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. Questa opzione è consigliata se si associano le estensioni pubblicitarie a un nuovo gruppo di annunci nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Elimina: Sola lettura e Obbligatorio

Nota

Per l'aggiunta e l'eliminazione, è necessario specificare l'ID padre o entrambi i campi Gruppo di annunci e Campagna .

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
Elimina: Sola lettura

Stato

Rappresenta lo stato di associazione tra il gruppo di annunci e l'estensione dell'annuncio.

I valori possibili sono Attivo ed Eliminato. Se l'estensione dell'annuncio è associata al gruppo di annunci, il valore di questo campo è Attivo.

Aggiungere: Sola lettura
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.