Skip to content

AccuWeather

AccuWeather ist ein Medienunternehmen, das weltweit Dienste zur Wettervorhersage anbietet. Mit AccuWeather können Sie Ihre Marketingkampagnen anreichern und personalisieren sowie Übersetzungen durch den Einsatz von Braze Connected-Content automatisieren.

Diese Integration wird von AccuWeather gepflegt.

Voraussetzungen

Anforderung Beschreibung
AccuWeather API-Schlüssel Kontaktieren Sie Ihren AccuWeather Account Manager, um kompatible API-Schlüssel für Ihre Anfrage-URLs zu erhalten.

Weitere Anweisungen finden Sie auf der Seite AccuWeather Enterprise API.

Verfügbare AccuWeather APIs

Im Folgenden finden Sie die AccuWeather APIs, die Sie in Ihren Braze Campaigns und Canvases referenzieren können.

API Beschreibung
Locations Rufen Sie einen Standortschlüssel für Ihren gewünschten Standort ab. Verwenden Sie den Standortschlüssel, um Wetterdaten von der Forecast- oder Current-Conditions-API abzurufen.
Forecast Erhalten Sie Vorhersageinformationen für einen bestimmten Standort.
Current Conditions Rufen Sie Daten zu den aktuellen Bedingungen für einen bestimmten Standort ab.
Indices Erhalten Sie tägliche Indexwerte für einen bestimmten Standort. Die Verfügbarkeit des Index variiert je nach Standort.
Weather Alarms Erhalten Sie Wetteralarme für einen bestimmten Standort. AccuWeather Weather Alarms werden anhand der täglichen Vorhersagen für einen Standort ermittelt. Ein Alarm besteht für einen Standort, wenn die Wettervorhersage bestimmte Schwellenwerte erreicht oder überschreitet.
Alerts Erhalten Sie Unwetterwarnungen von offiziellen staatlichen Wetterdiensten und führenden globalen Wetterwarnungsanbietern.
Imagery Rufen Sie Radar- und Satellitenbilder ab.
Tropical Erhalten Sie die aktuelle Position, frühere Positionen und Vorhersagen für tropische Wirbelstürme weltweit.
Translations Erhalten Sie eine Liste der verfügbaren Sprachen. Erhalten Sie Übersetzungen für bestimmte Gruppen von Phrasen.

Connected-Content-Beispiel

Das folgende Beispiel zeigt einen Connected-Content-Aufruf, der zwei verschiedene Arten von Nachrichten basierend auf den aktuellen Wetterbedingungen der Postleitzahl einer Nutzer:in in den USA anzeigt. Die AccuWeather-Endpunkte für Locations und Current Conditions werden verwendet.

1
2
3
4
5
6
7
8
9
10
11

{% connected_content http:///dataservice.accuweather.com/locations/v1/postalcodes/{{${country}}}/search?q={{custom_attribute.${Zip Code}}}&apikey={your API key} :save location_info %}

{% connected_content http://dataservice.accuweather.com/currentconditions/v1/{{location_info[0].Key}}?apikey={your API key} :save local_weather %}

{% if {{local_weather[0].WeatherText}} == 'Cloudy' %}
No sunscreen needed :)
{% elsif {{local_weather[0].WeatherText}} == 'Rain' %}
It's raining! Grab an umbrella!
{% else %}
Enjoy the weather!
{% endif %}

Eine Connected-Content-Push-Nachricht mit dem Text „It's raining! Grab an Umbrella!“, angezeigt auf einem Android-Gerät

Eine Aufschlüsselung der beiden Connected-Content-Aufrufe finden Sie in den folgenden Beispielen.

Locations-API-Beispiel

Innerhalb des ersten connected_content-Tags wird eine GET-Anfrage an die Locations API gestellt. Für dieses Beispiel können Sie alternativ die {{${city}}} der Nutzer:in nutzen, wenn Sie kein angepasstes Attribut für die Postleitzahl haben.

1

{% connected_content http://dataservice.accuweather.com/locations/v1/postalcodes/{{${country}}}/search?q={{custom_attribute.${Zip Code}}}&apikey={your API key} :save location_info %}

Hier sehen Sie ein Beispiel dafür, was AccuWeather als JSON-Objekt zurückgibt:

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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

[
  {
    "Version": 1,
    "Key": "41333_PC",
    "Type": "PostalCode",
    "Rank": 35,
    "LocalizedName": "Seattle",
    "EnglishName": "Seattle",
    "PrimaryPostalCode": "98102",
    "Region": {
      "ID": "NAM",
      "LocalizedName": "North America",
      "EnglishName": "North America"
    },
    "Country": {
      "ID": "US",
      "LocalizedName": "United States",
      "EnglishName": "United States"
    },
    "AdministrativeArea": {
      "ID": "WA",
      "LocalizedName": "Washington",
      "EnglishName": "Washington",
      "Level": 1,
      "LocalizedType": "State",
      "EnglishType": "State",
      "CountryID": "US"
    },
    "TimeZone": {
      "Code": "PDT",
      "Name": "America/Los_Angeles",
      "GmtOffset": -7.0,
      "IsDaylightSaving": true,
      "NextOffsetChange": "2018-11-04T09:00:00Z"
    },
    "GeoPosition": {
      "Latitude": 47.636,
      "Longitude": -122.327,
      "Elevation": {
        "Metric": {
          "Value": 26.0,
          "Unit": "m",
          "UnitType": 5
        },
        "Imperial": {
          "Value": 85.0,
          "Unit": "ft",
          "UnitType": 0
        }
      }
    },
    "IsAlias": false,
    "ParentCity": {
      "Key": "351409",
      "LocalizedName": "Seattle",
      "EnglishName": "Seattle"
    },
    "SupplementalAdminAreas": [
      {
        "Level": 2,
        "LocalizedName": "King",
        "EnglishName": "King"
      }
    ],
    "DataSets": [
      "Alerts",
      "DailyAirQualityForecast",
      "DailyPollenForecast",
      "ForecastConfidence",
      "MinuteCast"
    ]
  }
]

Die „Key“-ID ist eine nützliche Variable, da sie in der zweiten GET-Anfrage verwendet wird. Dieses JSON-Objekt kann in einer lokalen Variable location_info gespeichert werden, indem Sie :save location_info nach der URL angeben.

Current-Conditions-API-Beispiel

Für den zweiten connected_content-Tag wird eine GET-Anfrage an die Current Conditions API gestellt. Der Standortschlüssel muss der Anfrage-URL hinzugefügt werden. Hier ist ein Beispiel für den connected_content-Tag:

1

{% connected_content http://dataservice.accuweather.com/currentconditions/v1/{{location_info[0].Key}}?apikey={your API key} :save local_weather %}

Hier ist das zurückgegebene JSON-Objekt:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

[
  {
    "LocalObservationDateTime": "2018-04-10T09:35:00-07:00",
    "EpochTime": 1523378100,
    "WeatherText": "Rain",
    "WeatherIcon": 18,
    "IsDayTime": true,
    "Temperature": {
      "Metric": {
        "Value": 11.0,
        "Unit": "C",
        "UnitType": 17
      },
      "Imperial": {
        "Value": 52.0,
        "Unit": "F",
        "UnitType": 18
      }
    },
    "MobileLink": "http://m.accuweather.com/en/us/seattle-wa/98104/current-weather/41333_pc?lang=en-us",
    "Link": "http://www.accuweather.com/en/us/seattle-wa/98104/current-weather/41333_pc?lang=en-us"
  }
]

Wie im connected_content-Tag zu sehen ist, wird das JSON-Objekt in einer lokalen Variable local_weather gespeichert, indem :save local_weather nach der URL hinzugefügt wird.

Sie können testen, wie die Ausgabe von WeatherText aussehen soll, indem Sie auf {{local_weather[0].WeatherText}} verweisen.

Wenn der API-Aufruf mit {{local_weather[0].WeatherText}} antwortet und Rain zurückgibt, würde die Nutzer:in den Push erhalten.
New Stuff!