アプリ コンバージョン トラッキングとリマーケティング - リクエストとレスポンスの仕様

アプリのユーザー エージェント

Google では、スパム対策に関する取り組みの一環として、アプリユーザーに代わってデータ解析または広告サービスから送信されるユーザー エージェント ヘッダーの標準的な仕様を策定しました。アプリのユーザー エージェントは、ネイティブ コードから次の仕様で取得できます。

name version (os_and_version; locale; device; build; Proxy)

これらのフィールドの定義は以下のとおりです。

ユーザー エージェントのコンポーネント
name

データ解析または広告サービスの名前です（Google AdMob）

ユーザー エージェントをクライアント サイドで構築する場合は、name でクライアント アプリのバンドル ID を代わりに指定する必要があります。

Android
// Specified by API consumer.
iOS
// Specified by API consumer.
version

データ解析または広告サービスのバージョンです （7.10.1）

Android
// Specified by API consumer.
iOS
// Specified by API consumer.
os_and_version

アプリを実行しているオペレーティング システムとそのバージョンです（Android 6.0 ）

Android
String osAndVersion =
    "Android " + Build.VERSION.RELEASE;
iOS
UIDevice *uid =
  [UIDevice currentDevice];
NSString *osAndVersion =
  [NSString
    stringWithFormat:@"%@ %@",
    [uid systemName],
    [uid systemVersion]];
locale

デバイス用の IETF 言語タグです。2 文字の言語と国のコードをアンダースコアで区切って使用します （en_US）

Android
String locale = Locale.getDefault();
iOS
NSString *locale =
  [[NSLocale currentLocale]
    localeIdentifier]
device

データ解析または広告サービスを実行しているデバイス本体の名前です（iPhone9,1）

Android
String device = Build.MODEL;
iOS
@import Darwin.sys.sysctl;

NSString *device(void) {
  size_t bufferSize = 64;
  NSMutableData *buffer =
    [[NSMutableData alloc]
      initWithLength:bufferSize];
  int status =
    sysctlbyname("hw.machine",
      buffer.mutableBytes,
      &bufferSize, NULL, 0);
  if (status != 0) {
    return nil;
  }
  return [[NSString alloc]
    initWithCString:buffer.mutableBytes
    encoding:NSUTF8StringEncoding];
}
build

「Build/」に続けてオペレーティング システムのビルド番号を指定します（Build/13D15）

Android
String build = "Build/" + Build.ID;
iOS
@import Darwin.sys.sysctl;

NSString *build(void) {
  size_t bufferSize = 64;
  NSMutableData *buffer =
    [[NSMutableData alloc]
      initWithLength:bufferSize];
  int status =
    sysctlbyname("kern.osversion",
      buffer.mutableBytes,
      &bufferSize, NULL, 0);
  if (status != 0) {
    return nil;
  }
  return [[NSString alloc]
    initWithCString:buffer.mutableBytes
    encoding:NSUTF8StringEncoding];
}

アプリのユーザー エージェントをサーバーサイドで構築する場合に限り、; Proxy をアプリのユーザー エージェントの末尾に追加します。アプリのユーザー エージェントを完全にクライアント サイドで構築する場合は、; Proxy を除外します。たとえば、次のようになることがあります。

  • Android: AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M; Proxy)
  • iOS: AdMob/7.10.1 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)

コンバージョン トラッキング リクエスト ガイド

コンバージョン トラッキング リクエストを送信するのは、アプリイベント（コンバージョンとしてトラッキングするか、リマーケティング リストを入力するために使用）を Google 広告に通知して、イベントの前に発生したクリックを記述しているメタデータを取得するためです。

すべての API 呼び出しは、www.googleadservices.com ドメインに対して行われます。コンバージョン リクエストは、次のパスで HTTPS を介して POST リクエストとして送信されます。

/pagead/conversion/app/version
ここで、version は対象となるコンバージョン トラッキング API のバージョンです。

標準的なアプリ コンバージョン リクエストで使用するパラメータは以下のとおりです（アプリ コンバージョン API v1.1）。

コンバージョン トラッキング リクエスト
dev_token

必須

場所: クエリ

API ユーザーに対して発行される、固有の静的な開発者トークンです。

Z_eErE4DkvcKjDM1OVE4c4
link_id

必須

場所: クエリ

API ユーザーの開発者トークンと特定のアプリを関連付けるリンク ID です。

31FF8D67E5BB5DD5029DCC2734C2F884
app_event_type

必須

場所: クエリ

発生したアプリイベントの名前です。このフィールドでは列挙値を指定し、以下の値のみ許可されます。

 • first_open
 • session_start
 • in_app_purchase
 • view_item_list
 • view_item
 • view_search_results
 • add_to_cart
 • ecommerce_purchase
 • custom

インストールのアトリビューションの場合は常に first_open イベントを送信し、セッションのリアトリビューションの場合は常に session_start イベントを送信する必要があります。また、ネイティブ アプリ ストアでの購入の場合は in_app_purchase を使用し、他のすべての購入では ecommerce_purchase を使用します。
app_event_name

一定の条件下では必須

場所: クエリ

app_event_type フィールドで許可されないすべてのカスタム アプリイベントの名前です。このフィールドでは、1 ～ 64 の Unicode 文字（UTF-8 エンコードを使用）を使用する必要があります。app_event_type が custom の場合、このフィールドは必須となります。

level_achieved
Level Achieved

このフィールドには、app_event_type 用の値を含めることはできません。上記のイベント名が使用されている場合、API は APP_EVENT_NAME_RESERVED_VALUE エラーを返します。
app_event_data

省略可

場所: 本文

追加のリッチなイベントデータを、文字列キーと値をマッピングするシンプルな JSON オブジェクトとして送信します。文字列と文字列の配列が値として許可されます。

{"level": 5, "attempts": 20}
odm_info

iOS で統合コンバージョン測定を利用する場合に必要

場所: クエリ

Google オンデバイス測定（ODM）: イベントデータ SDK から iOS アプリのインストールまたは再インストール時に取得された info クエリ パラメータの値。このフィールドを使用すると、 iOS アプリ キャンペーンの統合コンバージョン測定が有効になります。

XYZr_AB8C-_zGtKjUhqtzPLeQ8lbJB5dADVR0tpZ9f-28sN5qN9GTZ_FztjL0OL
FzgxUJDhZr8w6lwGxAwPcxSwR5orjWepZiVP7sRRoCiaHerR-1TP17eJKtazgeSg
_CVEs13LllDTfrhVM8uWISqlg8dXobsLzmj8C7WrOlktHA5P_E23
id_type

必須

rdid フィールドで渡される ID の種類。

Android

advertisingid
 
appsetid

iOS

idfa
 
idfv
rdid

必須

場所: クエリ

未処理の端末 ID が、有効な UUID 文字列で表示されます。

f10e1de2-e237-4f50-b6aa-843c45cc63d6

デバイス ID がない場合（ATT の同意していないユーザーのデバイス ID など）は、すべてゼロに設定します。

00000000-0000-0000-0000-000000000000
ctry_c

必須

場所: クエリ

コンバージョンが発生した国を示す 2 文字の ISO 国コード。

このフィールドは、iOS と Android で非ユーザー単位のアプリ コンバージョンの測定を有効にするために必要です。

US, IN
eea

一定の条件下では必須

場所: クエリ

EEA スコープ。

0: このユーザーとコンバージョンには欧州の規制が適用されません。

1: このユーザーとコンバージョンには欧州の規制が適用されます。たとえば、ユーザーが EEA 内に居住している場合は、適用される欧州の規制の対象となります。

*Required to be sent when the value is known.
ad_personalization

一定の条件下では必須

場所: クエリ

パーソナライズド広告のフラグ

0: エンドユーザーが広告のパーソナライズに対する同意を拒否した

1: エンドユーザーが広告のパーソナライズに対する同意を許可した 

*Required to be sent when the value is known.
ad_user_data

一定の条件下では必須

場所: クエリ

広告目的でのユーザーデータの使用に関する同意フラグ

0: ユーザーは、広告目的でユーザーレベルのデータを Google に送信することに同意していません。

1: ユーザーは、広告目的でユーザーレベルのデータを Google に送信することに同意しています。 

*Required to be sent when the value is known.
lat

必須

場所: クエリ

デバイスの広告トラッキング制限ステータスです。

  • 0: ユーザーが広告トラッキング制限を設定していない
  • 1: ユーザーが広告トラッキング制限を設定している
app_version

必須

場所: クエリ

現在のアプリのバージョンです。以下のように標準化されます。

Android

packageManager.getPackageInfo(packageName(),
  PackageManager.GET_META_DATA).versionName

iOS

[[[NSBundle mainBundle] infoDictionary]
  objectForKey:@"CFBundleShortVersionString"]
 
1.2.4
os_version

必須

場所: クエリ

現在のアプリのホスト OS のバージョン。以下のように標準化されます。

Android

android.os.Build.VERSION.RELEASE

iOS

[[UIDevice currentDevice] systemVersion]
sdk_version

必須

場所: クエリ

イベントが確認された SDK のバージョンです。このフィールドは主にデバッグで使用するため、SDK リリースで公開されているリリース バージョンがそのまま反映されます。アプリで SDK を使用しない場合は、app_version と同じ値を渡してください。 

1.9.5r6
timestamp

必須

場所: クエリ

コンバージョン イベントが発生した UNIX タイムスタンプの秒数（マイクロ秒単位）です。

1432681913.123456
fot

必須

場所: クエリ

後続のすべてのセッションとインストール後のイベントについて、対応する first_open の UNIX タイムスタンプ（マイクロ秒単位）。

1432681913.123456
value

省略可

場所: クエリ

イベントの金銭的価値です（ある場合）。常に小数点を使用した機械可読形式の浮動小数点値として、値の整数と端数の部分を区別した形式で表示されます。

1.99
currency_code

一定の条件下では必須

場所: クエリ

value パラメータで使用される ISO 4217 の通貨コードです。value パラメータを指定していて空白ではない場合、このフィールドは必須となります。

USD
gclid

一定の条件下では必須

場所: クエリ

アプリが開いたディープリンク URL の gclid クエリ パラメータの値です。

Cj0KEQjw0dy4BRCuuL_e5M
market_referrer_gclid

一定の条件下では必須

場所: クエリ

Play Install Referrer API を介して install_referrer 値から取得されたディープリンク URL の gclid クエリ パラメータの値。

BX3QojHp4mY5MrJtFM_d1u
gclid_only_request

一定の条件下では必須

場所: クエリ

rdid（advertisingid）が not で、zeroes がすべて存在し、gclid または market_referrer_gclid のいずれかが存在する場合の gclid ベースのアトリビューションの識別子。

1
gbraid

一定の条件下では必須

場所: クエリ

アプリを開いたディープリンク URL を介して送信された gbraid の最終値。この値はアプリでキャッシュに保存し、アプリで発生する今後のコンバージョンとともに送信できるようにする必要があります。

ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
app_open_source

一定の条件下では必須

場所: クエリ

広告クリックのディープリンクまたはオーガニック アプリ セッションを識別する値。

ad_click or organic
User-Agent

必須

場所: ヘッダー

前のセクションで定義したアプリのユーザー エージェントです。

AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M)
X-Forwarded-For

必須

場所: ヘッダー

イベントが測定されたデバイスの IPv4 または IPv6 公開アドレスです。

216.58.194.174

リクエストはすべて HTTPS で送信する必要があります。HTTP で送られた信号は拒否されます。

リクエスト本文が空の場合（app_event_data ペイロードにリッチイベント データが渡されていない場合）、リクエストに Content-Length: 0 ヘッダーを明示的に設定するようサーバーから要求されます。

イベントデータのエンコード

app_event_data 本文パラメータでは、以下のプリミティブ データタイプの規則を使用してください。

  • Float

    • アプリのローカライズによる影響を受けないドット文字を小数点の区切り文字として使用する
    • 金銭的価値の表示には小数点以下 2 桁を使用する（例: 2.99）
    • 指数表記（例: 2E+9）は使用しない
    • 桁グループの区切りにカンマ文字（例: 1,000,000）を使用しない
    • 有効な例:
      • -0.5
      • 2.99
      • 1000000.123

  • 整数

    • 小数点以下を含まない整数値全体のみを送信する
    • 桁グループの区切りにカンマ文字（例: 1,000,000）を使用しない
    • 有効な例:
      • 1000
      • -11
      • 0

  • 日付

    • 日付の形式: yyyy-mm-dd
      • yyyy = 4 桁の年（例: 2016）
      • mm = 2 桁の月（例: 9 月の場合は「09」）
      • dd = 2 桁の日（例: 23 日の場合は「23」）
    • 常に上記の桁の数値を送信（例: 「dd」の値として 5 日を指定する場合は、「05」を送信します）。
    • 有効な例:
      • "2016-09-23"
      • "1990-12-31"

  • タイムスタンプ

    • 時間の形式: UTC タイムゾーンで定義される Unix/エポック タイムスタンプ（秒単位、マイクロ秒単位）
    • 有効な例:
      • 1478713087（2016 年 11 月 9 日水曜日 17 時 38 分 7 秒（グリニッジ標準時間）の場合）
      • 1073513982.123000（2004 年 1 月 7 日水曜日 22 時 19 分 42.123 秒（グリニッジ標準時間）の場合）

  • 配列

    • プリミティブ値（文字列、数値、ブール値）の配列のみを送信
    • 有効な例:
      • [123, 456, 789]
      • ["abc"]

サンプル リクエスト

オンデバイス測定: 統合コンバージョン測定用のイベントデータ SDK を使用した初回起動リクエストの例は次のとおりです。

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &odm_info=abcdEfadGdaf
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

オンデバイス測定: 統合コンバージョン測定用のイベントデータ SDK を使用しない初回起動リクエストの例は次のとおりです。

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

統合コンバージョン測定用のオンデバイス測定: イベントデータ SDK を使用したインストール後のリクエストの例は次のとおりです。

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &odm_info=abcdEfadGdaf
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &&fot=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

オンデバイス測定: イベントデータ SDK なしの初回起動リクエストの例は次のとおりです。

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

ACAPI v1.1 の Android 非決定論的コンバージョンの初回起動リクエストの例は次のとおりです。

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=appsetid
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &ctry_c=IN
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (android 11; en-GB; RMX2040; Build/_; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

カスタム以外のイベントの種類と収益に関する情報を含む有効なコンバージョン トラッキング リクエストのサンプルは、以下のとおりです。

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=0
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8
 
{"app_event_data":{"item_id":["Crayons","Markers"]}}

カスタム以外のイベントの種類と収益に関する情報を含む有効なコンバージョン トラッキング リクエストのサンプルは、以下のとおりです。なお、rdid（advertisingid）は利用できません。

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; Android,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8
 
{"app_event_data":{"item_id":["Crayons","Markers"]}}

有効なセッション開始リクエストのサンプルは以下のとおりです。

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

ディープリンク「example://product/123?gclid=Cj0KEQjw0dy4BRCuuL_e5M」で開始したセッションの有効なセッション開始リアトリビューション リクエストのサンプルは、以下のとおりです。

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

広告ユーザーデータの使用に同意し、広告のパーソナライズを拒否した EEA ユーザーに対する有効なコンバージョン トラッキング リクエストの例は次のとおりです。

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=1
       &ad_personalization=0
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

コンバージョン トラッキング レスポンス ガイド

コンバージョン トラッキング レスポンスでは以下の形式を使用します。

{
  "ad_events": [<ad event objects>],
  "errors": [<error strings>],
  "attributed": true|false
}

ad_events と errors の配列は、両方とも空白になることがあります。

エラーには、機械可読形式のエラーコード（invalid_timestamp など）が使用されます。

エラーコード

  • invalid_timestamp - リクエストに有効なタイムスタンプがありませんでした。

  • eea_missing_or_invalid - リクエストに「eea」フィールドが設定されていないか、無効です。

  • ad_user_data_missing - 「ad_user_data」リクエスト フィールドが設定されていませんでした。「ad_user_data」フィールドは、対象となるすべての DMA リクエストで必須です。

  • ad_user_data_invalid - 「ad_user_data」リクエスト値が無効でした。「ad_user_data」フィールドは、対象となるすべての DMA リクエストで必須です。

  • ad_personalization_missing_or_invalid - リクエストに「ad_personalization」フィールドが設定されていないか、無効です。「ad_personalization」フィールドは、対象範囲内のすべての DMA リクエストで必須です。

広告イベントはアプリ アトリビューションの主要なオブジェクトで、以下のプロパティが含まれます。

ユーザーの同意に基づくレスポンスの動作に関する重要な注意事項:
コンバージョンに広告ユーザー データの同意があり、ユーザーが Google ユーザー設定でクロスユースの同意をしている場合、Google 広告はすべての CPS で単一のラストクリックで応答します。ユーザーが Google ユーザー設定でクロスユースの同意をしていない場合、Google 広告は CPS ごとに複数のラストクリックを返します。

コンバージョンに、ユーザーが選択したクロスユースの同意に含まれる CPS と含まれない CPS がある場合、Google 広告は、クロスユースの同意が得られた CPS については単一のラストクリックで応答しますが、クロスユースの同意が得られなかった CPS については、CPS ごとに複数のラストクリックで応答します。

コンバージョン トラッキング レスポンス
ad_event_id

常に表示

文字列

ad_event_id は、広告イベントの固有の ID として送信されます。この値はクロスネットワーク アトリビューション リクエストで再使用され、デバッグ用に記録、保持されます。

Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
conversion_metric

常に表示

文字列

アトリビューションで使用されるコンバージョン指標です。最初は 1 つのコンバージョン指標がサポートされます。

conversion
timestamp

常に表示

数値

広告イベントが発生した UNIX タイムスタンプの秒数（マイクロ秒単位）です。この値はラストクリック アトリビューションで使用されます。

1432681913.123456
campaign_type

常に表示

文字列

このフィールドを使用して、広告イベントが発生したキャンペーンのタイプを特定できます。値は次のいずれかになります。

ACI
ACE
ACPre
Search
Display
Video
Shopping
Hotel
Performance_Max
Other

ACI は、アプリ インストール キャンペーンの略語です。ACE は、アプリ エンゲージメント キャンペーンの略語です。
campaign_id

常に表示

数値

広告イベントが発生したキャンペーンの、数値型のキャンペーン ID です。この値は固有であることが保証されています。

123456789
campaign_name

常に表示

文字列

広告イベントが発生したキャンペーンの、広告主様が定義したキャンペーン名です。この値が固有であることは保証されていません。

Occasional Gamers (Video)
ad_type

常に表示

文字列

広告イベントが発生した広告のタイプです。この値を使用して、以下のさまざまな広告枠のタイプを識別できます。

アプリのプロモーション 
ClickToDownload
 アプリ エンゲージメント 
AppDeepLink
 アプリのエンゲージメント - インストールおよび継続利用フロー 
AppDeepLinkContinue
 その他の値全般 
Unknown
external_customer_id

常に表示

数値

広告イベントが発生したキャンペーンを運用している広告主様の広告主 ID です。この値を使用して、Google 広告アカウントを識別できます。

123456789
location

常に表示

数値

広告イベントが発生した地域の地域 ID コードです。地域コードについては、 Google 広告 API リファレンスをご覧ください。
network_type

常に表示

文字列

このフィールドを使用して、広告イベントが発生した Google 広告 広告ネットワークを特定できます。値は次のいずれかになります。

Search
Display
YouTube
GoogleTv
cross-network
network_subtype

campaign_type が ACI または ACE で、network_type が Display の場合は null になります。

文字列

このフィールドを使用して、広告イベントが発生した Google 広告 広告ネットワークの「サブタイプ」を特定できます。値はメインのネットワーク タイプによって決まります。

通常の Google 検索 
GoogleSearch
 Google 検索パートナー 
SearchPartners

ディスプレイ

モバイルウェブ パブリッシャー 
mGDN
 アプリ パブリッシャー 
Google AdMob

YouTube

YouTube 動画ネットワーク 
YouTubeVideos
 YouTube 検索ネットワーク 
YouTubeSearch
 動画パートナー 
VideoPartners

GoogleTv

GoogleTV 動画ネットワーク 
GoogleTvVideos

クロスネットワーク

P-MAX のクロス ネットワーク
cross-network
video_id

network_type が YouTube となっていて、campaign_type が ACI と ACE 以外になっている場合にのみ指定されます。

文字列

広告イベントに関連付けられた YouTube 動画の ID。

dQw4w9WgXcQ
keyword

network_type が Search となっていて、campaign_type が ACI と ACE 以外になっている場合にのみ指定されます。

文字列

広告イベントに関連付けられた検索キーワードです。

+food +delivery
match_type

network_type が Search となっていて、campaign_type が ACI と ACE 以外になっている場合にのみ指定されます。

文字列

検索キーワードのマッチタイプ。

完全一致 
e
 フレーズ一致 
p
 部分一致 
b
placement

network_type が Display となっていて、campaign_type が ACI と ACE 以外になっている場合にのみ指定されます。

文字列

広告イベントに関連付けられたプレースメント。

mobileapp::1-343200656
ad_group_id

campaign_type が Performance_Max 以外の場合にのみ指定されます。

数値

広告イベントが発生した広告グループの数値 ID です。この値は一意であることが保証されています。

123456789
ad_group_name

campaign_type が ACI、ACE、または ACPRE の場合にのみ指定されます。

文字列

広告イベントが発生した広告グループの、広告主様が定義した広告グループ名です。この値が固有であることは保証されていません。

My App AdGroup
creative_id

campaign_type が ACI、ACE、ACPRE、Performance_Max 以外の場合にのみ指定されます。

数値

広告イベントが発生した広告ユニットの数値 ID です。この値は一意であることが保証されています。

123456789
interaction_type

このフィールドは常にエンゲージメントになります。

文字列
is_deterministic

アトリビューション方法が決定論的かどうかを示します。

ブール値

true, false
device_model

広告イベントが発生したデバイスモデル。

文字列

sm-s936w, sm-3936w
os_version

広告イベントが発生した OS のメジャー バージョン。

文字列

14, 12
country

広告イベントが発生した国の 2 文字の国コード。

文字列

CA, US
city

広告イベントが発生した都市。

文字列

san jose, london
region

広告イベントが発生した都道府県。

文字列

california, british columbia

レスポンス例

確定的なコンバージョンのレスポンスの例は次のとおりです。

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "network_type": null,
    "network_subtype": null,
    "ad_group_id": null,
    "ad_group_name": null,
    "is_deterministic": true
    "timestamp": 1234567.898765,
  }],
  "errors": [],
  "attributed": true
}

iOS の非決定論的コンバージョンのレスポンスの例は次のとおりです。

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "network_type": null,
    "network_subtype": null,
    "ad_group_id": null,
    "ad_group_name": null,
    "is_deterministic": false
    },
    "device_info": {
        "device_model": "iphone12,3",
        "os_version": "14",
    },
    "timestamp": 1432681918.123456
    }],
  "errors": [],
  "attributed": true
}

Android の非決定論的コンバージョンのレスポンスの例は次のとおりです。

{
  "ad_events": [
    {
      "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
      "conversion_metric": "conversion",
      "interaction_type": "click",
      "campaign_type": "ACI",
      "campaign_id": 123456789,
      "campaign_name": "My App Campaign",
      "network_type": null,
      "network_subtype": null,
      "ad_group_id": null,
      "ad_group_name": null,
      "is_deterministic": false
      "geo_info": {
        "city": "san jose"
        "country": "US"
        "region": "california"
      },
      "device_info": {
          "device_model": "sm-s926u",
          "os_version": "14",
      },
      "timestamp": 1432681918.123456
    },
    ],
    "errors": [],
    "warnings" [],
  }

gbraid でアトリビューションされた iOS/Android コンバージョンのレスポンスの例は次のとおりです。

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "interaction_type": "engagement",
    "network_type": "NULL",
    "is_deterministic": true
    "timestamp": 0.000000,
  }],
  "errors": [],
  "attributed": true
  "warnings" [],
}

リクエストにエラーが含まれる場合、コンバージョン トラッキング レスポンスのサンプルは以下のようになります。

{
  "ad_events": [],
  "errors": ["INVALID_CURRENCY_CODE"],
  "attributed": false
}

否定的なコンバージョン トラッキング レスポンスのサンプルは以下のとおりです。

{
  "ad_events": [],
  "errors": [],
  "attributed": false
}

コンバージョン トラッキング レスポンスは、すべてのコンバージョン トラッキング リクエストに対して返されます。

ユニバーサル アプリ キャンペーンで EEA 以外のユーザーを対象とする場合、肯定的なコンバージョン トラッキング レスポンスのサンプルは以下のようになります。

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "GoogleSearch",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

検索キャンペーンで EEA 以外のユーザーに対して肯定的なコンバージョン トラッキング レスポンスを返す場合の例は次のとおりです。

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Search",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "GoogleSearch",
    "video_id": null,
    "keyword": "+space +birds",
    "match_type": "b",
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

ディスプレイ キャンペーンで EEA 以外のユーザーを対象とする場合、肯定的なコンバージョン トラッキング レスポンスのサンプルは以下のようになります。

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Display",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "mGDN",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": "mobile-app::2-343200656",
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

YouTube キャンペーンで EEA 以外のユーザーを対象とする場合、肯定的なコンバージョン トラッキング レスポンスのサンプルは以下のようになります。

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Video",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "YouTube",
    "network_subtype": "YouTubeVideos",
    "video_id": "dQw4w9WgXcQ",
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}
 
{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  {
    "ad_event_id": "I8YUwWqxvOyqcwOcqBAkYZBMaOONSd",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}
 
{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}
 
{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  {
    "ad_event_id": "I8YUwWqxvOyqcwOcqBAkYZBMaOONSd",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Youtube",
    "network_subtype": "YouTubeVideos",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}


クロスネットワーク アトリビューション リクエスト

コンバージョン トラッキング リクエストに対して肯定的なレスポンスを送信する場合は、ラストクリックを特定してからクロスネットワーク アトリビューション リクエストを Google 広告 に送信する必要があります。

クロスネットワーク アトリビューション リクエストは元のコンバージョン トラッキング リクエストと同じものですが、次のリクエストパスを使用します。

/pagead/conversion/app/1.1/cross_network

また、以下の 2 つの必須パラメータが追加されます。

クロスネットワーク アトリビューション リクエスト
ad_event_id

必須

場所: クエリ

前回のリクエストのアトリビューションに関連付けられた広告イベントの ad_event_id の ID です。
attributed

必須

場所: クエリ

API ユーザーによってコンバージョンへの貢献度が割り当てられたかどうかを確認できます。0 または 1 のいずれか。

有効なクロスネットワーク アトリビューション リクエストのサンプルは次のとおりです。

POST /pagead/conversion/app/1.1/cross_network
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=custom
       &app_event_name=level_achieved
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &ad_event_id=Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
       &attributed=1
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

有効なクロスネットワーク アトリビューション リクエストでは、一般的なレスポンス 200（レスポンス本文を含まない）が常に送信されます。