iQタグAPI | iQプロファイル | Tealiumドキュメント

このAPIと利用可能なオブジェクトフィールドについて詳しくは、iQプロファイルAPIおよびiQプロファイルオブジェクトを参照してください。

動作方法

PATCH メソッドを使用して、iQプロファイルオブジェクトのコンポーネントを作成、更新、削除します。

PATCH /v3/tiq/accounts/{ACCOUNT}/profiles/{PROFILE}

PATCHメソッドを使用すると、保存または名前を付けて保存を使用してプログラムでプロファイルタグを変更します。APIで変更を加えた後、アプリケーションにログインして公開する必要があります。

cURLリクエストの例

curl --location --request PATCH 'https://platform.tealiumapis.com/v3/tiq/accounts/{ACCOUNT}/profiles/{PROFILE}' \
  --header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzUx...MiJ9'  \
  --header 'Content-Type: application/json' \
  --data '

認証

Bearerトークンは、すべてのAPI呼び出しを認証するために使用され、APIキーは認証呼び出しでのみ使用されます。Bearerトークンに加えて、認証応答には、後続のサーバーサイドAPI呼び出しで使用する必要がある地域固有のホスト名が含まれています。

APIキーからBearerトークンを生成する方法については、認証を参照してください。

プロファイルフィールド

プロファイルタグは、以下の可能なフィールドを含むJSONオブジェクトです：

オブジェクト	タイプ	必須	説明
`versionTitle`	文字列	任意	保存されたバージョンのタイトル。 `saveType`が`saveAs`に構成されている場合のデフォルト： `API \| {TIMESTAMP}` `saveType`が`save`に構成されている場合のデフォルト：既存のバージョンタイトル
`saveType`	文字列	任意	PATCHリクエストで実行する保存のタイプ：`save`または`saveAs`。デフォルトは`saveAs`です。
`notes`	文字列	必須	公開バージョンに関する追加のメモ。
`operationList`	配列	必須	操作オブジェクトのリスト。例えば、複数のタグ。
`op`	文字列	必須	実行する操作：`add`、`replace`、または`remove`。
`path`	文字列	必須	更新するコンポーネントタイプとIDの形式：`/{TYPE}/{ID}`。
`value.object`	文字列	必須	更新されるオブジェクトタイプ：`variable`、`extension`、`event`、または`tag`。
`value.tagID`	文字列	必須	ユニークなタグテンプレートID。GETリクエストを使用してタグIDを取得します。この値はタグUIDとは異なります。
`value.status`	文字列	任意	オン/オフの状態：`active`または`inactive`。
`value.notes`	文字列	任意	タグに関するメモ。
`value.name`	文字列	必須（add/replaceの場合）	タグの名前。
`value.selectedTargets`	マップ<string, Boolean>	任意	コンポーネントを公開する環境のオブジェクト。`{ "prod" : true\|false, "qa" : true\|false, "dev" : true\|false }` デフォルト：すべての環境が`true`に構成されています。
`value.configuration`	マップ<String, Object>	任意	ベンダーによって提供されるタグ構成の文字列とオブジェクトのマップ。構成は各タグに固有です。詳細については、タグのドキュメントを参照してください。
`value.advancedConfiguration`	オブジェクト	任意	タグ構成構成に対応する高度な構成のセット。 `advConfigBundle` — True または False `advConfigLoadType` — True または False `advConfigOptOut` — True `advConfigSend`— True または False `advConfigSrc` — テキストフィールド `tagTiming` — DOM Ready または Prioritized
`value.rules`	オブジェクト	任意	タグに適用または除外するロードルール。
`value.dataMappings`	マップ<String, String>	任意	Tealium IQ変数とその対応するマップ先、変数名、データタイプを含むオブジェクト。マップされた変数トリガーの特定の形式は、タグ構成のData Mappings画面で確認できます。
`value.dataMappings.variable`	文字列	任意	マップされる変数の名前。
`value.dataMappings.type`	文字列	任意	マップされる変数のデータタイプ。このフィールドは次の変数タイプをサポートしています： `ls` - ローカル保存 `ss` - セッション保存 `udo` - ユニバーサルデータオブジェクト `qp` - クエリ文字列パラメータ `cp` - クッキー `js_page` - JavaScript変数 `dom` - DOM変数 `meta` - メタデータ要素 `static.text` - 静的テキスト `static.js` - JavaScriptコード
`value.dataMappings.mappings`	文字列または文字列の配列	任意	変数のマップ先。

例のリクエスト

{
  "versionTitle": "バージョンタイトル",
  "notes": "メモ",
  "operationList": [
    {
      "op": "add",
      "path": "/tags",
      "value": {
        "object": "tag",
        "tagId": "7133",
        "status": "active",
        "notes": "タグ追加",
        "name": "7133タグ Google Analytics",
        "dataMappings": [
          {
            "variable": "variable_name",
            "type": "udo",
            "mappings": ["a1", "a2"]
          }
        ],
        "selectedTargets": {
          "qa": true,
          "dev": true,
          "prod": true
        },
        "advancedConfiguration": {
          "bundleFlag": true,
          "syncLoadType": false,
          "optout": true,
          "scriptSource": "",
          "sendFlag": false,
          "tagTiming": "Dom Ready"
        },
        "configuration": {
          "tracking_id": "123"
        },
        "rules": {
          "apply": [{"and": [{"or": [{"uid": "2", "type": "loadRule"}]}]}],
          "exclude": [{"and": [{"or": [{"uid": "3", "type": "loadRule"}, {"uid": "2", "type": "loadRule"}]}]}]
        }
      }
    }
  ]
}

PATCH操作パラメータ

POST、PUT、DELETEメソッドの代わりに、PATCHメソッドはopパラメータを使用して実行するアクションを指定します。

opパラメータは次の値をサポートしています：

add - コンポーネントを作成します。
replace - コンポーネントを更新します。
remove - コンポーネントを削除します。

コンポーネントのタイプとIDを指定するには、pathパラメータを使用します。pathパラメータの形式は/{TYPE}/{ID}です。

例えば、タグを追加するには：

"op" : "add",
"path" : "/tags"

特定のタグを更新するには、パスにIDを追加します：

"op" : "replace",
"path" : "/tags/503"

タグの作成

このPATCHメソッドは、プロファイルオブジェクトと追加のタグフィールドを取ります。

例のリクエスト

{
  "versionTitle": "バージョンタイトル",
  "notes": "メモ",
  "operationList": [
    {
      "op": "add",
      "path": "/tags",
      "value": {
        "object": "tag",
        "tagId": "7133",
        "status": "active",
        "notes": "タグ追加",
        "name": "7133タグ Google Analytics",
        "dataMappings": [
          {
            "variable": "variable_name",
            "type": "udo",
            "mappings": ["a1", "a2"]
          }
        ],
        "selectedTargets": {
          "qa": true,
          "dev": true,
          "prod": true
        },
        "advancedConfiguration": {
          "bundleFlag": true,
          "syncLoadType": false,
          "optout": true,
          "scriptSource": "",
          "sendFlag": false,
          "tagTiming": "Dom Ready"
        },
        "Configuration": {
          "tracking_id": "123"
        },
        "rules": {
          "apply": [{"and": [{"or": [{"uid": "2", "type": "loadRule"}]}]}],
          "exclude": [{"and": [{"or": [{"uid": "3", "type": "loadRule"}, {"uid": "2", "type": "loadRule"}]}]}]
        }
      }
    }
  ]
}

タグの更新

このPATCHメソッドは、プロファイルオブジェクトと追加のタグフィールドを取ります。

例のリクエスト

{
  "versionTitle": "version title",
  "notes": "notes",
  "operationList": [
    {
      "op": "replace",
      "path": "/tags/21",
      "value": {
        "object": "tag",
        "tagId": "7133",
        "status": "active",
        "notes": "adding tag",
        "name": "Replace name by API Google Analytics",
        "dataMappings": [
          {
            "variable": "variable_name",
            "type": "udo",
            "mappings": ["a1", "a2"]
          }
        ],
        "selectedTargets": {
          "qa": true,
          "dev": true,
          "prod": true
        },
        "advancedConfiguration": {
          "bundleFlag": true,
          "syncLoadType": false,
          "optout": true,
          "scriptSource": "",
          "sendFlag": false,
          "tagTiming": "Dom Ready"
        },
        "Configuration": {
          "tracking_id": "123"
        },
        "rules": {
          "apply": [{"and": [{"or": [{"uid": "2", "type": "loadRule"}]}]}],
          "exclude": [{"and": [{"or": [{"uid": "3", "type": "loadRule"}, {"uid": "2", "type": "loadRule"}]}]}]
        }
      }
    }
  ]
}

タグの削除

このPATCHメソッドはプロファイルオブジェクトと追加のタグフィールドを取ります。

例のリクエスト

{
  "versionTitle": "Version 2022.03.22.2108",
  "saveType": "saveAs",
  "notes":"",
  "operationList": [
    {
      "op": "remove",
      "path": "/tags/230",
      "value":{
        "object":"tag"
      }
    }
  ]
}

エラーメッセージ

このエンドポイントの潜在的なエラーメッセージ：

エラーコード	エラーメッセージ
400	`"プロファイルライブラリが古くなっています。プロファイルをパッチする前に変更をマージしてください - {ACCOUNT} \| profile: {PROFILE}"` `"patchProfile.arg2.notes: 空であってはなりません"`
404	`"プロファイルが見つかりません - account: {ACCOUNT} \| profile: {PROFILE}"` `"プロファイルライブラリが見つかりません - account: {ACCOUNT} \| profile: {PROFILE}"` `"プロファイル（レガシー）が見つかりません - account: {ACCOUNT} \| profile: {PROFILE}"` `"同じアカウントを現在他のユーザーが閲覧しています: {ACCOUNT} \| profile: {PROFILE}"` `"最新バージョンが見つかりません - {ACCOUNT} \| profile: {PROFILE}"`
409	`"プロファイルの保存エラー: {PROFILE} for account: {ACCOUNT}, 重複バージョン: {VERSION}"`
500	`"プロファイル: {PROFILE} はライブラリプロファイルを継承しています"` `"プロファイルメタデータの保存エラー - account: {ACCOUNT} \| profile: {PROFILE}"` `"プロファイルの保存エラー - account: {ACCOUNT} \| profile: {PROFILE}"` `"プロファイル（レガシー）の保存エラー - {ACCOUNT} \| profile: {PROFILE}"`