Native PC C++
리포지토리에 연결
GitHub
AppsFlyer Native PC C++ SDK integration
앱스플라이어는 크로스 플랫폼 어트리뷰션, 모바일 및 웹 분석, 딥링킹, 사기 탐지, 개인 정보 관리 및 보존 등을 포함하여 실제 문제를 해결하는 강력한 도구를 제공하여 게임 마케터가 더 나은 결정을 내릴 수 있도록 지원합니다.
Game attribution requires the game to communicate with AppsFlyer APIs over HTTPS and report user activities like first opens, consecutive sessions, and in-app events. For example, purchase events.
We recommend you use this sample app as a reference for integrating the code that reports user activities in your C++.
Note: The sample code that follows is currently only supported in a Windows environment.
Prerequisites
vcpkg openssl & nlohmann-json packages:
vcpkg install curl:x86-windows
vcpkg install nlohmann-json:x86-windows
vcpkg install openssl:x86-windows
AppsflyerLauncherModule - 인터페이스
AppsflyerLauncherModule.h
는 appsflyer-module
폴더에 있으며 앱스플라이어 서버에 연결하고 이벤트를 리포트하는 데 필요한 코드 및 논리가 포함되어 있습니다.
Init
이 메서드는 API 키와 앱 ID를 수신하고 앱스플라이어 모듈을 초기화합니다.
Method signature
void Init(const char* devkey, const char* appID)
Usage:
AppsflyerLauncherModule()->Init(<< DEV_KEY >>, << APP_ID >>);
Arguments:
APP_ID
: Your app id (excluding thenativepc-
제외).DEV_KEY
: 마케터 또는 앱스플라이어 본사에서 얻을 수 있습니다.
Start
이 메서드는 앱스플라이어에 first open/session 요청을 보냅니다.
Method signature
void Start(bool skipFirst = false)
인수
bool skipFirst
: Determines whether or not to skip first open events and send session events. The value is false by default. If true , first open events are skipped and session events are sent. See example
Usage:
// without the flag
AppsflyerLauncherModule()->Start();
// with the flag
bool skipFirst = [SOME_CONDITION];
AppsflyerLauncherModule()->Start(skipFirst);
Stop
This method stops the SDK from functioning and communicating with AppsFlyer servers. It's used when implementing user opt-in/opt-out.
Method signature
void Stop()
Usage:
// Starting the SDK
AppsflyerLauncherModule()->Start();
// ...
// Stopping the SDK, preventing further communication with AppsFlyer
AppsflyerLauncherModule()->Stop();
LogEvent
이 메서드는 이벤트 이름과 JSON 객체를 수신하고 앱스플라이어에 인앱이벤트를 보냅니다.
Method signature
void LogEvent(std::string event_name, json event_values, json custom_event_values = {})
인수
std::string event_name
-json event_parameters
: dictionary object which contains the predefined event parameters.json event_custom_parameters
(non-mandatory): dictionary object which contains the any custom event parameters. For non-English values, please use UTF-8 encoding.
Usage:
// Setting the event values json and event name
std::string event_name = "af_purchase";
json event_parameters = { {"af_currency", "USD"}, {"af_revenue", 24.12} };
// Send LogEvent request
AppsflyerLauncherModule()->LogEvent(event_name, event_parameters);
// Send LogEvent request with custom event params and UTF8 encoding (for non-English characters)
std::wstring ws = L"車B1234 こんにちは";
std::wstring ws2 = L"新人邀约购物日";
json custom_event_parameters = {
{"goodsName", AppsflyerLauncherModule()->to_utf8(ws)},
{"goodsName2", AppsflyerLauncherModule()->to_utf8(ws2)}
};
AppsflyerLauncherModule()->LogEvent(event_name, event_parameters, custom_event_parameters);
참고: JSON을 사용하려면 다음 가져오기를 사용해야 합니다.
#include <nlohmann/json.hpp>
using json = nlohmann::json;
SetCustomerUserId
This method sets a customer ID that enables you to cross-reference your unique ID with the AppsFlyer unique ID and other device IDs. Note: You can only use this method before calling Start()
.
The customer ID is available in raw data reports and in the postbacks sent via API.
Method signature
void SetCustomerUserId(std::string cuid)
Arguments:
std::string cuid
: Custom user id.
Usage:
AppsflyerLauncherModule()->Init(DEV_KEY, APP_ID);
AppsflyerLauncherModule()->SetCustomerUserId("Test-18-9-23");
AppsflyerLauncherModule()->Start();
OnCallbackSuccess, OnCallbackFailure
상기의 메서드는 성공/실패 시 원하는 작업에 대한 자리 표시자입니다.
각 함수 내에서 컨텍스트의 switch case를 사용하여 다양한 유형의 이벤트를 처리할 수 있습니다("FIRST_OPEN_REQUEST", "SESSION_REQUEST", "INAPP_EVENT_REQUEST").
Method signature
void OnCallbackSuccess(long responseCode, uint64 context)
void OnCallbackFailure(long responseCode, uint64 context)
GetAppsFlyerUID
앱스플라이어의 고유 기기 ID를 가져옵니다. SDK는 앱 설치 시 앱스플라이어의 고유 기기 ID를 생성합니다. SDK가 시작되면 이 ID가 첫 번째 앱 인스톨의 ID로 기록됩니다.
Method signature
std::string GetAppsFlyerUID()
Usage:
AppsflyerLauncherModule()->GetAppsFlyerUID();
To_utf8
This method receives a reference of a std::wstring
and returns UTF-8 encoded std::string
Method signature
std::string to_utf8(std::wstring& wide_string);
Usage:
std::wstring ws = L"車B1234 こんにちは";
std::wstring ws2 = L"新人邀约购物日";
custom_event_parameters = {
{"goodsName", AppsflyerLauncherModule()->to_utf8(ws)},
{"goodsName2", AppsflyerLauncherModule()->to_utf8(ws2)}
};
IsInstallOlderThanDate
This method receives a date string and returns true if the game exe modification date is older than the date string. The date string format is: "2023-January-01 23:12:34"
Method signature
bool IsInstallOlderThanDate(std::string datestring)
Arguments:
std::string datestring
: Date string inyyyy-mm-ddThh:mm:ss+hh:mm
format.
Usage:
// the modification date in this example is "2023-January-23 08:30:00"
// will return false
bool dateBefore = AppsflyerLauncherModule()->IsInstallOlderThanDate("2023-January-01 23:12:34");
// will return true
bool dateAfter = AppsflyerLauncherModule()->IsInstallOlderThanDate("2023-April-10 23:12:34");
// example usage with skipFirst -
// skipping if the install date is NOT older than the given date
bool isInstallOlderThanDate = AppsflyerLauncherModule()->IsInstallOlderThanDate("2023-January-10 23:12:34");
AppsflyerLauncherModule()->Start(!isInstallOlderThanDate);
샘플 앱 실행
- Visual Studio를 설치합니다.
- 솔루션을 엽니다.
- 이
AppsflyerSampleApp.cpp
file. - On line 110, replace
DEV_KEY
andAPP_ID
을 앱 세부 정보로 교체합니다. - 상단 도구 모음에서 재생 (로컬 Windows 디버거)을 클릭하여 앱을 실행합니다. 모드가 디버그로 설정되어 있는지 확인하십시오.
- 24시간 후 대시보드가 업데이트되고 오가닉 및 논오가닉 인스톨과 인앱이벤트가 표시됩니다.
앱스플라이어를 C++ 앱에 구현하기
Setup
- 이
appsflyer-module
파일을 헤더 파일 > 앱스플라이어의 C++ 프로젝트로 복사합니다. - 모듈을 가져옵니다.
#include "AppsflyerLauncherModule.h"
- 가져오기
nlohmann-json
:
#include <nlohmann/json.hpp>
using json = nlohmann::json;
Resetting the attribution
Remove the registry data from SOFTWARE\Microsoft\Windows\CurrentVersion\Run
. The Registry keys are AF_counter_[APPID]
and AF_uuid_[APPID]
.
Deleting AppsFlyer data on uninstall
When uninstalling your app, please make sure to remove the registry data from SOFTWARE\Microsoft\Windows\CurrentVersion\Run
. The Registry keys are AF_counter_[APPID]
and AF_uuid_[APPID]
.
최신 데이터 5개월 전