Record dell'estensione dell'annuncio della chiamata della campagna - Bulk

Definisce un record di associazione tra una campagna e un'estensione dell'annuncio di chiamata che può essere caricata e scaricata in un file bulk. Per caricare o scaricare la campagna o l'estensione dell'annuncio di chiamata, usa il record Campagna o Chiama estensione annuncio .

È possibile scaricare tutti i record dell'estensione campaign call ad nell'account includendo il valore DownloadEntity di CampaignCallAdExtensions 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 chiamata a una campagna 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
Campaign Call 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 BulkCampaignCallAdExtension , 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 BulkCampaignCallAdExtension
var bulkCampaignCallAdExtension = new BulkCampaignCallAdExtension
{
    // 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 = callAdExtensionIdKey,
        // 'Parent Id' column header in the Bulk file
        EntityId = campaignIdKey,
    },
                
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active,
};

uploadEntities.Add(bulkCampaignCallAdExtension);

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 campaign call ad extension , i campi dell'attributo seguenti sono disponibili nello schema del file bulk.

Campagna

Nome della campagna in cui l'estensione dell'annuncio è associata o rimossa.

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

Nota

Per aggiungere ed eliminare, è necessario specificare l'ID padre o la 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 dalla campagna.

Questo campo bulk esegue il mapping al campo Id del record Call Ad Extension.This bulk field maps to the Id field of the Call Ad Extension record.

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 Dell'estensione annunci di chiamata . 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 della campagna in cui l'estensione dell'annuncio è associata o rimossa.

Questo campo bulk viene mappato al campo Id del record Campagna .

Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore campagna esistente o un identificatore negativo uguale al campo Id del record campagna padre. Questa opzione è consigliata se si associano le estensioni degli annunci a una nuova campagna nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Elimina: Sola lettura e Obbligatorio

Nota

Per aggiungere ed eliminare, è necessario specificare l'ID padre o la 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 la campagna e l'estensione dell'annuncio.

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

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