Google Tag Manager

Forum Discussion

st-haingo's avatar
st-haingo
Active Member II
2 months ago

How to Use the standard user attribute in the Connected audience object filter

from the API side, I followed the document here to create an audience filter and send a message to the audience after this filter. But the document only mentions using custom attributes: {    "cus...
SDKs and APIs
  • eakinsey's avatar
    eakinsey
    2 months ago

    🤦‍♀️ I think I misinterpreted the docs!  Sorry about that, st-haingo The correct approach for filtering based on standard user attributes in the Braze API is indeed to use custom_attribute, and I appreciate your patience.

    To clarify, the correct structure for your audience filter when using standard user attributes should look like this:

    {
  "custom_attribute": {
    "custom_attribute_name": "country",
    "comparison": "equals",
    "value": "VN"
  }
}

    So this means that in your API request body for scheduling a message, you should structure it like this:

    {
  "messages": {
    "apple_push": {
      "alert": {
        "title": "良い一日を！",
        "body": "I hope 2024 is going to be a better year for this world 12"
      },
      "message_variation_id": ""
    }
  },
  "campaign_id": "",
  "schedule": {
    "time": "2024-11-20T00:50:00+0000"
  },
  "audience": {
    "AND": [
      {
        "custom_attribute": {
          "custom_attribute_name": "country",
          "comparison": "equals",
          "value": "VN"
        }
      }
    ]
  }
}

    If that still doesn't work let me know, or you can always get in touch with support. But I'm gonna tag in some other Braze experts here to validate me (I'm still really new at JSON!) -- DavidO or AllanHeo or Manoj__ any chance you can double check my work? 😅

eakinsey's avatar
eakinsey
Icon for Community Manager rankCommunity Manager
2 months ago

Hi st-haingo! I think I can help here. Yes, you can use standard user attributes in the Connected Audience Object filter in Braze. While the documentation primarily highlights custom attributes, standard user attributes - for example, country - can also be utilized in your audience filters.

LIQUID

{% assign country_filter = {
  "user_attribute": {
    "attribute_name": "country",
    "comparison": "equals",
    "value": "VN"
  }
} %}

In this Liquid code snippet, we create a variable called country_filter that holds the JSON structure for the audience filter. You can then use this variable in your API call or wherever you need to reference the filter.

JSON
To create a filter using a standard user attribute, you would structure your filter like this:

{
  "user_attribute": {
    "attribute_name": "country",
    "comparison": "equals",
    "value": "VN"
  }
}

In this example, the user_attribute object is used to specify the standard user attribute you want to filter on, along with the comparison type and the value you're targeting.

Make sure to replace "country" with the actual name of the standard user attribute you want to use, and adjust the comparison and value as needed for your specific use case.

I hope that helps! If so, please take a second to mark this answer as the solution. Thank you! 🙇‍♀️