Ana içeriğe atla

​
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

​
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:
1

IAM politikası oluşturma

Bu izinleri içeren bir IAM politikası oluşturun:
{
    "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>/*"
            ]
        }
    ]
}
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.
2

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.
3

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”)

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

1

Entegrasyonlara gitme

In OneSignal, go to Data > Integrations and click Add Integration.
2

Amazon Athena'yı seçme

Mevcut entegrasyonlar listesinden Amazon Athena’yı seçin.
3

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
4

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.

​
Alternatif: Rol tabanlı erişim

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

Rol tabanlı erişimi etkinleştirme

Athena bağlantı ayarlarında Rol Kullan’ı işaretleyin ve erişim anahtarlarını boş bırakın.
2

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ı
3

Bağlantıyı tamamlama

OneSignal’a Rol ARN’sini girin ve bağlantıyı test edin.

​
Etkinlik Veri Eşlemesi

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

Etkinlik tablolarını seçme

OneSignal’a senkronize etmek istediğiniz etkinlik verilerinizi içeren tabloları veya görünümleri seçin.
2

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ı)
3

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.)
4

Senkronizasyon ayarlarını yapılandırma

Etkinlik işleme sıklığınızı ve teslimat tercihlerinizi ayarlayın.

​
Event data mapping

Map your to OneSignal’s custom events format:
OneSignal FieldDescriptionRequired
nameevent_nameEvent identifierYes
external_iduser_idUser identifierYes
timestampevent_timestampWhen event occurredNo
propertiesevent_dataNo

​
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.