このページはAIにより自動翻訳されており、不正確な内容が含まれている可能性があります。翻訳の誤りを報告するには、 GitHubでイシューを作成してください.

Contentful

Contentful は、コンテンツの作成、管理、およびあらゆるプラットフォームへの配信を可能にするヘッドレスのコンテンツ管理システムです。コンテンツ管理システム (CMS) とは異なり、Contentful ではコンテンツモデルを作成できるため、どのコンテンツを管理するかを決めることができます。

このページでは、Contentful の Content Delivery API からデータを取得するように Braze コネクテッドコンテンツを設定する手順について説明します。

統合後は、Contentful の RESTful APIを使用して、Webサイト、モバイルアプリ (iOS、Android、および Windows)、その他の多くのプラットフォームなど、複数のチャネルにわたってコンテンツを配信できます。また、コンテンツをContentful からダイナミックにプルして、Braze Campaignsで使用することもできます。

前提条件

開始する前に、次のものが必要になります。

前提条件

説明

Contentful アカウント

Content Delivery APIにアクセスできる Contentful アカウントが必要です。

Braze アカウント

コネクテッドコンテンツ機能にアクセスできる Braze アカウントが必要です。

統合

ステップ 1: Contentful API認証情報を取得する

認証情報を使って Contentful にログインします。
Contentful ダッシュボードの Settings > API keys でAPIアクセストークンを作成または取得します。APIキーをまだ持っていない場合は、新規に作成します。
2.1 Add API key を選択します。
2.2 必要な詳細を入力し、適切な環境を選択します。
2.3 Save を選択し、Space ID と Content Delivery API - access token をメモします。
Contentful APIを使用してアクセスするコンテンツモデルを特定します。

ステップ 2: Braze コネクテッドコンテンツを設定する

認証情報を使って Braze にログインします。
Braze ダッシュボードで、Templates > Content Blocks > Create Content Block > HTML code editor の順に移動します。
Contentful の Contentful Content Delivery API URL に対してコネクテッドコンテンツリクエストを作成します。Contentful Content Delivery API URLの例は https://cdn.contentful.com/spaces/{space_id}/environments/{environment_id}/entries です。

異なるアセットを取得するには、特定の変数を含める必要があります。コネクテッドコンテンツURLリクエストの例は、Contentful のエントリエンドポイントをターゲットにしています。このエンドポイントには {space_id} および {environment_id}、あるいは {entry_id} および {access_token} のような変数が必要です。これらはContentful インスタンスから取得できます。このコンテンツブロックの例では、変数をContentful のスペースIDと環境IDに置き換える必要があります。

Content Delivery API URLの例では、Contentful の利用可能なエンドポイントの1つだけを使用しています。異なるユースケースは、異なるURLを活用することで実現できます。例えば、Images API を使えば、Contentful に保存されている画像を取り込むことができます。詳しくは、Content Delivery API を参照してください。

注

エンドポイントによっては、新しい変数が必要になる場合があります。たとえば、Images APIには {asset_id}、{unique_id},、{name} が必要です。さらなるガイダンスについては、Contentful にお問い合わせください。

        {% assign space_id = "YOUR-CONTENTFUL-SPACE-ID"}
        {% assign environment_id = "YOUR-CONTENTFUL-ENVIRONMENT-ID"}
        {% assign entry_id = "YOUR-CONTENTFUL-ENTRY-ID"}
        {% assign access_token = "YOUR-CONTENTFUL-ACCESS-TOKEN"}
         {% assign space_id = "YOUR-CONTENTFUL-SPACE-ID"}
        {% assign environment_id = "YOUR-CONTENTFUL-ENVIRONMENT-ID"}
        {% assign entry_id = "YOUR-CONTENTFUL-ENTRY-ID"}
        {% assign access_token = "YOUR-CONTENTFUL-ACCESS-TOKEN"}
         {% connected_content https://cdn.contentful.com/spaces/{space_id}/environments/{environment_id}/entries/{entry_id}?access_token={access_token}
         :method get
         :headers {
             "Authorization": "YOUR_CONTENTFUL_ACCESS_TOKEN"
                 }
               :content_type application/json
               :save response %}

「Test Endpoint」を使用して、Braze がContentful APIに正常に接続し、目的のデータを取得できることをテストします。
Done を選択してコンテンツブロックを保存します。
コンテンツブロックに「Contentful API」などのわかりやすい名前をつけ、Launch Content Block を選択します。

ステップ 3: CampaignsやCanvasでコネクテッドコンテンツを使用する

Braze で、新しいCampaignを作成するか、既存のCampaignを編集します。
コネクテッドコンテンツブロックを使って、Contentful から取得したデータを挿入します。設定時に定義したデータパスを使用して、Campaignのコンテンツをダイナミックに入力します。
- 応答パス: Content Blocksを Braze CampaignまたはCanvasに含めた後、変数 {response} をメッセージに挿入すると、レスポンスが利用可能になります。
  
  JSONドット表記法では、Contentful からの応答本文のどの部分をメッセージに含めるかを指定できます。これはユースケースによって異なります。例えば、Contentful のエントリエンドポイントからタイトル値 (liquid{{response.items[0].fields.title}}) を使用し、次のような応答を受け取ることができます。

   {
  "fields": {
    "title": {
      "en-US": "Hello!"
    },
    "body": {
      "en-US": "This is a sample message!"
    }
  },
  "metadata": {
    "tags": [
      {
        "sys": {
          "type": "Link",
          "linkType": "Tag",
          "id": "nyCampaign"
        }
      }
    ]
  },
  "sys": {
    "id": "5KsDBWseXY6QegucYAoacS",
    "type": "Entry",
    "version": 1,
    "space": {
      "sys": {
        "type": "Link",
        "linkType": "Space",
        "id": "yadj1kx9rmg0"
      }
    },
    "contentType": {
      "sys": {
        "type": "Link",
        "linkType": "ContentType",
        "id": "hfM9RCJIk0wIm06WkEOQY"
      }
    },
    "createdAt": "2016-12-20T10:43:35.772Z",
    "updatedAt": "2016-12-20T10:43:35.772Z",
    "revision": 1
  }
}

Campaignをプレビューしてテストし、コネクテッドコンテンツデータが正しく表示されることを確認します。
設定に問題がなければ、Campaignを起動します。

トラブルシューティング

APIレスポンス

Contentful APIの認証情報とエンドポイントURLが正しいことを確認してください。APIコールに問題があることを示すエラーメッセージがBraze に表示されていないか確認してください。

データマッピング

レスポンスパスのマッピングが正しく設定されていること、およびAPIレスポンスの構造が期待どおりであることを確認してください。

その他のリソース

New Stuff!