Integrar a biblioteca Play Install Referrer ao seu app
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Tome decisões de marketing mais informadas identificando seus canais de aquisição de usuários
mais valiosos para o jogo. Use a API Google Play Install Referrer para
rastrear de forma confiável as informações de referência dos seus apps.
Ao acompanhar os dados de referência, você pode entender quais fontes de tráfego enviam a
maior parte dos usuários para fazer o download do app na Google Play Store. Esses insights podem
ajudar você a aproveitar ao máximo seus gastos com publicidade e maximizar o ROI.
Etapa 2: consultar os detalhes do referenciador na inicialização do app
Depois que o usuário concluir a instalação do jogo e o iniciar, seu app
poderá determinar a origem do tráfego que levou à instalação usando as APIs
Install Referrer.
Consulte os detalhes do referenciador usando
InstallReferrerClient::GetInstallReferrer. Na
resposta, a mesma string transmitida para o parâmetro de consulta referrer da página de
detalhes da loja pode ser recuperada. Os detalhes do referrer podem ser anexados
às informações de análise coletadas, como um evento de instalação de 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`.}
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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 }"]]