Record dell'estensione dell'annuncio di Ad Group Review - Bulk

  • Articolo

Definisce un record di associazione tra un gruppo di annunci e un'estensione dell'annuncio di revisione che può essere caricata e scaricata in un file bulk. Per caricare o scaricare il gruppo di annunci o esaminare l'estensione dell'annuncio, usa il record Gruppo di annunci o Rivedi estensione annunci .

È possibile scaricare tutti i record dell'estensione Ad Revisione gruppo ad nell'account includendo il valore DownloadEntity di AdGroupReviewAdExtensions 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 di revisione 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 Review 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 BulkAdGroupReviewAdExtension , 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 BulkAdGroupReviewAdExtension
var bulkAdGroupReviewAdExtension = new BulkAdGroupReviewAdExtension
{
    // 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 = reviewAdExtensionIdKey,
        // '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(bulkAdGroupReviewAdExtension);

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 dell'estensione per la revisione di un gruppo di annunci, i campi dell'attributo seguenti sono disponibili nello schema del 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 Rivedi estensione annunci .

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 di estensione dell'annuncio di revisione padre.You must specify an existing ad extension identifier, or specify a negative identifier that is equal to the Id field of the parent Review Ad Extension record. 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.