Integrare la Libreria Install Referrer di Google Play nella tua app
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Prendi decisioni di marketing informate identificando i canali di acquisizione degli utenti di maggior valore per il tuo gioco. Utilizza l'API Install Referrer di Google Play per monitorare in modo affidabile le informazioni sui referral delle tue app.
Monitorando i dati dei referral, puoi capire quali sorgenti di traffico inviano la maggior parte degli utenti a scaricare la tua app dal Google Play Store. Questi approfondimenti possono aiutarti a sfruttare al meglio la spesa pubblicitaria e a massimizzare il ROI.
Passaggio 1: inserisci il link alla pagina della tua scheda dello Store
Per iniziare, collega gli utenti alla pagina del Google Play Store della tua applicazione. Nell'URL includi i parametri di query per:
id: il nome del pacchetto Google Play del tuo gioco
referrer: una stringa che rappresenta la sorgente di referral. È possibile eseguire query su questo valore
una volta installata e in esecuzione l'applicazione.
Passaggio 2: esegui una query sui dettagli del referrer all'avvio dell'app
Una volta che l'utente ha completato l'installazione del gioco e lo ha avviato, la tua app può determinare la sorgente di traffico che ha generato l'installazione utilizzando le API Install Referrer.
Esegui una query sui dettagli del referrer utilizzando
InstallReferrerClient::GetInstallReferrer. Nella risposta è possibile recuperare la stessa stringa passata al parametro di query referrer della pagina della scheda dello Store. I dettagli del referrer possono quindi essere collegati ai dati raccolti da Analytics, ad esempio un evento di installazione di app.
autopromise=std::make_shared<std::promise<GetInstallReferrerResult>>();install_referrer_client.GetInstallReferrer(params,[promise](GetInstallReferrerResultresult){promise->set_value(std::move(result));});autoget_install_referrer_result=promise->get_future().get();if(get_install_referrer_result.ok()){autoinstall_referrer=get_install_referrer_result.value().install_referrer;// Attribute your game's installation to an acquisition channel by including// the install referrer. Typically this would be done by logging an app// install event with an analytics library of your choice that includes the// `install_referrer`.}
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-07-26 UTC."],[],[],null,["# Integrate the Google Play Install Referrer Library into your app\n\nMake informed marketing decisions by identifying your most valuable user\nacquisition channels for your game. Use the Google Play Install Referrer API for\na reliable way to track your apps' referral information.\n\nBy tracking referral data, you can understand which traffic sources send the\nmost users to download your app from the Google Play store. These insights can\nhelp you make the most of your advertising spend and maximize ROI.\n\nPrerequisites\n-------------\n\n- Complete the [SDK setup](/games/playgames/native-pc/setup).\n\n**Step 1**: Link to your store listing page\n-------------------------------------------\n\nStart by linking your users to your application's Google Play store page. In the\nURL include query params for:\n\n- `id`: The Play package name of your game\n- `referrer`: A string representing the referral source. This can be queried once your application is installed and running.\n\n https://play.google.com/store/apps/details?id=\u003cvar translate=\"no\"\u003ecom.example.package\u003c/var\u003e&referrer=\u003cvar translate=\"no\"\u003eexample_referrer_source\u003c/var\u003e\n\n**Step 2**: Query the referrer details on app startup\n-----------------------------------------------------\n\n| **Note:** The referrer will be available for 90 days after the installation of your game.\n\nOnce the user has completed the installation of game and launched it your app\ncan determine the traffic source that led to the installation using the Install\nReferrer APIs.\n\nQuery the referrer details using\n[`InstallReferrerClient::GetInstallReferrer`](/games/playgames/native-pc/reference/class/google/play/install-referrer/install-referrer-client#getinstallreferrer). In the\nresponse the same string passed into the `referrer` query param of your store\nlisting page can be retrieved. The referrer details can then be attached\nanalytics collected such as an app installed event. \n\n auto promise = std::make_shared\u003cstd::promise\u003cGetInstallReferrerResult\u003e\u003e();\n install_referrer_client.GetInstallReferrer(params, [promise](GetInstallReferrerResult result) {\n promise-\u003eset_value(std::move(result));\n });\n\n auto get_install_referrer_result = promise-\u003eget_future().get();\n if (get_install_referrer_result.ok()) {\n auto install_referrer = get_install_referrer_result.value().install_referrer;\n // Attribute your game's installation to an acquisition channel by including\n // the install referrer. Typically this would be done by logging an app\n // install event with an analytics library of your choice that includes the\n // `install_referrer`.\n }"]]