オーディエンス - 追加の識別子

概要:カスタムオーディエンスを広告パートナーに送信するための追加のユーザー識別子を設定します。

追加の識別子について

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

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

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

これらの追加識別子には電話番号やメールが含まれますが、SHA256ハッシュで暗号化されている場合に限り利用できます。  このような追加識別子の使用は、追加識別子利用規約に従う必要があります。

次のステップ

  1. 使用したい追加識別子を利用可能な識別子の表から選択します。すべての広告パートナーがすべての識別子をサポートするわけではありませんので、ご注意ください。
  2. デベロッパー以下の方法で選択した識別子を設定します。
  3. オーディエンス管理画面で:

利用可能な識別子

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

追加の識別子パラメーターとフォーマット

識別子 パラメーター名 形式 ハッシュ化前の例となる値
メールアドレス email_sha256
  • 小文字
  • 空白なし
  • SHA256ハッシュ済み
name@domain.com
電話番号
(下記注意参照)
電話番号_sha256
  • 記号、文字、先頭のゼロを含めない
  • 国コードを含める
  • SHA256ハッシュ済み
442070313000

電話番号 E164

(下記注意参照)

電話番号_e164_sha256
  • E164電話番号
  • SHA256ハッシュ済み
+442070313000

注意 

異なる広告パートナーは異なる電話番号形式をサポートしています。したがって、電話番号を利用する場合は、両方の識別子を設定してください。電話番号電話番号 E164。

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

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

  • ハッシュ化されていないメールアドレス以外の識別子にはを使用してください。
  • ハッシュ化されたメールアドレスにはを使用してください。

iOS SDKの設定

ハッシュ化された電話番号を追加のユーザー識別子として設定するには:

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

ハッシュ化されたメールアドレスを追加のユーザー識別子として設定するには:

メソッドシグネチャ

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

使用例

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

Android SDKの設定

ハッシュ化された電話番号を追加のユーザー識別子として設定するには:

Java Kotlin
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);

ハッシュ化されたメールアドレスを追加のユーザー識別子として設定するには:

メソッドシグネチャ

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

使用例

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

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

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

S2S経由で識別子を送信する

形式:

  • ネストされたJSON
  • キーの値はaudiencesでなければなりません
  • すべての値は、以下のコード例に示すように文字列化する必要があります。
  • パラメータ名は、上記のに記載されている利用可能な識別子と一致する必要があります。

一般的な形式:

"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\" } }