Domande frequenti

Il forum microsoft Q&A è disponibile per la community di sviluppatori per porre e rispondere a domande sulle API Bing Ads e sugli script di Microsoft Advertising. Microsoft monitora i forum e risponde alle domande a cui la community non ha ancora risposto.

Se l'indagine prevede dati personali o account sensibili o se non si trovano le informazioni necessarie per risolvere il problema tramite Microsoft Q&A, contattare il supporto tecnico microsoft per la pubblicità. Per risolvere il problema in modo efficiente, fornire supporto con i dettagli richiesti in Supporto coinvolgente.

Le note sulla versione e la Guida alla migrazione sono ottime risorse da cui iniziare.

È possibile iscriversi alla newsletter mensile tramite la scheda Notizie del portale per sviluppatori ed è anche qui che vengono aggregati gli annunci di blog più recenti.

Per iniziare, è necessario iscriversi a un account Microsoft Advertising e quindi ottenere il token per sviluppatori tramite la scheda Account del portale per sviluppatori.

È possibile sviluppare applicazioni API Bing Ads con qualsiasi linguaggio di programmazione che supporti i servizi Web. L'SDK (Software Development Kit) dell'API Bing Ads migliora l'esperienza di sviluppo di applicazioni API Bing Ads con linguaggi .NET, Java, PHP e Python. Ogni SDK include un proxy per tutti i servizi Web dell'API Bing Ads e astrae i dettagli di basso livello dell'autenticazione con OAuth. È possibile usare le interfacce BulkServiceManager e ReportingServiceManager di alto livello per astrarre ed eseguire operazioni in Bulk e Reporting Services di basso livello.

Sono state ricevute richieste di SDK aggiuntivi, ad esempio Perl e Ruby, anche se non è previsto l'aggiunta di supporto a breve termine.

Oltre agli esempi di codice , sono disponibili frammenti di codice in molte guide tecniche, ad esempio la guida Introduttiva . È possibile usare il selettore di linguaggio in alto o a destra di tali pagine per visualizzare esempi in CSharp, Java, Php o Python. Quando si sceglie una lingua, l'impostazione viene mantenuta durante la navigazione in altre pagine. Il selettore di lingua includerà solo le lingue con esempi per la pagina specifica e per impostazione predefinita sarà C# se la lingua impostata in precedenza non è disponibile per la pagina a cui si è passati.

Il servizio Bulk è consigliato, soprattutto se devi aggiungere o aggiornare annunci e parole chiave in più gruppi di annunci o campagne in un account. Alcune funzionalità non sono disponibili in blocco, ad esempio AddUetTags, GetBMCStoresByCustomerId, GetGeoLocationsFileUrl e GetMediaMetaDataByAccountId. Per queste funzionalità, ovviamente, è necessario usare il servizio Campaign Management.

Il servizio report supporta la maggior parte degli stessi tipi di report disponibili nell'applicazione Web Microsoft Advertising. Assicurarsi di consultare le guide Attributi del report e Statistiche prestazioni e Periodi di tempo di conservazione dei dati di report per i dettagli sulla disponibilità.

Quando un utente fa clic su un annuncio, il sistema può richiedere fino a due ore per elaborare il clic (3 ore per le conversioni) e renderlo disponibile per la creazione di report. Quando tutti i dati del giorno precedente sono stati elaborati e resi disponibili per la creazione di report, questo stato viene definito libri chiusi. Per altre informazioni su quando i libri vengono chiusi per la creazione di report, vedere Fusi orari in Report.

È necessario aggiornare l'applicazione per usare il nuovo msads.manage ambito tramite l'endpoint Microsoft Identity Platform. Tutti gli sviluppatori di applicazioni devono intervenire per usare il nuovo ambito.

È necessario richiedere il consenso a un utente tramite il nuovo msads.manage ambito e l'endpoint Microsoft Identity Platform.

Se si dispone di un ID applicazione precedente (noto anche come ID client) formattato come valore esadecimale, ad esempio 00000000012345A67, è necessario registrare una nuova applicazione. Gli ID applicazione Microsoft Identity Platform validi vengono formattati come GUID con tratti, ad esempio ab01c23d-4e56-7f8a-90bc-1d23efabc45d. Se non viene visualizzata un'app esistente nel portale di Azure- Registrazioni app, è un'indicazione che è necessario sostituirla con una nuova app.

Sì. È necessario richiedere il consenso a un utente tramite il nuovo msads.manage ambito e l'endpoint Microsoft Identity Platform.

Quando si richiede il consenso di un utente (usando il tenant comune) con l'endpoint Microsoft Identity Platform, l'esperienza di accesso dell'utente varia a seconda dell'identità sottostante dietro le credenziali.

• Una persona che ha solo un'identità dell'account del servizio gestito verrà indirizzata alla pagina di accesso dell'account del servizio gestito.
• Una persona che ha solo un'identità di Azure AD verrà indirizzata alla pagina di accesso dell'organizzazione.
• Una persona le cui credenziali sono valide sia nell'account del servizio gestito che nei domini di Azure AD incontrerà una pagina di disambiguazione che chiede di scegliere tra l'identità personale e l'identità aziendale o dell'istituto di istruzione. Questa ambiguità sarà sempre presente finché l'utente ha due identità associate allo stesso indirizzo di posta elettronica. L'utente può interrompere la visualizzazione modificando l'indirizzo di posta elettronica del proprio account Microsoft personale. Per altre informazioni, vedere https://cloudblogs.microsoft.com/enterprisemobility/2016/09/15/cleaning-up-the-azure-ad-and-microsoft-account-overlap/.

Se l'utente non ha più un'identità dell'account personale del servizio gestito, l'API Bing Ads non accetterà più il token di accesso esistente. Analogamente, il token di aggiornamento non può più essere usato per richiedere un nuovo token di accesso, quindi dovrai richiedere di nuovo il consenso dell'utente affinché l'applicazione gestirà i propri account Microsoft Advertising. È consigliabile eliminare il token di aggiornamento precedente.

No. Gli account aziendali o dell'istituto di istruzione sono supportati solo nell'ambiente di produzione.

Per gestire un account Microsoft Advertising a livello di codice, è necessario fornire il consenso almeno una volta tramite il flusso di consenso dell'applicazione Web. Per l'autenticazione ripetuta o a lungo termine, è necessario seguire il flusso di concessione del codice di autorizzazione per ottenere un token di accesso e un token di aggiornamento. Successivamente è possibile usare il token di aggiornamento più recente per richiedere nuovi token di accesso e aggiornamento senza ulteriori interazioni con l'utente. Potrebbe essere necessario richiedere di nuovo il consenso dell'utente, ad esempio se l'utente ha eseguito il ripristino dell'account, ha modificato la password o ha rimosso in altro modo le autorizzazioni per l'autenticazione per conto dell'applicazione.

Il token di accesso scade in genere dopo un'ora, anche se è consigliabile controllare sempre l'ora di scadenza ogni volta che si richiede un nuovo token.

I token di aggiornamento sono e saranno sempre completamente opachi per l'applicazione. Sono di lunga durata, ad esempio 90 giorni per i client pubblici, ma l'app non deve essere scritta per prevedere che un token di aggiornamento durerà per qualsiasi periodo di tempo. I token di aggiornamento possono essere invalidati in qualsiasi momento e l'unico modo per un'app di sapere se un token di aggiornamento è valido consiste nel tentare di riscattarlo effettuando una richiesta di token. Anche se si aggiorna continuamente il token nello stesso dispositivo con il token di aggiornamento più recente, è consigliabile ricominciare e richiedere il consenso dell'utente se, ad esempio, l'utente di Microsoft Advertising ha modificato la password, rimosso un dispositivo dall'elenco di dispositivi attendibili o rimosso le autorizzazioni per l'autenticazione dell'applicazione per suo conto. In qualsiasi momento senza preavviso Microsoft può determinare che il consenso dell'utente deve essere nuovamente concesso. Come procedura consigliata, è consigliabile archiviare sempre in modo sicuro il token di aggiornamento più recente ogni volta che si richiedono nuovi token di accesso e aggiornamento.

Il token di accesso rappresenta le credenziali utente che hanno accesso a uno o più account Microsoft Advertising. L'ID applicazione (a.k.a. client_id) identifica l'applicazione per ogni utente di Microsoft Advertising che concede il consenso. Il token per sviluppatori concede all'applicazione l'autorizzazione per usare l'API Bing Ads.

Bing Ads è ora Microsoft Advertising. Il nostro nuovo nome riflette come stiamo crescendo le nostre soluzioni pubblicitarie per aiutarti a raggiungere più clienti. Non è previsto il ridenominamento di nessuna delle versioni dell'API correnti. Nella tabella seguente sono elencati i nomi che hanno o non sono stati modificati. Per altre informazioni, vedere l'annuncio del marchio.