변환 만들기

여기에서는 다양한 웹훅 값을 Braze 카탈로그 항목 업데이트에 매핑하는 방법을 정의하는 변환 코드를 작성합니다.

1. 새 변환에는 변환 코드 섹션에 이 기본 템플릿이 포함됩니다:

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
    // This is a default template that you can use as a starting point
    // Feel free to delete this entirely to start from scratch, or to edit specific components
   
   
    // First, this code defines a variable, "brazecall", to build a PUT /catalogs/{catalog_name}/items request
    // Everything from the incoming webhook is accessible via the special variable "payload"
    // As such, you can template in desired values in your request with JS dot notation, such as payload.x.y.z
   
   
    let brazecall = {
    // For Braze Data Transformation to update Catalog items, the special variable "catalog_name" is required
    // This variable is used to specify the catalog name which would otherwise go in the request URL
    "catalog_name": "catalog_name",
    // After defining "catalog name", construct the Update Multiple Catalog Items request as usual below
    // Documentation for the destination endpoint: https://www.braze.com/docs/api/endpoints/catalogs/catalog_items/asynchronous/put_update_catalog_items/
    "items": [
      {
        "id": payload.item_id_1,
        "catalog_column1": "string",
        "catalog_column2": 1,
        "catalog_column3": true,
        "catalog_column4": "2021-09-03T09:03:19.967+00:00",
        "catalog_column5": {
          "Latitude": 33.6112,
          "Longitude": -117.8711
        }
      },
      {
        "id": payload.item_id_2,
        "catalog_column1": "string",
        "catalog_column2": 1,
        "catalog_column3": true,
        "catalog_column4": "2021-09-03T09:03:19.967+00:00",
        "catalog_column5": {
          "Latitude": 33.6112,
          "Longitude": -117.8711
        }
      },
      {
        "id": payload.item_id_3,
        "catalog_column1": "string",
        "catalog_column2": 1,
        "catalog_column3": true,
        "catalog_column4": "2021-09-03T09:03:19.967+00:00",
        "catalog_column5": {
          "Latitude": 33.6112,
          "Longitude": -117.8711
        }
      }
    ]
    };
   
    // After the request body is assigned to brazecall, you will want to explicitly return brazecall to create an output
    return brazecall;
   

2. /catalogs 대상에 대한 변환에는 업데이트하려는 특정 카탈로그를 정의하는 catalog_name 이 필요합니다. 이 필드를 하드 코딩하거나 페이로드 라인을 통해 웹훅 필드로 필드를 템플릿화할 수 있습니다. 점 표기법을 사용하여 페이로드 개체 속성에 액세스합니다.
   
   
3. 항목 배열의 id 필드를 사용하여 카탈로그에서 업데이트할 항목을 정의합니다. 이러한 필드를 하드 코딩하거나 페이로드 라인을 통해 웹훅 필드에 템플릿을 만들 수 있습니다.
   
   ‘catalog_column’은 자리 표시자 값이라는 점에 유의하세요. 항목 객체에는 카탈로그에 존재하는 필드만 포함되어 있는지 확인합니다.
   
   
4. 유효성 검사를 클릭하여 코드 출력의 미리 보기를 반환하고 여러 카탈로그 항목 업데이트 엔드포인트에 대한 허용 가능한 요청인지 확인합니다.
   
   
5. 변환을 활성화하세요. 코드를 활성화하기 전에 코드에 대한 추가 도움이 필요하면 Braze 계정 관리자에게 문의하세요.
   
   
6. 소스 플랫폼에 웹훅 전송을 시작하도록 설정되어 있는지 확인하세요. 들어오는 각 웹훅에 대해 변환 코드가 실행되고 카탈로그 항목이 업데이트되기 시작합니다.

이제 웹훅 통합이 완료되었습니다!