Microsoft Advertising Sandbox
Microsoft Advertising offre un ambiente sandbox per le API in cui è possibile testare l'applicazione prima di distribuirla nell'ambiente di produzione. Gli annunci creati nella sandbox non vengono pubblicati. I servizi supportati nella sandbox variano a seconda dell'ambiente di produzione. Per ottenere gli indirizzi del servizio Web per i servizi supportati, vedere Indirizzi del servizio Web dell'API Bing Ads.
Nota
Sandbox può essere inattivo per la manutenzione, con o senza notifica preventiva.
Iscrizione iniziale del cliente
Gli ambienti sandbox e di produzione usano credenziali separate.
Seguire questa procedura per ottenere un nuovo cliente sandbox. Se si ha già un cliente sandbox e si vuole aggiungere un nuovo utente, ad esempio con le credenziali dell'account Microsoft, è possibile passare alla procedura di invito dell'utente .
Aprire un browser e passare a https://sandbox.bingads.microsoft.com?simpsp=true
Fare clic su Iscriviti per Microsoft Advertising o Iscriviti ora
Selezionare Crea un nuovo indirizzo di posta elettronica per creare un account del servizio gestito. Non usare un indirizzo di posta elettronica esistente.
Fai clic su Avanti
Immettere un indirizzo di posta elettronica dell'account del servizio gestito. Il server di posta elettronica deve essere outlook-int.com, someone@outlook-int.comad esempio .
Importante
Sandbox supporta gli account del servizio gestito creati usando solo un account di posta elettronica outlook-int.com. Non è possibile usare un account di posta elettronica outlook.com. Inoltre, non è possibile usare un account di posta elettronica da un altro servizio di posta elettronica( ad esempio, @contoso.com) anche se l'account è collegato a un account di posta elettronica outlook.com o outlook-int.com.
Completare il flusso di lavoro dell'account del servizio gestito specificando il resto delle informazioni sull'utente e sulla sicurezza. Si verrà quindi reindirizzati a Microsoft Advertising per continuare l'iscrizione al cliente e all'account sandbox.
Compilare il modulo Crea account
Per Importa/Crea campagna, fare clic su Ignora creazione campagna
Per Go Live fare clic su Ignora informazioni di pagamento
Invitare altri utenti
Per eseguire l'autenticazione con OAuth nella sandbox, è necessario un account Microsoft sandbox. Se il cliente sandbox non dispone ancora di credenziali utente tramite un account Microsoft, è necessario invitare un utente a lavorare sull'account sandbox seguendo questa procedura.
Nella sandbox di Microsoft Advertising fare clic sul nome utente (angolo in alto a destra)
Fare clic su Account & Fatturazione
Fare clic su Utenti
Fare clic su Invita utente
Immettere l'indirizzo di posta elettronica dell'utente da invitare. Il server di posta elettronica deve essere outlook.com, someone@outlook.comad esempio .
Importante
È possibile inviare inviti solo agli account di posta elettronica outlook.com. Non è possibile inviare inviti ad altri domini, anche se l'account è collegato a un account di posta elettronica outlook.com. Se si prova a inviare un invito a un altro dominio , ad esempio , someone@contoso.coml'interfaccia utente di BingAds visualizzerà l'invito come in sospeso a tempo indeterminato (l'invito non viene mai inviato).
Fare clic su Invia
Microsoft Advertising invia un invito tramite posta elettronica all'utente. Se l'invito non viene visualizzato nella posta in arrivo, selezionare la cartella Posta indesiderata Email. Potrebbero essere necessari alcuni minuti per ricevere l'invito. La procedura seguente illustra come accettare l'invito.
Aprire il messaggio di posta elettronica da Microsoft Advertising con la riga dell'oggetto Invito a Microsoft Advertising
Fare clic sul collegamento incorporato
Selezionare Crea un nuovo indirizzo di posta elettronica per creare un account del servizio gestito. Non usare un indirizzo di posta elettronica esistente.
Fai clic su Avanti
Immettere un indirizzo di posta elettronica dell'account del servizio gestito. Il server di posta elettronica deve essere outlook-int.com, someone@outlook-int.comad esempio .
Importante
Sandbox supporta gli account del servizio gestito creati usando solo un account di posta elettronica outlook-int.com. Non è possibile usare un account di posta elettronica outlook.com. Inoltre, non è possibile usare un account di posta elettronica da un altro servizio di posta elettronica( ad esempio, @contoso.com) anche se l'account è collegato a un account di posta elettronica outlook.com o outlook-int.com.
Completare il flusso di lavoro specificando il resto delle informazioni utente
Uscire da Microsoft Advertising dopo aver completato il processo msa.
Nota
Il processo di iscrizione all'account del servizio gestito restituisce l'utente all'interfaccia utente di Si Microsoft Advertising (ui.si.bingads.microsoft.com). Dopo aver completato il processo msa, disconnettersi dall'interfaccia SI e quindi accedere usando il nuovo indirizzo di posta elettronica outlook-int.com all'indirizzo https://secure.sandbox.bingads.microsoft.com/.
Ottenere l'accesso alle API
Gli ambienti sandbox e di produzione usano credenziali separate.
Per l'ambiente sandbox, sostituire https://login.microsoftonline.com/common con https://login.windows-ppe.net/consumers.
Questa tabella include endpoint sandbox aggiuntivi.
| Descrizione | Produzione | Sandbox |
|---|---|---|
| Endpoint per le richieste OAuth | login.microsoftonline.com | login.windows-ppe.net |
| Dominio per la posta elettronica usata quando si ottiene un account Microsoft | Qualsiasi indirizzo di posta elettronica | outlook-int.com |
| Endpoint per modificare la password dell'account Microsoft | account.live.com/password/change | account.live-int.com/password/change |
Anche se nell'ambiente di produzione è necessario usare il proprio token di sviluppo, tutti i clienti di Microsoft Advertising possono usare il token di sviluppo universale seguente nella sandbox.
BBD37VB98
Anche se nell'ambiente di produzione è necessario usare il proprio ID applicazione (a.k.a. ID client), tutti i clienti di Microsoft Advertising possono usare il seguente ID applicazione pubblica nella sandbox. L'ID client "Tutorial Sample App" è limitato alle applicazioni desktop o console e non può essere usato con alcun segreto client in un'applicazione Web.
4c0b021c-00c3-4508-838f-d3127e8167ff
A questo punto è possibile ottenere i token di accesso e aggiornamento per l'utente di Microsoft Advertising e effettuare la prima chiamata al servizio usando l'API Bing Ads, vedere la guida introduttiva .
Consiglio
Per informazioni dettagliate su come ottenere l'accesso e aggiornare i token usando gli SDK di Bing Ads, vedere Autenticazione con gli SDK.
Procedure consigliate per sandbox
La sandbox non deve essere usata nella stessa capacità dell'ambiente di produzione.
- Assicurarsi che quando si distribuisce l'applicazione nell'ambiente di produzione, si usino i file WSDL di produzione e le credenziali di produzione.
- Sandbox contiene la versione di produzione corrente e verrà aggiornata con le anteprime delle funzionalità con o senza notifica precedente.
- La capacità della sandbox è inferiore a quella di produzione e non è consigliabile usarla per eseguire test di stress o capacità.
- Non usare più thread.
Servizio Informazioni dettagliate sugli annunci
Sandbox supporta un set limitato di parole chiave per testare le operazioni del servizio Ad Insight. Non usare i dati di test per dedurre o prevedere stime simili per le parole chiave nell'ambiente di produzione. Alcune delle limitazioni sono descritte nella tabella seguente.
Consiglio
Usare il servizio Ad Insight nell'ambiente di produzione anziché nella sandbox. Sandbox offre solo un subset di operazioni del servizio di produzione e i dati analitici sono in ritardo rispetto all'ambiente di produzione. I dati delle opportunità sandbox vengono aggiornati ogni fine settimana ed è disponibile entro lunedì. I dati dell'idea della parola chiave nella sandbox potrebbero essere in ritardo rispetto alla produzione di diversi mesi. Se un'operazione ha esito negativo a causa di un intervallo di date non valido, provare a inviare di nuovo la richiesta con un intervallo di date precedente.
| Operazione del servizio | Limitazioni sandbox |
|---|---|
| GetBidLandscapeByKeywordIds | Non supportate. È possibile chiamare l'operazione con identificatori di parole chiave esistenti, ma non vengono restituiti dati. |
| GetEstimatedBidByKeywordIds | Un set limitato di parole chiave sono supportati: aria, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, affare del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurativo, sport, l'hotel. |
| GetEstimatedBidByKeywords | Un set limitato di parole chiave sono supportati: aria, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, affare del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurativo, sport, l'hotel. |
| GetEstimatedPositionByKeywordIds | Un set limitato di parole chiave sono supportati: aria, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, affare del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurativo, sport, l'hotel. Per aumentare le probabilità di ottenere una stima, l'elemento MaxBid deve essere maggiore o uguale a 5 dollari USA o l'equivalente in altre valute. |
| GetEstimatedPositionByKeywords | Un set limitato di parole chiave sono supportati: aria, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, affare del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurativo, sport, l'hotel. Per aumentare le probabilità di ottenere una stima, l'elemento MaxBid deve essere maggiore o uguale a 5 dollari USA o l'equivalente in altre valute. |
| GetHistoricalKeywordPerformance | Un set limitato di parole chiave sono supportati: aria, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, affare del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurativo, sport, l'hotel. Gli elementi MatchType e AdPosition devono essere impostati su Aggregate. L'elemento Devices deve essere impostato su Computers o lasciato nil. |
| GetHistoricalSearchCount | Un set limitato di parole chiave sono supportati: aria, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, affare del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurativo, sport, l'hotel. L'elemento EndMonthAndYear deve essere impostato sul mese precedente. Ad esempio, se la data odierna è il 1° aprile 2020, il mese di fine dovrebbe essere marzo 2020. L'elemento Devices deve essere impostato su Computers o lasciato nil. |
| GetKeywordCategories | Non dovrebbero esserci differenze tra sandbox e produzione. |
| GetKeywordDemographics | Un set limitato di parole chiave sono supportati: aria, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, affare del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurativo, sport, l'hotel. L'elemento Devices deve essere impostato su Computers o lasciato nil. |
| GetKeywordIdeas | I dati di test sandbox vengono aggiornati ogni 3 mesi, quindi sarà necessario impostare un intervallo di dati precedente. |
| GetKeywordLocations | Un set limitato di parole chiave sono supportati: aria, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, affare del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurativo, sport, l'hotel. L'elemento Devices deve essere impostato su Computers o lasciato nil. |
| SuggestKeywordsForUrl | Non dovrebbero esserci differenze tra sandbox e produzione. |
| SuggestKeywordsFromExistingKeywords | Se SuggestionType è impostato su 1, non dovrebbero esserci differenze di comportamento rispetto alla produzione. Per i valori del tipo di suggerimento 2, 3 e 4, è supportato un set limitato di parole chiave: aria, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, trattativa del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurativo, sport, hotel. |
Servizio bulk
Il limite di dimensioni del file per il caricamento nell'ambiente di produzione è di 100 MB o 2,5 milioni di righe. Per la sandbox il limite è di 20.000 righe. Per altre informazioni, vedere Download e caricamento bulk.
Servizio gestione campagna
Supporto editoriale
Sandbox supporta recensioni editoriali limitate e ricorsi. Non è possibile ottenere i motivi dei problemi editoriali nella sandbox come nell'ambiente di produzione, ad esempio tramite l'operazione del servizio GetEditorialReasonsByIds .
Annunci di prodotto
Gli annunci di prodotto sono supportati nella sandbox nel Stati Uniti. Per essere approvato automaticamente, è necessario creare un catalogo e un archivio Microsoft Merchant Center che termina con "sandbox" come indicato di seguito.
Nell'applicazione Web Microsoft Advertising fare clic su Strumenti.
In Strumenti di gestione fare clic su Microsoft Merchant Center.
Fare clic su Crea archivio e immettere un nome di archivio che termina con "sandbox" (senza distinzione tra maiuscole e minuscole).
Aggiungere le informazioni del negozio, selezionare Annunci di prodotto in Impostazioni catalogo e fare clic su Fine.
Nel nuovo archivio fare clic su Gestione catalogo e quindi su Crea catalogo.
Aggiungere il nome del catalogo, selezionare Carica manualmente il file in un secondo momento in File di feed del catalogo e fare clic su Salva.
Servizio di fatturazione clienti
I metodi di pagamento non sono supportati nella sandbox.
Reporting Service
Quando si crea una parola chiave, i dati sulle prestazioni dei test devono essere generati entro poche ore. I dati vengono forniti per testare la generazione, il recupero e l'analisi dei report nella sandbox. Non usare i dati di test per dedurre o prevedere prestazioni simili per le parole chiave nell'ambiente di produzione.
I dati di test vengono generati solo per lo stesso giorno in cui l'entità è stata aggiunta o aggiornata. Ad esempio, se si aggiunge una parola chiave oggi e si scarica un report sulle prestazioni delle parole chiave per la settimana scorsa, non ci saranno dati. È necessario eseguire il pull di un report che include oggi nel periodo di tempo del report.
I report seguenti possono restituire dati sulle prestazioni nella sandbox. Tutti gli altri tipi di report possono essere inviati correttamente, anche se il servizio sandbox non restituirà dati di esempio, ad esempio, l'URL di download del report non verrà impostato quando si esegue il polling dei risultati.