> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Amazon Athena

> Amazon Athena'dan OneSignal'a özel etkinlikleri senkronize ederek kullanıcı davranışlarına dayalı otomatik Yolculuklar ve kişiselleştirilmiş mesajlaşma kampanyaları tetikleyin.

export const PLATFORM_0 = "Athena"

export const DATA_TYPE_0 = "tablo sütunları"

export const COLUMN_HEADER_0 = "Athena Sütunu"

export const PROPERTIES_DESCRIPTION_0 = "S3 veri gölünden etkinlik meta verileri"

## Genel Bakış

OneSignal + Amazon Athena entegrasyonu, Athena veri gölünüzdeki özel etkinliklerin doğrudan OneSignal'ın Özel Etkinlikler API'sine otomatik senkronizasyonunu sağlar. Bu, AWS veri altyapınızda depolanan gerçek kullanıcı davranışlarına dayalı otomatik Yolculuklar ve kişiselleştirilmiş mesajlaşma kampanyaları tetiklemenize olanak tanır.

Satın almalar, ürün görüntülemeleri, abonelik değişiklikleri veya herhangi bir özel kullanıcı eylemini senkronize ederek, push bildirimleri, e-posta, uygulama içi mesajlar ve SMS üzerinden ekleme dizilerini, yeniden etkileşim kampanyalarını, işlemsel mesajları ve hedeflenmiş promosyonları otomatik olarak tetikleyebilirsiniz.

***

## Gereksinimler

* Access to [Event Streams](/docs/en/event-streams) for outbound message events (Plan limitations and overages apply)
* Access to [Custom Events](/docs/en/custom-events) for inbound event syncing (Plan limitations and overages apply)
* [Updated Account Plan](https://onesignal.com/pricing) (not available on free apps)

### Amazon Athena

* Athena erişimi olan **AWS Hesabı**
* Yapılandırılmış **Athena Çalışma Grubu** (varsayılan: "primary")
* Athena sorgu çıktıları için **S3 Sorgu Sonuçları Bucket'ı**
* Athena, S3 ve AWS Glue erişimi için **IAM İzinleri**
* S3'te depolanan ve AWS Glue'da kataloglanmış **Etkinlik verileri**

***

## Kurulum

### AWS izinlerini yapılandırma

OneSignal'ın Athena aracılığıyla etkinlik verilerinizi sorgulaması için belirli izinlere ihtiyacı vardır. Aşağıdaki izinlere sahip bir IAM politikası oluşturun:

<Steps>
  <Step title="IAM politikası oluşturma">
    Bu izinleri içeren bir IAM politikası oluşturun:

    ```json theme={null}
    {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Effect": "Allow",
                "Action": [
                    "athena:StartQueryExecution",
                    "athena:GetQueryExecution",
                    "athena:GetQueryResultsStream",
                    "athena:GetQueryResults",
                    "athena:CreatePreparedStatement",
                    "athena:DeletePreparedStatement",
                    "glue:GetTable",
                    "glue:GetTables",
                    "glue:GetDatabase",
                    "glue:GetDatabases",
                    "s3:PutObject",
                    "s3:GetObject",
                    "s3:ListBucket",
                    "s3:GetBucketLocation"
                ],
                "Resource": [
                    "arn:aws:glue:<region>:<aws-account-id>:table/<database>/*",
                    "arn:aws:glue:<region>:<aws-account-id>:database/<database>",
                    "arn:aws:glue:<region>:<aws-account-id>:catalog",
                    "arn:aws:athena:<region>:<aws-account-id>:workgroup/<workgroup>",
                    "arn:aws:s3:::<query-results-bucket>",
                    "arn:aws:s3:::<query-results-bucket>/*",
                    "arn:aws:s3:::<event-data-bucket>",
                    "arn:aws:s3:::<event-data-bucket>/*"
                ]
            }
        ]
    }
    ```

    <Info>
      Yer tutucuları gerçek AWS bölgeniz, hesap kimliğiniz, veritabanı adınız, çalışma grubunuz ve bucket adlarınızla değiştirin.
    </Info>
  </Step>

  <Step title="IAM kullanıcısı veya rolü oluşturma">
    OneSignal için bir IAM kullanıcısı oluşturun ve yukarıda oluşturulan politikayı ekleyin veya rol tabanlı erişim kullanmaya hazırlanın.
  </Step>

  <Step title="Bağlantı ayrıntılarını not etme">
    Aşağıdaki bilgileri toplayın:

    * **AWS Erişim Anahtarı Kimliği** ve **Gizli Erişim Anahtarı** (IAM kullanıcısı kullanılıyorsa)
    * **S3 Sorgu Sonuçları Bucket'ı** URL'si
    * **AWS Bölgesi**
    * **Athena Çalışma Grubu** (varsayılan: "primary")
  </Step>
</Steps>

### OneSignal Athena bağlantısını yapılandırma

<Steps>
  <Step title="Entegrasyonlara gitme">
    In OneSignal, go to **Data > Integrations** and click **Add Integration**.
  </Step>

  <Step title="Amazon Athena'yı seçme">
    Mevcut entegrasyonlar listesinden **Amazon Athena**'yı seçin.
  </Step>

  <Step title="Bağlantı ayrıntılarını girme">
    Athena bağlantı bilgilerinizi sağlayın:

    * **AWS Erişim Anahtarı Kimliği**: IAM kullanıcı erişim anahtarınız
    * **AWS Gizli Erişim Anahtarı**: IAM kullanıcı gizli anahtarınız
    * **AWS Bölgesi**: Athena bölgeniz
    * **S3 Sorgu Sonuçları Bucket'ı**: Sorgu çıktıları için URL
    * **Athena Çalışma Grubu**: Çalışma grubu adınız
  </Step>

  <Step title="Bağlantıyı test etme">
    OneSignal'ın Athena örneğinize erişip sorgu yürütebildiğini doğrulamak için **Bağlantıyı Test Et**'e tıklayın.
  </Step>
</Steps>

### Alternatif: Rol tabanlı erişim

Gelişmiş güvenlik için, erişim anahtarları yerine IAM rolleri kullanabilirsiniz:

<Steps>
  <Step title="Rol tabanlı erişimi etkinleştirme">
    Athena bağlantı ayarlarında **Rol Kullan**'ı işaretleyin ve erişim anahtarlarını boş bırakın.
  </Step>

  <Step title="IAM rolü oluşturma">
    AWS Konsolu'nda aşağıdakilere sahip bir IAM rolü oluşturun:

    * **Güvenilir Varlık**: Başka bir AWS Hesabı
    * **Hesap Kimliği**: `341876425553` (OneSignal'ın AWS hesabı)
    * **Harici Kimlik**: OneSignal'da gösterilen kimlik (ilk bağlantı denemesinden sonra görünür)
    * **İzinler**: Yukarıda oluşturulan IAM politikası
  </Step>

  <Step title="Bağlantıyı tamamlama">
    OneSignal'a Rol ARN'sini girin ve bağlantıyı test edin.
  </Step>
</Steps>

***

## Etkinlik Veri Eşlemesi

Bağlandıktan sonra, Athena tablolarınızı OneSignal özel etkinlik alanlarıyla eşlemeniz gerekecektir:

<Steps>
  <Step title="Etkinlik tablolarını seçme">
    OneSignal'a senkronize etmek istediğiniz etkinlik verilerinizi içeren tabloları veya görünümleri seçin.
  </Step>

  <Step title="Gerekli etkinlik alanlarını eşleme">
    Özel etkinlikler için gerekli alanları eşleyin:

    * **Etkinlik Adı**: Etkinlik türünü içeren sütun (örn., "satın alma", "kayıt")
    * **Kullanıcı Tanımlayıcısı**: Harici Kullanıcı Kimliği, E-posta veya Telefon Numarası sütunu
    * **Etkinlik Zaman Damgası**: Etkinliğin gerçekleştiği zaman (isteğe bağlı)
  </Step>

  <Step title="Etkinlik yük verilerini eşleme">
    Ek sütunları etkinlik yükü özelliklerine eşleyin:

    * Özel etkinlik özellikleri (product\_id, price, category, vb.)
    * Bağlamsal veriler (kaynak, kampanya, vb.)
    * Davranışsal metrikler (değer, miktar, vb.)
  </Step>

  <Step title="Senkronizasyon ayarlarını yapılandırma">
    Etkinlik işleme sıklığınızı ve teslimat tercihlerinizi ayarlayın.
  </Step>
</Steps>

***

### Event data mapping

Map your {PLATFORM_0} {DATA_TYPE_0} to OneSignal's custom events format:

| OneSignal Field | {COLUMN_HEADER_0} | Description                | Required |
| --------------- | ----------------- | -------------------------- | -------- |
| `name`          | `event_name`      | Event identifier           | Yes      |
| `external_id`   | `user_id`         | User identifier            | Yes      |
| `timestamp`     | `event_timestamp` | When event occurred        | No       |
| `properties`    | `event_data`      | {PROPERTIES_DESCRIPTION_0} | No       |

***

## Sınırlamalar

* **Sorgu Performansı**: Athena, sorgu başına ve taranan veri başına ücret alır - etkinlik tablolarınızı optimize edin
* **S3 Bağımlılıkları**: Düzgün yapılandırılmış S3 bucket'ları ve Glue katalogu gerektirir
* **Veri Tazeliği**: Etkinlik senkronizasyon sıklığı, S3 verilerinizin ne sıklıkla güncellendiğine bağlıdır

***

## SSS

### Athena sorgularım başarısız olursa ne olur?

OneSignal sorgu hatalarını günlükler ve başarısız sorguları yeniden dener. Kalıcı hatalarla karşılaşırsanız IAM izinlerinizi ve S3 bucket erişiminizi kontrol edin.

### OneSignal etkinlikleri ne sıklıkla senkronize eder?

OneSignal, yapılandırılmış senkronizasyon sıklığınıza göre yeni etkinlikleri kontrol eder, minimum aralık 15 dakikadır.

***

## Yardıma mı ihtiyacınız var?

Athena entegrasyon kurulumunuzla ilgili yardım için `support@onesignal.com` adresinden destek ekibimizle iletişime geçin veya uygulama içi sohbeti kullanın.