Condividi tramite


Record etichetta annunci di testo espanso - Bulk

Definisce un record di associazione tra un annuncio di testo espanso e un'etichetta che può essere caricata e scaricata in un file bulk. Per caricare o scaricare l'annuncio o l'etichetta di testo espanso, usare l'annuncio di testo espanso o il record etichetta .

Nota

  • Aggiorna gli annunci di testo espansi agli annunci di ricerca reattivi entro il 1° febbraio 2023. Dopo questa data, non sarà più possibile creare annunci di testo espansi nuovi o modificare quelli esistenti. Per altre informazioni, vedi Informazioni sugli annunci di ricerca reattivi.
  • Gli annunci di testo espansi esistenti continueranno a essere pubblicati e potrai visualizzare i report sulle loro prestazioni.
  • Potrai comunque sospendere, abilitare o rimuovere gli annunci di testo espansi. In caso contrario, i tentativi di aggiungere o aggiornare gli annunci di testo espansi genereranno un CampaignServiceAdTypeInvalid errore.
  • Altre informazioni su questa modifica.

È possibile scaricare tutti i record etichetta annunci testo espanso nell'account includendo il valore DownloadEntity di ExpandedTextAdLabels 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 applica un'etichetta a un annuncio di testo espanso se vengono specificati valori id eID padre validi.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Expanded Text Ad Label,,-22,-11112,,,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 BulkExpandedTextAdLabel , 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 BulkExpandedTextAdLabel
var bulkExpandedTextAdLabel = new BulkExpandedTextAdLabel
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // LabelAssociation object of the Campaign Management service.
    LabelAssociation = new LabelAssociation
    {
        // 'Parent Id' column header in the Bulk file
        EntityId = expandedTextAdIdKey,
        // 'Id' column header in the Bulk file
        LabelId = labelIdKey
    },

    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkExpandedTextAdLabel);

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 etichetta di annunci di testo espanso , i campi dell'attributo seguenti sono disponibili nello schema file bulk.

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

Id

Identificatore dell'etichetta applicata o rimossa dall'annuncio di testo espanso.

Questo campo bulk esegue il mapping al campo Id del record Etichetta .

Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore di etichetta esistente o un identificatore negativo uguale al campo Id del record etichetta padre. Questa opzione è consigliata se si applicano nuove etichette agli annunci di testo espansi 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 dell'annuncio di testo espanso in cui questa etichetta viene applicata o rimossa.

Questo campo bulk esegue il mapping al campo Id del record annunci di testo espanso .

Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore di annuncio di testo espanso esistente oppure specificare un identificatore negativo uguale al campo Id del record dell'annuncio di testo espanso padre. Questo è consigliato se si applicano etichette a un nuovo annuncio di testo espanso nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Elimina: Sola lettura e Obbligatorio

Stato

Rappresenta lo stato applicato tra l'annuncio di testo espanso e l'etichetta.

I valori possibili sono Attivo ed Eliminato. Se l'etichetta viene applicata all'annuncio di testo espanso, il valore di questo campo è Attivo.

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