Attribuisci le installazioni iOS con SKAdNetwork

La piattaforma di scambio di Google supporta gli indicatori utilizzati dall'SDK Google Mobile Ads per avviare l'attribuzione SKAdNetwork con l'API SKAdNetwork di Apple. Puoi eseguire l'integrazione con gli indicatori di SKAdNetwork per consentire agli inserzionisti di misurare il successo delle campagne di annunci per l'installazione di app per dispositivi iOS, rispettando al contempo la privacy degli utenti.

Il seguente elenco illustra come cambia il comportamento di attribuzione delle installazioni di app a seconda della versione di SKAdNetwork:

• 2.0-2.1: l'attribuzione per l'installazione di un'app pubblicizzata è basata sulla pagina di prodotto dell'App Store visualizzata da StoreKit quando l'utente fa clic sull'annuncio, il che porta l'utente a installare l'app.
• 2.2+: supporto aggiuntivo per gli annunci view-through, in cui l'attribuzione per l'installazione di un'app pubblicizzata viene assegnata quando l'utente installa l'app dopo aver visualizzato l'annuncio.

Per scoprire di più sulle differenze tra le versioni di SKAdNetwork, consulta le note di rilascio di SKAdNetwork.

Configura gli ID SKAdNetwork nell'interfaccia utente

Per ricevere richieste di offerta contenenti ID SKAdNetwork, devi specificare i tuoi ID SKAdNetwork nell'interfaccia utente di Authorized Buyers o Open Bidding. Ad esempio, un ID SKAdNetwork potrebbe avere un valore come a1b2c3d4e5.skadnetwork.

Per specificare l'ID SKAdNetwork nell'interfaccia utente di Authorized Buyers o Open Bidding, segui questi passaggi:

1. Nel menu di navigazione Impostazioni offerente, fai clic su Impostazioni RTB. Viene visualizzata la pagina Impostazione RTB.
2. Vai alla casella ID SKAdNetwork per iOS consentiti per visualizzare e configurare gli ID SKAdNetwork.

La seguente immagine mostra un esempio di ID SKAdNetwork nella casella ID SKAdNetwork per iOS consentiti:

Configura le creatività per l'attribuzione

L'SDK Google Mobile Ads avvia l'attribuzione SKAdNetwork solo se l'URL di clickthrough rimanda all'App Store di Apple. Quando invii le creatività per la revisione utilizzando l'API Offerte in tempo reale, le creatività devono utilizzare un URL di clickthrough che sia un link diretto all'app pubblicizzata nell'App Store o che utilizzi reindirizzamenti HTTP in cui la destinazione finale è l'app pubblicizzata nell'App Store. L'SDK Google Mobile Ads avvia l'attribuzione se la destinazione finale dell'URL di clickthrough della creatività inizia con uno dei seguenti prefissi:

• https://apps.apple.com
• https://itunes.apple.com
• itms-apps://
• itms://

Se la destinazione finale dell'URL di clickthrough della creatività non corrisponde a questi prefissi o se l'URL di clickthrough utilizza altri metodi di reindirizzamento lato client che non indirizzano all'App Store, l'SDK Google Mobile Ads potrebbe non avviare l'attribuzione SKAdNetwork. Il seguente elenco include esempi di casi in cui questa procedura potrebbe essere applicata:

• Una pagina HTML che richiede l'intervento dell'utente per il reindirizzamento allo store.
• Una pagina HTML con uno script di reindirizzamento automatico basato su JavaScript allo store.
• Tag meta refresh.

Avvia l'attribuzione per tipo di creatività

L'azione di clic per avviare l'attribuzione SKAdNetwork può essere configurata per i diversi tipi di creatività come segue:

HTML

Può essere impostato come URL di destinazione negli anchor tag che circondano l'elemento cliccabile o come URL di destinazione delle operazioni window.location dagli eventi di clic basati su JavaScript.

MRAID

L'azione di clic deve chiamare Mraid.open() per avviare l'attribuzione SKAdNetwork.

Video VAST

L'URL dello store deve essere impostato nell'elemento ClickThrough nel file XML VAST.

Nativo

L'URL dello store deve essere impostato nel campo BidResponse.seatbid.bid.{adm/adm_native}.link.url.

Identifica gli indicatori BidRequest

Puoi trovare informazioni sugli ID SKAdNetwork registrati supportati dall'app publisher con il campo BidRequest.imp.ext.skadn. Se il campo skadn è specificato, puoi utilizzare gli attributi per creare una risposta per un annuncio per l'installazione di app o un annuncio di re-engagement che associa un'installazione o una conversione a uno degli ID SKAdNetwork inclusi. Il campo skadn è un oggetto SKAdNetworkRequest con i seguenti attributi:

L'esempio seguente mostra una richiesta di offerta per l'inventario mobile in cui l'app del publisher supporta i tuoi ID SKAdNetwork:

{
  "id": "9NaI48SmPW7Zf3MAHR43DY",
  "imp": [
    {
      "id": "1",
      // OMITTED...
      "ext": {
        // OMITTED...
        "skadn": {
          "sourceapp": "com.google.testapp",
          "skadnetids": [
            "cF58w81X"
          ],
          "versions": [
            "2.0",
            "2.1",
            "4.0"
          ],
          "fidelities": [
            1,
            0
          ]
        }
        // OMITTED...
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "5.6.0",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-6156239328255091",
      "ext": {
        "country": "JP"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "livestream": 0,
      "language": "ja"
    },
    "storeurl": "https://www.google.com"
  }
  // OMITTED...
}

Compila BidResponse campi

Puoi includere informazioni sull'attribuzione nella risposta all'offerta che consentono all'inserzionista di ricevere una notifica di postback quando un utente interagisce con il suo annuncio. Per scoprire di più sulle notifiche di postback, consulta Ricevere attribuzioni degli annunci e postback.

Devi trasmettere informazioni sull'attribuzione coerenti con quelle incluse nella richiesta di offerta. Le informazioni sull'attribuzione sono specificate nel campo BidResponse.seatbid.bid.ext.skadn, che è un oggetto SKAdNetworkResponse con i seguenti attributi:

Il seguente esempio mostra una risposta all'offerta che include le informazioni di attribuzione dell'installazione di app:

{
  "id": "9NaI48SmPW7Zf3MAHR43DY",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9NaI48SmPW7Zf3MAHR43DY",
          // OMITTED...
          "ext": {
            // OMITTED...
            "skadn": {
              "version": "4.0",
              "network": "cF58w81X",
              "itunesitem": "788729094",
              "sourceapp": "1422994973",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "11iF1L96q2cw8tu790p301c10530ogr7h250k1P9pLxqcJ2qe37klG8xB3M592YbpafQ9861493838C521XA6AEF4A40DK8X"
                },
                {
                  "fidelity": 1,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "f67L3C138Y6XB7940141011Pd58AZbdBk9Xo1Mlf1973706DsB5808ILLKumU2ic9fr72b9bSs3CD25CCZo8DJB65JB0615L"
                }
              ],
              "sourceidentifier": "5507"
            },
            "app_promotion_type": 1
            // OMITTED...
          }
        }
      ]
      // OMITTED...
    }
  ]
  // OMITTED...
}

Il seguente elenco mostra il comportamento previsto di SKAdNetwork corrispondente alla risposta all'offerta:

• Quando l'app pubblicizzata viene installata entro 24 ore dalla visualizzazione dell'annuncio per almeno tre secondi, all'inserzionista viene inviata la notifica di postback dell'attribuzione view-through di SKAdNetwork.
• Quando l'annuncio viene selezionato, viene mostrato un overlay dello store integrato dell'app pubblicizzata e, se l'utente installa e apre l'app pubblicizzata, viene inviata all'inserzionista la notifica di postback dell'attribuzione clickthrough di SKAdNetwork.

Aumenta l'attribuzione con SKOverlay

Puoi aumentare l'attribuzione per gli annunci con rendering StoreKit che pubblichi mostrando un SKOverlay quando è supportato. Un SKOverlay consente all'app del publisher di visualizzare un overlay che permette agli utenti di scaricare l'app pubblicizzata senza uscire dall'app del publisher. Per scoprire di più su SKOverlay, consulta SKOverlay.

Quando sono soddisfatte tutte le seguenti condizioni, ricevi l'attribuzione per l'installazione dell'app pubblicizzata:

• L'SKOverlay viene visualizzato per almeno tre secondi.
• L'app pubblicizzata viene installata entro 30 giorni dalla visualizzazione di SKOverlay.
• Il tuo SKOverlay è stato l'ultimo visualizzato prima dell'installazione dell'app pubblicizzata.

Google supporta SKOverlay per snippet HTML e creatività video VAST inserite in annunci interstitial o con premio.

Determina se SKOverlay è supportato

Quando ricevi una richiesta di offerta, puoi scoprire se SKOverlay è supportato controllando il valore del campo BidRequest.imp.ext.skadn.skoverlay. SKOverlay è supportato nei casi in cui il campo skoverlay è impostato su true per gli endpoint di offerta che utilizzano il formato Protobuf OpenRTB o su 1 per gli endpoint di offerta che utilizzano il formato JSON OpenRTB.

Posiziona l'annuncio con un SKOverlay

Quando SKOverlay è supportato, puoi specificare il campo BidResponse.seatbid.bid.ext.skadn.skoverlay per indicare che vuoi visualizzare un SKOverlay. Il campo skoverlay ha i seguenti attributi:

• delay: un numero intero che rappresenta il ritardo in secondi tra la visualizzazione dell'annuncio e quella di SKOverlay. Per le creatività video, l'ora di visualizzazione è l'ora in cui inizia la riproduzione del video. Se questo campo non è impostato, l'SKOverlay non viene mostrato.
• endcarddelay: un numero intero che rappresenta il ritardo in secondi tra il momento in cui viene visualizzata la cartolina finale di una creatività video e il momento in cui viene visualizzato l'SKOverlay. Se questo campo non è impostato, l'SKOverlay non verrà mostrato dopo la cartolina finale. Applicabile solo alle creatività video VAST inserite in annunci interstitial o con premio.
• dismissible: un valore booleano che indica se l'utente può ignorare l'SKOverlay.

L'esempio seguente mostra una risposta all'offerta:

{
  // OMITTED...
  "seatbid": [
    {
      "bid": [
        {
          // OMITTED...
          "ext": {
            // OMITTED...
            "skadn": {
              // OMITTED...
              "itunesitem": "422689480",
              "skoverlay": {
                "delay": 5,
                "endcarddelay": 0
              },
              "productpageid": "some_id"
            }
          }
        }
      ]
    }
  ]
}

Esamina il comportamento previsto di SKOverlay

Di seguito è riportato il comportamento previsto di SKOverlay corrispondente alla risposta all'offerta precedente:

• Mostra l'SKOverlay cinque secondi dopo l'inizio del video.
• Mostra l'SKOverlay immediatamente dopo la cartolina finale.

• Apri l'app store quando l'utente fa clic su SKOverlay.

• Se viene specificato BidResponse.seatbid.bid.ext.skadn.productpageid, i dati della scheda dell'app nell'SKOverlay corrispondono all'icona nella pagina di prodotto personalizzata.

• Per le creatività video VAST, quando un utente fa clic sull'overlay SDK, viene inviato un ping agli URL di clickthrough e di monitoraggio dei clic.

• Per le creatività video VAST, anche se un utente chiude l'SKOverlay durante il video, l'SKOverlay viene comunque mostrato dopo la cartolina finale se il campo BidResponse.seatbid.bid.ext.skadn.skoverlay.endcarddelay è impostato.