この統合は、Google AdWords API が廃止されたため、サポートされなくなりました。この統合を使用すると、以下のエラーメッセージが表示されます。 | | | --- | | Caused by: com.fasterxml.jackson.databind.JsonMappingException: Can not construct instance of com.fasterxml.jackson.databind.JsonNode, problem:``abstract types either need to be mapped to concrete types, have custom deserializer, or be instantiated with additional type information at [Source: N/A; line: -``1``, column: -``1``] | Google Ads Import Integration - V2 への移行を推奨します。Migrating Google Adwords Integrations を参照してください。
複数の Google Ads 統合が利用可能です。この記事では Google Ads リマーケティングについて説明します。
この記事では、Audience Partner API 経由の Google Ads(旧称 DDP 経由の AdWords)については説明していません。この名称は、Google が Google AdWords を Google Ads にリブランディングした後に変更されました。この統合は、特定のタイプのオーディエンスリスト(カスタマーリスト)でのみ機能します。アプリユーザーやウェブサイト訪問者などの他のリマーケティングリストタイプは、この統合ではサポートされていません。
この統合を活用することで、メールアドレスや電話番号などのユーザープロファイルを Google Ads リマーケティングユーザーリストに直接エクスポートできます。TD SQL クエリジョブの結果を実行して CRM データを一括アップロードし、Google リマーケティングユーザーリストにデータを追加または削除します。
userId カラムのデータをエクスポートできます。また、既存の segment からユーザーを削除することもできます。
- 前提条件
- 制限事項
- カラム名
- データの正規化とハッシュ化
- Google Ads ポリシー
- Google Ads Developer Token の取得
- TD Console の使用
- 新しい接続の作成
- クエリの定義
- Google Ads リマーケティングリストの統合パラメータ
- クエリの例
- クエリ結果の検証(オプション)
- クエリエクスポートジョブのスケジュール設定(オプション)
- TD Console を使用したジョブのスケジュール設定
- カスタム cron の詳細
- クエリの実行
- Workflow でのエクスポート結果の設定(オプション)
- トラブルシューティング
- TD Toolbelt を含む Treasure Data の基本知識
- Google Ads アカウント
- 自身の Google Ads アカウントへの Treasure Data Google OAuth アプリアクセスの承認
以下の制限事項は、Google Ads API ドキュメント「リマーケティングとオーディエンスターゲティング」およびサポート記事に記載されています。
最小 5000 ユーザー。広告は、少なくとも 5000 人のユーザーを持つユーザーリストに配信されます。「カスタマーマッチの制限」セクションを参照してください。ドキュメントには次のように記載されています:「広告の配信を開始するには、リストに少なくとも 5,000 人のメンバーをアップロードしてください。」
Google アカウントのメール。メールは Google アカウントを使用して接続する必要があります。「メールアドレス、住所、またはユーザー ID によるカスタマーマッチ」セクションを参照してください。
@gmail.com 以外のアドレスは無視される。Gmail でのターゲティングには、@gmail.com 形式のメールのみを使用できます。「メールアドレス、住所、またはユーザー ID によるカスタマーマッチ」セクションを参照してください。
ユーザーリストの丸め処理。 Google Ads マネージャーサイトでは、ユーザーリストの数は正確に表示されません:
- ユーザー数が 1000 未満の場合、100 単位に丸められます。
- それ以外の場合は、最も重要な 2 桁に丸められます。「カスタマーマッチの制限」セクションを参照してください。
Google ディスプレイネットワークのカスタマーマッチ。カスタマーマッチは、Google ディスプレイネットワーク内のサードパーティサイトでは利用できません。「メールアドレス、住所、またはユーザー ID によるカスタマーマッチ」セクションを参照してください。
48 時間の遅延。 Google が新しいユーザーをリストに追加するには最大 48 時間かかります。https://support.google.com/google-ads/answer/7474263 の「注意」セクションを参照してください。
出力結果は、事前定義されたカラム名を使用する必要があります。サポートされているカラム名は次のとおりです:
mobile_id: IDFA(Identifier for Advertising)または AAID(Google Advertising ID)モバイルデバイス ID。例:AEBE52E7-03EE-455A-B3C4-E57283966239(形式は: 8-4-4-4-12 の 16 進数文字)email: メールアドレスphone_number: 電話番号- user_id: 広告主が生成および割り当てたユーザー ID。この機能を使用するには、ホワイトリストに登録された Google アカウントが必要です(詳細については: https://support.google.com/adspolicy/answer/6299717)。
クエリ結果からサポートされているカラムが見つからない場合、エラーが発生します。カラムエイリアスは大文字と小文字を区別しません。たとえば、email または EMAIL を使用できます。
カラム名がサポートされている値と一致しない場合は、クエリでエイリアスを使用する必要があります。例:
SELECT an_email_column AS email,
another_phone_column AS phone_number
FROM your_table;Treasure Data の結果出力は、Google のフォーマットとプライバシーガイドラインに従うために、値を自動的に正規化およびハッシュ化します。サポートされているハッシュアルゴリズムは SHA-256 のみです。
CRM データは、受け入れられるために特定のフォーマットガイドラインに従う必要があります。誤ったフォーマットは、アップロードエラーまたは一致するレコード数の減少につながる可能性があります。
正規化のために、結果出力中にデータタイプに応じて次の変換動作が適用されます。
モバイル広告 ID: 正規化なし。
メール:
- データがプレーンテキストの場合、先頭と末尾の空白をトリミングし、すべての文字を小文字に変換してから、送信前にハッシュ化します
- データが既にハッシュ化されている場合、変換は適用されません
電話番号: E.164 形式を使用します。例: +1234567890
- データがプレーンテキストの場合、値をハッシュ化します
- データが既にハッシュ化されている場合、変換は適用されません
ユーザー ID: 正規化なし。
Treasure Data は、特に以下の Google Ads ポリシーを遵守することを推奨します:
この情報には、Ads Managerアカウントが必要です：
- Ad Managerアカウントのホームページにアクセスし、今すぐ開始を選択します。
- 必要な情報を入力し、保存を選択して続行します。
- メールアドレスが確認されると、新しいマネージャーアカウントがアクティブになります。
- ツール、お支払い、設定アイコンを選択し、セットアップの下にあるAdWords APIセンターを選択します。マネージャーアカウントにログインしている場合のみ、AdWords APIセンターのリンクが表示されます。
- Ads APIの利用規約に同意するよう求められます。同意後、トークンを作成を選択します。
- テストアカウントに対してはすぐにDeveloper Tokenを使用できますが、実際のAdsアカウントで動作するにはDeveloper Tokenの承認が必要です。これを行うには、Basic/Standardアクセスレベルを申請する必要があります。
Treasure Dataでは、クエリを実行する前にデータ接続を作成して設定する必要があります。データ接続の一部として、統合にアクセスするための認証情報を提供します。
- Integrations Hub > Catalogに戻ります。
- Google Adsを検索して選択します。
- New Authenticationを選択します。
- OAuth接続フィールドの定義を確認します。
出力結果には、事前定義された列名を使用する必要があります。
user_idをGoogleにアップロードするには、user_id列をクエリする必要があります。
Treasure Dataの結果出力は、Googleのフォーマットおよびプライバシーガイドラインに従うために、値を自動的に正規化およびハッシュ化します。サポートされているハッシュアルゴリズムはSHA-256のみです。
| パラメータ | 必須 | 説明 |
|---|---|---|
| Ads Account | はい | Ads Customer IDで、形式はxxx-yyy-zzzzです |
| Mobile Application ID | モバイルアプリケーションID。Mobile Advertising IDをエクスポートする場合は必須です - - iOS の場合：この設定を使用するには、モバイルアプリ名、9桁または10桁のApple ID、またはパブリッシャーで検索します。 - Androidの場合：ID文字列はアプリケーションのパッケージ名です（例：Google Playリンクhttps://play.google.com/store/apps/details?id=com.labpixies.colordripsの「Color Drips」の場合は「com.labpixies.colordrips」） | |
| UserList name | はい | ユーザーリストの名前。 |
| UserList description | ユーザーリストの説明。 | |
| Mode | 出力モード。 - - Append（デフォルト）：クエリ結果が既存のユーザーリストに追加されます。指定された入力名のユーザーリストが存在しない場合は、新しいユーザーリストが作成されます。 - Replace：既存のユーザーリストのすべてのメンバーが削除され、クエリ結果に置き換えられます。ユーザーリストが存在しない場合は、新しいユーザーリストが作成されます。 - Remove：クエリ結果が既存のユーザーリストから削除されます。 | |
| Membership Lifespan | ユーザーの連絡先情報がユーザーリストに保持される日数。デフォルト：10000 | |
| Upload Batch Size | 各バッチでアップロードするレコード数。デフォルト：100000 | |
| Retry Limit | システムが諦めるまでの再試行回数。デフォルト：5 | |
| Initial retry time wait in millis | 最初の試行と2回目の試行の間の時間（ミリ秒）。デフォルト：500（0.5秒相当） | |
| Max retry wait in millis | 2回目以降のすべての試行の間の時間（ミリ秒）。デフォルト：300000（5分相当） |
TD ConsoleのQueriesページから、出力結果がGoogle Ads接続に送信されるように指定して、次のようなクエリを実行します。このクエリは一例です。
SELECT email, phone_number FROM (
VALUES ('demo1@example.com', '+1234567890'),
('demo2@example.com', '+9876543210'),
('demo3@example.com', '+9988776655')
) tbl (email, phone_number)クエリでソーステーブルを指定する必要はありませんが、データベースを選択する必要があります。
SELECT email FROM app_usersクエリには以下を含めることができます：
mobile_idのみemailおよび/またはphone_numberのみuser_idのみ- その他のすべての列は無視されます
クエリは数秒で完了します。
新しく入力されたデータを表示するために、オーディエンスリストを検証します。
Scheduled Jobsとエクスポート結果を使用して、指定したターゲット送信先に出力結果を定期的に書き込むことができます。
Treasure Dataのスケジューラー機能は、高可用性を実現するために定期的なクエリ実行をサポートしています。
2つの仕様が競合するスケジュール仕様を提供する場合、より頻繁に実行することを要求する仕様が優先され、もう一方のスケジュール仕様は無視されます。
たとえば、cronスケジュールが'0 0 1 * 1'の場合、「日」の仕様と「曜日」は一致しません。前者の仕様は毎月1日の深夜（00:00）に実行することを要求し、後者の仕様は毎週月曜日の深夜（00:00）に実行することを要求するためです。この場合、後者の仕様が優先されます。
Data Workbench > Queriesに移動します
新しいクエリを作成するか、既存のクエリを選択します。
Scheduleの横にある「None」を選択します。
ドロップダウンで、次のスケジュールオプションのいずれかを選択します。
ドロップダウン値 説明 Custom cron... Custom cron...の詳細を参照してください。 @daily (midnight) 指定されたタイムゾーンで1日1回深夜（午前00:00）に実行します。 @hourly (:00) 毎時00分に実行します。 None スケジュールなし。
| Cron値 | 説明 |
|---|---|
0 * * * * | 1時間に1回実行します。 |
0 0 * * * | 1日1回深夜に実行します。 |
0 0 1 * * | 毎月1日の深夜に1回実行します。 |
| "" | スケジュールされた実行時間のないジョブを作成します。 |
* * * * *
- - - - -
| | | | |
| | | | +----- day of week (0 - 6) (Sunday=0)
| | | +---------- month (1 - 12)
| | +--------------- day of month (1 - 31)
| +-------------------- hour (0 - 23)
+------------------------- min (0 - 59)次の名前付きエントリを使用できます。
- Day of Week: sun, mon, tue, wed, thu, fri, sat.
- Month: jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec.
各フィールドの間には単一のスペースが必要です。各フィールドの値は次のように構成できます。
| フィールド値 | 例 | 例の説明 |
|---|---|---|
| 各フィールドの上記制限内の単一の値。 | ||
フィールドに基づく制限がないことを示すワイルドカード'*'。 | '0 0 1 * *' | 毎月1日の深夜（00:00）に実行するようにスケジュールを設定します。 |
フィールドで受け入れられる値の範囲を示す範囲'2-5'。 | '0 0 1-10 * *' | 毎月1日から10日の深夜（00:00）に実行するようにスケジュールを設定します。 |
フィールドで受け入れられる値のリストを示すカンマ区切りの値のリスト'2,3,4,5'。 | 0 0 1,11,21 * *' | 毎月1日、11日、21日の深夜（00:00）に実行するようにスケジュールを設定します。 |
フィールドの有効な値の範囲に基づいて、スケジュールの実行頻度を表す周期性インジケーター'*/5'。 | '30 */2 1 * *' | 毎月1日に、00:30から2時間ごとに実行するようにスケジュールを設定します。'0 0 */5 * *'は、毎月5日から5日ごとに深夜（00:00）に実行するようにスケジュールを設定します。 |
'*'ワイルドカードを除く上記のいずれかのカンマ区切りリスト'2,*/5,8-10'もサポートされています。 | '0 0 5,*/10,25 * *' | 毎月5日、10日、20日、25日の深夜（00:00）に実行するようにスケジュールを設定します。 |
- （オプション）Delay executionを有効にして、クエリの開始時間を遅らせることができます。
名前を付けてクエリを保存して実行するか、クエリを実行するだけです。クエリが正常に完了すると、クエリ結果は指定されたコンテナの送信先に自動的にインポートされます。
| Information | 設定エラーにより継続的に失敗するスケジュールジョブは、複数回の通知の後、システム側で無効化される場合があります。 |
| --- | --- |
Treasure Workflow内で、このデータコネクターを使用してデータをエクスポートするように指定できます。
詳細については、Using Workflows to Export Data with the TD Toolbeltを参照してください。
Q: ステータスが「Populating」の状態が1日または2日続いた後、ユーザーリストのステータスが「Error with the last upload」に変わります。なぜですか？
- テスト中、多くのリストを同時にアップロードすると、Google APIでこの問題が発生するようです。問題を引き起こす可能性のあるユーザーリストの数は不明ですが、一度にアップロードするユーザーリストは3〜5個に制限する必要があります。
Q: ユーザーリストのサイズの値が変わり続けるのはなぜですか？
- 観察によると、各ネットワークのサイズは、アクティブなユーザー数に基づいて毎日変化する可能性があります。
Q: リストのステータスが「Populating...」と表示されるのはなぜですか？
- リストにメンバーが入力されるまでに6〜12時間かかるため、12時間ごとに1回よりも頻繁にオーディエンスリストにアップロードすると、Ads UIで「Populating...」ステータスが表示される可能性があります。ほとんどの場合、リストが確定するまで最大48時間かかることがあります。