Record ambito prodotto campagna - Bulk

Definisce un ambito di prodotto a livello di campagna con un elenco di condizioni che consentono di determinare quali elementi del catalogo includere nella campagna, ad esempio, filtrare in base al marchio o alla condizione.

Puoi usare gli ambiti dei prodotti delle campagne sia con le campagne Shopping che con quelle basate su feed, ad esempio quelle campagne che sfruttano un ID negozio di Microsoft Merchant Center. L'ambito del prodotto consente di scegliere gli elementi del catalogo da includere nella campagna, ad esempio filtrare in base alla marca o alla condizione.

È possibile scaricare tutti i record di Ambito prodotto campagna nell'account includendo il valore DownloadEntity di CampaignProductScopes 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.

Nell'esempio csv bulk seguente viene aggiunto un nuovo ambito di prodotto della campagna se viene fornito un valore di ID padre valido.

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Product Condition 1,Product Value 1,Product Condition 2,Product Value 2,Product Condition 3,Product Value 3,Product Condition 4,Product Value 4,Product Condition 5,Product Value 5,Product Condition 6,Product Value 6,Product Condition 7,Product Value 7,Is Excluded,Parent Criterion Id,Tracking Template,Custom Parameter
Format Version,,,,,,,,,,6.0,,,,,,,,,,,,,,,,,,
Campaign Product Scope,Active,,-113,,,,ClientIdGoesHere,,,,Condition,New,CustomLabel0,MerchantDefinedCustomLabel,,,,,,,,,,,,,,

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkCampaignProductScope , 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 BulkCampaignProductScope
var bulkCampaignProductScope = new BulkCampaignProductScope
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // SharedEntityAssociation object of the Campaign Management service.
    CampaignCriterion = new CampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new ProductScope
        {
            // Conditions are mapped to Product Value 1..7 and Product Condition 1..7 columns
            Conditions = new []
            {
                new ProductCondition
                {
                    // 'Product Value 1' column header in the Bulk file
                    Attribute = "New",
                    // 'Product Condition 1' column header in the Bulk file
                    Operand = "Condition",
                    // 'Product Operator 1' column header in the Bulk file
                    Operator = "Operator",
                },
                new ProductCondition
                {
                    // 'Product Value 2' column header in the Bulk file
                    Attribute = "MerchantDefinedCustomLabel",
                    // 'Product Condition 2' column header in the Bulk file
                    Operand = "CustomLabel0",
                    // 'Product Operator 2' column header in the Bulk file
                    Operator = "Operator",
                },
            },
        },
        // 'Id' column header in the Bulk file
        Id = null,
    },

    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignProductScope);

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'ambito del prodotto campagna , i campi dell'attributo seguenti sono disponibili nello schema file bulk.

• Campagna
• Client Id
• Id
• Ora modifica
• Parent Id
• Condizione del prodotto 1
• Condizione del prodotto 2
• Condizione del prodotto 3
• Condizione del prodotto 4
• Condizione del prodotto 5
• Condizione del prodotto 6
• Condizione del prodotto 7
• Operatore di prodotto 1
• Operatore di prodotto 2
• Operatore di prodotto 3
• Operatore di prodotto 4
• Operatore di prodotto 5
• Operatore di prodotto 6
• Product Operator 7
• Valore prodotto 1
• Valore prodotto 2
• Valore prodotto 3
• Valore prodotto 4
• Valore prodotto 5
• Valore prodotto 6
• Valore prodotto 7
• Stato

Campagna

Nome della campagna che contiene l'ambito del prodotto.

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

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

Id

Identificatore generato dal sistema dell'ambito del prodotto.

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

Ora modifica

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

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura

Parent Id

Identificatore generato dal sistema della campagna che contiene l'ambito del prodotto.

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 operazione è consigliata se si aggiungono nuovi ambiti di prodotto a una nuova campagna nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornamento: Sola lettura
Elimina: Sola lettura

Condizione del prodotto 1

Operando della condizione. Gli operandi includono in modo implicito l'operatore uguale. Ad esempio, è possibile leggere Brand come Brand=.

Usare ogni condizione del prodotto come operando per il valore del prodotto corrispondente.

Ogni condizione viene soddisfatta se il valore dell'attributo del prodotto è uguale al valore dell'attributo dell'operando. Ad esempio, se l'operando è impostato su Brand e l'attributo è impostato su Contoso, la condizione viene soddisfatta se il valore dell'attributo Brand del catalogo prodotti è uguale a Contoso.

Aggiungere: Opzionale
Aggiornamento: Sola lettura. Non è possibile aggiornare i campi condizione o valore. Per aggiornare le condizioni, è necessario eliminare l'ambito del prodotto e aggiungerne uno nuovo.
Elimina: Sola lettura

Per la condizione del prodotto (operando) e il valore del prodotto (attributo) supportati per tipo di campagna, vedere le tabelle seguenti.

Condizioni del prodotto per le campagne Feed-Based audience

È possibile specificare più condizioni del prodotto per ogni campagna audience basata su feed. Ogni condizione viene soddisfatta se il valore dell'attributo del prodotto è uguale al valore dell'attributo dell'operando. Ad esempio, se l'operando è impostato su Brand e l'attributo è impostato su Contoso, la condizione viene soddisfatta se il valore dell'attributo Brand del catalogo prodotti è uguale a Contoso.

Condizioni del prodotto per le campagne di shopping

È possibile specificare più condizioni del prodotto per ogni campagna e gruppo di annunci Microsoft Shopping. Ogni condizione viene soddisfatta se il valore dell'attributo del prodotto è uguale al valore dell'attributo dell'operando. Ad esempio, se l'operando è impostato su Brand e l'attributo è impostato su Contoso, la condizione viene soddisfatta se il valore dell'attributo Brand del catalogo prodotti è uguale a Contoso.

Nelle campagne Shopping le condizioni del prodotto possono essere impostate a livello di campagna e gruppo di annunci. Nella tabella seguente vengono descritte le regole business Condizione prodotto (operando) e Valore prodotto (attributo) per i record dell'ambito del prodotto della campagna e della partizione del prodotto del gruppo di annunci .

Condizione del prodotto 2

Supporta gli stessi valori e le stesse regole della condizione 1 del prodotto.

Condizione del prodotto 3

Supporta gli stessi valori e le stesse regole della condizione 1 del prodotto.

Condizione del prodotto 4

Supporta gli stessi valori e le stesse regole della condizione 1 del prodotto.

Condizione del prodotto 5

Supporta gli stessi valori e le stesse regole della condizione 1 del prodotto.

Condizione del prodotto 6

Supporta gli stessi valori e le stesse regole della condizione 1 del prodotto.

Condizione del prodotto 7

Supporta gli stessi valori e le stesse regole della condizione 1 del prodotto.

Operatore di prodotto 1

Valore dell'operatore della condizione. Il valore dell'operatore è uguale o notequal.

Aggiungere: Opzionale
Aggiornamento: Sola lettura. Non è possibile aggiornare i campi condizione o valore. Per aggiornare le condizioni, è necessario eliminare l'ambito del prodotto della campagna e aggiungerne uno nuovo.
Elimina: Sola lettura

Operatore di prodotto 2

Supporta gli stessi valori e regole dell'operatore di prodotto 1.

Operatore di prodotto 3

Supporta gli stessi valori e regole dell'operatore di prodotto 1.

Operatore di prodotto 4

Supporta gli stessi valori e regole dell'operatore di prodotto 1.

Operatore di prodotto 5

Supporta gli stessi valori e regole dell'operatore di prodotto 1.

Operatore di prodotto 6

Supporta gli stessi valori e regole dell'operatore di prodotto 1.

Product Operator 7

Supporta gli stessi valori e regole dell'operatore di prodotto 1.

Valore prodotto 1

Valore dell'attributo della condizione. Il valore di un attributo deve corrispondere esattamente al valore specificato nel file di catalogo Microsoft Merchant Center del cliente.

Per le regole business, vedere Condizione del prodotto 1.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura. Non è possibile aggiornare i campi condizione o valore. Per aggiornare le condizioni, è necessario eliminare l'ambito del prodotto della campagna e aggiungerne uno nuovo.
Elimina: Sola lettura

Valore prodotto 2

Supporta gli stessi valori e regole di Product Value 1.

Valore prodotto 3

Supporta gli stessi valori e regole di Product Value 1.

Valore prodotto 4

Supporta gli stessi valori e regole di Product Value 1.

Valore prodotto 5

Supporta gli stessi valori e regole di Product Value 1.

Valore prodotto 6

Supporta gli stessi valori e regole di Product Value 1.

Valore prodotto 7

Supporta gli stessi valori e regole di Product Value 1.

Stato

Stato dell'ambito del prodotto.

I valori possibili sono Attivo o Eliminato.

Aggiungere: Opzionale. L'unico stato possibile è Attivo. Se si imposta lo stato su Eliminato , verrà ignorato e il record restituito avrà lo stato impostato su Attivo.
Aggiornamento: Opzionale
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.