Condividi tramite

Gestire contenuti creativi

Usa questi metodi nell'API promozioni di Microsoft Store per caricare i tuoi contenuti creativi personalizzati da usare nelle campagne promozionali o ottenere contenuti creativi esistenti. Una creatività può essere associata a una o più linee di distribuzione, anche nel contesto di campagne pubblicitarie diverse, purché rappresenti sempre la stessa applicazione.

Per altre informazioni sulla relazione tra creatività e campagne pubblicitarie, linee di recapito e profili di destinazione, vedi Eseguire campagne pubblicitarie usando i servizi di Microsoft Store.

Annotazioni

Quando si usa questa API per caricare la propria creatività, la dimensione massima consentita per la creatività è di 40 KB. Se invii un file creativo di dimensioni superiori a questo, questa API non restituirà un errore, ma la campagna non verrà creata correttamente.

Prerequisiti

Per usare questi metodi, è prima necessario eseguire le operazioni seguenti:

  • Se non l'hai già fatto, completa tutti i prerequisiti e dell'API delle promozioni di Microsoft Store.
  • Ottenere un token di accesso di Azure AD da usare nell'intestazione della richiesta per questi metodi. Dopo aver ottenuto un token di accesso, si hanno 60 minuti per usarlo prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.

Richiesta

Questi metodi hanno gli URI seguenti.

Tipo di metodo URI della richiesta Descrizione
INSERISCI https://manage.devcenter.microsoft.com/v1.0/my/promotion/creative Crea una nuova creatività.
OTTIENI https://manage.devcenter.microsoft.com/v1.0/my/promotion/creative/{creativeId} Ottiene la creatività specificata da creativeId.

Annotazioni

Questa API attualmente non supporta un metodo PUT.

Intestazione TIPO Descrizione
Autorizzazione corda Obbligatorio. Il token di accesso di Azure AD nel formato Bearer<token>.
ID di tracciamento Identificatore Unico Globale (GUID) Opzionale. ID che tiene traccia del flusso di chiamata.

Testo della richiesta

Il metodo POST richiede un corpo della richiesta JSON con i campi richiesti di un oggetto Creative.

Esempi di richiesta

Nell'esempio seguente viene illustrato come chiamare il metodo POST per creare una creatività. In questo esempio, il contenuto valore è stato abbreviato per brevità.

POST https://manage.devcenter.microsoft.com/v1.0/my/promotion/creative HTTP/1.1
Authorization: Bearer <your access token>

{
  "name": "Contoso App Campaign - Creative 1",
  "content": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAgGB...other base64 data shortened for brevity...",
  "height": 80,
  "width": 480,
  "imageAttributes":
  {
    "imageExtension": "PNG"
  }
}

Nell'esempio seguente viene illustrato come chiamare il metodo GET per recuperare una creatività.

GET https://manage.devcenter.microsoft.com/v1.0/my/promotion/creative/106851  HTTP/1.1
Authorization: Bearer <your access token>

Risposta

Questi metodi restituiscono una risposta JSON con un oggetto Creative che contiene informazioni sull'elemento creativo creato o recuperato. Nell'esempio seguente viene illustrato il contenuto della risposta per questi metodi. In questo esempio, il contenuto valore è stato abbreviato per brevità.

{
    "Data": {
        "id": 106126,
        "name": "Contoso App Campaign - Creative 2",
        "content": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAgGB...other base64 data shortened for brevity...",
        "height": 50,
        "width": 300,
        "format": "Banner",
        "imageAttributes":
        {
          "imageExtension": "PNG"
        },
        "storeProductId": "9nblggh42cfd"
    }
}

Oggetto creativo

I corpi di richiesta e risposta per questi metodi contengono i campi seguenti. Questa tabella mostra quali campi sono di sola lettura (ovvero non possono essere modificati nel metodo PUT) e quali campi sono necessari nel corpo della richiesta per il metodo POST.

Campo TIPO Descrizione Sola lettura Impostazione predefinita Obbligatorio per il metodo POST
Id numero intero ID della creatività. Sì NO
nome corda Nome del creativo. NO Sì
contenuto corda Contenuto dell'immagine creativa, in formato con codifica Base64.

Nota La dimensione massima consentita per la creatività è 40 KB. Se invii un file creativo di dimensioni superiori a questo, questa API non restituirà un errore, ma la campagna non verrà creata correttamente.		 NO Sì
altezza numero intero Il culmine della creatività. NO Sì
Larghezza numero intero Larghezza della creatività. NO Sì
URL di destinazione corda Se usi un servizio di rilevamento delle campagne come AppsFlyer, Kochava, Tune o Vungle per misurare l'analisi di installazione per la tua app, assegna l'URL di rilevamento in questo campo quando chiami il metodo POST (se specificato, questo valore deve essere un URI valido). Se non si usa un servizio di rilevamento delle campagne, omettere questo valore quando si chiama il metodo POST (in questo caso, questo URL verrà creato automaticamente). NO Sì
formato corda Formato dell'annuncio. Attualmente, l'unico valore supportato è Banner. NO Striscione NO
attributi dell'immagine ImageAttributes Fornisce attributi per la creatività. NO Sì
IDProdottoNegozio corda L'ID dello Store per l'app a cui è associata questa campagna pubblicitaria. Un esempio di ID dello Store per un prodotto è 9nblggh42cfd. NO NO

Oggetto ImageAttributes

Campo TIPO Descrizione Sola lettura Valore predefinito Obbligatorio per il metodo POST
imageExtension corda Uno dei valori seguenti: PNG o JPG. NO Sì