Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Microsoft Advertising offre un ambiente sandbox di 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 rispetto alla produzione. Per ottenere gli indirizzi dei servizi Web per i servizi supportati, vedere Indirizzi dei servizi Web dell'API di Bing Ads.
Nota
La sandbox potrebbe essere inattiva per manutenzione, con o senza preavviso.
Iscrizione iniziale del cliente
Gli ambienti sandbox e di produzione usano credenziali distinte.
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 ignorare i passaggi di invito dell'utente .
Apri un browser e vai alla pagina di iscrizione alla sandbox.
Seleziona Iscriviti ora.
Selezionare Crea un account per creare un account Microsoft (MSA).
Selezionare Ottieni un nuovo indirizzo e-mail.
Immettere un indirizzo di posta elettronica MSA. Il server di posta elettronica deve essere outlook.com (ad esempio, someone@outlook.com).
Importante
Sandbox supporta gli MSA creati usando un account di posta elettronica outlook.com. Inoltre, non è possibile utilizzare un account di posta elettronica di un altro servizio di posta elettronica, @contoso.com) ad esempio anche se l'account è collegato a un account di posta elettronica outlook.com.
Completare il flusso di lavoro MSA specificando il resto delle informazioni sull'utente e sulla sicurezza. Si verrà quindi reindirizzati a Microsoft Advertising per continuare la sandbox con l'iscrizione di clienti e account.
Compila il modulo Crea account .
Per Go Live, seleziona Ignora le informazioni di pagamento.
Facoltativo: invitare altri utenti
Per eseguire l'autenticazione con OAuth nella sandbox, è necessario un account Microsoft (MSA) creato con un account di posta elettronica outlook.com. Se il cliente sandbox non ha ancora credenziali utente tramite un account Microsoft o se il cliente sandbox è stato creato con un account e-mail outlook-int.com, è necessario invitare un utente a lavorare sul proprio account sandbox seguendo questa procedura.
Nella sandbox di Microsoft Advertising selezionare Impostazioni.
Selezionare Gestione utenti.
Seleziona Invita utente.
Immettere l'indirizzo di posta elettronica dell'utente da invitare. Il server di posta elettronica deve essere outlook.com (ad esempio, someone@outlook.com).
Importante
È possibile inviare inviti solo a outlook.com account di posta elettronica. Non puoi inviare inviti a nessun altro dominio, 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.com), l'interfaccia utente di BingAds mostrerà l'invito come in sospeso a tempo indeterminato (l'invito non viene mai inviato).
Scegli Invia.
Microsoft Advertising invia un invito tramite posta elettronica all'utente. Se l'invito non viene visualizzato nella posta in arrivo, controlla la cartella Email indesiderata. La ricezione dell'invito può richiedere qualche minuto. I passaggi seguenti mostrano come accettare l'invito.
Apri il messaggio di posta elettronica da Microsoft Advertising con oggetto, Invito a Microsoft Advertising
Copiare il collegamento incorporato e aprirlo in una finestra in modalità InPrivate o in un altro browser.
Selezionare Crea un account per creare un account Microsoft (MSA).
Selezionare Ottieni un nuovo indirizzo e-mail.
Immettere un indirizzo di posta elettronica MSA. Il server di posta elettronica deve essere outlook.com (ad esempio, someone@outlook.com).
Importante
Sandbox supporta gli MSA creati usando un account di posta elettronica outlook.com. Inoltre, non è possibile utilizzare un account di posta elettronica di un altro servizio di posta elettronica, @contoso.com) ad esempio anche se l'account è collegato a un account di posta elettronica outlook.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 Microsoft consente di tornare all'interfaccia utente (ads-int.microsoft.com di Microsoft Advertising). Dopo aver completato il processo MSA, disconnettersi dall'interfaccia SI e quindi accedere utilizzando il nuovo indirizzo e-mail outlook.com all'indirizzo https://sandbox.bingads.microsoft.com/.
Ambiente sandbox — Supporto OAuth di Google
La sandbox di Microsoft Advertising e gli ambienti di produzione utilizzano credenziali distinte. Oltre agli account Microsoft, ora è possibile creare client sandbox e autenticare gli utenti utilizzando Google OAuth 2.0.
In questo modo gli sviluppatori e gli inserzionisti possono testare le API di Microsoft Advertising nella sandbox usando un'identità Google, senza richiedere un outlook.com account Microsoft.
Initial Customer Sign-Up (Sandbox) - Google OAuth
È possibile creare un nuovo cliente di sandbox usando un account Google.
Procedura per creare un nuovo cliente Sandbox con Google OAuth
Apri un browser e vai alla pagina di iscrizione alla sandbox.
Seleziona Iscriviti ora.
Scegli Sign up with Google.
Completare il flusso di autenticazione OAuth di Google:
- Accedi con il tuo account Google.
- Verificare e concedere il consenso per consentire a Microsoft Advertising di accedere all'account.
- Approva gli ambiti richiesti (
email,profile) se richiesto.
Dopo aver completato l'autenticazione, si viene reindirizzati a Microsoft Advertising per continuare la creazione del cliente nel sandbox.
Compilare il modulo Crea account .
- Per Go Live, seleziona Ignora le informazioni di pagamento.
Accettazione di un invito con Google OAuth
Gli utenti invitati possono accettare gli inviti sandbox utilizzando Google OAuth come indicato di seguito:
- Apri il collegamento di invito.
- Seleziona Accedi con Google.
- Completare il flusso di autenticazione OAuth di Google.
- Dopo aver eseguito l'accesso, l'utente viene aggiunto all'account sandbox.
Il supporto migliorato della sandbox consente ai team di testare le API di Microsoft Advertising con utenti autenticati da Google mantenendo lo stesso comportamento API della produzione.
Ottenere l'accesso alle API
Gli ambienti sandbox e di produzione usano credenziali distinte.
Questa tabella include endpoint sandbox aggiuntivi.
| Descrizione | Produzione | Sandbox |
|---|---|---|
| Endpoint per le richieste OAuth | login.microsoftonline.com | login.microsoftonline.com |
| Dominio per la posta elettronica usata quando si ottiene un account Microsoft | Qualsiasi indirizzo di posta elettronica | outlook.com |
| Endpoint per modificare la password dell'account Microsoft | account.live.com/password/change | account.live.com/password/change |
Anche se nell'ambiente di produzione è necessario utilizzare il proprio token sviluppatore, tutti i clienti di Microsoft Advertising possono utilizzare il seguente token sviluppatore universale nella sandbox.
BBD37VB98
È necessario utilizzare il proprio ID applicazione sia nella produzione che nella sandbox (detto anche ID client).
Ora è possibile ottenere i token di accesso e di aggiornamento per l'utente di Microsoft Advertising ed effettuare la prima chiamata di servizio utilizzando l'API di Bing Ads, vedere la Guida introduttiva .
Consiglio
Per informazioni dettagliate su come ottenere i token di accesso e di aggiornamento tramite gli SDK di Bing Ads, vedere Autenticazione con gli SDK.
Ottenere l'accesso all'API per Google oAuth
Crea un account Google all'indirizzo https://accounts.google.com.
Procedure consigliate per la sandbox
La sandbox non deve essere usata nella stessa capacità della produzione.
- Assicurarsi che quando si distribuisce l'applicazione nell'ambiente di produzione, si utilizzino i file WSDL di produzione e le credenziali di produzione.
- La sandbox contiene la versione di produzione corrente e verrà aggiornata con le anteprime delle funzionalità con o senza preavviso.
- La capacità della sandbox è inferiore a quella della produzione e non deve essere usata per eseguire test di stress o di capacità.
- Non usare più di un thread.
Servizio Ad Insight
La sandbox supporta un set limitato di parole chiave per testare le operazioni del servizio Ad Insight. Non è consigliabile utilizzare i dati di test per dedurre o prevedere stime simili per le parole chiave in produzione. Alcune delle limitazioni sono descritte nella tabella seguente.
Consiglio
Utilizza il servizio Ad Insight in produzione anziché nella sandbox. La sandbox offre solo un sottoinsieme delle operazioni dei servizi di produzione e i dati di insight sono in ritardo rispetto alla produzione. I dati sulle opportunità sandbox vengono aggiornati ogni fine settimana e sono disponibili entro lunedì. I dati delle idee chiave nella sandbox potrebbero rimanere indietro di alcuni mesi rispetto alla produzione. Se un'operazione non riesce a causa di un intervallo di date non valido, provare a inviare nuovamente la richiesta con un intervallo di date precedente.
| Funzionamento del servizio | Limitazioni della sandbox |
|---|---|
| GetBidLandscapeByKeywordIds | Non supportate. È possibile chiamare l'operazione con identificatori di parole chiave esistenti, ma non vengono restituiti dati. |
| GetEstimatedBidByKeywordIds | È supportato un set limitato di parole chiave: aereo, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, offerta del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurazioni, sport, hotel. |
| GetEstimatedBidByKeywords | È supportato un set limitato di parole chiave: aereo, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, offerta del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurazioni, sport, hotel. |
| GetEstimatedPositionByKeywordIds | È supportato un set limitato di parole chiave: aereo, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, offerta del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurazioni, sport, hotel. Per aumentare le possibilità di ottenere una stima, l'elemento MaxBid deve essere maggiore o uguale a 5 dollari USA o all'equivalente in altre valute. |
| GetEstimatedPositionByKeywords | È supportato un set limitato di parole chiave: aereo, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, offerta del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurazioni, sport, hotel. Per aumentare le possibilità di ottenere una stima, l'elemento MaxBid deve essere maggiore o uguale a 5 dollari USA o all'equivalente in altre valute. |
| GetHistoricalKeywordPerformance | È supportato un set limitato di parole chiave: aereo, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, offerta del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurazioni, sport, hotel. Gli elementi MatchType e AdPosition devono essere impostati su Aggregate. L'elemento Devices deve essere impostato su Computers o lasciato zero. |
| GetHistoricalSearchCount | È supportato un set limitato di parole chiave: aereo, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, offerta del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurazioni, sport, hotel. L'elemento EndMonthAndYear deve essere impostato sul mese precedente. Ad esempio, se la data di oggi è il 1° aprile 2020, il mese di fine dovrebbe essere marzo 2020. L'elemento Devices deve essere impostato su Computers o lasciato zero. |
| GetKeywordCategories | Non dovrebbe esserci differenza tra sandbox e produzione. |
| GetKeywordDemographics | È supportato un set limitato di parole chiave: aereo, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, offerta del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurazioni, sport, hotel. L'elemento Devices deve essere impostato su Computers o lasciato zero. |
| GetKeywordIdeas | I dati del test sandbox vengono aggiornati ogni tre mesi, quindi sarà necessario impostare un intervallo di date precedente. |
| GetKeywordLocations | È supportato un set limitato di parole chiave: aereo, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, offerta del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurazioni, sport, hotel. L'elemento Devices deve essere impostato su Computers o lasciato zero. |
| SuggestKeywordsForUrl | Non dovrebbe esserci differenza tra sandbox e produzione. |
| SuggestKeywordsFromExistingKeywords | Se SuggestionType è impostato su 1, non dovrebbe esserci alcuna differenza di comportamento rispetto alla produzione. Per i valori del tipo di suggerimento 2, 3 e 4 è supportato un set limitato di parole chiave: aereo, auto, migliori offerte, prenotazione, informazioni sull'auto, cura, offerta del giorno, sconti, intrattenimento, finanze, giochi, recensioni di hotel, confronto assicurazioni, sport, hotel. |
Servizio all'ingrosso
Il limite delle dimensioni del file per il caricamento in produzione è di 100 MB, o 2,5 milioni di righe. Per la sandbox il limite è di 20.000 righe. Per ulteriori informazioni, vedere Download e caricamento in blocco.
Servizio di gestione delle campagne
Supporto editoriale
Sandbox supporta revisioni editoriali e ricorsi limitati. Non è possibile ottenere i motivi dei problemi editoriali nella sandbox, come invece avviene in produzione, ad esempio tramite l'operazione del servizio GetEditorialReasonsByIds .
Annunci prodotto
Gli annunci prodotto sono supportati tramite sandbox negli Stati Uniti. Per ottenere l'approvazione automatica, è necessario creare un catalogo e un negozio di Microsoft Merchant Center che termini con "sandbox" nel modo seguente.
- Nell'applicazione Web Microsoft Advertising selezionare Strumenti.
- In Strumenti di gestione selezionare Microsoft Merchant Center.
- Selezionare Crea negozio e immettere un nome che termini con "sandbox" (senza distinzione tra maiuscole e minuscole).
- Aggiungi le informazioni sul tuo negozio, seleziona Annunci prodotto in Impostazioni catalogo e seleziona Fine.
- Nel nuovo negozio selezionare Gestione catalogo e quindi Crea catalogo.
- Aggiungere il nome del catalogo, selezionare Carica manualmente il file in un secondo momento in File feed catalogo e selezionare Salva.
Servizio di fatturazione del cliente
I metodi di pagamento non sono supportati nella sandbox.
Servizio di creazione report
Quando si crea una parola chiave, i dati sulle prestazioni del 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 è consigliabile utilizzare i dati di test per dedurre o prevedere prestazioni simili per le parole chiave in 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 sul rendimento delle parole chiave per la settimana precedente, non sarà presente alcun dato. Dovresti estrarre un report che includa 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à alcun dato di esempio, ovvero l'URL di download del report non verrà impostato quando si esegue il polling dei risultati.