adjust-icon

SKAdNetwork 및 전환값 설정

SKAdNetwork(StoreKit Ad Network)는 앱 설치와 재설치를 어트리뷰션하는 Apple의 자체 어트리뷰션 프레임워크입니다. SKAdNetwork 워크플로우는 다음과 같습니다.

  1. Apple은 어트리뷰션 정보를 수집하고, 관련 광고 네트워크에게 이를 알립니다.
  2. 네트워크는 Adjust에 해당 정보와 함께 포스트백을 전송합니다.
  3. Adjust는 SKAdNetwork 데이터를 Datascape과 Data Canvas에 표시합니다.

SKAdNetwork 커뮤니케이션 비활성화

메서드 서명
void deactivateSkAdNetworkHandling();

Adjust SDK v4.23.0 및 이상 버전에서는 기본값에 따라 SKAdNetwork와 정보를 주고 받습니다.SDK는 초기화 시 SKAdNetwork의 어트리뷰션을 기록합니다.

config 객체에는 해당 동작을 제어하는 boolean isSKAdNetworkHandlingActive 속성이 포함되어 있습니다. 인수 없이 deactivateSKAdNetworkHandling 메서드를 호출하여 SKAdNetwork 커뮤니케이션을 비활성화할 수 있습니다.

AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment, false);
adjustConfig.deactivateSKAdNetworkHandling();
Adjust2dx::start(adjustConfig);

전환값 업데이트

메서드 서명
static void updateConversionValue(int conversionValue);

전환값은 SKAdNetwork에서 사용자 행동 트래킹에 사용되는 메커니즘입니다. 64개의 조건을 0에서 63 사이의 값에 매핑하여 설치에 대해 이 정수 값을 SKAdNetwork로 전송할 수 있습니다. 이를 통해 처음 며칠간 사용자의 앱 이용에 관한 통찰력을 얻을 수 있습니다.

Adjust에서 전환값을 관리하는 경우 서버는 SDK에서 이 값을 업데이트합니다. updateConversionValue 메서드를 사용하여 이 값을 업데이트할 수도 있습니다. 이 메서드는 Apple의 updateConversionValue 메서드를 래핑하고 업데이트된 전환값을 나타내는 정수로된 인수를 받아들입니다.

Adjust2dx::updateConversionValue(6);

예시

이 예시에서는 사용자가 이벤트를 트리거함에 따라 전환값을 10으로 업데이트하는 방법을 보여줍니다.

bool HelloWorld::init() {
    auto position =
            Vec2(origin.x + visibleSize.width / 2,
                 origin.y + visibleSize.height - label->getContentSize().height
                 + offset
                 - divide * (++index));
    makeButton(mainmenu, "Update conversion value", position,
               CC_CALLBACK_1(HelloWorld::onUpdateCv, this));
}


void HelloWorld::onUpdateCv(cocos2d::Ref *pSender) {
    Adjust2dx::updateConversionValue(6);
}

전환값 변경 사항 수신

메서드 서명
void setConversionValueUpdatedCallback(void(*callbackMethod)(int conversionValue));

전환값 관리에 Adjust 솔루션을 사용하는 경우, Adjust 서버는 전환값 업데이트를 SDK에 전송합니다. setConversionValueUpdatedCallback 메서드를 사용하면 콜백 함수를 설정하여 이러한 업데이트를 수신할 수 있습니다. 함수를 인수로 전달합니다.

AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment, false);
adjustConfig.setConversionValueUpdatedCallback(conversionValueUpdatedCallbackMethod);
Adjust2dx::start(adjustConfig);

예시

이 예시에서는 전환값이 업데이트될 때 다음 항목을 로깅하는 방법을 보여줍니다.

  • 전환값 업데이트 확인 메세지
  • 새로운 전환값
#include "Adjust/Adjust2dx.h"


bool AppDelegate::applicationDidFinishLaunching() {
    std::string appToken = "{YourAppToken}";
    std::string environment = AdjustEnvironmentSandbox2dx;


    AdjustConfig2dx adjustConfig = AdjustConfig2dx(appToken, environment);
    adjustConfig.setLogLevel(AdjustLogLevel2dxVerbose);
    adjustConfig.setPostbackConversionValueUpdatedCallback([](int conversionValue) {
        std::cout << "\nConversion value updated. Callback received";
        std::cout << "\nConversion value: " << conversionValue;
    });
    Adjust2dx::start(adjustConfig);
}