Skip to content

Commit 282f2e4

Browse files
committed
Copy the en snippet file and translate it as necessary.
1 parent ee99c91 commit 282f2e4

15 files changed

+249
-50
lines changed
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
```
2+
A4AAAABlh75XmviGJi-hkLGs96duivRhMd3a3pe7yTIwbAHudfB9wFTj2FtJTdMW5TXXd1KAb-Z3ekQ_KImZ5Mi7xP75jRNeD6Mt6opWwXCCpQxYejP0R6WnCGnWawx9rLu59LsHv6YEA_ARNIUUl9koobfA9pLmnxE3dRedDgCKm4xHXYk01Fr8rOts6iJj2AhYISR3XkyBpqzT-vqBjsHH0g
3+
```
Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
import Tabs from '@theme/Tabs';
2+
import TabItem from '@theme/TabItem';
3+
4+
<Tabs>
5+
<TabItem value='js' label='JavaScript'>
6+
7+
```js
8+
window.__uid2 = window.__uid2 || {};
9+
window.__uid2.callbacks = window.__uid2.callbacks || [];
10+
11+
// Step 1-f
12+
window.__uid2.callbacks.push((eventType, payload) => {
13+
if (eventType === 'SdkLoaded') {
14+
__uid2.init({
15+
identity : {
16+
"advertising_token": "A4AAAABlh75XmviGJi-hkLGs96duivRhMd3a3pe7yTIwbAHudfB9wFTj2FtJTdMW5TXXd1KAb-Z3ekQ_KImZ5Mi7xP75jRNeD6Mt6opWwXCCpQxYejP0R6WnCGnWawx9rLu59LsHv6YEA_ARNIUUl9koobfA9pLmnxE3dRedDgCKm4xHXYk01Fr8rOts6iJj2AhYISR3XkyBpqzT-vqBjsHH0g",
17+
"identity_expires": 1724899014352,
18+
"refresh_expires": 1724981814352,
19+
"refresh_from": 1724896314352,
20+
"refresh_response_key": "TS0H0szacv/F3U8bQjZwjSaZJjxZbMvxqHn1l3TL/iY=",
21+
"refresh_token": "AAAAAGYzgUszke2sV9CxXnxyFfUU+KDCJUCXNbj1/FVcCjvR7K07jYaWe44wxM6SOTwG7WQB4XfIcquMqH57iHUnAu1zacYf9g58BtbhKCYWTwrdpB0fSqTANBXOYy+yBnl6tLRwVv32LqRCj76D8meO4tw+MKlUAc2EoFzFNPSfZLpA3Jk4q68vH6VJH/WIuu1tulrVm5J8RZAZnmTlEcsPdjoOC6X4w3aAwiwtbeGw7yOO0immpVoC5KaXnT9olRPTlrt8F9SvebLIcqkYhvRMPpl1S89yeneyGo++RnD9qSHIrfu9To3VwYW018QuvyA15uv4No4BoAzyPuHqzQ8gAs6csWwZ7VwfYD7DSJXlQiIpwzjA2Hl8mgg/5fcXwKEJ"
22+
}
23+
});
24+
}
25+
});
26+
27+
// Step 1-g
28+
window.__uid2.callbacks.push((eventType, payload) => {
29+
if (eventType !== 'SdkLoaded') {
30+
if (payload.identity) {
31+
const advertisingToken = payload.identity.advertising_token;
32+
// Pass advertising_token to your advertising system to use
33+
} else {
34+
// No identity is available. Trigger a workflow for obtaining email address or phone number if you want to use UID2 for targeted advertising.
35+
}
36+
}
37+
});
38+
```
39+
</TabItem>
40+
<TabItem value='ts' label='TypeScript'>
41+
42+
```tsx
43+
import { EventType, CallbackPayload } from "./callbackManager";
44+
45+
window.__uid2 = window.__uid2 || {};
46+
window.__uid2.callbacks = window.__uid2.callbacks || [];
47+
48+
// Step 1-f
49+
window.__uid2.callbacks.push((eventType: EventType, payload: CallbackPayload) => {
50+
if (eventType === 'SdkLoaded') {
51+
__uid2.init({
52+
identity : {
53+
"advertising_token": "A4AAAABlh75XmviGJi-hkLGs96duivRhMd3a3pe7yTIwbAHudfB9wFTj2FtJTdMW5TXXd1KAb-Z3ekQ_KImZ5Mi7xP75jRNeD6Mt6opWwXCCpQxYejP0R6WnCGnWawx9rLu59LsHv6YEA_ARNIUUl9koobfA9pLmnxE3dRedDgCKm4xHXYk01Fr8rOts6iJj2AhYISR3XkyBpqzT-vqBjsHH0g",
54+
"identity_expires": 1724899014352,
55+
"refresh_expires": 1724981814352,
56+
"refresh_from": 1724896314352,
57+
"refresh_response_key": "TS0H0szacv/F3U8bQjZwjSaZJjxZbMvxqHn1l3TL/iY=",
58+
"refresh_token": "AAAAAGYzgUszke2sV9CxXnxyFfUU+KDCJUCXNbj1/FVcCjvR7K07jYaWe44wxM6SOTwG7WQB4XfIcquMqH57iHUnAu1zacYf9g58BtbhKCYWTwrdpB0fSqTANBXOYy+yBnl6tLRwVv32LqRCj76D8meO4tw+MKlUAc2EoFzFNPSfZLpA3Jk4q68vH6VJH/WIuu1tulrVm5J8RZAZnmTlEcsPdjoOC6X4w3aAwiwtbeGw7yOO0immpVoC5KaXnT9olRPTlrt8F9SvebLIcqkYhvRMPpl1S89yeneyGo++RnD9qSHIrfu9To3VwYW018QuvyA15uv4No4BoAzyPuHqzQ8gAs6csWwZ7VwfYD7DSJXlQiIpwzjA2Hl8mgg/5fcXwKEJ"
59+
}
60+
});
61+
}
62+
});
63+
64+
// Step 1-g
65+
window.__uid2.callbacks.push((eventType: EventType, payload: CallbackPayload) => {
66+
if (eventType !== 'SdkLoaded') {
67+
if (payload.identity) {
68+
const advertisingToken = payload.identity.advertising_token;
69+
// Pass advertising_token to your advertising system to use
70+
} else {
71+
// No identity is available. Trigger a workflow for obtaining email address or phone number if you want to use UID2 for targeted advertising.
72+
}
73+
}
74+
});
75+
```
76+
77+
</TabItem>
78+
</Tabs>
Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
```js
2+
{
3+
"body": {
4+
"advertising_token": "A4AAAABlh75XmviGJi-hkLGs96duivRhMd3a3pe7yTIwbAHudfB9wFTj2FtJTdMW5TXXd1KAb-Z3ekQ_KImZ5Mi7xP75jRNeD6Mt6opWwXCCpQxYejP0R6WnCGnWawx9rLu59LsHv6YEA_ARNIUUl9koobfA9pLmnxE3dRedDgCKm4xHXYk01Fr8rOts6iJj2AhYISR3XkyBpqzT-vqBjsHH0g",
5+
"identity_expires": 1724899014352,
6+
"refresh_expires": 1724981814352,
7+
"refresh_from": 1724896314352,
8+
"refresh_response_key": "TS0H0szacv/F3U8bQjZwjSaZJjxZbMvxqHn1l3TL/iY=",
9+
"refresh_token": "AAAAAGYzgUszke2sV9CxXnxyFfUU+KDCJUCXNbj1/FVcCjvR7K07jYaWe44wxM6SOTwG7WQB4XfIcquMqH57iHUnAu1zacYf9g58BtbhKCYWTwrdpB0fSqTANBXOYy+yBnl6tLRwVv32LqRCj76D8meO4tw+MKlUAc2EoFzFNPSfZLpA3Jk4q68vH6VJH/WIuu1tulrVm5J8RZAZnmTlEcsPdjoOC6X4w3aAwiwtbeGw7yOO0immpVoC5KaXnT9olRPTlrt8F9SvebLIcqkYhvRMPpl1S89yeneyGo++RnD9qSHIrfu9To3VwYW018QuvyA15uv4No4BoAzyPuHqzQ8gAs6csWwZ7VwfYD7DSJXlQiIpwzjA2Hl8mgg/5fcXwKEJ"
10+
},
11+
"status": "success"
12+
}
13+
```
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
```html
2+
<script>
3+
window.__uid2 = window.__uid2 || {};
4+
window.__uid2.callbacks = window.__uid2.callbacks || [];
5+
window.__uid2.callbacks.push((eventType, payload) => {
6+
if (eventType === "SdkLoaded") {
7+
__uid2.init({
8+
identity : { // The `body` property value from the token/generate or token/refresh API response.
9+
"advertising_token": "A4AAAABlh75XmviGJi-hkLGs96duivRhMd3a3pe7yTIwbAHudfB9wFTj2FtJTdMW5TXXd1KAb-Z3ekQ_KImZ5Mi7xP75jRNeD6Mt6opWwXCCpQxYejP0R6WnCGnWawx9rLu59LsHv6YEA_ARNIUUl9koobfA9pLmnxE3dRedDgCKm4xHXYk01Fr8rOts6iJj2AhYISR3XkyBpqzT-vqBjsHH0g",
10+
"identity_expires": 1724899014352,
11+
"refresh_expires": 1724981814352,
12+
"refresh_from": 1724896314352,
13+
"refresh_response_key": "TS0H0szacv/F3U8bQjZwjSaZJjxZbMvxqHn1l3TL/iY=",
14+
"refresh_token": "AAAAAGYzgUszke2sV9CxXnxyFfUU+KDCJUCXNbj1/FVcCjvR7K07jYaWe44wxM6SOTwG7WQB4XfIcquMqH57iHUnAu1zacYf9g58BtbhKCYWTwrdpB0fSqTANBXOYy+yBnl6tLRwVv32LqRCj76D8meO4tw+MKlUAc2EoFzFNPSfZLpA3Jk4q68vH6VJH/WIuu1tulrVm5J8RZAZnmTlEcsPdjoOC6X4w3aAwiwtbeGw7yOO0immpVoC5KaXnT9olRPTlrt8F9SvebLIcqkYhvRMPpl1S89yeneyGo++RnD9qSHIrfu9To3VwYW018QuvyA15uv4No4BoAzyPuHqzQ8gAs6csWwZ7VwfYD7DSJXlQiIpwzjA2Hl8mgg/5fcXwKEJ"
15+
}
16+
});
17+
}
18+
});
19+
</script>
20+
```
Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
```html
2+
<script>
3+
__uid2.init({
4+
callback : onUid2IdentityUpdated,
5+
identity : {
6+
"advertising_token": "A4AAAABlh75XmviGJi-hkLGs96duivRhMd3a3pe7yTIwbAHudfB9wFTj2FtJTdMW5TXXd1KAb-Z3ekQ_KImZ5Mi7xP75jRNeD6Mt6opWwXCCpQxYejP0R6WnCGnWawx9rLu59LsHv6YEA_ARNIUUl9koobfA9pLmnxE3dRedDgCKm4xHXYk01Fr8rOts6iJj2AhYISR3XkyBpqzT-vqBjsHH0g",
7+
"identity_expires": 1724899014352,
8+
"refresh_expires": 1724981814352,
9+
"refresh_from": 1724896314352,
10+
"refresh_response_key": "TS0H0szacv/F3U8bQjZwjSaZJjxZbMvxqHn1l3TL/iY=",
11+
"refresh_token": "AAAAAGYzgUszke2sV9CxXnxyFfUU+KDCJUCXNbj1/FVcCjvR7K07jYaWe44wxM6SOTwG7WQB4XfIcquMqH57iHUnAu1zacYf9g58BtbhKCYWTwrdpB0fSqTANBXOYy+yBnl6tLRwVv32LqRCj76D8meO4tw+MKlUAc2EoFzFNPSfZLpA3Jk4q68vH6VJH/WIuu1tulrVm5J8RZAZnmTlEcsPdjoOC6X4w3aAwiwtbeGw7yOO0immpVoC5KaXnT9olRPTlrt8F9SvebLIcqkYhvRMPpl1S89yeneyGo++RnD9qSHIrfu9To3VwYW018QuvyA15uv4No4BoAzyPuHqzQ8gAs6csWwZ7VwfYD7DSJXlQiIpwzjA2Hl8mgg/5fcXwKEJ"
12+
}
13+
});
14+
</script>
15+
```
Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
```js
2+
{
3+
"user": {
4+
"ext": {
5+
"eids": [
6+
{
7+
"source": "uidapi.com",
8+
"uids": [
9+
{
10+
"id": "A4AAAABlh75XmviGJi-hkLGs96duivRhMd3a3pe7yTIwbAHudfB9wFTj2FtJTdMW5TXXd1KAb-Z3ekQ_KImZ5Mi7xP75jRNeD6Mt6opWwXCCpQxYejP0R6WnCGnWawx9rLu59LsHv6YEA_ARNIUUl9koobfA9pLmnxE3dRedDgCKm4xHXYk01Fr8rOts6iJj2AhYISR3XkyBpqzT-vqBjsHH0g",
11+
"rtiPartner": "UID2"
12+
}
13+
]
14+
}
15+
]
16+
}
17+
}
18+
}
19+
```
Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
```js
2+
{
3+
"advertising_token": "A4AAAABlxUNurwXyIrJ1fc4VIWke6xLqFt7tXdWIJlMIuXHdPOZ4wswrBqiJWeUmduy1pA2c8xePmosknC_6hmr5YFoZ6zKF4K-YwVRib_6uyXZTWLDwS5uz1t-HXi3U84fAqAsGifw4ei7cBvvHLcZksv3Cmm2ejXMrArdwNr7sXPg80mP00xRXK46NmjdY83l5azMa6F-CyFR8cbABOHJCug",
4+
"refresh_token": "AAAAAGZAGDZ+JF/HriTQOEclFWWx27NlLn7x7Xd/079QtQbPYcSHO2ie0SkyGNGvNdglmw1r0A2NIjd2/4mPYlxMAwGYw3s97LWQwZdJtI+M31k0kg0zB/Ob45w+0HK/zWQVJAxx4gp1LmKO6xhIWyLUoXGMcLWFZDcpSB1rKLvTIx1eo7QAtTQieJPoxJTmP4kTX3jX2ClQuwM5sF6TsHoGaBMuYC8OQdOpRlDquEAU3eUikIPPiIYu/dBu2bdqObnxsxBqk00Kanot2oocY9vHcMo0jMEfjb3h6KVqFdkDQMpKDVhlpbw/ROKszsgQ42PXdeCNPa6iMtMdwxcawaLjHbqBbiovZHgdm5GnnQDM1P/mv1L1AqELrC78x8GnADSn",
5+
"identity_expires": 1724907586353,
6+
"refresh_expires": 1724990386353,
7+
"refresh_from": 1724904886353,
8+
"refresh_response_key": "imm/IBMVaoRFVQiCudjwyvGuqEnBC+brxWkCiJQpWgE=",
9+
"private": {
10+
}
11+
}
12+
```

i18n/ja/docusaurus-plugin-content-docs/current/snippets/_mobile-docs-enable-logging.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
import Tabs from "@theme/Tabs";
2-
import TabItem from "@theme/TabItem";
1+
import Tabs from '@theme/Tabs';
2+
import TabItem from '@theme/TabItem';
33

4-
UID2 SDK はログを生成することができ、UID2 インテグレーション作業中の問題のデバッグに役立ちます。ログを有効にするには、以下を実行します:
4+
UID2 SDK はログを生成することができ、UID2 インテグレーションにログを使用して問題をデバッグすることができます。ログを有効にするには、次の手順を実行します:
55

66
<Tabs groupId="language-selection">
77
<TabItem value='android' label='Android'>
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
<!-- Used by: guides/integration-mobile-client-side.md | guides/integration-mobile-client-server.md -->
2+
3+
特定の条件下では、モバイル SDK は次のいずれかのエラー応答状態を返す可能性があります:
4+
5+
- [Expired](#response-state-of-expired)
6+
- [RefreshExpired](#response-state-of-refreshexpired)
7+
- [Invalid](#response-state-of-expired)
8+
- [NoIdentity](#response-state-of-expired)
9+
10+
:::note
11+
レスポンスステータスは、Android iOS の両方で同じです。
12+
:::
13+
14+
### Response State of Expired
15+
16+
`Expired` のレスポンスステータスは、UID2 Token が有効期限切れであることを示しますが、リフレッシュトークンは有効期限切れではないため、UID2 Token をリフレッシュできます。
17+
18+
**Automatic refresh**: SDK で自動リフレッシュが有効になっている場合 (`automaticRefreshEnabled` プロパティ)、SDK がトークンを自動的にリフレッシュします。ただし、この状態が発生する可能性があるいくつかのシナリオがあります。
19+
20+
例えば、アプリが起動され、SDK がすぐにクエリされた場合、レスポンスステータスが `Expired` になる可能性がありますが、バックグラウンドで SDK がトークンをリフレッシュしており、すぐに新しい ID で更新されます。
21+
22+
この場合、何もする必要はありません。SDK が初期化されるとすぐにトークンがリフレッシュされます。
23+
24+
**Manual refresh**: トークンの自動リフレッシュを無効にしている場合、`Expired` のレスポンスステータスが返された場合、`refreshIdentity()` メソッドを呼び出してリフレッシュを手動でリクエストできます。
25+
26+
### Response State of RefreshExpired
27+
28+
`RefreshExpired` のレスポンスステータスは、UID2 Token Refresh Token の両方が有効期限切れであることを示します。そのため、UID2 Token をリフレッシュできません。
29+
30+
このような状況が発生する可能性がある例としては、ユーザーがアプリを長期間実行しない場合、SDK Refresh Token が期限切れになる前に UID2 Token をリフレッシュする機会がない場合があります。
31+
32+
この場合、Identity を再生成する必要があります。
33+
34+
### Response State of Invalid
35+
36+
`Invalid` のレスポンスステータスは、ディスクからロードされたか、API 経由でリクエストされた ID に、必要なすべてのトークンが含まれていないことを示します。これは起こるべきではありませんが、予期しない状況で発生する可能性があります。
37+
38+
SDK がこのエラーを検出すると、以前の ID は使用できないと見なされるため、クリアされます。
39+
40+
この場合、Identity を再生成する必要があります。また、問題を UID2 の連絡先に報告することが望ましいです。
41+
42+
### Response State of NoIdentity
43+
44+
`NoIdentity` のレスポンスステータスは、SDK は初期化されていますが、現在の identity がまだ生成されていないことを示します。
45+
46+
これは、デバイスで初めて SDK が使用される場合に発生します。この場合、identity を生成する必要があります。
Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,32 @@
1-
import Tabs from "@theme/Tabs";
2-
import TabItem from "@theme/TabItem";
1+
import Tabs from '@theme/Tabs';
2+
import TabItem from '@theme/TabItem';
33

4-
[Google GMA SDK](https://developers.google.com/ad-manager/mobile-ads-sdk) または [Google IMA SDK](https://developers.google.com/interactive-media-ads/) に送信する UID2 Token を生成する場合、このガイドに従っていると仮定すると、モバイルアプリに UID2 GMA/IMA プラグインを追加する必要があります。手順については、該当するプラグインガイドを参照してください:
4+
UID2 Token を生成して [Google GMA SDK](https://developers.google.com/ad-manager/mobile-ads-sdk) または [Google IMA SDK](https://developers.google.com/interactive-media-ads/) に送信する場合、このガイドに従っていると仮定して、モバイルアプリに UID2 GMA/IMA プラグインを追加する必要があります。手順については、該当するプラグインガイドを参照してください
55

6-
- [UID2 GMA Plugin for Android Integration Guide](../guides/mobile-plugin-gma-android.md)
7-
- [UID2 GMA Plugin for iOS Integration Guide](../guides/mobile-plugin-gma-ios.md)
8-
- [UID2 IMA Plugin for Android Integration Guide](../guides/mobile-plugin-ima-android.md)
9-
- [UID2 IMA Plugin for iOS Integration Guide](../guides/mobile-plugin-ima-ios.md)
6+
- [UID2 GMA Plugin for Android Integration Guide](../guides/mobile-plugin-gma-android)
7+
- [UID2 GMA Plugin for iOS Integration Guide](../guides/mobile-plugin-gma-ios)
8+
- [UID2 IMA Plugin for Android Integration Guide](../guides/mobile-plugin-ima-android)
9+
- [UID2 IMA Plugin for iOS Integration Guide](../guides/mobile-plugin-ima-ios)
1010

11-
明示的に `getAdvertisingToken()` メソッドを呼び出して Advertising Token を取得し、Google GMA/IMA SDK に手動で渡す必要はありません。UID2 GMA/IMA プラグインがこれを自動的に処理します
11+
Advertising Token を取得して Google GMA/IMA SDK に手動で渡すために、明示的に `getAdvertisingToken()` メソッドを呼び出す必要はありません。UID2 GMA/IMA プラグインが自動的に処理します
1212

13-
必要なのは`getAdvertisingToken()` が null でない文字列オブジェクトを返すようにするだけです:
13+
必要なことは`getAdvertisingToken()` が null でない文字列オブジェクトを返すようにするだけです
1414

1515
<Tabs groupId="language-selection">
1616
<TabItem value='android' label='Android'>
1717

1818
```js
19-
UID2Manager.getInstance().getAdvertisingToken();
19+
UID2Manager.getInstance().getAdvertisingToken()
2020
```
2121

2222
</TabItem>
2323
<TabItem value='ios' label='iOS'>
2424

2525
```js
26-
UID2Manager.shared.getAdvertisingToken();
26+
UID2Manager.shared.getAdvertisingToken()
2727
```
2828

2929
</TabItem>
3030
</Tabs>
3131

32-
If the token exists, the Google GMA/IMA plug-ins can retrieve it automatically via the UID2 GMA/IMA plugins.
32+
トークンが存在する場合、Google GMA/IMA プラグインは UID2 GMA/IMA プラグインを介して自動的に取得できます。

0 commit comments

Comments
 (0)