TPStashEvent.WatchAd

public int WatchAd(
    string player_uuid,
    string character_uuid,
    string ad_slug,
    adType ad_type,
    adPlacement placed_at,
    adStatus ad_status,
    [string placed_at_slug = null]
);

説明

アプリ内の広告に関するデータを収集します。広告の表示・再生・終了などのイベントが発生すると必ず呼び出されるメソッドであり、広告視聴と関係している分析モデルに使用されます。

データのアップロードに成功した場合1をリターンし、成功できなかった場合には-1をリターンします。-1リターンとなった場合TentuPlay debug modeに設定されている状態でUnity Editorを使用している場合、Unity Editorコンソールから以下のメッセージが表示されます。

TPError||ERROR inserting table_name: exception_error_message

パラメータ

名前説明必須か

player_uuid

プレイヤーの固有ID

必須

character_uuid

プレイヤー内キャラクターの固有ID

ゲームにキャラクターがない、もしくはキャラクターではなくプレイヤーを示す場合にはTentuPlayKeyword._DUMMY_CHARACTER_ID_に設定します。

必須

ad_slug

広告の固有識別子

必須

ad_type

広告の種類

public enum adType {
    Interstitial, // 全面広告
    Reward, // 報酬型広告
}

必須

placed_at

広告を視聴するタイミング

エンティティー

public enum adPlacement {
    Etc,
    Join,
    LoginApp,
    LoginAsCharacter,
    InAppPurchase,
    ShopPurchase,
    Trade,
    PlayQuest,
    GetBonus,
    ChangeCharacterArchetype,
    ChangeStat,
    ChangeCustomAbility,
    PlayStage,
    GetCharacter,
    GetInfrastructure,
    GetPet,
    GetToken,
    GetConsumable,
    GetMaterial,
    GetEquipment,
    GetCostume,
    GetRandomBox,
    EquipInfrastructure,
    EquipPet,
    UseToken,
    UseConsumable,
    UseMaterial,
    EquipEquipment,
    EquipCostume,
    OpenRandomBox,
    EquipSkill,
    DismissCharacter,
    DismissInfrastructure,
    DismissPet,
    DismissToken,
    DismissConsumable,
    DismissMaterial,
    DismissEquipment,
    DismissCostume,
    DismissRandomBox,
    LevelUpCharacter,
    LevelUpInfrastructure,
    LevelUpPet,
    LevelUpConsumable,
    LevelUpMaterial,
    LevelUpEquipment,
    LevelUpCostume,
    LevelUpSkill,
    Deposit,
    Withdraw,
    FinishedTutorial,
}

必須

ad_status

広告のステータス

public enum adStatus {
    Ready,
    Start,
    Quit,
    End
}

Ready: クールタイム終了などでプレイヤーに広告が表示される
Start: 広告視聴を開始
Quit: 途中で広告視聴を終了（中断）
End: 広告視聴を完了

必須

placed_at_slug

広告を視聴するタイミングの詳細

オプション

«InAppPurchase

PlayQuest»