追加の識別子について

AppsFlyer Audiencesは、カスタムオーディエンスを広告パートナーに送信するための以下のデバイス識別子を自動的にサポートします。

• iOS:IDFA
• Android (Google Play):GAID
• Android（サードパーティのアプリストア）:OAIDとIMEI

一部の広告パートナーは、追加のユーザー識別子に基づくカスタムオーディエンスのマッチングもサポートしています。オーディエンスでは、AppsFlyer SDKまたはS2SモバイルAPIを利用してこれらの識別子を特別に設定した場合に、これらを使用する選択肢を提供します。

これらの追加識別子には電話番号やメールが含まれますが、SHA256ハッシュで暗号化されている場合に限り利用できます。  これらの追加の識別子の使用には、Additional Identifiers Terms of Use（追加識別子の利用規約）への同意が必要です。

次のステップ

1. 使用したい追加識別子を利用可能な識別子の表から選択します。すべての広告パートナーがすべての識別子をサポートするわけではありませんので、ご注意ください。
2. デベロッパー—以下の方法で選択した識別子を設定します。
   • 利用可能な識別子の表に記載されているパラメーターおよびフォーマット要件
   • SDKおよびS2Sのリファレンスおよびコードサンプル
3. オーディエンス管理画面で:
   • アカウントレベルのユーザー識別子ポリシーを設定します
   • 各パートナー接続でアップロードする識別子を選択します

利用可能な識別子

以下の表に示されているように、1つ以上の識別子を設定できます。

SDKリファレンスとコードサンプル

SDKを介してオーディエンスの識別子を送信する場合:

• ハッシュ化されたメールアドレスや電話番号以外の識別子には、setAdditionalData 。
• ハッシュ化されたメールアドレスにはを使用してください。
  • SDK v7.0.1以降:setUserEmail 。
  • SDK v7.0.0以前: 使用setUserEmails。
• ハッシュ化された電話番号の場合：
  • SDK v7.0.1以降:setUserPhone （推奨）。
  • SDK v7.0.0以前: 使用setAdditionalDataカスタムデータを使用。

NSDictionary *customData = @{
  @"audiences": @{
    @"phone_number_sha256": @"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
    @"phone_number_e164_sha256":@"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
  }
};
[[AppsFlyerLib shared] setAdditionalData:customData];

let customData: Dictionary = [
  "audiences" : [
    "phone_number_sha256":"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
    "phone_number_e164_sha256":"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
  ]
] 
AppsFlyerLib.shared().customData = customData

- (void)setUserPhone:(NSString *_Nonnull)countryCode
phoneNumber:(NSString *_Nonnull)phoneNumber;

[[AppsFlyerLib shared] setUserPhone:@"1" phoneNumber:@"(650) 555-1212"];

AppsFlyerLib.shared().setUserPhone(countryCode: "1", phoneNumber: "(650) 555-1212")

- (void)setUserEmails:(NSArray<NSString *> *_Nullable)userEmails 
withCryptType:(EmailCryptType)type;

NSArray *emails = @[@"name@domain.com"];    
[[AppsFlyerLib shared] setUserEmails:emails withCryptType:EmailCryptTypeSHA256];

let emails: Array = ["name@domain.com"]
AppsFlyerLib.shared().setUserEmails(emails, with: EmailCryptTypeSHA256)

- (void)setUserEmail:(NSString *_Nonnull)email;

[[AppsFlyerLib shared] setUserEmail:@"name@domain.com"];

AppsFlyerLib.shared().setUserEmail("name@domain.com")

HashMap<String, Object> audiences = new HashMap<>();
audiences.put("phone_number_sha256", "6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37");
audiences.put("phone_number_e164_sha256", "F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E");
HashMap<String, Object> customDataMap = new HashMap<>();
customDataMap.put("audiences", audiences);
AppsFlyerLib.getInstance().setAdditionalData(customDataMap);

val audiences = hashMapOf<String, Any>(
   "phone_number_sha256" to "6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37",
   "phone_number_e164_sha256" to "F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E"
)
val customDataMap = hashMapOf<String, Any>("audiences" to audiences)
AppsFlyerLib.getInstance().setAdditionalData(customDataMap)

public abstract void setUserPhone(String countryCode, String phoneNumber);

AppsFlyerLib.getInstance().setUserPhone("1", "(650) 555-1212");

AppsFlyerLib.getInstance().setUserPhone("1", "(650) 555-1212")

public abstract void setUserEmails(
  AppsFlyerProperties.EmailsCryptType cryptMethod,
  String... emails
);

AppsFlyerLib.getInstance().setUserEmails(
  AppsFlyerProperties.EmailsCryptType.SHA256,
  "name@domain.com",
  "another_name@another_domain.com"
);

AppsFlyerLib.getInstance().setUserEmails(
  AppsFlyerProperties.EmailsCryptType.SHA256,
  "name@domain.com",
  "another_name@another_domain.com"
);

public abstract void setUserEmail(String email);

AppsFlyerLib.getInstance().setUserEmail("name@domain.com");

S2Sリファレンスとコードサンプル

S2Sを経由してオーディエンスの識別子を送信する場合、すべての識別子（ハッシュ化されたメールアドレスも含む）にはパラメータを使用してください。1つ以上の識別子を送信できます。

"custom_data" : { 
      \"audiences\" : { 
          \"parameter_name_a\" : \"hashed_identifer_a\",
          \"parameter_name_a\" : \"hashed_identifer_b\",
          \"parameter_name_c\" : \"hashed_identifer_c\" 
       }
 }

"custom_data" : {
     \"audiences\" : { 
         \"phone_number_sha256\" : \"6C91C4C640F6EF0162833260DB4F13DEC0DF2B683092F4DBA7E874BEF1ACEA37\",
         \"phone_number_e164_sha256\" : \"F3D7E96C73FB0DE1B66ACFCE541D7AF758FBD4F3FA3AF0EA4E10110000D3625E\",
         \"email_sha256\"         : \"34D31BE18022626DE6B311D6A76E791176D2691B6EEF406F524D8F56364C187A\"
     }
}

• Additional Identifiers Terms of Use.pdf100 KB